Import de bibliothèque de Workload — un corps de Workload partagé via `$import`
Un seul service web sans état dont la Recipe synthétise son Workload Kubernetes à partir d’une entrée de bibliothèque partagée au lieu d’un corps inline. C’est le troisième mode de rédaction de spec.workload sur une Recipe :
- Mode 1 (inline) : un Workload en modèle Go écrit directement dans la Recipe.
- Mode 2 (import de fichier) :
$import: ./relative/path.yaml— un fichier local. - Mode 3 (import de bibliothèque) :
$import: <Library>#/workloads/<Entry>— une entrée deWorkloadLibraryréférencée par une identité de nom simple.
La Recipe web-service utilise ici le mode 3 :
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceÉcrivez la référence comme un seul jeton ininterrompu : aucune espace et aucun saut de ligne nulle part, du nom de la bibliothèque jusqu’au fragment. Une référence contenant des espaces est refusée plutôt que nettoyée, et le build s’arrête — voir errors/fatal-halts.md « A reference to a library entry carries whitespace (Une référence à une entrée de bibliothèque contient des espaces blancs) ».
BaseWorkloads est une WorkloadLibrary publiée dans le catalogue du hub (workloadlibrary/base-workloads). Son entrée StatelessService est un modèle Go évalué dans le contexte de rendu de cette Recipe, si bien que .values.image (du Component/Aggregate) et .infra.* (réplicas, port, compute — de la Release) y circulent exactement comme ils le feraient dans un corps inline. Factoriser le Workload dans une bibliothèque ne change rien à ce qui est déployé : la sortie rendue est identique octet par octet au Workload inline équivalent.
La version de la bibliothèque est fournie par le fichier de verrouillage propre à chaque Release — aucun hôte de registre n’apparaît dans la référence. Lors de aggrega pull, BaseWorkloads est épinglée dans la section workload_libraries du fichier de verrouillage ; lors de aggrega build, la bibliothèque épinglée est résolue et son entrée rendue.
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 workload-library-importElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlLe catalogue est résolu à partir du registre du hub nommé dans .aggrega-config.yaml (qui fournit BaseWorkloads et le fournisseur helm) ainsi que du catalog/ local de cet exemple (le Component et la Recipe web-service). Les Manifests arrivent sous dist/app/helm/ — la directory: de la frontière suivie de la capacité du fournisseur.
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 `workload-library-import`, appelez une fois l’outil `scaffold` avec `example` défini sur `workload-library-import` et sans `dir` : il écrit l’exemple dans un nouveau dossier `workload-library-import`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `workload-library-import`, `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 `workload-library-import/dist/`.Vérifier l’affirmation d’identité octet par octet
Remplacez le workload: { $import: … } de la Recipe par un bloc workload: | contenant mot pour mot le corps de StatelessService, relancez le build, puis comparez avec diff les deux arborescences dist/. Elles correspondent exactement : la référence de bibliothèque se résout vers le même texte de modèle, évalué dans le même contexte de rendu, si bien que l’import est une factorisation de la surface de rédaction sans effet sur les octets rendus.