Home

MKurator is a Kubernetes operator that declaratively manages IBM MQ administrative objects on an existing queue manager — queues, topics, channels, channel auth rules, and authority records — via the mqweb REST API.

messaging.mkurator.dev/v1alpha1 · event-driven · TLS-first · Helm-ready

Quick start Install guide

What MKurator does

You declare desired MQ state in Kubernetes custom resources. The operator reconciles that state against your queue manager through HTTPS mqweb, reports conditions on each CR, and removes MQ objects when you delete a resource (finalizers).

MKurator does not install or scale queue managers — it connects to one you already run.

How it works

Custom Resource  →  controller reconcile  →  mqweb REST (MQSC)  →  IBM MQ Queue Manager
       ↑                                                              |
       └──────────── status conditions / Events ←──────────────────────┘

Custom resource	MQ objects
QueueManagerConnection	Connectivity + credential reference
Queue	QLOCAL, QALIAS, QREMOTE
Topic	TOPIC
Channel	CHLTYPE(SVRCONN)
ChannelAuthRule	SET CHLAUTH
AuthorityRecord	SET AUTHREC (OAM)

v1alpha1 status

Phase 5 auth (ChannelAuthRule, AuthorityRecord) is shipped on main. Latest release: v0.6.0. See the roadmap for remaining items.

Documentation map

Audience	Start here
Operators	Install and use · Upgrade · Observability
Developers	Development setup · Developer guide · CI/CD
Architects	Architecture · Attribute reconciliation · ADRs
Contributors	Contributing · Code of Conduct · Governance

Examples

• Queue and connection walkthrough
• Channel authentication
• Upgrade walkthrough

Sample YAML with field notes: config/samples README.