Esquema do contexto dos modelos de caminho do Aggrega
Referência gerada. Não editar à mão — gerar 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 modelos Go avaliados face a Release.spec.boundaries[].directory e Release.spec.boundaries[].subDirectory (e à substituição de subDirectory por componente) quando o Aggrega compila a Release. Os modelos de caminho usam missingkey=error (ao contrário do regime global missingkey=zero dos modelos de valor) mais a validação em tempo de análise: cada referência a um campo num modelo de caminho tem de constar desta lista de variáveis permitidas para o contexto pertinente (directory: face a 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 modelos de caminho da referência da linguagem ensina a diferença em relação aos modelos de valor.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
capability | string | não | Disponível em directory: E subDirectory:. A capacidade de renderização que a Recipe do componente contribuinte declara em spec.capability, sem qualquer fixação de versão — por exemplo ‘helm’, ‘helm-chart’ ou ‘compose’. subDirectory: tem como predefinição {{ .capability }}, que é o que coloca os artefactos de cada capacidade na sua própria subpasta sob o diretório da fronteira. Num modelo directory:, o valor é resolvido por componente, pelo 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 de qualquer componente ser vinculado e deixa este valor vazio. |
boundary_name | string | não | Disponível em directory: E subDirectory:. A chave do mapa em release.spec.boundaries. |
parameters | objeto | não | Disponível em directory: E subDirectory:. Mapa tipado de parâmetros proveniente da Release. Os modelos de caminho recebem acesso a .parameters como uma exceção deliberada ao ciclo de vida de passagem única de parameters — os modelos de valor NÃO recebem .parameters; os valores dependentes do ambiente chegam aos modelos de valor através do YAML do Aggregate já interpolado. |
component_id | string | não | Disponível APENAS em subDirectory:. A identidade do contribuidor que está a ser posicionado. Para um componente, o seu ID de instância achatado por componente (por exemplo, ‘backend’ ou ‘data-layer.main-db’). Para uma Feature anexada numa fronteira cuja FeatureRecipe é executada uma vez para a fronteira (executionScope: boundary), a identidade de componente composta que cada recurso emitido por esse anexo contém na sua etiqueta aggrega.ai/component-id (por exemplo, ‘bfr—app—shared’ para um anexo ‘shared’ na fronteira ‘app’), encurtada onde o plugin de renderização do anexo limita os nomes, para que o diretório que indica corresponda a essa etiqueta. Sem significado ao nível da fronteira e rejeitado pela validação no momento da análise em templates directory:. |
parent_boundary | objeto | não | Disponível em directory: E subDirectory:. Os valores já resolvidos da fronteira-mãe. Preenchido através de um percurso em profundidade que avalia os modelos de cada fronteira com os valores resolvidos da sua fronteira-mãe; as fronteiras-filhas nunca veem aqui os seus próprios valores. Uma fronteira de nível superior não tem fronteira-mãe, pelo que uma chave lida sob parent_boundary nesse caso interrompe a compilação, nomeando a fronteira, o campo do modelo e a chave em falta. |
manifest | objeto | não | Disponível em directory: E subDirectory:. Transporta os metadados da Recipe resolvida tal como 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 através de um percurso em profundidade que avalia os modelos de cada fronteira com os valores resolvidos da sua fronteira-mãe; as fronteiras-filhas nunca veem aqui os seus próprios valores. Uma fronteira de nível superior não tem fronteira-mãe, pelo que uma chave lida sob parent_boundary nesse caso interrompe a compilação, nomeando a fronteira, o campo do modelo e a chave em falta.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
directory | string | não | Cadeia do diretório avaliado da fronteira-mãe. |
boundary_name | string | não | Nome da fronteira-mãe (a chave do mapa em release.spec.boundaries). |
parameters | objeto | não | O mapa de parâmetros da Release — o mesmo mapa que .parameters transporta. |
annotations | mapa de string | não | As anotações da fronteira-mãe depois de a cascata ser resolvida. |
Não são permitidas propriedades adicionais.
path-template-context.manifest
Disponível em directory: E subDirectory:. Transporta os metadados da Recipe resolvida tal como avaliados por componente.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
recipe_name | string | não | O nome da Recipe resolvida a partir da pesquisa por componente. |
Não são permitidas propriedades adicionais.