Многоключевые учётные данные в синтезированном Deployment helm
Одно приложение без состояния, отрисованное в Kubernetes с помощью синтеза Workload провайдера helm, — без внешнего чарта. Приложение читает два ключа данных из одного секрета: имя пользователя и пароль. Оба обеспечиваются одним слотом учётных данных, который заполняется многоключевыми ссылочными учётными данными.
Создание примера
Этот пример можно собрать командами ниже или поручить сборку вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example multikey-secret-synthЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd multikey-secret-synthСборка
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). Здесь вызывающая сторона передаёт два ключа:
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 с обоими ключами:
[… 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 workloadattachments: 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 разработчика никогда не содержит этого поля.