RabbitMQ — один Aggregate, дві цілі, необов'язкова автентифікація
Цей приклад компілює один брокер повідомлень RabbitMQ (AMQP) з одного написаного розробником Aggregate для двох цілей:
- Docker Compose для локальної розробки та
- Kubernetes — через синтезований helm Recipe, який безпосередньо запускає офіційний
upstream-образ
rabbitmq(StatefulSet із постійним томом, без зовнішнього chart).
Той самий 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 | Той самий брокер із приєднаними обліковими даними пароля, на які можна посилатися, матеріалізованими як Kubernetes Secret, на який посилається 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 відкриває брокер для локальної розробки. - Синтез без chart (Kubernetes). Ціль Kubernetes безпосередньо запускає офіційний
образ
rabbitmq. Компілятор синтезує StatefulSet, ClusterIP Service і Headless Service на основі розмірівinfraкомпонента — без зовнішнього chart, який треба отримувати чи відстежувати. Тег образу закріплено через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 на облікові дані можна посилатися: вони
матеріалізуються як Kubernetes Secret, а StatefulSet посилається на нього через
env secretKeyRef, тож пароль у відкритому вигляді ніколи не з’являється в маніфесті
робочого навантаження. Значення origin в Aggregates з автентифікацією є заповнювачем
для розробки; для будь-якого реального розгортання надайте справжнє значення через ваше джерело облікових даних.
Вбудований пароль для розробки, що використовується, коли облікові дані не приєднано,
так само призначений лише для локального використання.