MariaDB su Kubernetes — helm sintetizzato (StatefulSet), credenziali a due slot
Un singolo database MariaDB renderizzato su Kubernetes dalla sintesi del Workload del provider helm — nessun chart esterno. Il Component core/datastore/mariadb si lega alla Recipe helm/mariadb, che dichiara un Workload form: stateful; il provider helm lo traduce in uno StatefulSet, un Service ClusterIP, un Service headless (l’identità di rete stabile dello StatefulSet) e un volumeClaimTemplate per la directory dei dati.
Lo scopo dell’esempio è il modello di credenziali a due slot di MariaDB sul target helm sintetizzato. I due slot delle password sono consegnati da meccanismi diversi perché il Component li dichiara in modo diverso, e la Recipe collega ciascuno nel modo che il suo slot richiede.
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-helm-synthPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd mariadb-helm-synthBuild
aggrega build --release release.yaml --auto-pullIl catalogo si risolve dal registry dell’hub indicato in .aggrega-config.yaml, quindi non serve alcun flag --catalog, e --auto-pull scrive durante il build il lockfile che manca a un clone appena creato. Quattro manifest vengono generati in dist/helm/helm/.
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-helm-synth`, chiama una volta lo strumento `scaffold` con `example` impostato su `mariadb-helm-synth` e senza `dir`: scrive l’esempio in una nuova cartella `mariadb-helm-synth`. Poi chiama lo strumento `build` con `workspace_root` impostato su `mariadb-helm-synth`, `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-helm-synth/dist/`.root_password — Black-Box, consegnata sul canale di iniezione
root_password è uno slot Black-Box: il featuresSchema del Component dichiara inject: [], quindi la consegna la controlla la Recipe e lo sviluppatore non può imporla. L’Aggregate associa core/secret-value, che il Manifest mappa su env-secret. Quella FeatureRecipe mette il valore sul canale di iniezione del componente sotto la chiave scelta, e la Recipe lo legge come .context.inject.env.MARIADB_ROOT_PASSWORD, emettendo una semplice variabile d’ambiente del container:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meUno slot Black-Box non viene mai referenziato dal blocco attachments: di un container del carico di lavoro, e per esso non viene generata alcuna risorsa Secret di Kubernetes — il valore raggiunge il container direttamente attraverso il canale di iniezione.
user_password — trasparente, consegnata come Secret + secretKeyRef
user_password è uno slot trasparente (inject: [env, file]). L’Aggregate associa core/referenced-secret, che il Manifest mappa su k8s-secret-from-parameter. Quella FeatureRecipe materializza un Secret Kubernetes e pubblica l’identità del Secret come provides {name, key}. La Recipe referenzia lo slot tramite containers.attachments, che il sintetizzatore renderizza come un secretKeyRef di env. Il Secret generato e il riferimento del container nominano la stessa risorsa perché entrambi leggono .features.user_password.provides.name — non c’è alcuna ri-derivazione né alcuna convenzione su cui le due parti debbano accordarsi. Il nome pubblicato normalizza i trattini bassi del nome dello slot in trattini, così user_password diventa il nome di risorsa Kubernetes valido db-user-password. Il nome del file che lo contiene è una derivazione separata e si legge diversamente: antepone il componente e il nome dello slot come coordinate proprie dell’associazione, codificate per un alfabeto di nomi di file che ammette solo lettere minuscole e cifre, così lì il trattino basso compare come un escape anziché come un trattino.
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyAnche lasciare user_password non associato è valido: la Recipe ripiega su un valore predefinito di sviluppo inline (MARIADB_PASSWORD: apppass) e non viene generato alcun Secret, così una distribuzione minima viene comunque renderizzata ed eseguita.
Dimensionamento da parte dell’operatore
release.yaml soddisfa il pilastro del dimensionamento da parte dell’operatore per ambiente: il tag dell’immagine del container proviene da infra.engine_version (mariadb:11.4), e la richiesta e la storage class del volumeClaimTemplate provengono da infra.storage (5Gi, standard). L’Aggregate dello sviluppatore non contiene mai questi campi.