Custom resources¶
API group: messaging.mkurator.dev — v1beta1 is the only served and
stored version (all six kinds). The earlier v1alpha1 version and its
conversion webhook were removed; upgrading from a build where v1alpha1 was ever
the etcd storage version (≤ v0.12) requires the one-time stored-object
rewrite+prune in UPGRADE.md first
(ADR-0026, API_STABILITY.md).
Field-level reference pages (every spec/status field) are being added per
kind; the field tables are generated from the CRD OpenAPI schema by
task docs:crd-ref and augmented with hand-written prose. All six kinds are
covered: QueueManagerConnection,
Queue, Topic, Channel,
ChannelAuthRule, AuthorityRecord.
| Kind | Short name | Purpose | Sample YAML |
|---|---|---|---|
QueueManagerConnection |
qmc |
mqweb endpoint, TLS, credential Secret reference |
queuemanagerconnection.yaml |
Queue |
mq |
Local, alias, or remote queue | queue.yaml |
Topic |
tp |
Administrative topic | topic.yaml |
Channel |
chl |
Server-connection, sender, or receiver channel | channel.yaml |
ChannelAuthRule |
car |
Channel authentication rule | channelauthrule.yaml |
AuthorityRecord |
auth |
OAM authority record | authorityrecord.yaml |
Queue variants¶
spec.type |
MQ object | Sample |
|---|---|---|
local (default) |
QLOCAL |
queue.yaml |
alias |
QALIAS |
queue_alias.yaml |
remote |
QREMOTE |
queue_remote.yaml |
Further reading¶
- Field-level install guide: INSTALL_AND_USE.md — Resource reference
- Drift and attribute policy: ATTRIBUTE_RECONCILIATION.md
- Annotated samples: config/samples/README.md
- OpenAPI golden contracts: test/schema/README.md