RabbitMQ — один Aggregate, две целевые платформы, необязательная аутентификация
Этот пример компилирует один брокер сообщений RabbitMQ (AMQP) из одного написанного разработчиком Aggregate для двух целевых платформ:
- Docker Compose для локальной разработки и
- Kubernetes — через синтезированный helm Recipe, который напрямую запускает официальный
upstream-образ
rabbitmq(StatefulSet с постоянным томом, без внешнего чарта).
Один и тот же aggregate.yaml управляет обоими. Для каждой целевой платформы меняется только слой Recipe, выбранный
Manifest. Второй Aggregate, aggregate-helm-synth-auth.yaml,
показывает тот же брокер в Kubernetes с прикреплёнными ссылочными учётными данными
в виде пароля.
Файлы
| Файл | Роль |
|---|---|
aggregate.yaml | Намерение разработчика: один компонент broker типа core/messaging/rabbitmq, без учётных данных — Recipe предоставляет детерминированный встроенный пароль для разработки. |
aggregate-auth.yaml | Тот же брокер с учётными данными в виде пароля типа inject-value, прикреплёнными к необязательному слоту password компонента (используется целевой платформой Compose). |
aggregate-helm-synth-auth.yaml | Тот же брокер с прикреплёнными ссылочными учётными данными в виде пароля, материализованными как Secret Kubernetes, на который ссылается StatefulSet (используется целевой платформой Kubernetes). |
manifest-compose.yaml | Сопоставляет тип RabbitMQ с Recipe для Compose (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 | Записи оператора, передающие пароль через слот учётных данных. |
Ссылки на Recipe в Manifests ограничены областью провайдера (compose/rabbitmq,
helm/rabbitmq), поскольку Recipe с таким именем существует для каждого провайдера.
Что демонстрирует пример
- Одна поверхность описания, много целевых платформ. Единственный Aggregate — источник истины о том, что представляет собой стек. Каждый Manifest описывает, как его реализовать.
- Надёжный брокер. RabbitMQ сохраняет очереди и сообщения, поэтому компонент
имеет тип
stateful-server. В Kubernetes синтезированный Recipe генерирует StatefulSet с постоянным томом для каждой реплики, смонтированным в каталог данных RabbitMQ, и Headless Service для стабильной сетевой идентичности; сервис Compose открывает доступ к брокеру для локальной разработки. - Синтез без чарта (Kubernetes). Целевая платформа Kubernetes напрямую запускает официальный
образ
rabbitmq. Компилятор синтезирует StatefulSet, ClusterIP Service и Headless Service на основе параметров размераinfraкомпонента — не нужно искать и отслеживать внешний чарт. Тег образа фиксируется черезinfra.engine_version, поэтому результат рендеринга не содержит плавающего тега. - Оба порта брокера. В образе включён модуль управления, поэтому брокер открывает порт AMQP (5672) и панель управления (15672) в контейнере и в ClusterIP Service.
- Детерминированные учётные данные. RabbitMQ всегда выполняет аутентификацию. Если
учётные данные не прикреплены, каждый Recipe предоставляет фиксированный встроенный пароль
для разработки, поэтому результат рендеринга побайтово совпадает между запусками. Если учётные данные
прикреплены, внедрённое значение задаёт пароль брокера: в Compose оно становится
переменной окружения сервиса
RABBITMQ_DEFAULT_PASS; в Kubernetes оно материализуется как Secret, на который ссылается envsecretKeyRef, поэтому открытый текст никогда не попадает в отрендеренный манифест.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example rabbitmq-brokerЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd rabbitmq-brokerСборка
В этом рабочем пространстве нет .aggrega-config.yaml, поэтому сущности стандартной библиотеки разрешаются из реестра hub, hub.aggrega.ai, и флаг каталога не нужен; --auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне:
# 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/.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке Workspace ещё нет папки `rabbitmq-broker`, вызовите один раз инструмент `scaffold`, задав для `example` значение `rabbitmq-broker` и не задавая `dir`: он запишет пример в новую папку `rabbitmq-broker`. Затем вызовите инструмент `build` по одному разу для каждой сущности Release в таком порядке — `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: его значение передаётся по
каналу окружения компонента и становится переменной окружения сервиса RABBITMQ_DEFAULT_PASS. В Kubernetes учётные данные ссылочные: они
материализуются как Secret Kubernetes, и StatefulSet ссылается на него через
env secretKeyRef, поэтому пароль в открытом виде никогда не появляется в манифесте
рабочей нагрузки. Значение origin в Aggregates с аутентификацией — заполнитель
для разработки; для любого реального развёртывания передайте настоящее значение через свой источник учётных данных. Встроенный пароль для разработки, используемый, когда учётные данные не прикреплены,
также предназначен только для локального использования.