Перейти до вмісту
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 під час збирання записує lockfile, якого бракує свіжому клону. Три маніфести з’являються в 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 — багатоключові облікові дані, на які можна посилатися, що матеріалізують один Kubernetes Secret із набором ключів даних, наданим викликачем, і публікують лише локатор цього 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 розробника ніколи не містить цього поля.