Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Привязка рабочей нагрузки к тому, что публикует присоединение

Одно приложение без состояния, отрисованное в Kubernetes синтезом Workload провайдера helm, — без внешнего чарта. Приложение работает под облачной идентичностью, слот для которой объявляет его Component, а заполняет Release: присоединение, заполняющее слот, создаёт один ServiceAccount Kubernetes и публикует его имя, а 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 разработчика не содержит ни того, ни другого.