Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

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, на который ссылается 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 учётные данные ссылочные: они материализуются как Secret Kubernetes, и StatefulSet ссылается на него через env secretKeyRef, поэтому пароль в открытом виде никогда не появляется в манифесте рабочей нагрузки. Значение origin в Aggregates с аутентификацией — заполнитель для разработки; для любого реального развёртывания передайте настоящее значение через свой источник учётных данных. Встроенный пароль для разработки, используемый, когда учётные данные не прикреплены, также предназначен только для локального использования.