Component
core/messaging/rabbitmq
A RabbitMQ message broker speaking the AMQP protocol, persisting queues and messages durably. Exports its host and AMQP port to consumers via the uses topology. Self-hosted, it renders as a stateful workload with a persistent volume, by a Helm Recipe (Workload synthesis to native Kubernetes resources), a Compose Recipe (local development), and a controller-driven Helm Recipe that emits a RabbitmqCluster custom resource for the RabbitMQ Cluster Operator. Reach for the synthesis Recipe on a cluster that runs no RabbitMQ control plane, and for the controller-driven one where the control plane is in place and the cluster should own upgrades, rolling restarts and credential rotation. Broker access always requires credentials: on these Recipes the password slot is optional, and each falls back to a deterministic inline development default so the render stays reproducible. Reach for the rabbitmq-amazon-mq Recipes, on terraform and on CloudFormation, where the broker is an Amazon MQ broker in the operator's AWS account. Amazon MQ serves AMQP over TLS alone, on 5671, published as protocol amqps, and requires a password: a core/random-password attachment, without which the build halts. It runs RabbitMQ 4.3, 4.2 and 3.13, so the engine_version default halts there. The self-hosted brokers serve their own metrics, published with `values.metrics_enabled` true; the Amazon MQ Recipes halt on true.
출처
- 콘텐츠 다이제스트
- sha256:f4c0aefbfcb8b053e435e79985622412924a5ffdd575b3b96dcb804ba583bff4
- 게시일
- 2026-11-10T10:12:32Z
- 서명 ID
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
서명
- 공식application/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:e0e8d7037c8e13c83e681972e42ec3e0bcaf2b0c1cf48b972365c9c6c3a50d28
이 버전의 참조
oci://hub.aggrega.ai/component/core/messaging/rabbitmq:1.0.0개발자 매개변수
개발자가 Aggregate에서 설정하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| user | string | user | 아니요 | Application user the broker provisions on startup. The matching password comes from the password credential slot. On Amazon MQ it is the broker's one administrative user, named with 2 to 100 letters, digits, dashes, periods and underscores; the Amazon MQ Recipes refuse any other name, and guest. |
| metrics_enabled | boolean | false | 아니요 | Publishes where the broker's own metrics are, in the Prometheus format — the address as `metrics_endpoint`, or, on a controller-driven cluster of more than one node, the Service a scraper discovers every node behind — putting their port on the Service where a realization needs it; while false those keys are empty. The metrics port checks no caller, so anything that reaches it can read them. The Amazon MQ realizations halt the build on true, since the service shows its metrics only to a scraper presenting the broker's own credentials. |
운영자 사이징
운영자가 환경별로 조정하는 인프라 사이징입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 5672 | 아니요 | AMQP listen port. Most operators should omit this and let the Recipe assign the default (5672). The Amazon MQ realizations do not read it — the service serves AMQP over TLS on 5671 alone, which they publish as port — and halt the build on any value other than this default. |
| management_port | integer (min 1024, max 65535) | 15672 | 아니요 | Management HTTP API and dashboard port. Most operators should omit this and let the Recipe assign the default (15672). The Amazon MQ realizations do not read it — the service serves the management interface at an address of its own — and halt the build on any value other than this default. |
| engine_version | string | 4.1.3-management-alpine | 아니요 | RabbitMQ container image tag. Selects the image tag on container targets. On Amazon MQ the major and minor version it begins with is the broker's RabbitMQ version, one of 4.3, 4.2 (both on the mq.m7g instance types alone) and 3.13; this default begins 4.1, which the service does not run, so the Amazon MQ realizations halt on it, naming the versions to set. |
| compute | object | — | 아니요 | — |
| storage | object | — | 아니요 | — |
| overrides | object (open) | — | 아니요 | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
| control_plane_present | boolean | false | 아니요 | Operator affirmation that the RabbitMQ Cluster Operator (control plane) is installed in the target cluster. A controller-driven realization halts the build unless this is set true, so a RabbitmqCluster custom resource is never emitted as an orphan into a cluster that cannot reconcile it. The synthesized realizations ignore this flag. The Amazon MQ realizations do not read it and halt the build while it is true: no RabbitMQ control plane is installed for Amazon MQ. |
| credentials | string (generated | supplied) | generated | 아니요 | Who owns the broker's credentials on a controller-driven realization. `generated` — the controller creates the credential Secret and owns the password, which is what it does when nothing is supplied; the developer's `user` value is still honored, and no password reaches the rendered artifact. `supplied` — the controller reads the credentials from an existing Secret named in `credentials_secret` and generates none. The synthesized realizations ignore this key: they always take the password from the `password` credential slot. The Amazon MQ realizations do not read it either, and halt the build on `supplied`. |
| credentials_secret | string | 아니요 | Name of the existing Secret a controller-driven realization reads the broker credentials from when `credentials` is `supplied`. The Secret lives in the same namespace as the broker and carries the same entries the controller would otherwise generate — `username`, `password`, `default_user.conf`, `host`, `port`, `provider` and `type`. Leave it empty when `credentials` is `generated`; a controller-driven build halts if `supplied` is selected without it. The Amazon MQ realizations do not read it and halt the build while it is set. |
출력 계약
이 컴포넌트가 uses 토폴로지를 통해 소비자에게 게시하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| host | string | — | 예 | Address a producer or consumer opens its broker connection to. Which Service carries it follows the realization the Manifest selected, so a consumer reads this rather than deriving a name. On Amazon MQ it is a pointer string the target resolves to the host of the broker's AMQP endpoint — a Terraform reference, or a CloudFormation intrinsic that a consumer in another stack imports — or the DNS name the Release sets in infra.overrides.host instead, so a consumer on another target receives an address it can resolve. The broker's certificate names its own endpoint, so a client checking it fails against that DNS name. |
| port | integer | — | 예 | TCP port the broker accepts client connections on. It carries the messaging port, never the management API port, so a consumer reaches the broker rather than its dashboard; on Amazon MQ it is 5671. |
| protocol | string | — | 아니요 | Wire protocol the published address speaks, which is what a consumer selects a client library and its connection security for — `amqp`, AMQP without TLS, from the self-hosted realizations, and `amqps`, AMQP over TLS, from the Amazon MQ realizations, since the service requires TLS on every client connection. |
| metrics_endpoint | string | — | 아니요 | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:15692/metrics`. Empty while values.metrics_enabled is false, and on the controller-driven realization while the cluster runs more than one node, which then publishes `metrics_service` instead. |
| metrics_service | string | — | 아니요 | Name of the Service every node's metrics sit behind, for a scraper that discovers each endpoint of that Service rather than scraping one address. Set by the controller-driven realization while values.metrics_enabled is true and the cluster runs more than one node, beside `metrics_service_port` and `metrics_path`; empty otherwise. |
| metrics_service_port | string | — | 아니요 | Name of the port of `metrics_service` that carries the metrics, `prometheus`. Set and empty together with `metrics_service`. |
| metrics_path | string | — | 아니요 | Path the metrics are served at, `/metrics`, published beside `metrics_service`. Empty where the component publishes `metrics_endpoint`, which carries its own path. |
uses 소켓
이 컴포넌트가 연결에 사용하는 의존성 소켓입니다. 소켓을 통해 배선되는 모든 연결의 대상은 해당 소켓의 레이블 셀렉터를 충족해야 하며, 각 연결은 소켓이 선언한 슬롯에 첨부를 전달할 수 있습니다. 필수 슬롯은 Aggregate 또는 Release가 해당 소켓을 통해 배선하는 각 연결이 채워야 합니다.
선언된 uses 소켓이 없습니다.
첨부 슬롯
Feature가 이 컴포넌트에 첨부되는 이름 있는 바인딩 지점입니다. 슬롯의 셀렉터는 어떤 Feature가 슬롯을 채울 수 있는지를 제한하고, 슬롯의 inject 목록은 Feature의 자료를 어떻게 전달할 수 있는지를 지정합니다. 필수 슬롯은 인스턴스의 첨부 또는 그 위 범위의 첨부를 통해 모든 인스턴스에서 바인딩되어야 하며, 민감 슬롯은 비밀 자료를 처리하도록 선언됩니다. Feature는 어떤 슬롯도 선언하지 않은 이름으로 첨부될 수도 있습니다.
| 슬롯 | 셀렉터 | 필수 | 주입 | 민감 | 설명 |
|---|---|---|---|---|---|
| password | feature.aggrega.ai/kind=secret | 아니요 | env | 예 | Broker password credential. Attached, it supplies the RabbitMQ application-user password via the credential subsystem. Unattached, compose/rabbitmq and helm/rabbitmq set it to the development literal `devpass`, which this catalog publishes, so every Release built with them that leaves the slot unattached shares that password, and the Amazon MQ Recipes halt the build: they take core/random-password alone, with values.symbols false and values.length 12 or more, as Amazon MQ refuses a password shorter than 12 characters or holding a comma, colon or equals sign. |
자체 주입 허용 목록
env
관계
게시된 다른 엔터티와 주고받는 타입 지정 에지입니다. 게시된 대상이 없는 참조는 링크가 아닌 끊어진 에지로 표시됩니다.
사용함
이 엔터티는 카탈로그의 어떤 것도 사용하지 않습니다.
사용됨
소켓 «target_messaging» 사용
소켓 «backend» 사용
소켓 «databases» 사용
소켓 «etcd» 사용
소켓 «backend» 사용
소켓 «backend» 사용
소켓 «forward_target» 사용
소켓 «scrape_target» 사용
소켓 «backend» 사용
소켓 «database» 사용
적용 대상
적용 대상
적용 대상
구현
구현
구현
구현
구현