Recipe

rabbitmq-cluster

RabbitMQ realized as a RabbitmqCluster custom resource the RabbitMQ Cluster Operator reconciles, rather than a directly synthesized StatefulSet — the controller-driven realization of the same RabbitMQ component, selectable in the Manifest alongside the synthesis recipe. The recipe emits one RabbitmqCluster conformant to the rabbitmq.com/v1beta1 API; the controller turns it into a running broker, its client Service and its credential Secret. The RabbitmqCluster is written into the namespace the Release, or else the Aggregate, names through the aggrega.ai/namespace annotation, where one is set. provides.host is the client Service the controller creates for the cluster, so a consumer wires to it exactly as it would to the synthesized realization. Credential custody is the operator's choice: infra.credentials generated leaves the password with the controller, and supplied points it at an existing Secret named in infra.credentials_secret. The RabbitMQ Cluster Operator is a runtime prerequisite: the build halts unless the operator affirms it is installed (infra.control_plane_present), so no custom resource is emitted into a cluster that cannot reconcile it. Reach for this realization where the control plane is already in place; reach for the synthesis recipe where it is not. The controller switches the broker's metrics on and puts their port, 15692, which checks no caller, on the client Service. With `values.metrics_enabled` true their address is published as provides.metrics_endpoint while the cluster runs one node; with more, provides.metrics_service names that client Service for a scraper to discover every node behind it. With the value false, those keys are empty.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:64ddbf911f0c8b53f7e4e484497ec3bf596d00ef016bfc9cbb2e78fc69a607bf
Published
2026-11-10T10:26:51Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:04db23cc0752b1def3cefbbcd8334150d63834ae0d985ea456bd34652a3199a0

Reference at this version

oci://hub.aggrega.ai/recipe/helm/rabbitmq-cluster:1.0.0
Target
—
Implements
core/messaging/rabbitmq:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port5672
protocolamqp
metrics_endpoint{{ if and .values.metrics_enabled (le (int (optional (default dict .infra.overrides) "replicas" 1)) 1) }}http://{{ .context.instance_id }}:15692/metrics{{ end }}
metrics_service{{ if and .values.metrics_enabled (gt (int (optional (default dict .infra.overrides) "replicas" 1)) 1) }}{{ .context.instance_id }}{{ end }}
metrics_service_port{{ if and .values.metrics_enabled (gt (int (optional (default dict .infra.overrides) "replicas" 1)) 1) }}prometheus{{ end }}
metrics_path{{ if and .values.metrics_enabled (gt (int (optional (default dict .infra.overrides) "replicas" 1)) 1) }}/metrics{{ end }}

Workload

No workload template declared.

Locals

No locals declared.

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/messaging/rabbitmq:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy