NATS — один Aggregate, дві цілі, необов’язкова автентифікація
Цей приклад компілює один сервер обміну повідомленнями NATS (pub-sub, request-reply, черги) з одного Aggregate, написаного розробником, у дві реалізації:
- Docker Compose для локальної розробки та
- синтезований Recipe для helm, що запускає офіційний upstream-образ
natsбезпосередньо в Kubernetes (без зовнішнього чарта).
Синтезований helm Recipe — бажаний шлях для Kubernetes: він залежить лише від тегу офіційного образу, а не від стороннього чарту, і набір відрендерених ресурсів точно відповідає тому, що оголошує робоче навантаження.
Обидві реалізації керуються тим самим aggregate.yaml. Для кожної реалізації змінюється лише шар Recipe, вибраний
у Manifest. Другий Aggregate, aggregate-auth.yaml,
показує той самий сервер із приєднаними обліковими даними-паролем типу inject-value для
шляху Compose; aggregate-helm-synth-auth.yaml приєднує облікові дані, на які можна посилатися,
для синтезованого шляху helm.
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент bus типу core/messaging/nats, без облікових даних — сервер працює без автентифікації. |
aggregate-auth.yaml | Той самий сервер з обліковими даними-паролем типу inject-value, приєднаними до необов’язкового слота password компонента (шлях Compose). |
aggregate-helm-synth-auth.yaml | Той самий сервер з обліковими даними, на які можна посилатися, приєднаними для синтезованого шляху helm — значення матеріалізується як Kubernetes Secret, на який посилається Deployment. |
manifest-compose.yaml | Зіставляє тип NATS із Recipe для Compose (compose/nats), а облікові дані — з dotenv-secret. |
manifest-helm-synth.yaml | Зіставляє тип NATS із синтезованим Recipe для helm (helm/nats), а облікові дані — з k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Записи оператора для двох реалізацій, без автентифікації. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Записи оператора, що вмикають автентифікацію. |
Що демонструє приклад
- Одна поверхня написання, багато цілей. Єдиний Aggregate є джерелом істини щодо того, що являє собою стек. Кожен Manifest визначає, як його реалізувати.
- Сервер обміну повідомленнями без стану. У цій мінімальній формі NATS маршрутизує теми в
пам’яті з вимкненим файловим сховищем JetStream, тому компонент має тип
server. У Kubernetes синтезований Recipe рендерить Deployment з однією реплікою без постійного тому; сервіс Compose надає доступ до сервера для локальної розробки. - Синтез робочого навантаження (Kubernetes). Синтезований Recipe для helm оголошує
Workload — Deployment і ClusterIP Service, що запускають офіційний образ
nats, — який провайдер helm перетворює на маніфести Kubernetes без зовнішнього чарта. Відрендерений набір ресурсів точно відповідає тому, що оголошує Workload. Оскільки і Recipe для Compose, і синтезований Recipe для helm мають назвуnats, Manifests посилаються на них з областю провайдера якcompose/natsіhelm/nats. - Необов’язкова автентифікація, детермінована в обох випадках. Автентифікацію NATS за замовчуванням вимкнено. Коли облікові дані не приєднано, жодна реалізація не вмикає автентифікацію, і результат рендерингу побайтово однаковий між запусками. Коли облікові дані приєднано, впроваджене значення вмикає автентифікацію за ім’ям користувача й паролем в обох реалізаціях.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example nats-messagingПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd nats-messagingЗбирання
Цей робочий простір не містить .aggrega-config.yaml, тож сутності стандартної бібліотеки розв’язуються з реєстру hub, hub.aggrega.ai, і прапорець каталогу не потрібен; --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullВідрендерені артефакти потрапляють у dist/.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека робочого простору ще не містить теки `nats-messaging`, викличте один раз інструмент `scaffold`, задавши для `example` значення `nats-messaging`, без `dir`: він запише приклад у нову теку `nats-messaging`. Потім викличте інструмент `build` один раз для кожного файлу Release у такому порядку — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` і `release-helm-synth-auth.yaml` — щоразу задаючи для `workspace_root` значення `nats-messaging`, для `release` — цей файл, для `auto_pull` — true і для `write` — true. Скажіть, які файли записала кожна збірка; вони розташовані в `nats-messaging/dist/`.Примітка щодо доставки облікових даних
На шляху Compose облікові дані — це секрет типу inject-value
(aggregate-auth.yaml): його значення доставляється через канал середовища компонента,
і сервер запускається з прапорцями автентифікації за ім’ям користувача й паролем.
Синтезований шлях helm використовує облікові дані, на які можна посилатися
(aggregate-helm-synth-auth.yaml): значення матеріалізується як Kubernetes
Secret, Deployment посилається на нього через env secretKeyRef, а
сервер запускається з прапорцями --user/--pass, що читають цю змінну
середовища. Тому пароль у відкритому вигляді ніколи не з’являється в маніфесті
Deployment — лише в Secret.
Значення origin в Aggregates з автентифікацією — це заповнювач для розробки;
для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.