Vue d’ensemble du vocabulaire
Un petit ensemble de mots-clés revient dans les entités d’Aggrega. Plutôt que de les réexpliquer sur chaque page d’entité, les chapitres du vocabulaire concentrent l’explication en un seul endroit par famille de mots-clés. Chaque entité qui accepte l’un de ces mots-clés le fait avec la sémantique que spécifie cet ensemble de chapitres.
Le vocabulaire se répartit en quatre familles : la triade topologique (provides, inject, uses), qui relie des arêtes topologiques explicites entre les nœuds et porte le contrat d’injection que le compilateur fait transiter ; les piliers de données (values, infra, parameters, locals), qui séparent les quatre préoccupations relatives aux données — intention du développeur, dimensionnement physique, réglages par environnement et état privé de la Recipe ; les mots-clés d’héritage et d’interface (extends, implements), qui composent les entités de catalogue et déclarent quel Component une Recipe implémente ; et le système de modificateurs (appliesTo, appliesToAnyOf), qui détermine à quels nœuds une Feature s’attache via des sélecteurs de labels. Le cadrage conceptuel de la manière dont les piliers séparent les préoccupations se trouve dans ../architecture/06-data-taxonomy-and-composition.md ; la mécanique de résolution de la topologie se trouve dans ../architecture/07-dependency-resolution.md.
Référence par thème
- Triade topologique :
provides,inject,uses— le contrat d’injection et les déclarations explicites d’arêtes topologiques. Couvre la syntaxe inject compacte et la syntaxe détaillée, les formes de pipe.context.inject/.context.usesque lisent les templates, et le contexte à double état qui protège Ops des panics de pointeur nil. - Piliers de données :
values,infra,parameters,locals— les quatre piliers de données et leur propriété.valuesetparametersdétenus par le développeur,infradétenu par Ops,localsprivés à la Recipe, et le modèle de remontée des paramètres pour la variation par environnement. - Héritage et interface :
extends,implements— l’héritage des entités de catalogue viaextends(la fusion profonde de l’enveloppe YAML commune aux Components et aux Features, les piliers de données qu’un Component qui en étend un autre hérite intégralement de sa base, et la composition JSON Schema 2020-12 que subit le schéma d’une Feature) et la déclaration de Recipe à Componentimplements(formes exacte, à plage de versions et non versionnée), par rapport à laquelle le mapping du Manifest est vérifié —implementsne sélectionne jamais une Recipe. - Système de modificateurs :
appliesToet sélecteurs — les sélecteurs d’attachement des Features, le moteur natif Go de correspondance de labels, la grammaire des sélecteurs sous forme de chaîne et la varianteappliesToAnyOfqui compose en OU. - En dehors des quatre familles : la rédaction en forme compacte, les références entre documents, les labels et annotations, la surface de publication, les contrats sociaux, la surface de validation, la composition de la sortie, la grammaire URI et la résolution des versions.