Доставлення облікових даних — `secretKeyRef` від початку до кінця
Одна база даних PostgreSQL, пароль якої надає підсистема облікових даних, показана для кожного провайдера. Той самий слот password у
core/datastore/postgres приймає будь-яку з двох родин облікових даних; родина, яку
під’єднує розробник, визначає, як доставляється пароль, а сутність
Recipe бази даних читає слот так, як це підтримує її провайдер.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example credential-secretkeyrefПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd credential-secretkeyrefЗбирання
Цей приклад містить три релізи. За один запуск збирайте один:
aggrega build --release release-helm.yaml --auto-pullaggrega build --release release-compose.yaml --auto-pullaggrega build --release release-negative.yaml --auto-pull # expected to fail (see below)Кожен реліз розв’язує сутності свого каталогу через .aggrega-config.yaml цього робочого простору, з реєстру hub, який той називає реєстром за замовчуванням, тож прапорець --catalog не потрібен, а --auto-pull під час збирання записує lock-файл, якого бракує свіжому клону.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної папки самостійно. Якщо в папці робочої області ще немає папки `credential-secretkeyref`, один раз викличте інструмент `scaffold` зі значенням `example`, встановленим у `credential-secretkeyref`, і без `dir`: він записує приклад у нову папку `credential-secretkeyref`. Потім викличте інструмент `build` один раз для кожної сутності Release у такому порядку — `release-helm.yaml`, `release-compose.yaml` — щоразу з `workspace_root`, встановленим у `credential-secretkeyref`, `release`, встановленим у цей файл, `auto_pull`, встановленим у true, і `write`, встановленим у true. Потім так само викличте інструмент `build` із `release`, встановленим у `release-negative.yaml`: цю збірку має бути відхилено, тож прочитайте мені відмову. Скажіть мені, які файли записала кожна збірка; вони розташовані в `credential-secretkeyref/dist/`.Helm — Secret, на який можна посилатися, + secretKeyRef
aggregate-helm.yaml під’єднує core/referenced-secret до слота password.
Сутність Manifest зіставляє це з k8s-secret-from-parameter, що створює
Kubernetes Secret і публікує ідентичність цього Secret як provides {name, key}.
Сутність Recipe helm для postgres посилається на слот через containers.attachments, який
синтезатор відтворює як env secretKeyRef.
aggrega build --release release-helm.yaml --auto-pullЗгенерований Secret (dist/helm/helm/db--password--db-secret-db-password.yaml) і
secretKeyRef бази даних (dist/helm/helm/db-statefulset.yaml) називають той самий
ресурс, бо обидва читають .features.password.provides.name — немає ні
повторного виведення, ні домовленості, щодо якої мали б погодитися дві сторони:
[… omitted: the apiVersion and the Secret kind]metadata: name: db-password [… omitted: the labels and annotations every rendered document carries]stringData: POSTGRES_PASSWORD: "dev-pw-change-me"
# db-statefulset.yaml (container env)- name: POSTGRES_PASSWORD valueFrom: secretKeyRef: name: db-password # == the Secret's metadata.name key: POSTGRES_PASSWORD # == the Secret's data keyCompose — облікові дані з впровадженням значення
aggregate-compose.yaml під’єднує core/secret-value. Compose не має примітива ресурсу Secret / secretKeyRef, тому сутність Manifest зіставляє облікові дані з dotenv-secret, що доставляє значення через канал впровадження під ключем, який під’єднання називає у values.key, тут POSTGRES_PASSWORD, а сутність Recipe compose для postgres читає його під цим ключем.
aggrega build --release release-compose.yaml --auto-pull# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-meНегативний випадок — заповнення, на яке не можна посилатися, відхилене для посилання
aggregate-negative.yaml під’єднує облікові дані з впровадженням значення core/secret-value до
слота password, а потім збирає на helm, де сутність Recipe для postgres посилається на
слот через containers.attachments (secretKeyRef). secretKeyRef потребує ресурсу Secret,
на який можна вказати, але облікові дані з впровадженням значення його не публікують — тому збирання
гучно зупиняється:
aggrega build --release release-negative.yaml --auto-pull# [… omitted: the pull's lines, which carry the same halt, and two lint notices]# [CATALOG_ERROR E0212] instance db# rendering node "db"# [… omitted: the cause, "workload attachment slot is not referenceable", naming the Recipe and its path in your catalog, then one line each for the "name" and the "key" the slot's provides does not expose]Очікується, що цей реліз завершиться невдачею — зупинка і є уроком. Збірка завершується з кодом 1, а не повідомляє про успіх, тож запобіжник видно і читачеві, і будь-якому скрипту, що її запускає.
Є два способи виправлення. Під’єднайте облікові дані, на які можна посилатися (core/referenced-secret), як у aggregate-helm.yaml; або залиште прикріплення core/secret-value і зіставте його в сутності Manifest з k8s-secret-from-value — реалізацією Helm для core/secret-value, яка записує значення в Secret, що його створює, і публікує ім’я та ключ цього Secret, тож посилання має ресурс, на який воно вказує. Прив’язані до env-secret, облікові дані з впровадженням значення натомість потрапляють до контейнера через канал впровадження, а не через посилання containers.attachments.