Comment utiliser cette référence
La référence du langage spécifie la surface de rédaction d’Aggrega — les schémas YAML, le vocabulaire de mots-clés partagé, le système de templates Go, les contrats des providers, les commandes de la CLI, le catalogue d’erreurs du compilateur et des exemples détaillés de bout en bout. Lisez les chapitres ci-dessous dans l’ordre pour une première prise en main, ou allez directement dans un sous-répertoire lorsque vous cherchez une entité, un mot-clé, un provider, une commande de la CLI ou une erreur précise.
Pour installer d’abord le binaire aggrega, suivez Installer le binaire ; pour qu’un assistant d’IA l’installe et le configure pour vous, collez le prompt de Configurer Aggrega avec votre assistant d’IA. Avant de bâtir des scripts ou un catalogue sur Aggrega, lisez Compatibilité pour savoir ce qu’une mise à niveau peut changer et ce qu’elle ne peut pas changer.
Avant de lire la référence, appropriez-vous le modèle mental qu’établissent les chapitres d’architecture. Le chapitre Les quatre domaines et Team Topologies explique comment Aggrega sépare les préoccupations de Developer Intent, Platform Catalog, Platform Ops et Platform Operator en surfaces de rédaction distinctes ; le chapitre Taxonomie des entités nomme les entités (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) et leurs rôles dans ces domaines. Chaque chapitre de la référence qui suit celui-ci suppose que le lecteur a cette vue d’ensemble.
Utilisez cette référence de deux manières. Pour la prise en main, lisez-la dans l’ordre : commencez par Conventions de nommage pour le modèle des noms d’instance et les règles de casse, puis parcourez les chapitres sur les entités et le vocabulaire pour construire le contrat de rédaction complet. Pour la consultation, allez directement au sous-répertoire qui correspond à la question — entities/ pour la sémantique des champs de chaque entité, vocabulary/ pour les mots-clés communs aux entités, templates/ pour la surface des templates Go à la disposition des auteurs de Recipe, providers/ pour les contrats de dispatch de chaque provider, plugins/ pour les sockets de plugins et la rédaction de plugins, schema/ pour le JSON Schema de chaque type, cli/ pour l’utilisation en ligne de commande, errors/ pour les diagnostics et examples/ pour les modèles détaillés.