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

Redis — один Aggregate, дві цілі, необов’язкова автентифікація

Цей мінімальний приклад компілює єдиний кеш у пам’яті Redis (протокол Redis) з одного Aggregate, написаного розробником, у дві реалізації:

  • Docker Compose для локальної розробки та
  • синтезований helm Recipe, що запускає офіційний upstream-образ redis безпосередньо в Kubernetes (без зовнішнього чарту).

Синтезований helm Recipe — це шлях для Kubernetes: він залежить лише від тегу офіційного образу, а не від стороннього чарту, і набір відрендерених ресурсів точно відповідає тому, що оголошує робоче навантаження.

Той самий aggregate.yaml керує обома. Для кожної реалізації змінюється лише шар Recipe, обраний у Manifest. Другий Aggregate, aggregate-auth.yaml, показує той самий кеш із доданими необов’язковими обліковими даними пароля для шляху Compose; aggregate-helm-synth-auth.yaml додає облікові дані з посиланням для шляху синтезованого helm.

Сутності Recipes для Redis з каталогу, які зіставляє цей приклад, compose/redis і helm/redis, оголошують ліцензію AGPL-3.0. Приклад valkey-cache розгортає Valkey, який використовує той самий протокол; його сутність Recipe helm/valkey оголошує BSD-3-Clause.

Файли

ФайлРоль
aggregate.yamlНамір розробника: один компонент cache типу core/datastore/redis, без облікових даних — кеш працює без автентифікації.
aggregate-auth.yamlТой самий кеш з обліковими даними пароля, доданими до необов’язкового слота password компонента (шлях Compose).
aggregate-helm-synth-auth.yamlТой самий кеш з обліковими даними з можливістю посилання, приєднаними для синтезованого шляху helm, — значення матеріалізується як Kubernetes Secret, на який посилається Deployment.
manifest-compose.yamlЗіставляє тип Redis із Recipe для Compose (compose/redis), а облікові дані — з dotenv-secret.
manifest-helm-synth.yamlЗіставляє тип Redis із синтезованим helm Recipe (helm/redis), а облікові дані — з k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlЗаписи оператора для двох реалізацій, без автентифікації.
release-compose-auth.yaml / release-helm-synth-auth.yamlЗаписи оператора, що вмикають автентифікацію.

Що демонструє приклад

  • Одна поверхня написання, багато цілей. Єдиний Aggregate є джерелом істини щодо того, що являє собою стек. Кожен Manifest визначає, як його реалізувати.
  • Сховище даних у ролі кешу. Тут Redis використовується як кеш у пам’яті й нічого не зберігає довготривало, тому компонент має тип простого server, а не stateful-server. У Kubernetes синтезований Recipe рендерить Deployment, а не StatefulSet, і не запитує постійного тому; у Compose сервіс не оголошує тому даних.
  • Синтез Workload (Kubernetes). Синтезований helm Recipe оголошує Workload — Deployment і ClusterIP Service, що запускають офіційний образ redis, — який провайдер helm перетворює на маніфести Kubernetes без зовнішнього чарту. Набір відрендерених ресурсів точно відповідає тому, що оголошує Workload. Оскільки і Recipe для Compose, і синтезований helm Recipe мають назву redis, Manifests посилаються на них з областю провайдера як compose/redis і helm/redis.
  • Необов’язкова автентифікація через слот облікових даних. Компонент оголошує один необов’язковий слот password у своєму featuresSchema. Коли облікові дані не додано (базовий Aggregate), Recipe рендерить кеш із вимкненою автентифікацією — побайтово ідентично Recipe без слота. Коли облікові дані додано, обидві цілі запускають Redis з --requirepass, тож сервер вимагає пароль: у Compose (aggregate-auth.yaml) значення передається серверу як цей аргумент; на синтезованому шляху Kubernetes (aggregate-helm-synth-auth.yaml) воно матеріалізується як Secret, на який посилається Deployment.

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

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

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

Terminal window
aggrega scaffold --example redis-cache

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

Terminal window
cd redis-cache

Збирання

Цей робочий простір не містить .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 і не створюйте жодної теки самостійно. Якщо тека Workspace ще не містить теки `redis-cache`, викличте один раз інструмент `scaffold`, задавши для `example` значення `redis-cache` і не задаючи `dir`: він запише приклад у нову теку `redis-cache`. Потім викличте інструмент `build` один раз для кожної сутності Release у такому порядку — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` і `release-helm-synth-auth.yaml` — щоразу задаючи для `workspace_root` значення `redis-cache`, для `release` — цей файл, для `auto_pull` — true і для `write` — true. Скажіть мені, які файли записала кожна збірка; вони розташовані в `redis-cache/dist/`.

Примітка щодо доставки облікових даних

На шляху Compose облікові дані — це секрет із вставленням значення (aggregate-auth.yaml): його значення передається каналом середовища компонента у змінній, яку називає його values.key, — REDIS_PASSWORD, і Recipe передає його серверу як --requirepass. Офіційний образ redis не читає жодної змінної з паролем, тому значення передається як аргумент і видно в команді сервісу. Приєднання, значення якого доходить до Recipe не в тій змінній, яку він читає, зупиняє збирання з указанням слота, а не залишає кеш відкритим.

Шлях синтезованого helm використовує облікові дані з посиланням (aggregate-helm-synth-auth.yaml): значення матеріалізується як Secret Kubernetes, Deployment посилається на нього через env secretKeyRef, а Redis запускається з --requirepass, що читає цю змінну середовища. Тому пароль у відкритому вигляді ніколи не з’являється в маніфесті Deployment — лише в Secret. Саме це фактично вмикає автентифікацію в офіційному образі redis, який сам не читає пароль із середовища.

Значення origin в Aggregates з автентифікацією — це заповнювач для розробки; для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.