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

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

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

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

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

Terminal window
aggrega scaffold --example nats-messaging

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

Terminal window
cd nats-messaging

Збирання

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

Terminal window
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega 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 з автентифікацією — це заповнювач для розробки; для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.