Catalogue seul — MariaDB + Adminer sans écrire la moindre entité de plateforme
Cet exemple déploie une petite stack réelle — une base de données MariaDB précédée d’une interface web Adminer — en ne référençant que des entités du catalogue de la bibliothèque standard. Aucun Component, aucune Feature ni aucune Recipe n’est écrit ici : trois courts fichiers YAML acheminent tout vers des entités que le catalogue fournit déjà.
C’est la plus petite surface de rédaction qu’offre Aggrega, et le premier contact naturel avec le langage. L’exemple frère du niveau authoring déploie la même stack tout en construisant sa propre couche de catalogue — lisez d’abord cet exemple pour voir ce qu’un catalogue fini vous apporte, puis celui-là pour apprendre comment la couche sous-jacente est faite.
Les trois fichiers
aggregate.yaml— l’intention du développeur : ce qu’est la stack. Deux composants choisis dans le catalogue partype:, une information d’identification requise sous forme de rattachement qui remplit un slot, et une arêteusesqui câble la base de données au socketdatabasesd’Adminer.release.yaml— la concrétisation par environnement de l’opérateur : quelle taille et où. Les blocsinfra:(version du moteur, taille du stockage, port publié) appartiennent à l’opérateur ; l’Aggregate ne les porte jamais.manifest.yaml— le routage de l’opérateur : quelle Recipe réalise chaque type sur cette cible. Voir plus bas pourquoi les références sont qualifiées par fournisseur.
Ce qu’il démontre
- Les Components comme références au catalogue.
type: core/datastore/mariadbettype: core/devtool/adminerconstituent toute la déclaration de calcul. Le développeur n’écrit que les valeurs qu’exposent les schémas des Component — chaque champ omis prend la valeur par défaut de son schéma (comparez les variables d’environnement de charset et de collation de la sortie rendue avec le blocvalues:d’une ligne qui les a produites). - Le String Pipe. Le Component de catalogue d’Adminer déclare un uses-socket
databasesqui accepte tout composant étiquetécomponent.aggrega.ai/type=stateful-server. L’arête de l’Aggregate injecte leprovides.hostde la Recipe de la base de données dansADMINER_DEFAULT_SERVER. Le compilateur achemine la chaîne sans l’interpréter — sur cette cible, c’est un nom de service compose ; la même arête sur une cible Kubernetes porterait un nom DNS de Service. - Le pilier des rattachements. Le
featuresSchemadu Component de la base de données exige un slotroot_password, rempli avec la Featurecore/secret-valuedu catalogue. Le slot est une boîte noire : la FeatureRecipe sélectionnée par le Manifest contrôle la livraison, et le développeur ne peut pas l’imposer. - Routage de Recipe qualifié par Provider. Le Manifest mappe
core/datastore/mariadb:1.0.0verscompose/mariadb:1.0.0— qualifié par fournisseur — parce que la bibliothèque standard fournit une Recipe mariadb sous plus d’un fournisseur (dont compose et helm). C’est le mappage de l’opérateur qui lève l’ambiguïté sur la cible : une référence nue, non qualifiée, qui correspond à la Recipe de plus d’un fournisseur arrête le build de manière explicite plutôt que d’en choisir une en silence. Reciblez la stack en redirigeant ces mappages ; l’Aggregate ne change pas.
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 catalog-onlyElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd catalog-onlyBuild
Depuis ce répertoire, avec les entités du catalogue résolues depuis hub.aggrega.ai, le registre par défaut que nomme .aggrega-config.yaml :
aggrega pull --release release.yamlaggrega build --release release.yamlLa commande pull résout chaque entité référencée et l’épingle dans release.lock (identité + digest du contenu ; exécutez-la de nouveau pour régénérer un lockfile périmé). Avec un checkout du catalogue de la bibliothèque standard (où en obtenir un), nommez son répertoire aggrega-catalog avec --catalog sur les deux commandes pour y lire les entités. Le build lit ce lockfile — sans lui, le build s’arrête et nomme les deux voies possibles, la commande pull ou --auto-pull — et rend dist/compose/docker-compose.yaml. La Release écrit ses composants directement (pas de bloc boundaries:), si bien que le compilateur les replie dans la portée par défaut synthétisée et émet à plat sous dist/ — une seule frontière, aucun segment de nom de frontière dans le chemin.
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 `catalog-only`, appelez une seule fois l’outil `scaffold` avec `example` défini sur `catalog-only` et sans `dir` : il écrit l’exemple dans un nouveau dossier `catalog-only`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `catalog-only`, `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 `catalog-only/dist/`.Lire la sortie
C’est dans le fichier compose rendu que le câblage devient visible :
- le service
webporteADMINER_DEFAULT_SERVER: db— leprovides.hostde la Recipe de la base de données (le nom du service compose) livré par l’arête uses ; - la même arête a produit
depends_on: [db]— de la topologie, pas seulement des chaînes ; MARIADB_CHARACTER_SET_SERVERetMARIADB_COLLATION_SERVERdu servicedbproviennent de valeurs par défaut du schéma que l’Aggregate ne mentionne jamais ;image: mariadb:11.4et la liaison de port8080:8080proviennent des blocsinfra:de la Release — le pilier de l’opérateur, rendu à côté de celui du développeur.
Exécution
cd dist/composedocker compose up -dOuvrez http://localhost:8080 : le champ du serveur est prérempli avec db. Connectez-vous en tant que root avec le mot de passe de développement issu du rattachement de l’Aggregate (dev-root-pw-change-me — un espace réservé à remplacer dans tout ce qui dépasse le développement local), base de données appdb.
Pour aller plus loin
Le niveau authoring vous fait construire vous-même cette même couche de plateforme — les Components, les Recipes et les FeatureRecipes d’informations d’identification que cet exemple a consommés tout prêts — et compile un Aggregate vers quatre cibles.