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

Vue d’ensemble des templates

Les auteurs de Recipe et de FeatureRecipe écrivent du code Go text/template à des emplacements d’évaluation précis : les entrées provides, les entrées locals, valuesMapping (en ligne ou chargé par $import:), le contenu workload: (en ligne ou chargé par $import:), les entrées artifacts: (en ligne ou chargées par $import: entrée par entrée), l’injectMapping d’une FeatureRecipe, source:, les entrées assertions:, ainsi que with: et when: de chaque étape pipeline:. Chaque emplacement s’exécute à une phase définie du pipeline de compilation et reçoit une vue définie du contexte des piliers. Cet ensemble de chapitres documente la surface des templates : où s’exécutent les templates, ce que le contexte expose à chaque emplacement et quelles fonctions helper sont disponibles.

La forme du contexte de template et l’ordre d’évaluation sont des contrats porteurs — modifier l’un ou l’autre casse chaque template de Recipe existant. Le contexte de template est formellement défini dans un JSON Schema livré avec le compilateur ; la matrice d’évaluation par emplacement décrit quels piliers sont lisibles à quel emplacement, et le moteur de templates Go est livré avec la bibliothèque de helpers Sprig plus des extensions propres à Aggrega. Les étapes du pipeline auxquelles ces emplacements d’évaluation sont ancrés sont décrites au niveau architectural dans ../architecture/10-compilation-pipeline.md — l’inject mapping pour l’injectMapping des FeatureRecipe, le préambule des locals et la résolution des sources pour .locals et .source des Recipes, le rendu de base pour le valuesMapping des Recipes de base, et le rendu des features pour la Resource Generation des FeatureRecipe.

Référence par thème

  • Matrice d’expansion des templates — la table de référence par emplacement qui couvre chaque point d’évaluation de template, les piliers que lit l’emplacement et la manière dont les sorties alimentent le graphe IR ou les sous-passes en aval.
  • Contrat du contexte de template — la forme formelle du contexte de template que le compilateur transmet aux templates, y compris la paire à double état .inject / .inject_raw et la projection JOIN enrichie .context.uses.
  • Nommer une ressource produite — laquelle des deux clés d’identité nomme quoi, la différence entre une cible uses et la référence qu’un producteur publie, quels providers signalent un nom pour les ressources qu’ils produisent et pourquoi les autres n’en signalent aucun, et l’arrêt qui refuse la clé là où un tel nom n’existe pas.
  • Fonctions et helpers Sprig — les helpers Sprig disponibles dans les templates Go, plus les extensions et les helpers de sécurité propres à Aggrega, la manière dont un nombre écrit par l’auteur est lu, affiché et comparé dans un template de valeur, et quels helpers demandent si une valeur a été écrite et lesquels si elle est vide.
  • Contexte des paramètres dans les templates — où les valeurs parameters: fournies par la Release atteignent un template : interpolées dans les templates de valeur avant leur exécution, et lues directement uniquement par les templates de chemin.
  • Le bloc assertions: — les règles inter-champs nommées qu’un Component, une Feature, une Recipe ou une FeatureRecipe déclare sous forme de templates, évaluées avant le rendu.