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

Remplacement de recipe par instance

Cet exemple enseigne une fonctionnalité du Manifest : le niveau de mappage name, qui surcharge la Recipe pour une seule instance de composant tandis que chaque autre instance du même type conserve la Recipe globale du niveau type.

Ce qu’il montre

L’Aggregate déclare deux instances d’un même type de composant (example/compute/greeter) :

components:
greeter-default:
type: example/compute/greeter
greeter-special:
type: example/compute/greeter

Le catalogue fournit deux Recipes qui implémentent toutes deux example/compute/greeter — greeter-blue (le build par défaut) et greeter-green (un build alternatif). Le Manifest mappe le type en bloc et remplace une instance par son nom :

mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance...
name:
greeter-special: compose/greeter-green:1.0.0 # ...except this one

Le nom l’emporte sur le type, si bien que greeter-special est déployé via greeter-green et greeter-default via greeter-blue.

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 per-instance-recipe-override

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

Terminal window
cd per-instance-recipe-override

Build

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Cet exemple utilise la bibliothèque standard pour son fournisseur : le fournisseur compose est livré dans le catalogue standard. Les jouets propres à la leçon sur le remplacement — le composant de démonstration example/compute/greeter et ses deux recipes (greeter-blue / greeter-green), qui n’existent que pour rendre visible le remplacement par instance — se trouvent dans le catalogue partagé sous l’éditeur example/, à côté des entités de la bibliothèque standard. .aggrega-config.yaml déclare hub.aggrega.ai comme registre par défaut, si bien que les entités sont résolues depuis le hub — la commande de build n’a besoin d’aucun flag --catalog.

Le dist/app/compose/docker-compose.yaml rendu montre le remplacement à l’œuvre — greeter-default exécute image: greeter:blue, greeter-special exécute image: greeter:green, et l’étiquette de provenance aggrega.ai/recipe-uri de chaque service nomme la Recipe distincte vers laquelle il a été résolu.

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 Workspace ne contient pas encore de dossier `per-instance-recipe-override`, appelez une fois l’outil `scaffold` avec `example` défini sur `per-instance-recipe-override` et sans `dir` : il écrit l’exemple dans un nouveau dossier `per-instance-recipe-override`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `per-instance-recipe-override`, `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 `per-instance-recipe-override/dist/`.

Pourquoi c’est utile

Deux instances d’un même type de composant ont parfois besoin d’implémentations physiques différentes — par exemple une base de données primaire sur une Recipe cloud managée tandis que ses répliques utilisent la Recipe interne au cluster. Le niveau name exprime cela par instance, dans le Manifest, sans forker le type de composant ni dupliquer l’Aggregate. Un type que plus d’une Recipe implémente doit être désambiguïsé par un mappage ; s’il reste non mappé, le build s’arrête et nomme les candidates au lieu de deviner.