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

Credenciales de varias claves en un Deployment helm sintetizado

Una única app sin estado renderizada en Kubernetes por la síntesis de Workload del proveedor helm — sin chart externo. La app lee dos claves de datos de un único secreto: un nombre de usuario y una contraseña. Un único slot de credencial respalda ambas, rellenado por una credencial referenciable de varias claves.

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 multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

Compilación

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

El catálogo se resuelve desde dos fuentes nombradas en .aggrega-config.yaml: el propio ./catalog del ejemplo (el Component local/compute/app y su Recipe synth helm/app) y el registro del hub (la Feature de credencial de varias claves, su FeatureRecipe y el Provider helm). --auto-pull escribe durante la compilación el lockfile que le falta a un clon nuevo. Tres manifiestos quedan bajo 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 tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `multikey-secret-synth`, llama una vez a la herramienta `scaffold` con `example` establecido en `multikey-secret-synth` y sin `dir`: escribe el ejemplo en una nueva carpeta `multikey-secret-synth`. Después llama a la herramienta `build` con `workspace_root` establecido en `multikey-secret-synth`, `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 `multikey-secret-synth/dist/`.

Un slot, dos claves

El Component declara un slot de credencial transparente, app_credentials (inject: [env]). El Aggregate lo rellena con core/referenced-secret-set — una credencial referenciable de varias claves que materializa un único Secret de Kubernetes que lleva un conjunto de claves de datos proporcionado por el llamador y publica solo el localizador del Secret (provides.name). Aquí el llamador proporciona dos claves:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

El Manifest asigna core/referenced-secret-set a la FeatureRecipe k8s-secret-set, que renderiza un único Secret que lleva ambas claves:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

Referenciar un mismo slot por cada clave

La Recipe synth referencia el mismo slot dos veces — una por clave de datos. Cada entrada nombra la clave de datos que lee mediante el campo key; la clave de mapa de la entrada es el nombre de la variable de entorno:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

El sintetizador renderiza un secretKeyRef de env por entrada. Ambos referencian el mismo Secret (provides.name), cada uno con su propia clave de datos:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

El campo key es lo que hace que un secreto de varias claves sea consumible desde un Workload sintetizado. Cuando una entrada omite key, lee en su lugar la única clave de datos publicada del slot — la forma que usa una credencial de una sola clave (core/referenced-secret), que publica tanto un localizador como una clave.

Dimensionamiento por parte del operador

release.yaml cumple el pilar de dimensionamiento del operador por entorno: el tag de la imagen del contenedor procede de infra.image_tag (myapp:1.2). El Aggregate del desarrollador nunca lleva este campo.