Прив’язування робочого навантаження до того, що публікує вкладення
Один застосунок без стану, відрендерений у Kubernetes синтезом Workload провайдера helm — без зовнішнього чарта. Застосунок працює під хмарною ідентичністю, для якої його Component оголошує слот, а Release його заповнює: вкладення, що заповнює слот, створює один Kubernetes ServiceAccount і публікує його ім’я, а Recipe застосунку прив’язує под до цього опублікованого імені.
Головне, чого вчить цей приклад, — напрямок потоку. Виробник задає ім’я один раз; споживач його зчитує. Ніщо на боці споживача не повторює значення, яким вже володіє виробник, тож вони не можуть розійтися.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example workload-identity-bindingПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd workload-identity-bindingЗбирання
aggrega build --release release.yaml --auto-pullКаталог розв’язується з двох джерел, названих у .aggrega-config.yaml: власного ./catalog прикладу (сутність Component local/compute/identity-app і її синтезувальний Recipe helm/identity-app) та реєстру hub (сутність Feature core/gcp-workload-identity і її FeatureRecipe). --auto-pull під час збирання записує lock-файл, якого бракує у свіжому клоні. Три маніфести з’являються в dist/helm/helm/.
З ШІ-асистентом
ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.
Використовуйте лише інструменти Aggrega і не створюйте жодної папки самостійно. Якщо папка робочої області ще не містить папки `workload-identity-binding`, викличте один раз інструмент `scaffold` з параметром `example` зі значенням `workload-identity-binding` і без `dir`: він запише приклад у нову папку `workload-identity-binding`. Потім викличте інструмент `build` з параметрами `workspace_root` — `workload-identity-binding`, `release` — `release.yaml`, `auto_pull` — true і `write` — true. Скажіть мені, які файли записала збірка; вони розташовані в `workload-identity-binding/dist/`.Component оголошує потребу; Release її заповнює
Застосунку потрібна ідентичність, під якою він працюватиме, тож його Component оголошує її як
обов’язковий слот identity:
featuresSchema: identity: required: true selector: "feature.aggrega.ai/kind!=secret" inject: []Aggregate нічого для нього не пише. Під якою ідентичністю працює застосунок і в якій хмарі — це вибір оператора для кожної цілі, тож Release заповнює слот сутністю Feature ідентичності та всіма полями, потрібними цій Feature:
features: identity: type: core/gcp-workload-identity infra: service_account_name: app-workload-identity gcp_service_account: app-dev@example-project.iam.gserviceaccount.comRelease, що залишає слот незаповненим, зупиняється з помилкою, називаючи слот. Release для
кластера EKS натомість заповнює той самий слот за допомогою core/aws-irsa і його role_arn,
а його Manifest зіставляє цю Feature з її FeatureRecipe. Селектор не допускає
облікові дані в слот: Feature типу secret, що його заповнює, спричиняє зупинку.
Вкладення публікує
Feature оголошує у своєму schema.provides, що публікує name, а її
FeatureRecipe публікує його — з тієї самої локальної змінної, якою створений чарт називає
ServiceAccount, тобто заданого оператором service_account_name, коли
Release його вказує:
# FeatureRecipe gcp-workload-identitylocals: sa_name: '{{ default (printf "%s-%s" .context.rendered_name (.attachment_name | replace "_" "-")) .infra.service_account_name }}'provides: name: "{{ .locals.sa_name }}"Recipe споживає
Recipe-споживач зчитує опубліковане ім’я за шляхом
.features.<instance-name>.provides.<key>:
# helm/identity-app recipe workloadserviceAccount: "{{ .features.identity.provides.name }}"containers: main: variables: IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}Обидва зчитування розв’язуються в ServiceAccount, який вкладення справді створило:
[… omitted: the apiVersion]kind: ServiceAccountmetadata: name: app-workload-identity annotations: iam.gke.io/gcp-service-account: "app-dev@example-project.iam.gserviceaccount.com" [… omitted: the boundary and recipe annotations, and the labels, that every rendered document carries][… omitted: the Deployment's metadata, selector and pod template up to the containers] containers: - name: main [… omitted: the image and the port] env: [… omitted: the GREETING variable] - name: IDENTITY_SERVICE_ACCOUNT value: app-workload-identity serviceAccountName: app-workload-identityЧому зчитувати, а не повторювати
Альтернатива — вдруге написати app-workload-identity на
боці споживача. Це працює, доки хтось не змінить service_account_name
оператора й не оновить лише одне з двох місць — і тоді
под запитує ServiceAccount, якого не існує, а компіляція
цього не помічає, бо обидва написання є допустимими рядками.
Зчитування .features.identity.provides.name усуває друге написання. Та сама
форма застосовується до кожного вкладення: облікові дані публікують локатор свого Secret за шляхом
.features.<slot>.provides.name, sidecar публікує свій порт, ідентичність
публікує своє ім’я. Повний опис форми вкладення поле за полем див. у
templates/template-context-contract.md.
Визначення розмірів оператором
release.yaml реалізує принцип визначення розмірів оператором для кожного середовища: тег образу
контейнера береться з infra.image_tag (myapp:1.2), а ідентичність — її
Feature і поля цієї Feature — із заповнення слота. Aggregate розробника
не містить ні того, ні іншого.