MySQL — un Aggregate, deux cibles
Cet exemple minimal compile une seule base de données MySQL à partir d’Aggregate écrits par le développeur vers deux cibles :
- Kubernetes via la synthèse de Workload du fournisseur helm (un StatefulSet rendu directement sur l’image officielle
mysql, aucun chart externe), et - Docker Compose pour le développement local.
La même intention du développeur pilote chaque cible. Seule la couche de Recipe sélectionnée par le Manifest change d’une cible à l’autre.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate-helm-synth.yaml | Intention du développeur pour la variante Kubernetes de base : un composant db de type core/datastore/mysql, ses valeurs, et uniquement l’information d’identification obligatoire root_password. |
aggregate-helm-synth-auth.yaml | Intention du développeur pour la variante Kubernetes complète : les deux slots d’informations d’identification, root_password et user_password. |
manifest-helm-synth.yaml | Associe le type MySQL à la Recipe helm synthétisée (helm/mysql) et chaque information d’identification à sa FeatureRecipe (env-secret, k8s-secret-from-parameter). |
release-helm-synth.yaml | Document de l’opérateur pour la variante Kubernetes de base, avec le dimensionnement opérationnel (engine_version, storage). |
release-helm-synth-auth.yaml | Document de l’opérateur pour la variante Kubernetes complète. |
aggregate.yaml | Intention du développeur pour la cible Compose locale : le même composant db avec les deux slots d’informations d’identification livrés comme informations d’identification inject-value. |
manifest-compose.yaml | Associe le type MySQL à la Recipe Compose (mysql) et l’information d’identification à dotenv-secret. |
release-compose.yaml | Document de l’opérateur pour la cible Compose locale, incluant une entrée infra.overrides propre au fournisseur qui épingle l’image de conteneur exacte. |
Ce qu’il démontre
- Une seule surface de rédaction, plusieurs cibles. Un Aggregate est la source de vérité sur ce qu’est la stack. Chaque Manifest dit comment la réaliser.
- Synthèse de Workload sur Kubernetes (privilégiée). La Recipe
helm/mysqldéclare unWorkloadagnostique vis-à-vis des capacités avecform: stateful; le fournisseur helm synthétise 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. L’environnement du conteneur porteMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORDetMYSQL_PASSWORD. Le jeu de caractères et la collation sont pris en compte comme arguments de ligne de commande du serveurmysqld(--character-set-server,--collation-server), parce que l’image officiellemysqlles accepte comme flags du serveur plutôt que comme variables d’environnement. - Synthèse de Workload sur Compose. La Recipe Compose déclare un
Workloadagnostique vis-à-vis des capacités ; le fournisseur compose synthétise un servicedocker-compose.yamlavec l’image MySQL, son environnement, un volume de données nommé et un contrôle de santé. - Une porte de sortie pour l’opérateur. La release Compose définit
infra.overrides.image, le pilier ouvert pour les faits propres au fournisseur que le schéma propre du Component ne nomme pas, et le service rendu exécute exactement cette référence d’image. Voir Remplacements propres au Provider. - Modèle d’informations d’identification à deux slots. Les mots de passe sont des rattachements sur le pilier
features:du composant, chacun une Feature étiquetéefeature.aggrega.ai/kind: secret, tenus à l’écart desvaluesde l’application. LefeaturesSchemadu Component déclare un slot Black-Boxroot_passwordet un slot transparentuser_password.
Livraison des informations d’identification sur Kubernetes
root_password est un slot Black-Box (inject: []) : la Recipe contrôle la livraison. L’information d’identification inject-value rattachée place la valeur sur le canal d’injection du composant, et la Recipe la lit comme .context.inject.env.MYSQL_ROOT_PASSWORD, en émettant une simple variable d’environnement de conteneur. Aucun Secret Kubernetes n’est généré pour lui.
user_password est un slot transparent (inject: [env, file]). La variante complète rattache une information d’identification référençable, qui matérialise un Secret Kubernetes et publie son identité ; 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. Laisser user_password non rattaché (la variante de base) est également valide : la Recipe se rabat sur une valeur par défaut de développement écrite en ligne (MYSQL_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.
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 :
aggrega scaffold --example mysql-standaloneElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd mysql-standaloneBuild
Ce workspace ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard sont résolues depuis le registre du hub, hub.aggrega.ai, et aucune option de catalogue n’est nécessaire ; --auto-pull écrit pendant le build le lockfile qui manque à un clone récent :
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pullLes artefacts rendus atterrissent sous dist/.
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 `mysql-standalone`, appelez une fois l’outil `scaffold` avec `example` défini sur `mysql-standalone` et sans `dir` : il écrit l’exemple dans un nouveau dossier `mysql-standalone`. Appelez ensuite l’outil `build` une fois pour chaque Release, dans cet ordre — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml` et `release-compose.yaml` —, chaque fois avec `workspace_root` défini sur `mysql-standalone`, `release` défini sur ce fichier, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers chaque build a écrits ; ils se trouvent sous `mysql-standalone/dist/`.Dimensionnement par l’opérateur
Les releases Kubernetes remplissent le pilier du dimensionnement par l’opérateur pour chaque environnement : le tag d’image du conteneur provient de infra.engine_version (mysql:8.4), et la requête et la classe de stockage du volumeClaimTemplate proviennent de infra.storage. L’Aggregate du développeur ne porte jamais ces champs.
Remplacements propres au Provider
Les piliers de dimensionnement sont des champs nommés : le Component déclare engine_version et storage, si bien qu’un opérateur qui définit l’un ou l’autre remplit un champ que le Component a anticipé. infra.overrides est le pilier pour ce qu’un Component ne peut pas anticiper — il est déclaré comme un objet acceptant n’importe quelle structure imbriquée, et chaque Recipe documente les clés qu’elle lit.
release-compose.yaml l’utilise. La Recipe Compose lit une clé, image, et lorsqu’elle est définie, le conteneur exécute exactement cette référence au lieu de celle que la Recipe compose à partir de engine_version :
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"Le service rendu porte le remplacement tel quel :
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]C’est le chemin vers un build de la même version du serveur mis en miroir dans un registre ou épinglé par digest — un fait de déploiement qui appartient à l’environnement cible, et non au contrat du Component. Comme l’ensemble de clés est propre à chaque Recipe plutôt qu’à chaque Component, c’est la Recipe qu’il faut consulter pour savoir quelles clés s’appliquent : la Recipe Compose lit ici image, et une Recipe qui n’en lit aucune le dit.