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 и Service типа ClusterIP, запускающие официальный
образ
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 с аутентификацией — заглушка для разработки;
для любого реального развёртывания задайте настоящее значение через свой источник учётных данных.