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

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 par type:, une information d’identification requise sous forme de rattachement qui remplit un slot, et une arête uses qui câble la base de données au socket databases d’Adminer.
  • release.yaml — la concrétisation par environnement de l’opérateur : quelle taille et où. Les blocs infra: (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/mariadb et type: core/devtool/adminer constituent 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 bloc values: d’une ligne qui les a produites).
  • Le String Pipe. Le Component de catalogue d’Adminer déclare un uses-socket databases qui accepte tout composant étiqueté component.aggrega.ai/type=stateful-server. L’arête de l’Aggregate injecte le provides.host de la Recipe de la base de données dans ADMINER_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 featuresSchema du Component de la base de données exige un slot root_password, rempli avec la Feature core/secret-value du 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.0 vers compose/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 :

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

Build

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 :

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

La 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 web porte ADMINER_DEFAULT_SERVER: db — le provides.host de 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_SERVER et MARIADB_COLLATION_SERVER du service db proviennent de valeurs par défaut du schéma que l’Aggregate ne mentionne jamais ;
  • image: mariadb:11.4 et la liaison de port 8080:8080 proviennent des blocs infra: de la Release — le pilier de l’opérateur, rendu à côté de celui du développeur.

Exécution

Terminal window
cd dist/compose
docker compose up -d

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