Entrega de credenciales — `secretKeyRef` de extremo a extremo
Una única base de datos PostgreSQL cuya contraseña la proporciona el subsistema de credenciales, mostrado por proveedor. El mismo slot password en core/datastore/postgres acepta cualquiera de las dos familias de credenciales; la familia que vincula el desarrollador decide cómo se entrega la contraseña, y la Recipe de la base de datos lee el slot de la forma que admite su proveedor.
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 credential-secretkeyrefDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd credential-secretkeyrefCompilación
Este ejemplo tiene tres releases. Compila una por ejecución:
aggrega build --release release-helm.yaml --auto-pullaggrega build --release release-compose.yaml --auto-pullaggrega build --release release-negative.yaml --auto-pull # expected to fail (see below)Cada release resuelve sus entidades de catálogo a través del .aggrega-config.yaml de este espacio de trabajo, desde el registro del hub que nombra como predeterminado, así que no hace falta ningún flag --catalog, y --auto-pull escribe durante la compilación el lockfile que le falta a un clon nuevo.
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 `credential-secretkeyref`, llama una vez a la herramienta `scaffold` con `example` establecido en `credential-secretkeyref` y sin `dir`: escribe el ejemplo en una nueva carpeta `credential-secretkeyref`. Después llama a la herramienta `build` una vez por cada Release, en este orden — `release-helm.yaml`, `release-compose.yaml` — cada vez con `workspace_root` establecido en `credential-secretkeyref`, `release` establecido en ese archivo, `auto_pull` establecido en true y `write` establecido en true. Después llama a la herramienta `build` de la misma manera con `release` establecido en `release-negative.yaml`: está pensada para ser rechazada, así que léeme el rechazo. Dime qué archivos escribió cada compilación; están en `credential-secretkeyref/dist/`.Helm — un Secret referenciable + secretKeyRef
aggregate-helm.yaml vincula core/referenced-secret al slot password. El Manifest lo asigna a k8s-secret-from-parameter, que materializa un Secret de Kubernetes y publica la identidad del Secret como provides {name, key}. La Recipe de helm de postgres referencia el slot mediante containers.attachments, que el sintetizador renderiza como un secretKeyRef de env.
aggrega build --release release-helm.yaml --auto-pullEl Secret generado (dist/helm/helm/db--password--db-secret-db-password.yaml) y el secretKeyRef de la base de datos (dist/helm/helm/db-statefulset.yaml) nombran el mismo recurso, porque ambos leen .features.password.provides.name — no hay ninguna nueva derivación ni ninguna convención en la que los dos lados tengan que coincidir:
[… omitted: the apiVersion and the Secret kind]metadata: name: db-password [… omitted: the labels and annotations every rendered document carries]stringData: POSTGRES_PASSWORD: "dev-pw-change-me"
# db-statefulset.yaml (container env)- name: POSTGRES_PASSWORD valueFrom: secretKeyRef: name: db-password # == the Secret's metadata.name key: POSTGRES_PASSWORD # == the Secret's data keyCompose — una credencial de valor inyectado
aggregate-compose.yaml vincula core/secret-value. Compose no tiene ninguna primitiva de recurso Secret / secretKeyRef, así que el Manifest asigna la credencial a dotenv-secret, que entrega el valor por el pipe de inyección bajo la clave que la vinculación nombra en values.key, aquí POSTGRES_PASSWORD, y la Recipe de compose de postgres lo lee bajo esa clave.
aggrega build --release release-compose.yaml --auto-pull# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-meNegativo — un relleno no referenciable rechazado desde una referencia
aggregate-negative.yaml vincula la credencial de valor inyectado core/secret-value al slot password y luego compila en helm, donde la Recipe de postgres referencia el slot mediante containers.attachments (un secretKeyRef). Un secretKeyRef necesita un recurso Secret al que apuntar, pero una credencial de valor inyectado no publica ninguno — así que la compilación se detiene de forma explícita:
aggrega build --release release-negative.yaml --auto-pull# [… omitted: the pull's lines, which carry the same halt, and two lint notices]# [CATALOG_ERROR E0212] instance db# rendering node "db"# [… omitted: the cause, "workload attachment slot is not referenceable", naming the Recipe and its path in your catalog, then one line each for the "name" and the "key" the slot's provides does not expose]Se espera que esta release falle — la detención es la lección. La compilación termina con 1 en lugar de informar de éxito, así que la salvaguarda es visible para quien lee y para cualquier script que la ejecute.
Hay dos soluciones. Vincula una credencial referenciable (core/referenced-secret), como en aggregate-helm.yaml; o conserva la vinculación core/secret-value y mapéala en el Manifest a k8s-secret-from-value, la realización de Helm de core/secret-value que escribe el valor en un Secret que emite y publica el nombre y la clave de ese Secret, de modo que la referencia tenga un recurso al que apuntar. Ligada a env-secret, una credencial de valor inyectado llega en cambio al contenedor a través del pipe de inyección, nunca mediante una referencia containers.attachments.