Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

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, на який посилається env secretKeyRef, тож відкритий текст ніколи не потрапляє у відрендерений маніфест.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example rabbitmq-broker

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd rabbitmq-broker

Збирання

Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:

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/.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами 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 з автентифікацією є заповнювачем для розробки; для будь-якого реального розгортання надайте справжнє значення через ваше джерело облікових даних. Вбудований пароль для розробки, що використовується, коли облікові дані не приєднано, так само призначений лише для локального використання.