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

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.

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

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

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

Terminal window
aggrega scaffold --example valkey-cache

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

Terminal window
cd valkey-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 і не створюйте жодної папки самостійно. Якщо папка робочої області ще не містить папки `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 з автентифікацією — це заповнювач для розробки; для будь-якого реального розгортання задайте справжнє значення через ваше джерело облікових даних.