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