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

Esquema do contexto dos templates de caminho do Aggrega

Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.

ID do esquema: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json

A lista de variáveis permitidas consumida pelos templates Go avaliados em relação a Release.spec.boundaries[].directory e Release.spec.boundaries[].subDirectory (e à substituição de subDirectory por componente) quando o Aggrega faz o build da Release. Os templates de caminho usam missingkey=error (diferente do regime global missingkey=zero dos templates de valor) mais a validação em tempo de análise: toda referência a um campo em um template de caminho deve constar desta lista de variáveis permitidas para o contexto pertinente (directory: versus subDirectory:); campos desconhecidos produzem um erro Loud Guardrail em tempo de análise, nunca em tempo de renderização. A página sobre as variáveis dos templates de caminho da referência da linguagem ensina a diferença em relação aos templates de valor.

Tipo de nível superior: object

Propriedades

PropriedadeTipoObrigatóriaDescrição
capabilitystringnãoDisponível em directory: E subDirectory:. A capacidade de renderização que a Recipe do componente contribuinte declara em spec.capability, sem nenhuma fixação de versão — por exemplo ‘helm’, ‘helm-chart’ ou ‘compose’. subDirectory: tem como padrão {{ .capability }}, que é o que coloca os artefatos de cada capacidade em sua própria subpasta sob o diretório da fronteira. Em um template directory:, o valor é resolvido por componente, de modo que uma fronteira cuja subárvore contribui com mais de uma capacidade é avaliada como um diretório por capacidade; o percurso separado por fronteira que publica .parent_boundary.directory é executado antes que qualquer componente seja vinculado e deixa este valor vazio.
boundary_namestringnãoDisponível em directory: E subDirectory:. A chave do mapa em release.spec.boundaries..
parametersobjectnãoDisponível em directory: E subDirectory:. Mapa tipado de parâmetros vindo da Release. Os templates de caminho recebem acesso a .parameters como uma exceção deliberada ao ciclo de vida de passagem única de parameters — os templates de valor NÃO recebem .parameters; valores dependentes do ambiente chegam aos templates de valor por meio do YAML do Aggregate já interpolado.
component_idstringnãoDisponível APENAS em subDirectory:. A identidade do contribuidor que está sendo posicionado. Para um componente, o seu ID de instância achatado por componente (por exemplo, ‘backend’ ou ‘data-layer.main-db’). Para uma Feature vinculada em uma fronteira cuja FeatureRecipe é executada uma vez para a fronteira (executionScope: boundary), a identidade de componente composta que todo recurso emitido por essa vinculação carrega no seu rótulo aggrega.ai/component-id (por exemplo, ‘bfr—app—shared’ para uma vinculação ‘shared’ na fronteira ‘app’), encurtada onde o plugin de renderização da vinculação limita os nomes, de modo que o diretório que ela nomeia corresponda a esse rótulo. Sem significado no nível de fronteira e rejeitado pela validação em tempo de parsing em templates directory:.
parent_boundaryobjectnãoDisponível em directory: E subDirectory:. Os valores já resolvidos da fronteira-mãe. Preenchido por meio de um percurso em profundidade que avalia os templates de cada fronteira com os valores resolvidos da sua fronteira-mãe; as fronteiras-filhas nunca veem aqui seus próprios valores. Uma fronteira de nível superior não tem fronteira-mãe, então uma chave lida sob parent_boundary nesse caso interrompe o build, nomeando a fronteira, o campo do template e a chave ausente.
manifestobjectnãoDisponível em directory: E subDirectory:. Traz os metadados da Recipe resolvida conforme avaliados por componente.

Não são permitidas propriedades adicionais.

path-template-context.parent_boundary

Disponível em directory: E subDirectory:. Os valores já resolvidos da fronteira-mãe. Preenchido por meio de um percurso em profundidade que avalia os templates de cada fronteira com os valores resolvidos da sua fronteira-mãe; as fronteiras-filhas nunca veem aqui seus próprios valores. Uma fronteira de nível superior não tem fronteira-mãe, então uma chave lida sob parent_boundary nesse caso interrompe o build, nomeando a fronteira, o campo do template e a chave ausente.

PropriedadeTipoObrigatóriaDescrição
directorystringnãoString do diretório avaliado da fronteira-mãe.
boundary_namestringnãoNome da fronteira-mãe (a chave do mapa em release.spec.boundaries).
parametersobjectnãoO mapa de parâmetros da Release — o mesmo mapa que .parameters traz.
annotationsmapa de stringnãoAs anotações da fronteira-mãe depois que a cascata é resolvida.

Não são permitidas propriedades adicionais.

path-template-context.manifest

Disponível em directory: E subDirectory:. Traz os metadados da Recipe resolvida conforme avaliados por componente.

PropriedadeTipoObrigatóriaDescrição
recipe_namestringnãoO nome da Recipe resolvida a partir da busca por componente.

Não são permitidas propriedades adicionais.