Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Прив’язування робочого навантаження до того, що публікує вкладення

Один застосунок без стану, відрендерений у Kubernetes синтезом Workload провайдера helm — без зовнішнього чарта. Застосунок працює під хмарною ідентичністю, для якої його Component оголошує слот, а Release його заповнює: вкладення, що заповнює слот, створює один Kubernetes ServiceAccount і публікує його ім’я, а Recipe застосунку прив’язує под до цього опублікованого імені.

Головне, чого вчить цей приклад, — напрямок потоку. Виробник задає ім’я один раз; споживач його зчитує. Ніщо на боці споживача не повторює значення, яким вже володіє виробник, тож вони не можуть розійтися.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

Terminal window
aggrega scaffold --example workload-identity-binding

Потім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:

Terminal window
cd workload-identity-binding

Збирання

Terminal window
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:

catalog/component/local/compute/identity-app/1.0.0/component.yaml
featuresSchema:
identity:
required: true
selector: "feature.aggrega.ai/kind!=secret"
inject: []

Aggregate нічого для нього не пише. Під якою ідентичністю працює застосунок і в якій хмарі — це вибір оператора для кожної цілі, тож Release заповнює слот сутністю Feature ідентичності та всіма полями, потрібними цій Feature:

release.yaml
features:
identity:
type: core/gcp-workload-identity
infra:
service_account_name: app-workload-identity
gcp_service_account: app-dev@example-project.iam.gserviceaccount.com

Release, що залишає слот незаповненим, зупиняється з помилкою, називаючи слот. 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-identity
locals:
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 workload
serviceAccount: "{{ .features.identity.provides.name }}"
containers:
main:
variables:
IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}

Обидва зчитування розв’язуються в ServiceAccount, який вкладення справді створило:

app--identity--app-serviceaccount-app-workload-identity.yaml
[… omitted: the apiVersion]
kind: ServiceAccount
metadata:
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]
app-deployment.yaml
[… 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 розробника не містить ні того, ні іншого.