Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Valkey — один Aggregate, две целевые платформы, необязательная аутентификация

Этот компактный пример компилирует один кэш в памяти Valkey (сетевой протокол Redis) из одного Aggregate, написанного разработчиком, в две реализации:

  • Docker Compose для локальной разработки и
  • синтезированный helm Recipe, запускающий официальный образ 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 сервис не объявляет том данных.
  • Синтез рабочей нагрузки (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 с аутентификацией — заглушка для разработки; для любого реального развёртывания задайте настоящее значение через свой источник учётных данных.