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.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example redis-cacheПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd redis-cacheЗбирання
Цей робочий простір не містить .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 і не створюйте жодної теки самостійно. Якщо тека 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 з автентифікацією — це заповнювач для розробки;
для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.