Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Visão geral dos templates

Os autores de Recipe e FeatureRecipe escrevem código Go text/template em pontos de avaliação específicos: entradas provides, entradas locals, valuesMapping (inline ou carregado por $import:), conteúdo workload: (inline ou carregado por $import:), entradas artifacts: (inline ou carregadas por $import: por entrada), o injectMapping da FeatureRecipe, source:, entradas assertions:, e with: e when: de cada etapa pipeline:. Cada ponto é executado em uma fase definida do pipeline de compilação e recebe uma visão definida do contexto de pilares. Este conjunto de capítulos documenta a superfície de templates: onde os templates são executados, o que o contexto expõe em cada ponto e quais funções helper estão disponíveis.

A forma do contexto de templates e a ordem de avaliação são contratos estruturais — alterar qualquer um deles quebra todos os templates de Recipe existentes. O contexto de templates é definido formalmente em um JSON Schema distribuído com o compilador; a matriz de avaliação por ponto descreve quais pilares podem ser lidos em qual ponto, e o mecanismo de templates Go é distribuído com a biblioteca de helpers Sprig mais extensões específicas do Aggrega. As etapas do pipeline em que esses pontos de avaliação se ancoram são descritas no nível arquitetural em ../architecture/10-compilation-pipeline.md — o inject mapping para o injectMapping da FeatureRecipe, o preâmbulo de locals e a resolução de fonte para .locals e .source da Recipe, a renderização base para o valuesMapping da Recipe base e a renderização de features para a Resource Generation da FeatureRecipe.

Referência por tópico

  • Matriz de expansão de templates — a tabela de referência por ponto que cobre cada ponto de avaliação de templates, quais pilares o ponto lê e como as saídas fluem para o grafo IR ou para subetapas posteriores.
  • Contrato do contexto de templates — a forma formal do contexto de templates que o compilador entrega aos templates, incluindo o par de duplo estado .inject / .inject_raw e a projeção JOIN enriquecida .context.uses.
  • Nomeando um recurso gerado — qual das duas chaves de identidade nomeia o quê, a diferença entre um destino uses e a referência que um produtor publica, quais providers informam um nome para os recursos que geram e por que os outros não informam nenhum, e a interrupção que recusa a chave onde esse nome não existe.
  • Funções e helpers Sprig — os helpers Sprig disponíveis nos templates Go, mais as extensões e helpers de segurança específicos do Aggrega, como um número escrito pelo autor é lido, impresso e comparado em um template de valor, e quais helpers perguntam se um valor foi escrito e quais se ele está vazio.
  • Contexto de parâmetros nos templates — onde os valores parameters: fornecidos pela Release chegam a um template: interpolados nos templates de valor antes de serem executados, 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.