Valkey — один Aggregate, дві цілі, необов’язкова автентифікація
Цей мінімальний приклад компілює єдиний кеш у пам’яті Valkey (протокол Redis) з одного написаного розробником Aggregate у дві реалізації:
- Docker Compose для локальної розробки та
- синтезований helm Recipe, що запускає офіційний upstream-образ
valkey/valkeyбезпосередньо в Kubernetes (без зовнішнього чарту).
Синтезований helm Recipe — це шлях для Kubernetes: він залежить лише від тегу офіційного образу, а не від стороннього чарту, і набір ресурсів, який він рендерить, точно відповідає тому, що оголошує робоче навантаження.
Обидві реалізації визначає той самий aggregate.yaml. Для кожної реалізації змінюється лише шар Recipe, який вибирає Manifest. Ще два Aggregates показують той самий кеш з доданими необов’язковими обліковими даними-паролем: aggregate-auth.yaml для шляху Compose (облікові дані inject-value, з якими запускається сервер) і aggregate-helm-synth-auth.yaml для синтезованого шляху helm (облікові дані з можливістю посилання, матеріалізовані як Kubernetes Secret).
Файли
| Файл | Роль |
|---|---|
aggregate.yaml | Намір розробника: один компонент cache типу core/datastore/valkey, без облікових даних — кеш працює без автентифікації. |
aggregate-auth.yaml | Той самий кеш з обліковими даними пароля, доданими до необов’язкового слота password компонента (шлях Compose). |
aggregate-helm-synth-auth.yaml | Той самий кеш з обліковими даними з можливістю посилання, приєднаними для синтезованого шляху helm, — значення матеріалізується як Kubernetes Secret, на який посилається Deployment. |
manifest-compose.yaml | Зіставляє тип Valkey з Compose Recipe (compose/valkey), а облікові дані — з dotenv-secret. |
manifest-helm-synth.yaml | Зіставляє тип Valkey із синтезованим helm Recipe (helm/valkey), а облікові дані — з k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Записи оператора для двох реалізацій, без автентифікації. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Записи оператора, що вмикають автентифікацію. |
Що демонструє приклад
- Одна поверхня написання, багато цілей. Єдиний Aggregate є джерелом істини щодо того, що являє собою стек. Кожен Manifest визначає, як його реалізувати.
- Сховище даних у ролі кешу. Valkey тут використовується як кеш у пам’яті й
нічого не зберігає постійно, тому компонент має тип простого
server, а неstateful-server. У Kubernetes синтезований helm Recipe рендерить Deployment, а не StatefulSet, і не запитує постійного тому; у Compose сервіс не оголошує тому для даних. - Синтез Workload (Kubernetes). Синтезований helm Recipe оголошує
Workload — Deployment і ClusterIP Service, що запускають офіційний образ
valkey/valkey, — який helm-провайдер перетворює на маніфести Kubernetes без зовнішнього чарту. Набір відрендерених ресурсів точно відповідає тому, що оголошує Workload. Оскільки і Compose Recipe, і синтезований helm Recipe мають ім’яvalkey, Manifests посилаються на них з областю провайдера якcompose/valkeyіhelm/valkey. - Необов’язкова автентифікація через слот облікових даних. Компонент оголошує один необов’язковий слот
passwordу своємуfeaturesSchema. Коли облікові дані не додано (базовий Aggregate), Recipe рендерить кеш із вимкненою автентифікацією — побайтово ідентично до Recipe без слота. Коли облікові дані додано, обидві цілі запускають Valkey з--requirepass, тож сервер вимагає пароль: у Compose значення доходить до сервера через змінну образуVALKEY_EXTRA_FLAGS; у Kubernetes синтезований шлях helm матеріалізує його як Secret, на який посилається Deployment.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example valkey-cacheПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd valkey-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 і не створюйте жодної папки самостійно. Якщо папка робочої області ще не містить папки `valkey-cache`, викличте один раз інструмент `scaffold` з параметром `example` зі значенням `valkey-cache` і без `dir`: він запише приклад у нову папку `valkey-cache`. Потім викличте інструмент `build` по одному разу для кожної сутності Release, у такому порядку — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` і `release-helm-synth-auth.yaml`, — щоразу з параметрами `workspace_root` — `valkey-cache`, `release` — цей файл, `auto_pull` — true і `write` — true. Скажіть мені, які файли записала кожна збірка; вони розташовані в `valkey-cache/dist/`.Примітка щодо доставки облікових даних
На шляху Compose облікові дані — це секрет inject-value (aggregate-auth.yaml): його значення передається каналом середовища компонента у змінній, яку називає його values.key, — VALKEY_PASSWORD, і Recipe передає його серверу як --requirepass через змінну образу VALKEY_EXTRA_FLAGS, тож воно видно в середовищі сервісу, але не в його командному рядку. Стартовий скрипт образу розгортає цю змінну без лапок, тому пароль із пробілом зупиняє сервер під час запуску, а пароль із *, ? або [ зіставляється з іменами файлів у каталозі даних сервера, тож пишіть пароль без тих і других. Приєднання пароля, значення якого доходить до Recipe не в тій змінній, яку він читає, зупиняє збирання з указанням слота, а не рендерить незахищений кеш.
Синтезований шлях helm використовує облікові дані з можливістю посилання
(aggregate-helm-synth-auth.yaml): значення матеріалізується як Kubernetes
Secret, Deployment посилається на нього через env secretKeyRef, а Valkey
запускається з --requirepass, читаючи цю змінну середовища. Тому пароль у відкритому вигляді
ніколи не з’являється в маніфесті Deployment — лише в
Secret. Саме це справді вмикає автентифікацію в офіційному образі
valkey/valkey, який сам не читає пароль зі
середовища.
Значення origin в Aggregates з автентифікацією — це заповнювач для розробки;
для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.