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:
aggrega scaffold --example multikey-secret-synthDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd multikey-secret-synthCompilación
aggrega build --release release.yaml --auto-pullEl 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:
features: app_credentials: type: core/referenced-secret-set values: entries: - key: db_username value: appuser - key: db_password value: dev-pw-change-meEl Manifest asigna core/referenced-secret-set a la FeatureRecipe k8s-secret-set, que renderiza un único Secret que lleva ambas claves:
[… 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 workloadattachments: APP_DB_USER: from: app_credentials as: env key: db_username APP_DB_PASSWORD: from: app_credentials as: env key: db_passwordEl 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.