Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

MariaDB sur Kubernetes — helm synthétisé (StatefulSet), informations d’identification à deux slots

Une base de données MariaDB unique rendue sur Kubernetes par la synthèse de Workload du fournisseur helm — aucun chart externe. Le Component core/datastore/mariadb se lie à la Recipe helm/mariadb, qui déclare un Workload form: stateful ; le fournisseur helm le traduit en un StatefulSet, un Service ClusterIP, un Service headless (l’identité réseau stable du StatefulSet) et un volumeClaimTemplate pour le répertoire de données.

Le but de l’exemple est le modèle d’informations d’identification à deux slots de MariaDB sur la cible helm synthétisée. Les deux slots de mot de passe sont livrés par des mécanismes différents parce que le Component les déclare différemment, et la Recipe câble chacun de la manière que son slot exige.

Générer l’exemple

Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.

Écrivez l’exemple dans un nouveau dossier qui porte son nom :

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

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd mariadb-helm-synth

Build

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

Le catalogue se résout depuis le registre du hub nommé dans .aggrega-config.yaml, si bien qu’aucun flag --catalog n’est nécessaire, et --auto-pull écrit pendant le build le fichier de verrouillage qui manque à un clone récent. Quatre manifestes arrivent sous dist/helm/helm/.

Avec un assistant IA

Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.

Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `mariadb-helm-synth`, appelez une fois l’outil `scaffold` avec `example` défini sur `mariadb-helm-synth` et sans `dir` : il écrit l’exemple dans un nouveau dossier `mariadb-helm-synth`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `mariadb-helm-synth`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `mariadb-helm-synth/dist/`.

root_password — Black-Box, livré sur le canal d’injection

root_password est un slot Black-Box : le featuresSchema du Component déclare inject: [], si bien que la Recipe contrôle la livraison et que le développeur ne peut pas l’imposer. L’Aggregate rattache core/secret-value, que le Manifest associe à env-secret. Cette FeatureRecipe place la valeur sur le canal d’injection du composant sous la clé choisie, et la Recipe la lit comme .context.inject.env.MARIADB_ROOT_PASSWORD, en émettant une simple variable d’environnement de conteneur :

# db-statefulset.yaml (container env)
- name: MARIADB_ROOT_PASSWORD
value: dev-root-pw-change-me

Un slot Black-Box n’est jamais référencé depuis le bloc attachments: d’un conteneur de charge de travail, et aucune ressource Secret Kubernetes n’est générée pour lui — la valeur atteint le conteneur directement par le canal d’injection.

user_password — transparent, livré comme Secret + secretKeyRef

user_password est un slot transparent (inject: [env, file]). L’Aggregate rattache core/referenced-secret, que le Manifest associe à k8s-secret-from-parameter. Cette FeatureRecipe matérialise un Secret Kubernetes et publie l’identité du Secret comme provides {name, key}. La Recipe référence le slot via containers.attachments, que le synthétiseur rend sous forme d’un secretKeyRef d’env. Le Secret généré et la référence du conteneur nomment la même ressource parce que tous deux lisent .features.user_password.provides.name — il n’y a aucune redérivation ni aucune convention sur laquelle les deux côtés devraient s’accorder. Le nom publié normalise les tirets bas du nom du slot en traits d’union, si bien que user_password devient le nom de ressource Kubernetes valide db-user-password. Le nom de fichier qui le porte est une dérivation distincte et se lit différemment : il préfixe le composant et le nom du slot comme coordonnées propres du rattachement, encodées pour un alphabet de noms de fichiers qui n’admet que des lettres minuscules et des chiffres, si bien que le tiret bas y apparaît comme un échappement plutôt que comme un trait d’union.

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

Laisser user_password non rattaché est également valide : la Recipe se rabat sur une valeur par défaut de développement écrite en ligne (MARIADB_PASSWORD: apppass) et aucun Secret n’est généré, si bien qu’un déploiement minimal est quand même rendu et s’exécute.

Dimensionnement par l’opérateur

release.yaml remplit le pilier du dimensionnement par l’opérateur pour chaque environnement : le tag d’image du conteneur provient de infra.engine_version (mariadb:11.4), et la requête et la classe de stockage du volumeClaimTemplate proviennent de infra.storage (5Gi, standard). L’Aggregate du développeur ne porte jamais ces champs.