Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Associar uma carga de trabalho ao que um anexo publica

Uma única aplicação sem estado renderizada no Kubernetes pela síntese de Workload do fornecedor helm — sem chart externo. A aplicação é executada sob uma identidade de cloud para a qual o seu Component declara uma ranhura e que a Release preenche: o anexo que preenche a ranhura emite um ServiceAccount do Kubernetes e publica o respetivo nome, e a Recipe da aplicação associa o pod a esse nome publicado.

O ponto didático é a direção do fluxo. O produtor indica o nome uma única vez; o consumidor lê-o. Nada no lado consumidor repete um valor que o produtor já detém, pelo que os dois não podem divergir.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

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

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd workload-identity-binding

Compilação

Terminal window
aggrega build --release release.yaml --auto-pull

O catálogo é resolvido a partir de duas origens indicadas em .aggrega-config.yaml: o ./catalog próprio do exemplo (o Component local/compute/identity-app e a sua Recipe de síntese helm/identity-app) e o registo do hub (a Feature core/gcp-workload-identity e a sua FeatureRecipe). --auto-pull escreve durante a compilação o ficheiro de bloqueio que falta a um clone novo. Três manifestos ficam em dist/helm/helm/.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta da área de trabalho ainda não contiver uma pasta `workload-identity-binding`, chame uma vez a ferramenta `scaffold` com `example` definido como `workload-identity-binding` e sem `dir`: esta escreve o exemplo numa nova pasta `workload-identity-binding`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `workload-identity-binding`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros a compilação escreveu; encontram-se em `workload-identity-binding/dist/`.

O Component declara a necessidade; a Release supre-a

A aplicação precisa de uma identidade sob a qual ser executada, pelo que o seu Component declara uma, como ranhura identity obrigatória:

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

O Aggregate não escreve nada para isso. Sob que identidade a aplicação é executada, e em que cloud, é escolha do operador para cada destino, pelo que a Release preenche a ranhura com a Feature de identidade e com cada campo de que essa Feature precisa:

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

Uma Release que deixa a ranhura por preencher é interrompida, nomeando a ranhura. Uma Release para um cluster EKS preenche, em vez disso, a mesma ranhura com core/aws-irsa e o seu role_arn, e o seu Manifest mapeia essa Feature para a sua FeatureRecipe. O seletor mantém uma credencial fora da ranhura: uma Feature do tipo segredo que a preencha provoca uma interrupção.

O anexo publica

A Feature declara no seu schema.provides que publica um name, e a sua FeatureRecipe publica-o — a partir do mesmo valor local com que o chart emitido nomeia o ServiceAccount, que é o service_account_name definido pelo operador quando a Release escreve um:

# 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 }}"

A Recipe consome

A Recipe consumidora lê o nome publicado em .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 }}

Ambas as leituras resolvem-se no ServiceAccount que o anexo efetivamente emitiu:

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

Porquê lê-lo em vez de repeti-lo

A alternativa é escrever app-workload-identity uma segunda vez no lado consumidor. Isso funciona até alguém alterar o service_account_name do operador e atualizar apenas um dos dois sítios — nessa altura, o pod pede um ServiceAccount que não existe, e nada na compilação o deteta, porque ambas as grafias são strings válidas.

Ler .features.identity.provides.name elimina a segunda grafia. A mesma estrutura aplica-se a cada anexo: uma credencial publica o localizador do seu Secret em .features.<slot>.provides.name, um sidecar publica a sua porta, uma identidade publica o seu nome. A estrutura completa do anexo, campo a campo, encontra-se em templates/template-context-contract.md.

Dimensionamento pelo operador

release.yaml satisfaz o pilar de dimensionamento do operador por ambiente: a tag de imagem do contentor vem de infra.image_tag (myapp:1.2), e a identidade — a sua Feature e os campos dessa Feature — vem do preenchimento da ranhura. O Aggregate do programador não contém nenhum dos dois.