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

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:

Terminal window
aggrega scaffold --example mariadb-helm-synth

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

Terminal window
cd mariadb-helm-synth

Build

Terminal window
aggrega build --release release.yaml --auto-pull

Il 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-me

Uno 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.

db--user-zupassword--db-secret-db-user-password.yaml
[… 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 key

Anche 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.