Visão geral dos templates
Os autores de Recipes e FeatureRecipes escrevem código Go text/template em locais de avaliação específicos: entradas de provides, entradas de locals, valuesMapping (inline ou carregado por $import:), conteúdo de workload: (inline ou carregado por $import:), entradas de artifacts: (inline ou carregadas por $import: por entrada), o injectMapping da FeatureRecipe, source:, entradas de assertions:, e with: e when: de cada passo de pipeline:. Cada local corre numa fase definida do pipeline de compilação e recebe uma vista definida do contexto dos pilares. Este conjunto de capítulos documenta a superfície de templates: onde os templates correm, o que o contexto expõe em cada local e que funções auxiliares estão disponíveis.
A forma do contexto de template e a ordem de avaliação são contratos estruturais — alterações a qualquer um deles quebram todos os templates de Recipe existentes. O contexto de template está formalmente definido num JSON Schema distribuído com o compilador; a matriz de avaliação por local descreve que pilares são legíveis em que local, e o motor de templates Go vem com a biblioteca de helpers Sprig mais extensões específicas do Aggrega. As fases do pipeline que ancoram estes locais de avaliação estão descritas a nível arquitetónico em ../architecture/10-compilation-pipeline.md — o mapeamento de inject para o injectMapping da FeatureRecipe, o preâmbulo de locals e a resolução da source para .locals e .source da Recipe, a renderização base para o valuesMapping da Recipe base e a renderização de features para a geração de recursos da FeatureRecipe.
Referência por tema
- Matriz de expansão de templates — a tabela autoritativa por local que abrange todos os pontos de avaliação de templates, que pilares cada local lê e como as saídas fluem para o grafo IR ou para subpassagens a jusante.
- Contrato do contexto de template — a forma formal do contexto de template que o compilador entrega aos templates, incluindo o par de estado duplo
.inject/.inject_rawe a projeção JOIN enriquecida.context.uses. - Nomear um recurso renderizado — qual das duas chaves de identidade nomeia o quê, a diferença entre um alvo de
usese a referência que um produtor publica, que providers reportam um nome para os recursos que renderizam e porque é que os outros não reportam nenhum, e a interrupção que recusa a chave quando esse nome não existe. - Funções e helpers Sprig — os helpers Sprig disponíveis dentro dos templates Go, mais extensões e helpers de segurança específicos do Aggrega, como um número escrito pelo autor é lido, impresso e comparado num template de valor, e que helpers perguntam se um valor foi escrito e quais perguntam se está vazio.
- Contexto de parâmetros nos templates — onde os valores de
parameters:fornecidos pela Release chegam a um template: interpolados nos templates de valor antes de estes correrem, e lidos diretamente apenas pelos templates de caminho. - O bloco
assertions:— as regras nomeadas entre campos que um Component, uma Feature, uma Recipe ou uma FeatureRecipe declara como templates, avaliadas antes da renderização.