Consegna delle credenziali — `secretKeyRef` dall’inizio alla fine
Un unico database PostgreSQL la cui password è fornita dal sottosistema delle credenziali, mostrato per provider. Lo stesso slot password su core/datastore/postgres accetta l’una o l’altra famiglia di credenziali; la famiglia che lo sviluppatore associa decide come viene consegnata la password, e la Recipe del database legge lo slot nel modo supportato dal suo provider.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example credential-secretkeyrefPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd credential-secretkeyrefBuild
Questo esempio ha tre release. Esegui il build di una per esecuzione:
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)Ogni release risolve le proprie entità di catalogo tramite il .aggrega-config.yaml di questo workspace, dal registry dell’hub che vi è nominato come predefinito, quindi non serve alcun flag --catalog, e --auto-pull scrive durante il build il lockfile che manca a un clone appena creato.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `credential-secretkeyref`, chiama una volta lo strumento `scaffold` con `example` impostato a `credential-secretkeyref` e senza `dir`: scrive l’esempio in una nuova cartella `credential-secretkeyref`. Poi chiama lo strumento `build` una volta per ogni Release, in quest’ordine — `release-helm.yaml`, `release-compose.yaml` — ogni volta con `workspace_root` impostato a `credential-secretkeyref`, `release` impostato a quel file, `auto_pull` impostato a true e `write` impostato a true. Poi chiama lo strumento `build` nello stesso modo con `release` impostato a `release-negative.yaml`: è previsto che venga rifiutata, quindi leggimi il rifiuto. Dimmi quali file ha scritto ciascuna build; si trovano in `credential-secretkeyref/dist/`.Helm — un Secret referenziabile + secretKeyRef
aggregate-helm.yaml associa core/referenced-secret allo slot password. Il Manifest lo mappa su k8s-secret-from-parameter, che materializza un Secret Kubernetes e pubblica l’identità del Secret come provides {name, key}. La Recipe helm di postgres fa riferimento allo slot tramite containers.attachments, che il sintetizzatore renderizza come un secretKeyRef di env.
aggrega build --release release-helm.yaml --auto-pullIl Secret generato (dist/helm/helm/db--password--db-secret-db-password.yaml) e il secretKeyRef del database (dist/helm/helm/db-statefulset.yaml) nominano la stessa risorsa, perché entrambi leggono .features.password.provides.name — non c’è alcuna nuova derivazione né alcuna convenzione su cui i due lati debbano accordarsi:
[… 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 credenziale a valore iniettato
aggregate-compose.yaml associa core/secret-value. Compose non ha alcuna primitiva risorsa Secret / secretKeyRef, quindi il Manifest mappa la credenziale su dotenv-secret, che consegna il valore sulla pipe di iniezione sotto la chiave che l’associazione nomina in values.key, qui POSTGRES_PASSWORD, e la Recipe compose di postgres lo legge sotto quella chiave.
aggrega build --release release-compose.yaml --auto-pull# dist/compose/compose/docker-compose.yaml → POSTGRES_PASSWORD: dev-pw-change-meNegativo — un riempimento non referenziabile rifiutato da un riferimento
aggregate-negative.yaml associa la credenziale a valore iniettato core/secret-value allo slot password, poi esegue il build su helm, dove la Recipe di postgres fa riferimento allo slot tramite containers.attachments (un secretKeyRef). Un secretKeyRef ha bisogno di una risorsa Secret a cui puntare, ma una credenziale a valore iniettato non ne pubblica alcuna — quindi il build si arresta in modo esplicito:
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]Questa release è destinata a fallire — l’arresto è la lezione. Il build termina con 1 anziché segnalare un successo, quindi il guardrail è visibile a chi legge e a qualsiasi script che lo esegue.
Ci sono due correzioni. Associa una credenziale referenziabile (core/referenced-secret), come in aggregate-helm.yaml; oppure mantieni l’associazione core/secret-value e mappala nel Manifest su k8s-secret-from-value, la realizzazione Helm di core/secret-value che scrive il valore in un Secret che emette e pubblica il nome e la chiave di quel Secret, così il riferimento ha una risorsa a cui puntare. Legata a env-secret, una credenziale a valore iniettato raggiunge invece il container tramite la pipe di iniezione, mai tramite un riferimento containers.attachments.