Panoramica dei template
Gli autori di Recipe e FeatureRecipe scrivono codice Go text/template in specifici punti di valutazione: le voci provides, le voci locals, valuesMapping (inline o caricato con $import:), il contenuto workload: (inline o caricato con $import:), le voci artifacts: (inline o caricate con $import: per singola voce), l’injectMapping delle FeatureRecipe, source:, le voci assertions:, e with: e when: di ciascuno step pipeline:. Ogni punto viene eseguito in una fase definita della pipeline di compilazione e riceve una vista definita del contesto dei pilastri. Questo insieme di capitoli documenta la superficie dei template: dove vengono eseguiti i template, che cosa espone il contesto in ogni punto e quali funzioni helper sono disponibili.
La forma del contesto dei template e l’ordine di valutazione sono contratti portanti: modificare l’uno o l’altro rompe ogni template di Recipe esistente. Il contesto dei template è definito formalmente in uno JSON Schema fornito con il compilatore; la matrice di valutazione per punto descrive quali pilastri sono leggibili in quale punto, e il motore di template Go viene fornito con la libreria di helper Sprig più estensioni specifiche di Aggrega. Le fasi della pipeline a cui sono ancorati questi punti di valutazione sono descritte a livello architetturale in ../architecture/10-compilation-pipeline.md: l’inject mapping per l’injectMapping delle FeatureRecipe, il preambolo dei locals e la risoluzione della sorgente per .locals e .source delle Recipe, il rendering di base per il valuesMapping delle Recipe di base, e il rendering delle feature per la Resource Generation delle FeatureRecipe.
Riferimento per argomento
- Matrice di espansione dei template — la tabella autorevole per punto che copre ogni punto di valutazione dei template, quali pilastri legge ciascun punto e come gli output confluiscono nel grafo IR o nei sotto-passaggi a valle.
- Contratto del contesto dei template — la forma formale del contesto dei template che il compilatore consegna ai template, inclusa la coppia a doppio stato
.inject/.inject_rawe la proiezione JOIN arricchita.context.uses. - Dare un nome a una risorsa prodotta — quale delle due chiavi di identità nomina che cosa, la differenza tra un target
usese il riferimento che un producer pubblica, quali provider riportano un nome per le risorse che producono e perché gli altri non ne riportano nessuno, e l’arresto che rifiuta la chiave dove tale nome non esiste. - Funzioni e helper Sprig — gli helper Sprig disponibili nei template Go più le estensioni e gli helper di sicurezza specifici di Aggrega, come un numero scritto dall’autore viene letto, stampato e confrontato in un template di valore, e quali helper chiedono se un valore è stato scritto e quali se è vuoto.
- Contesto dei parametri nei template — dove i valori
parameters:forniti dalla Release raggiungono un template: interpolati nei template di valore prima che vengano eseguiti, e letti direttamente solo dai template di percorso. - Il blocco
assertions:— le regole tra campi, con un nome, che un Component, una Feature, una Recipe o una FeatureRecipe dichiara come template, valutate prima del rendering.