MariaDB (chart Bitnami) — un unico Secret di credenziali a più chiavi
Un singolo database MariaDB realizzato dal chart Helm di Bitnami, le cui password sono fornite da un unico secret referenziabile a più chiavi (core/referenced-secret-set).
Il chart Bitnami si autentica da un unico Secret Kubernetes indicato da auth.existingSecret, e si aspetta che quel Secret contenga chiavi di dati fisse — mariadb-root-password e, quando è impostato un utente personalizzato, mariadb-password (una distribuzione con replica aggiunge mariadb-replication-password). Non esiste alcuna impostazione per rinominare quelle chiavi; sono fissate dal chart.
Anziché lasciare che la Recipe del database indovini il nome del Secret, lo sviluppatore associa una credenziale a più chiavi che contiene esattamente quelle chiavi fisse, e la Recipe legge il nome del Secret prodotto da .features.root_password.provides.name. Il nome del riferimento e il metadata.name del Secret generato sono un unico valore — non c’è alcuna ri-derivazione né alcuna convenzione su cui le due parti debbano accordarsi.
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 mariadb-bitnami-credential-setPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd mariadb-bitnami-credential-setBuild
aggrega build --release release.yaml --auto-pull--auto-pull scrive durante il build il lockfile che manca a un clone appena creato.
La Recipe mariadb-bitnami si risolve dalla copia locale di catalog/ di questo esempio — una Recipe locale con sorgente, scritta dall’azienda — mentre il Component core/datastore/mariadb e le funzionalità di credenziale si risolvono da hub.aggrega.ai, il registry predefinito indicato da .aggrega-config.yaml; il catalog/ locale è elencato lì sotto catalog_dirs. Il chart Bitnami viene scaricato dalla sua sorgente OCI.
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 del workspace non contiene ancora una cartella `mariadb-bitnami-credential-set`, chiama una volta lo strumento `scaffold` con `example` impostato su `mariadb-bitnami-credential-set` e senza `dir`: scrive l’esempio in una nuova cartella `mariadb-bitnami-credential-set`. Poi chiama lo strumento `build` con `workspace_root` impostato su `mariadb-bitnami-credential-set`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `mariadb-bitnami-credential-set/dist/`.Cosa produce la credenziale
Il componente db associa core/referenced-secret-set al suo slot obbligatorio root_password, fornendo come dati i nomi di chiave fissi del chart. Il Manifest mappa quella credenziale su k8s-secret-set, che materializza un unico Secret Kubernetes e ne pubblica il nome come provides.name:
[… omitted: the apiVersion and the Secret kind]metadata: name: db-root-password [… omitted: the labels and annotations every rendered document carries]stringData: mariadb-root-password: "dev-root-pw-change-me" mariadb-password: "dev-user-pw-change-me"Cosa referenzia il chart
La Recipe mariadb-bitnami collega auth.existingSecret al nome pubblicato dello slot, così lo StatefulSet renderizzato monta lo stesso Secret che la credenziale ha prodotto — entrambe le parti leggono .features.root_password.provides.name:
# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)- name: mariadb-credentials secret: secretName: db-root-password # == the produced Secret's metadata.name items: - key: mariadb-root-password # a fixed key the chart reads path: mariadb-root-password - key: mariadb-password path: mariadb-passwordPoiché auth.existingSecret è impostato, il chart non genera un Secret proprio — l’unico Secret nel build è quello prodotto dalla credenziale.
La variante a chiave singola
core/referenced-secret (vedi l’esempio credential-secretkeyref) è il membro a chiave singola della stessa famiglia: incapsula una chiave di dati nominata dal chiamante e pubblica sia il nome della risorsa sia quella chiave, per un consumatore che referenzia una chiave tramite secretKeyRef. Usa invece core/referenced-secret-set quando il target che consuma legge un insieme fisso di chiavi da un unico Secret che nomina nel suo complesso, come fa il chart Bitnami.