Esquema da base de infraestrutura do Aggrega (Recipe)
Referência gerada. Não editar à mão — gerar novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/recipe-v1beta1.schema.json
Camada de ponteiros e de mapeamento escrita por Ops que liga a intenção Dev a um fornecedor de infraestrutura específico. Estritamente 1:1 com um fornecedor físico e um componente do catálogo.
Consulte-se a referência de autoria da Recipe para orientações em prosa sobre como escrever entidades Recipe; esta página documenta o esquema estrutural que essa referência descreve.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “Recipe” | sim | Constante: "Recipe" |
metadata | objeto | sim | |
spec | objeto | sim | A associação ao fornecedor, a fonte, o mapeamento de values e o pipeline de uma Recipe. Suporta três tipos de entrada compostos por adição: com fonte (source mais a sobreposição de valuesMapping), sintetizado (workload) e artifacts (ficheiros de saída com nome). Separadamente destes, uma Recipe pode contribuir com ficheiros para a saída partilhada da fronteira em que é renderizada, sob ‘boundary’. |
Não são permitidas propriedades adicionais.
recipe.metadata
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | Pelo menos 1 carácter. |
version | string | sim | Versionamento semântico estrito da receita de implementação (por exemplo, 2.1.0). Padrão: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | não | O que esta entidade é e para que serve, escrito para quem está a decidir se a vai usar. Convém começar por uma frase que nomeie a coisa e acrescentar depois o que um leitor precisa para a escolher e usar corretamente — o que espera da Release que a implementa, e tudo o que seja surpreendente no seu comportamento. Um parágrafo curto é a extensão habitual. |
maintainers | object[] | não | Lista dos responsáveis pela manutenção desta entidade. |
license | string | não | Identificador SPDX da licença do software que esta entidade descreve, como MIT ou AGPL-3.0. Regista os termos desse software, não os termos deste ficheiro. |
repository | string | não | O URL do repositório Git onde se encontram os ficheiros de origem. |
home | string | não | O URL da página inicial, da wiki ou da documentação desta entidade. |
keywords | string[] | não | Uma lista de palavras-chave descritivas para facilitar a descoberta na interface do utilizador. |
Não são permitidas propriedades adicionais.
recipe.metadata.maintainers[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | |
email | string | não | |
url | string | não |
Não são permitidas propriedades adicionais.
recipe.spec
A associação ao fornecedor, a fonte, o mapeamento de values e o pipeline de uma Recipe. Suporta três tipos de entrada compostos por adição: com fonte (source mais a sobreposição de valuesMapping), sintetizado (workload) e artifacts (ficheiros de saída com nome). Separadamente destes, uma Recipe pode contribuir com ficheiros para a saída partilhada da fronteira em que é renderizada, sob ‘boundary’.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
capability | string | sim | A capacidade explícita do fornecedor à qual esta receita se associa (por exemplo, ‘helm’, ‘terraform’, ‘compose’) — o tipo de fornecedor que a renderiza. Aceita uma fixação de versão opcional, nas mesmas três formas que ‘implements’: sem versão (‘helm’), exata (‘helm:1.0.0’) ou intervalo compatível com a versão principal (‘helm:^1.0.0’). O nome simples seleciona o tipo de fornecedor; a fixação, quando presente, seleciona que versão do plugin de renderização do fornecedor que serve essa capacidade renderiza esta receita — a mais alta disponível quando não há fixação, a exata para uma fixação exata, a mais alta dentro do intervalo para um acento circunflexo. Uma fixação que nenhuma versão do plugin que serve a capacidade satisfaça interrompe a compilação de forma explícita. Tudo o que fica a jusante da seleção do fornecedor — agrupamento da saída, segmentos de caminho, compatibilidade do pipeline e escolha do codec — baseia-se na capacidade simples, pelo que duas receitas que fixam versões diferentes do plugin da mesma capacidade coexistem numa mesma compilação. |
implements | string | sim | Declara que tipo de componente do catálogo esta receita é capaz de implementar (versão exata ‘core/api-server:1.0.0’, intervalo compatível com a versão principal ‘core/api-server:^1.0.0’ ou sem versão ‘core/api-server’). O compilador usa-o para verificar os mapeamentos do Manifest e para sugerir candidatos nos diagnósticos e no preenchimento automático do editor; nunca resolve uma compilação. aggrega lint também o lê, para localizar o Component cujo contrato provides declarado é aquele com o qual as chaves publicadas de uma Recipe são comparadas. O mapeamento do Manifest é a escolha explícita de implementação do utilizador, fixada no ficheiro de bloqueio da Release. |
source | string ou object | não | A localização do código de infraestrutura. Aceita uma string URI ou um objeto estruturado aberto cujas chaves definidas pelo fornecedor são expostas aos templates da Recipe como ‘.source.*’. |
locals | mapa de string | não | O estado privado de Ops. Resultados de computação internos disponíveis dentro dos templates desta Recipe como ‘.locals.*’. Cada entrada é ela própria um template Go, avaliado face a um contexto autónomo local ao nó: ‘.context.instance_id’, ‘.values’, ‘.infra’ e as entradas deste mesmo bloco resolvidas até então. As entradas são resolvidas pela ordem em que são escritas, e uma entrada PODE ler uma entrada irmã definida ACIMA dela, recebendo o valor resolvido dessa entrada em vez do texto do seu template. A ordem do autor faz parte do contrato sempre que uma entrada lê outra: mover uma definição para baixo da entrada que a lê quebra a compilação, e o bloco nunca é reordenado para que uma referência seja resolvida. Uma referência ‘.locals. |
provides | mapa de string ou number ou boolean | não | A API pública do Programador. Variáveis de saída contratuais disponíveis para a resolução do inject do Chamador a jusante. O compilador avalia os templates de provides face a um contexto autónomo, por qualquer ordem entre si — nenhuma entrada de provides lê outra. Os locals do nó são resolvidos no preâmbulo dos locals, antes dos seus provides, pelo que um template de provides pode ler ‘.locals’ e recebe valores resolvidos; nomear uma chave que o bloco locals não declara provoca uma interrupção. Os Chamadores resolvem as chaves de inject face a estes valores durante a hidratação do inject. Os valores são escalares — o pipe transporta-os tal como estão e converte-os em string de forma determinística no limite da injeção. |
valuesMapping | string ou object | não | Conteúdo do mapeamento de values com três modos de autoria através de despacho conforme a forma do conteúdo. Modo 1 (inline): um escalar string de template Go (tipicamente YAML de escalar de bloco |) que produz o formato de values esperado pelo fornecedor a partir do contexto do Aggrega (.values, .features, .infra). Modo 2 (importação de ficheiro): um mapa YAML de exatamente uma chave, $import: ./relative/path.tmpl, que aponta para um ficheiro de template Go local. Modo 3 (importação de biblioteca): um mapa YAML de exatamente uma chave, $import: <Library>#/mappings/<entry>, que referencia uma entrada de uma MappingLibrary por identidade de nome simples (a versão é fornecida pelo ficheiro de bloqueio de cada Release; nenhum host de registo aparece na referência). Na forma de objeto, $import não pode corresponder a ^oci://; um valor que corresponda é recusado. |
workload | string ou object | não | Produtor de YAML de Workload com três modos de autoria através de despacho conforme a forma do conteúdo. Modo 1 (inline): um escalar string de template Go cuja saída é analisada como ‘aggrega.ai/v1beta1 Workload’. Modo 2 (importação de ficheiro): um mapa YAML de exatamente uma chave, $import: ./relative/path.yaml, que aponta para um ficheiro de template Go local. Modo 3 (importação de biblioteca): um mapa YAML de exatamente uma chave, $import: <Library>#/workloads/<entry>, que referencia uma entrada de uma WorkloadLibrary por identidade de nome simples (a versão é fornecida pelo ficheiro de bloqueio de cada Release; nenhum host de registo aparece na referência). O Provider de destino tem de suportar a síntese de cargas de trabalho; o catálogo da biblioteca padrão declara workloadSchema nesses fornecedores como o contrato documentado. Uma Recipe com workload: associada a um fornecedor que não consegue sintetizar é interrompida de forma explícita no momento da renderização. Na forma de objeto, $import não pode corresponder a ^oci://; um valor que corresponda é recusado. |
artifacts | mapa de string ou object | não | Mapa do nome da entrada para a autoria do conteúdo do artefacto. O valor de cada entrada contém um de três modos através de despacho conforme a forma do conteúdo. Modo 1 (inline): um escalar string de template Go cuja saída é o corpo do artefacto. Modo 2 (importação de ficheiro): um mapa YAML de exatamente uma chave, $import: ./relative/path.yaml, que aponta para um ficheiro de template Go local. Modo 3 (importação de biblioteca): um mapa YAML de exatamente uma chave, $import: <Library>#/artifacts/<entry>, que referencia um bundle de uma ArtifactLibrary por identidade de nome simples (a versão é fornecida pelo ficheiro de bloqueio de cada Release; nenhum host de registo aparece na referência). Um bundle expande-se numa saída por ficheiro, cada uma aninhada sob a chave da entrada como <key>/<filename>. A chave nomeia a saída da entrada: a chave de uma entrada de modo 1 ou 2 é o nome do seu ficheiro de saída, usado tal como está escrito, e o ficheiro importado de uma entrada de modo 2 fornece o conteúdo sem nomear a saída, pelo que duas entradas que importam ficheiros diferentes que partilham um nome são duas saídas distintas. As colisões entre entradas de artefactos, ficheiros de bundle, saída da fonte e síntese de cargas de trabalho interrompem a compilação quando o nó é renderizado. O bloco artifacts é escrito de forma idêntica numa Recipe e numa FeatureRecipe — os mesmos três modos, a mesma regra de chave para saída e o mesmo comportamento em caso de colisão —, e é por isso que essa parte desta descrição se lê da mesma forma em ambos os tipos; um exemplo escrito para um transfere-se para o outro sem alterações. Na forma de objeto, $import não pode corresponder a ^oci://; um valor que corresponda é recusado. Chaves: a chave nomeia a saída da entrada, pelo que está limitada a um único nome de ficheiro: começa com uma letra ou um algarismo e continua com letras, algarismos, pontos, hífenes ou sublinhados. Os pontos após o primeiro carácter preservam as extensões que as chaves de artefacto têm (main.tf, template.yaml, serviceaccount.yaml). Uma / faria uma chave nomear um caminho em vez de um ficheiro, e um . inicial admitiria .., que nomeia uma localização fora do diretório de saída — a classe do primeiro carácter recusa ambos. Para uma importação de biblioteca, a chave nomeia o diretório sob o qual os ficheiros do bundle são aninhados, pelo que se aplica o mesmo limite. Padrão: ^[A-Za-z0-9][A-Za-z0-9._-]*$. |
omits | object[] | não | O que deixar de fora do que a fonte desta Recipe renderiza — para uma fonte usada tal como está que renderiza algo que a Release não deve entregar: um documento que um chart obtido renderiza, como um Secret que contém uma chave que o chart gera de novo a cada renderização, um serviço, um volume ou uma configuração que um ficheiro compose obtido inclui, ou um recurso que um template do CloudFormation obtido declara. A maioria das Recipes nunca precisa disto. Cada entrada nomeia uma unidade que a fonte renderiza pelo seu tipo, pelo seu nome e, onde a entrada os indica, pelo seu namespace e pelo subchart de onde veio, cada um no vocabulário do fornecedor que renderiza a fonte — para um chart, um documento pelo seu próprio kind e pelo seu metadata.name; para um ficheiro compose, um service, um volume ou um config pela sua chave sob services:, volumes: ou configs:; para um template do CloudFormation, um recurso pelo seu Type e pelo seu ID lógico. Esse fornecedor deixa de fora cada unidade a que uma entrada corresponde, e aquilo a que uma entrada corresponde, e o que o fornecedor recusa por causa de uma entrada, é o contrato documentado do próprio fornecedor. Um fornecedor que não consegue deixar nada de fora recusa uma Recipe que declare esta chave antes de qualquer coisa ser renderizada. Só é filtrado o que source: renderiza — uma entrada de workload: ou de artifacts: nunca o é —, pelo que a chave exige source. Cada valor é um template, avaliado face ao contexto face ao qual valuesMapping é avaliado. O when de uma entrada é avaliado primeiro, e uma entrada cujo when renderiza um valor falsy é descartada. Cada entrada que permanece ativa tem de deixar algo de fora: uma entrada ativa que não corresponde a nada do que a fonte renderizou interrompe a compilação, nomeando a entrada. A fonte continua a ser renderizada por completo — cada template de um chart continua a ser executado, pelo que um template que falha continua a fazer falhar a compilação — e só a sua saída é deixada de fora. Pelo menos 1 entrada. |
boundary | objeto | não | O que esta Recipe contribui para a saída partilhada da fronteira em que é renderizada, em vez de para a saída do seu próprio componente. A maioria das Recipes nunca precisa disto: serve para um ficheiro que o destino lê uma única vez para toda a fronteira — uma configuração de fornecedor do Terraform, por exemplo, que o Terraform só aceita na configuração raiz de uma fronteira e nunca dentro do módulo de um único componente. Um fornecedor só aceita esses ficheiros onde o seu contrato declara boundaryArtifacts, e uma Recipe que declare este bloco para um fornecedor que não o faça é recusada antes de qualquer renderização. Uma FeatureRecipe não contém nenhum bloco deste tipo. |
outputLabels | mapa de string | não | Etiquetas declaradas pelo autor da Recipe, aplicadas a cada objeto que a saída renderizada desta receita produz, traduzidas pelo fornecedor para a superfície de etiquetas de cada fornecedor (metadata.labels do Kubernetes para a síntese do helm, a renderização da fonte e os artefactos; etiquetas de serviço do Compose; tags por recurso nos corpos de artefactos .tf.json do Terraform). Seguem pelo mesmo trilho que as etiquetas de proveniência fixas, mas pertencem ao autor em vez de ao compilador. Os namespaces aggrega.ai/ e app.kubernetes.io/ estão reservados para a proveniência nativa da plataforma e são recusados no carregamento. Uma chave ou um valor que não seja uma etiqueta válida para o fornecedor de destino é da responsabilidade do autor da receita; o núcleo não controla o conjunto de caracteres das etiquetas para além da regra dos namespaces reservados. |
outputComponentLabels | string[] | não | Chaves de etiquetas de identidade do Component que esta receita promove para a sua saída renderizada. Cada entrada nomeia uma chave de etiqueta; o valor é obtido das etiquetas da instância de componente que esta receita renderiza, pelo que a etiqueta aplicada contém o valor declarado desse componente em vez de um repetido aqui. As etiquetas promovidas chegam à mesma superfície de etiquetas que outputLabels, que por sua vez contém pares chave-valor literais escritos no local. Uma chave declarada em ambos os blocos é recusada no carregamento, pelo que cada chave aplicada tem uma única fonte. Os namespaces aggrega.ai/ e app.kubernetes.io/ estão reservados para a proveniência nativa da plataforma e são recusados no carregamento; uma chave com âmbito como component.aggrega.ai/hosting fica fora dessas raízes reservadas e pode ser promovida. |
pipeline | object[] | não | Lista sequencial de passos de pipeline Wasm executados após a renderização sobre o conjunto de documentos renderizados, cada um devolvendo patches RFC 6902 e efeitos secundários. |
assertions | mapa de string | não | Validação entre campos em tempo de compilação. Cada entrada é uma asserção com nome: a chave é um identificador de regra estável que surge nas mensagens de erro; o valor é uma string de template Go com semântica de interrupção {{ fail "message" }}. Várias asserções com nome por entidade são avaliadas por instância pela ordem declarada pelo autor; a primeira asserção que falha interrompe a compilação. As asserções de Recipe são avaliadas após a associação da receita e após a avaliação dos provides, antes da renderização, e exprimem invariantes de implementação do chart ou módulo específico que a Recipe usa como fonte. Contexto do template: .values / .infra / .uses / .features / .metadata mais .provides / .locals / .recipe. O avaliador usa missingkey=error: as referências a chaves não definidas provocam uma interrupção com um diagnóstico no-such-key. Como a referência simples provoca a interrupção antes de qualquer fallback poder ser executado, um default simples não fornece um fallback de campo opcional nesta superfície — convém proteger a referência com hasKey, ou usar o helper optional, que realiza diretamente a verificação de presença. Ler a chave através de index também não fornece um: index provoca uma interrupção perante uma chave de mapa que o mapa não contém, nomeando a chave. |
Não são permitidas propriedades adicionais.
recipe.spec.omits[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
kind | string | sim | O tipo da unidade a deixar de fora, no vocabulário do fornecedor que renderiza a fonte: para um chart, o kind próprio de um documento renderizado, como Secret; para um ficheiro compose, service, volume ou config; para um template do CloudFormation, o Type de um recurso, como AWS::S3::Bucket. Nomeia um tipo que a fonte renderiza e não tem relação com o kind: que um source: estruturado contém. Um template. |
name | string | sim | O nome da unidade a deixar de fora, no vocabulário do fornecedor que renderiza a fonte: para um chart, o metadata.name próprio de um documento renderizado; para um ficheiro compose, a chave da unidade sob services:, volumes: ou configs:; para um template do CloudFormation, o ID lógico do recurso, a sua chave sob Resources. Um template. |
namespace | string | não | O namespace em que se encontra a unidade a deixar de fora, quando a entrada deve corresponder apenas a uma unidade nesse namespace — para um fornecedor cuja saída tem namespaces, como acontece com os documentos renderizados de um chart. Se estiver ausente, ou se for renderizado como a string vazia, a entrada corresponde a uma unidade do seu tipo e nome, seja qual for o seu namespace. Um ficheiro compose e um template do CloudFormation não têm namespaces, e os seus fornecedores recusam uma entrada que nomeie um. Um template. |
subchart | string | não | O subchart de onde provém a unidade a deixar de fora, quando a entrada deve corresponder apenas à cópia que um subchart renderiza — para uma fonte montada a partir de fontes aninhadas, como um chart o é a partir dos seus subcharts. Para um chart, o nome próprio do subchart, ou o alias que a dependência do seu pai lhe atribui, com os nomes de um subchart aninhado unidos por / a partir do mais exterior: operator, ou operator/webhooks. A entrada corresponde então a um documento renderizado a partir dos templates/ ou dos crds/ próprios desse subchart, e nem a um que o próprio chart renderiza nem a um que um subchart aninhado dentro dele renderiza. Se estiver ausente, ou se for renderizado como a string vazia, a entrada corresponde a uma unidade do seu tipo e nome, seja qual for a sua origem. Um chart que não renderiza nenhum subchart com esse nome interrompe a compilação, nomeando a entrada. Um ficheiro compose e um template do CloudFormation não têm subcharts, e os seus fornecedores recusam uma entrada que nomeie um. Um template. |
when | string | não | Template Go inline avaliado antes dos restantes campos da entrada. Quando renderiza um valor falsy, a entrada é descartada: os seus restantes campos não são avaliados, nada é deixado de fora por causa dela e não tem de corresponder a nada. Um when vazio ou ausente mantém a entrada. A veracidade segue a convenção habitual para a saída de template do tipo booleano: as strings true/True/TRUE, qualquer número diferente de zero e qualquer outra string não vazia são verdadeiros, enquanto false/False/FALSE, a string vazia e o zero são falsos. Um when cuja renderização falha interrompe a compilação. |
Não são permitidas propriedades adicionais.
recipe.spec.boundary
O que esta Recipe contribui para a saída partilhada da fronteira em que é renderizada, em vez de para a saída do seu próprio componente. A maioria das Recipes nunca precisa disto: serve para um ficheiro que o destino lê uma única vez para toda a fronteira — uma configuração de fornecedor do Terraform, por exemplo, que o Terraform só aceita na configuração raiz de uma fronteira e nunca dentro do módulo de um único componente. Um fornecedor só aceita esses ficheiros onde o seu contrato declara boundaryArtifacts, e uma Recipe que declare este bloco para um fornecedor que não o faça é recusada antes de qualquer renderização. Uma FeatureRecipe não contém nenhum bloco deste tipo.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
artifacts | mapa de string ou object | sim | Mapa do nome de ficheiro para a autoria do conteúdo do ficheiro, com a mesma forma que os artifacts próprios desta Recipe: os mesmos três modos — uma string de template Go inline, um $import: de um ficheiro de template Go local ou um $import: de um bundle de uma ArtifactLibrary, cujos ficheiros são aninhados sob a chave da entrada como <key>/<filename> —, a mesma regra de chave para nome de ficheiro e o mesmo contexto de template, pelo que uma entrada pode ler .values, .infra, .locals e o resto exatamente como uma entrada de artifacts faz. O que muda é onde cada ficheiro é escrito: uma única vez, no diretório que contém a saída montada da fronteira, ao lado dos ficheiros que a montagem própria do fornecedor aí escreve, em vez de no diretório próprio deste componente. Cada entrada é avaliada para cada componente que esta Recipe renderiza na fronteira, e os ficheiros que essas avaliações produzem são fundidos por nome: um mesmo nome avaliado em bytes idênticos por vários componentes, ou por várias Recipes, é um único ficheiro, enquanto um mesmo nome avaliado em bytes diferentes interrompe a compilação nomeando o ficheiro e cada contribuidor, tal como um nome que a montagem própria do fornecedor já escreve. Nada é aplicado num ficheiro deste tipo para indicar que componente o escreveu, porque ele pertence a cada componente que o declarou. Uma entrada cujo template não renderiza nada não escreve nenhum ficheiro. As entradas não são entregues ao fornecedor, que escreve o resto da saída da fronteira sem as ler. Na forma de objeto, $import não pode corresponder a ^oci://; um valor que corresponda é recusado. Chaves: a chave nomeia o ficheiro, pelo que está limitada a um único nome de ficheiro, segundo a regra que uma chave de artifacts segue: começa com uma letra ou um algarismo e continua com letras, algarismos, pontos, hífenes ou sublinhados. Uma / faria uma chave nomear um caminho em vez de um ficheiro, e um . inicial admitiria .., que nomeia uma localização fora do diretório de saída da fronteira — a classe do primeiro carácter recusa ambos. Para uma importação de biblioteca, a chave nomeia o diretório sob o qual os ficheiros do bundle são aninhados, pelo que se aplica o mesmo limite. Padrão: ^[A-Za-z0-9][A-Za-z0-9._-]*$. Pelo menos 1 entrada. |
Não são permitidas propriedades adicionais.
recipe.spec.pipeline[]
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
id | string | sim | Um identificador programático para este passo, único entre os passos deste pipeline: um documento que declara um mesmo id em dois dos seus passos é recusado quando é lido. Um passo posterior do mesmo pipeline lê as saídas deste passo como .steps.<id>.outputs. Padrão: ^[a-zA-Z0-9_]+$. |
plugin | string | sim | A referência à entidade Plugin que este passo executa, sempre qualificada pelo tipo de socket próprio do plugin: <pluginType>/<name> com uma versão opcional, como em parser/yaml ou parser/yaml:1.0.0. A qualificação é obrigatória, e não uma forma entre várias — um name:version sem qualificação é recusado, porque dois sockets podem conter um plugin com o mesmo nome e é a qualificação que torna a entidade resolúvel. A compilação resolve a entidade para o seu artefacto .wasm endereçado por conteúdo — localizado a partir da identidade do plugin e do registo configurado, com o seu digest fixado no ficheiro de bloqueio — e carrega os bytes. Uma simples referência a um .wasm ou a um artefacto não é aceite aqui. |
function | string | sim | A função Wasm exportada a invocar. |
with | string | não | Template Go inline avaliado como um mapa JSON/YAML que satisfaz estritamente o esquema de entrada explícito deste plugin. |
optional | booleana | não | Quando true, uma falha deste passo (um trap do guest, um patch dirigido a um documento ausente do conjunto, um patch malformado ou um diagnóstico com gravidade de interrupção) é despromovida a um aviso bem visível: o conjunto de documentos anterior ao passo é reposto, a saída deste passo é descartada e o pipeline continua. Quando false ou ausente, qualquer falha de um passo interrompe a compilação depois de repor o conjunto de documentos anterior ao passo. |
when | string | não | Template Go inline avaliado no momento de percorrer o pipeline. Quando renderiza um valor falsy, o passo é ignorado — uma passagem direta: o conjunto de documentos segue inalterado para o passo seguinte, sem contribuir com patches, efeitos secundários ou registo do passo. Um when vazio ou ausente executa sempre o passo. A veracidade segue a convenção habitual para a saída de template do tipo booleano: as strings true/True/TRUE, qualquer número diferente de zero e qualquer outra string não vazia são verdadeiros, enquanto false/False/FALSE, a string vazia e o zero são falsos. when e optional são independentes: um passo pode declarar ambos. |
Não são permitidas propriedades adicionais.