Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Enlazar una carga de trabajo a lo que publica una vinculación

Una única aplicación sin estado renderizada en Kubernetes por la síntesis de Workload del proveedor helm — sin chart externo. La aplicación se ejecuta bajo una identidad en la nube para la que su Component declara una ranura y que la Release rellena: la vinculación que rellena la ranura emite un ServiceAccount de Kubernetes y publica su nombre, y la Recipe de la aplicación enlaza el pod a ese nombre publicado.

La lección es la dirección del flujo. El productor indica el nombre una sola vez; el consumidor lo lee. Nada en el lado consumidor repite un valor que el productor ya posee, así que ambos no pueden desincronizarse.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

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

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd workload-identity-binding

Compilación

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

El catálogo se resuelve a partir de dos fuentes nombradas en .aggrega-config.yaml: el ./catalog propio del ejemplo (el Component local/compute/identity-app y su Recipe de síntesis helm/identity-app) y el registro del hub (la Feature core/gcp-workload-identity y su FeatureRecipe). --auto-pull escribe durante la compilación el archivo de bloqueo que le falta a un clon nuevo. Tres manifiestos quedan en dist/helm/helm/.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `workload-identity-binding`, llama una vez a la herramienta `scaffold` con `example` establecido en `workload-identity-binding` y sin `dir`: escribe el ejemplo en una nueva carpeta `workload-identity-binding`. Luego llama a la herramienta `build` con `workspace_root` establecido en `workload-identity-binding`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `workload-identity-binding/dist/`.

El Component declara la necesidad; la Release la cubre

La aplicación necesita una identidad bajo la que ejecutarse, así que su Component declara una, como ranura identity obligatoria:

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

El Aggregate no escribe nada para ello. Bajo qué identidad se ejecuta la aplicación, y en qué nube, es decisión del operador para cada destino, así que la Release rellena la ranura con la Feature de identidad y cada campo que esa Feature necesita:

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

Una Release que deja la ranura sin rellenar se detiene, nombrando la ranura. Una Release para un clúster EKS rellena en cambio la misma ranura con core/aws-irsa y su role_arn, y su Manifest asigna esa Feature a su FeatureRecipe. El selector mantiene una credencial fuera de la ranura: una Feature de tipo secreto que la rellene provoca una detención.

La vinculación publica

La Feature declara en su schema.provides que publica un name, y su FeatureRecipe lo publica — a partir del mismo valor local con el que el chart emitido nombra el ServiceAccount, que es el service_account_name fijado por el operador cuando la Release escribe uno:

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

La Recipe consume

La Recipe consumidora lee el nombre publicado en .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 lecturas se resuelven en el ServiceAccount que la vinculación emitió realmente:

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

Por qué leerlo en lugar de repetirlo

La alternativa es escribir app-workload-identity una segunda vez en el lado consumidor. Eso funciona hasta que alguien cambia el service_account_name del operador y actualiza solo uno de los dos lugares — momento en el que el pod solicita un ServiceAccount que no existe, y nada en la compilación lo detecta, porque ambas grafías son cadenas válidas.

Leer .features.identity.provides.name elimina la segunda grafía. La misma estructura se aplica a cada vinculación: una credencial publica el localizador de su Secret en .features.<slot>.provides.name, un sidecar publica su puerto, una identidad publica su nombre. La estructura completa de la vinculación, campo por campo, está en templates/template-context-contract.md.

Dimensionamiento por parte del operador

release.yaml satisface el pilar de dimensionamiento del operador por entorno: el tag de imagen del contenedor proviene de infra.image_tag (myapp:1.2), y la identidad — su Feature y los campos de esa Feature — proviene del relleno de la ranura. El Aggregate del desarrollador no contiene ninguno de los dos.