Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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:

Terminal window
aggrega scaffold --example mariadb-bitnami-credential-set

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd mariadb-bitnami-credential-set

Build

Terminal window
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:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… 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-password

Poiché 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.