Custom resources¶
API group: messaging.mkurator.dev — both v1alpha1 and v1beta1
are served (all six kinds), with a conversion webhook between them. New manifests
should use v1beta1 (the samples below default to it); v1alpha1 remains the
etcd storage version until the hub migration is proven in CI
(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