RabbitMQ — 一个 Aggregate,两个目标,可选身份验证
本示例将一个由开发者编写的 Aggregate 中的单个 RabbitMQ 消息代理(AMQP)编译到两个目标:
- 用于本地开发的 Docker Compose,以及
- Kubernetes,通过合成的 helm Recipe 直接运行官方
上游
rabbitmq镜像(一个带持久卷的 StatefulSet, 无需外部 chart)。
同一个 aggregate.yaml 驱动两者。每个目标只改变由
Manifest 选择的 Recipe 层。第二个 Aggregate aggregate-helm-synth-auth.yaml
展示了 Kubernetes 上附加了可引用密码凭据的
同一代理。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | 开发者意图:一个类型为 core/messaging/rabbitmq 的 broker 组件,无凭据——由 Recipe 提供确定性的内联开发密码。 |
aggregate-auth.yaml | 同一代理,在组件的可选 password 槽位上附加了注入值(inject-value)密码凭据(供 Compose 目标使用)。 |
aggregate-helm-synth-auth.yaml | 同一代理,附加了可引用的密码凭据,该凭据被具体化为 Kubernetes Secret 并由 StatefulSet 引用(供 Kubernetes 目标使用)。 |
manifest-compose.yaml | 将 RabbitMQ 类型映射到 Compose Recipe(compose/rabbitmq),并将凭据映射到 dotenv-secret。 |
manifest-helm-synth.yaml | 将 RabbitMQ 类型映射到合成的 helm Recipe(helm/rabbitmq),并将凭据映射到 k8s-secret-from-parameter。 |
release-compose.yaml / release-helm-synth.yaml | 两个目标的运维记录,使用内联开发密码。 |
release-compose-auth.yaml / release-helm-synth-auth.yaml | 通过凭据槽位提供密码的运维记录。 |
Manifests 中的 Recipe 引用限定了 provider 作用域(compose/rabbitmq、
helm/rabbitmq),因为每个 provider 都存在同名的 Recipe。
演示内容
- 一个编写界面,多个目标。 单个 Aggregate 是栈是什么的 唯一事实来源。每个 Manifest 说明如何实现它。
- 持久化代理。 RabbitMQ 会持久化队列和消息,因此该组件
的类型为
stateful-server。在 Kubernetes 上,合成的 Recipe 会渲染 一个 StatefulSet,其每个副本都有一个挂载到 RabbitMQ 数据目录的持久卷,以及一个提供稳定网络标识的 Headless Service;Compose 服务则为本地开发暴露该代理。 - 无 chart 合成(Kubernetes)。 Kubernetes 目标直接运行官方
rabbitmq镜像。编译器根据组件的infra规格合成 StatefulSet、ClusterIP Service 和 Headless Service——无需获取或跟踪外部 chart。镜像标签通过infra.engine_version固定,因此渲染结果不含浮动标签。 - 两个代理端口。 该镜像启用了管理功能,因此代理会在容器 和 ClusterIP Service 上暴露 AMQP 端口(5672)和管理面板(15672)。
- 确定性凭据。 RabbitMQ 始终进行身份验证。未附加
凭据时,每个 Recipe 都会提供固定的内联开发
密码,使渲染结果在多次运行间逐字节一致。附加凭据
时,注入的值会设置代理密码:在 Compose 上,它成为
RABBITMQ_DEFAULT_PASS服务环境变量;在 Kubernetes 上,它被 具体化为 Secret,并通过 envsecretKeyRef引用,因此 明文永远不会出现在渲染出的清单中。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example rabbitmq-broker然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd rabbitmq-broker构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志;--auto-pull 会在构建期间写入新克隆所缺少的锁文件:
# Local development (Docker Compose), inline development passwordaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline passwordaggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attachedaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pull渲染产物位于 dist/ 下。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果 Workspace 文件夹中还没有 `rabbitmq-broker` 文件夹,就调用一次 `scaffold` 工具,将 `example` 设为 `rabbitmq-broker`,不设 `dir`:它会把示例写入新的 `rabbitmq-broker` 文件夹。然后按以下顺序为每个 Release 各调用一次 `build` 工具——`release-compose.yaml`、`release-helm-synth.yaml`、`release-compose-auth.yaml` 和 `release-helm-synth-auth.yaml`——每次都将 `workspace_root` 设为 `rabbitmq-broker`,`release` 设为该文件,`auto_pull` 设为 true,`write` 设为 true。告诉我每次构建写入了哪些文件;它们位于 `rabbitmq-broker/dist/` 下。凭据传递说明
在 Compose 上,凭据是注入值(inject-value)secret:其值通过
组件的环境管道传递,并成为 RABBITMQ_DEFAULT_PASS 服务
环境变量。在 Kubernetes 上,凭据是可引用的:它被
具体化为 Kubernetes Secret,StatefulSet 通过
env secretKeyRef 引用它,因此明文密码永远不会出现在工作负载
清单中。auth Aggregates 中的 origin 值是开发用
占位符;任何实际部署都应通过你的凭据来源提供真实值。未附加凭据时使用的内联开发密码
同样仅供本地使用。