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

Многоключевые учётные данные в синтезированном Deployment helm

Одно приложение без состояния, отрисованное в Kubernetes с помощью синтеза Workload провайдера helm, — без внешнего чарта. Приложение читает два ключа данных из одного секрета: имя пользователя и пароль. Оба обеспечиваются одним слотом учётных данных, который заполняется многоключевыми ссылочными учётными данными.

Создание примера

Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example multikey-secret-synth

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd multikey-secret-synth

Сборка

Terminal window
aggrega build --release release.yaml --auto-pull

Каталог разрешается из двух источников, указанных в .aggrega-config.yaml: собственного ./catalog примера (сущность Component local/compute/app и её синтезирующая сущность Recipe helm/app) и реестра hub (сущность Feature многоключевых учётных данных, её FeatureRecipe и сущность Provider helm). --auto-pull во время сборки записывает lock-файл, которого нет в свежем клоне. Три манифеста попадают в dist/helm/helm/.

С ИИ-ассистентом

ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.

Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочего пространства ещё нет папки `multikey-secret-synth`, вызовите инструмент `scaffold` один раз, задав для `example` значение `multikey-secret-synth`, без `dir`: он запишет пример в новую папку `multikey-secret-synth`. Затем вызовите инструмент `build`, задав для `workspace_root` значение `multikey-secret-synth`, для `release` — `release.yaml`, для `auto_pull` — true и для `write` — true. Сообщите, какие файлы записала сборка; они находятся в `multikey-secret-synth/dist/`.

Один слот, два ключа

Сущность Component объявляет один прозрачный слот учётных данных, app_credentials (inject: [env]). Сущность Aggregate заполняет его с помощью core/referenced-secret-set — многоключевых ссылочных учётных данных, которые материализуют один Secret Kubernetes с набором ключей данных, переданным вызывающей стороной, и публикуют только локатор этого Secret (provides.name). Здесь вызывающая сторона передаёт два ключа:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Сущность Manifest сопоставляет core/referenced-secret-set с FeatureRecipe k8s-secret-set, которая отрисовывает один Secret с обоими ключами:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

Ссылка на один слот по каждому ключу

Синтезирующая сущность Recipe ссылается на один и тот же слот дважды — по разу на каждый ключ данных. Каждая запись указывает читаемый ею ключ данных в поле key; ключ записи в словаре — имя переменной окружения:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

Синтезатор отрисовывает по одному env secretKeyRef на каждую запись. Оба ссылаются на один и тот же Secret (provides.name), каждый со своим ключом данных:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

Именно поле key позволяет использовать многоключевой секрет из синтезированной сущности Workload. Если в записи key опущено, она читает единственный опубликованный ключ данных слота — так устроены одноключевые учётные данные (core/referenced-secret), которые публикуют и локатор, и ключ.

Размеры, задаваемые оператором

release.yaml реализует опору операторского выбора размеров для каждого окружения: тег образа контейнера берётся из infra.image_tag (myapp:1.2). Сущность Aggregate разработчика никогда не содержит этого поля.