跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

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,并通过 env secretKeyRef 引用,因此 明文永远不会出现在渲染出的清单中。

生成示例

你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。

将示例写入一个以其命名的新文件夹:

Terminal window
aggrega scaffold --example rabbitmq-broker

然后它会打印接下来要运行的命令。第一条命令进入新文件夹:

Terminal window
cd rabbitmq-broker

构建

此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志;--auto-pull 会在构建期间写入新克隆所缺少的锁文件:

Terminal window
# Local development (Docker Compose), inline development password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attached
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega 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 值是开发用 占位符;任何实际部署都应通过你的凭据来源提供真实值。未附加凭据时使用的内联开发密码 同样仅供本地使用。