Visión general de las plantillas
Los autores de Recipes y FeatureRecipes escriben código Go text/template en puntos de evaluación específicos: las entradas provides, las entradas locals, valuesMapping (en línea o cargado con $import:), el contenido workload: (en línea o cargado con $import:), las entradas artifacts: (en línea o cargadas con $import: por entrada), el injectMapping de las FeatureRecipes, source:, las entradas assertions:, y with: y when: de cada paso pipeline:. Cada punto se ejecuta en una fase definida del pipeline de compilación y recibe una vista definida del contexto de pilares. Este conjunto de capítulos documenta la superficie de las plantillas: dónde se ejecutan las plantillas, qué expone el contexto en cada punto y qué funciones helper están disponibles.
La forma del contexto de las plantillas y el orden de evaluación son contratos estructurales: cambiar cualquiera de los dos rompe todas las plantillas de Recipe existentes. El contexto de las plantillas se define formalmente en un JSON Schema que se distribuye con el compilador; la matriz de evaluación por punto describe qué pilares se pueden leer en qué punto, y el motor de plantillas Go se distribuye con la biblioteca de helpers Sprig más extensiones específicas de Aggrega. Las etapas del pipeline en las que se anclan estos puntos de evaluación se describen a nivel arquitectónico en ../architecture/10-compilation-pipeline.md: el inject mapping para el injectMapping de las FeatureRecipes, el preámbulo de locals y la resolución de la fuente para .locals y .source de las Recipes, el renderizado base para el valuesMapping de la Recipe base y el renderizado de features para la Resource Generation de las FeatureRecipes.
Referencia por tema
- Matriz de expansión de plantillas — la tabla de referencia por punto que cubre cada punto de evaluación de plantillas, qué pilares lee el punto y cómo fluyen las salidas al grafo IR o a los subpasos posteriores.
- Contrato del contexto de plantillas — la forma formal del contexto de plantillas que el compilador entrega a las plantillas, incluido el par de doble estado
.inject/.inject_rawy la proyección JOIN enriquecida.context.uses. - Nombrar un recurso generado — cuál de las dos claves de identidad nombra qué, la diferencia entre un destino
usesy la referencia que publica un productor, qué providers informan de un nombre para los recursos que generan y por qué los demás no informan de ninguno, y la detención que rechaza la clave donde no existe tal nombre. - Funciones y helpers de Sprig — los helpers de Sprig disponibles en las plantillas Go, más las extensiones y los helpers de seguridad específicos de Aggrega, cómo se lee, se imprime y se compara un número escrito por el autor en una plantilla de valor, y qué helpers preguntan si un valor se escribió y cuáles si está vacío.
- Contexto de parámetros en las plantillas — dónde llegan a una plantilla los valores
parameters:que proporciona la Release: interpolados en las plantillas de valor antes de que se ejecuten, y leídos directamente solo por las plantillas de ruta. - El bloque
assertions:— las reglas con nombre entre campos que un Component, una Feature, una Recipe o una FeatureRecipe declara como plantillas, evaluadas antes del renderizado.