Esquema da base de infraestrutura do Aggrega (Recipe)
Referência gerada. Não edite à mão — gere 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 conecta a intenção Dev a um provedor de infraestrutura específico. Estritamente 1:1 com um provedor físico e um componente do catálogo.
Consulte 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 | object | sim | |
spec | object | sim | A associação ao provedor, 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 (arquivos de saída nomeados). Separadamente desses, uma Recipe pode contribuir com arquivos para a saída compartilhada 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 caractere. |
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á decidindo se vai usá-la. Comece com uma frase que nomeie a coisa e depois acrescente o que um leitor precisa para escolhê-la e usá-la corretamente — o que ela espera da Release que a implanta, e qualquer coisa surpreendente sobre como ela se comporta. Um parágrafo curto é o tamanho habitual. |
maintainers | object[] | não | Lista de mantenedores responsáveis por esta entidade. |
license | string | não | Identificador SPDX da licença do software que esta entidade descreve, como MIT ou AGPL-3.0. Ele registra os termos desse software, não os termos deste arquivo. |
repository | string | não | A URL do repositório Git onde ficam os arquivos-fonte. |
home | string | não | A URL da página inicial, do wiki ou da documentação desta entidade. |
keywords | string[] | não | Uma lista de palavras-chave descritivas para facilitar a descoberta na interface do usuário. |
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 provedor, 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 (arquivos de saída nomeados). Separadamente desses, uma Recipe pode contribuir com arquivos para a saída compartilhada da fronteira em que é renderizada, sob ‘boundary’.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
capability | string | sim | A capacidade explícita do provedor à qual esta receita se associa (por exemplo, ‘helm’, ‘terraform’, ‘compose’) — o tipo de provedor que a renderiza. Aceita uma fixação de versão opcional, nas mesmas três formas de ‘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 provedor; a fixação, quando presente, seleciona qual versão do plugin de renderização do provedor que atende essa capacidade renderiza esta receta — 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 atende a capacidade satisfaz interrompe o build de forma explícita. Tudo o que fica a jusante da seleção do provedor — agrupamento da saída, segmentos de caminho, compatibilidade do pipeline e escolha do codec — se baseia na capacidade simples, de modo que duas receitas que fixam versões diferentes do plugin da mesma capacidade coexistem em um mesmo build. |
implements | string | sim | Declara qual 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 o usa para verificar os mapeamentos do Manifest e para sugerir candidatos em diagnósticos e no preenchimento automático do editor; ele nunca resolve um build. 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 usuário, fixada no arquivo 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 provedor 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 mesma um template Go, avaliado em relação a um contexto autocontido local ao nó: ‘.context.instance_id’, ‘.values’, ‘.infra’ e as entradas deste mesmo bloco resolvidas até então. As entradas são resolvidas na 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 o build, e o bloco nunca é reordenado para fazer uma referência ser resolvida. Uma referência ‘.locals. |
provides | mapa de string ou number ou boolean | não | A API pública do Desenvolvedor. 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 em relação a um contexto autocontido, em 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, então um template de provides pode ler ‘.locals’ e recebe valores resolvidos; nomear uma chave que o bloco locals não declara causa uma interrupção. Os Chamadores resolvem as chaves de inject em relação a esses valores durante a hidratação do inject. Os valores são escalares — o pipe os transporta como estão e os converte 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 por despacho conforme o formato 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 provedor a partir do contexto do Aggrega (.values, .features, .infra). Modo 2 (importação de arquivo): um mapa YAML de exatamente uma chave, $import: ./relative/path.tmpl, que aponta para um arquivo 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 arquivo de bloqueio de cada Release; nenhum host de registro aparece na referência). Na forma de objeto, $import não deve corresponder a ^oci://; um valor que corresponde é recusado. |
workload | string ou object | não | Produtor de YAML de Workload com três modos de autoria por despacho conforme o formato 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 arquivo): um mapa YAML de exatamente uma chave, $import: ./relative/path.yaml, que aponta para um arquivo 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 arquivo de bloqueio de cada Release; nenhum host de registro aparece na referência). O Provider de destino deve suportar a síntese de cargas de trabalho; o catálogo da biblioteca padrão declara workloadSchema nesses provedores como o contrato documentado. Uma Recipe com workload: associada a um provedor que não consegue sintetizar é interrompida de forma explícita no momento da renderização. Na forma de objeto, $import não deve corresponder a ^oci://; um valor que corresponde é recusado. |
artifacts | mapa de string ou object | não | Mapa do nome da entrada para a autoria do conteúdo do artefato. O valor de cada entrada traz um de três modos por despacho conforme o formato do conteúdo. Modo 1 (inline): um escalar string de template Go cuja saída é o corpo do artefato. Modo 2 (importação de arquivo): um mapa YAML de exatamente uma chave, $import: ./relative/path.yaml, que aponta para um arquivo 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 arquivo de bloqueio de cada Release; nenhum host de registro aparece na referência). Um bundle se expande em uma saída por arquivo, 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 arquivo de saída, usado como está escrito, e o arquivo importado de uma entrada de modo 2 fornece o conteúdo sem nomear a saída, de modo que duas entradas que importam arquivos diferentes que compartilham um nome são duas saídas distintas. Colisões entre entradas de artefatos, arquivos de bundle, saída da fonte e síntese de cargas de trabalho interrompem o build quando o nó é renderizado. O bloco artifacts é escrito de forma idêntica em uma Recipe e em uma 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 nos dois tipos; um exemplo escrito para um se transfere para o outro sem alterações. Na forma de objeto, $import não deve corresponder a ^oci://; um valor que corresponde é recusado. Chaves: a chave nomeia a saída da entrada, então é limitada a um único nome de arquivo: começa com uma letra ou um dígito e continua com letras, dígitos, pontos, hifens ou sublinhados. Os pontos após o primeiro caractere preservam as extensões que as chaves de artefato carregam (main.tf, template.yaml, serviceaccount.yaml). Uma / faria uma chave nomear um caminho em vez de um arquivo, e um . inicial admitiria .., que nomeia um local fora do diretório de saída — a classe do primeiro caractere recusa ambos. Para uma importação de biblioteca, a chave nomeia o diretório sob o qual os arquivos do bundle são aninhados, então o mesmo limite se aplica. 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 como está que renderiza algo que a Release não deve entregar: um documento que um chart baixado renderiza, como um Secret contendo uma chave que o chart gera de novo a cada renderização, um serviço, um volume ou uma configuração que um arquivo compose baixado inclui, ou um recurso que um template do CloudFormation baixado declara. A maioria das Recipes nunca precisa disso. Cada entrada nomeia uma unidade que a fonte renderiza pelo seu tipo, pelo seu nome e, onde a entrada os fornece, pelo seu namespace e pelo subchart de onde veio, cada um no vocabulário do provedor que renderiza a fonte — para um chart, um documento pelo seu próprio kind e pelo seu metadata.name; para um arquivo 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 provedor deixa de fora cada unidade com a qual uma entrada corresponde, e aquilo com que uma entrada corresponde, e o que o provedor recusa por causa de uma entrada, é o contrato documentado do próprio provedor. Um provedor que não consegue deixar nada de fora recusa uma Recipe que declara esta chave antes que qualquer coisa seja renderizada. Somente o que source: renderiza é filtrado — uma entrada de workload: ou de artifacts: nunca é —, então a chave exige source. Cada valor é um template, avaliado em relação ao contexto em relação 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 deve deixar algo de fora: uma entrada ativa que não corresponde a nada que a fonte renderizou interrompe o build, nomeando a entrada. A fonte ainda é renderizada por completo — cada template de um chart ainda é executado, então um template que falha ainda faz o build falhar — e somente a sua saída é deixada de fora. Pelo menos 1 entrada. |
boundary | object | não | O que esta Recipe contribui para a saída compartilhada da fronteira em que é renderizada, em vez de para a saída do seu próprio componente. A maioria das Recipes nunca precisa disso: serve para um arquivo que o destino lê uma única vez para toda a fronteira — uma configuração de provedor do Terraform, por exemplo, que o Terraform aceita apenas na configuração raiz de uma fronteira e nunca dentro do módulo de um único componente. Um provedor aceita esses arquivos apenas onde o seu contrato declara boundaryArtifacts, e uma Recipe que declara este bloco para um provedor que não o faz é recusada antes de qualquer renderização. Uma FeatureRecipe não traz nenhum bloco desse tipo. |
outputLabels | mapa de string | não | Rótulos declarados pelo autor da Recipe, carimbados em cada objeto que a saída renderizada desta receita produz, traduzidos pelo provedor para a superfície de rótulos de cada provedor (metadata.labels do Kubernetes para a síntese do helm, a renderização da fonte e os artefatos; rótulos de serviço do Compose; tags por recurso nos corpos de artefatos .tf.json do Terraform). Eles seguem pelo mesmo trilho dos rótulos de procedência fixos, mas pertencem ao autor em vez de ao compilador. Os namespaces aggrega.ai/ e app.kubernetes.io/ são reservados para a procedência nativa da plataforma e são recusados no carregamento. Uma chave ou um valor que não é um rótulo válido para o provedor de destino é responsabilidade do autor da receita; o núcleo não controla o conjunto de caracteres dos rótulos além da regra dos namespaces reservados. |
outputComponentLabels | string[] | não | Chaves de rótulos de identidade do Component que esta receita promove para a sua saída renderizada. Cada entrada nomeia uma chave de rótulo; o valor é obtido dos rótulos da instância de componente que esta receita renderiza, de modo que o rótulo carimbado traz o valor declarado desse componente em vez de um repetido aqui. Os rótulos promovidos chegam à mesma superfície de rótulos que outputLabels, que por sua vez traz pares chave-valor literais escritos no local. Uma chave declarada nos dois blocos é recusada no carregamento, de modo que cada chave carimbada tem uma única fonte. Os namespaces aggrega.ai/ e app.kubernetes.io/ são reservados para a procedência nativa da plataforma e são recusados no carregamento; uma chave com escopo como component.aggrega.ai/hosting fica fora dessas raízes reservadas e pode ser promovida. |
pipeline | object[] | não | Lista sequencial de etapas de pipeline Wasm executadas após a renderização sobre o conjunto de documentos renderizados, cada uma retornando patches RFC 6902 e efeitos colaterais. |
assertions | mapa de string | não | Validação entre campos em tempo de build. Cada entrada é uma asserção nomeada: a chave é um identificador de regra estável que aparece nas mensagens de erro; o valor é uma string de template Go com semântica de interrupção {{ fail "message" }}. Várias asserções nomeadas por entidade são avaliadas por instância na ordem declarada pelo autor; a primeira asserção que falha interrompe o build. 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 expressam 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: referências a chaves não definidas causam uma interrupção com um diagnóstico no-such-key. Como a referência simples causa a interrupção antes que qualquer fallback possa ser executado, um default simples não fornece um fallback de campo opcional nesta superfície — proteja a referência com hasKey, ou use o helper optional, que realiza diretamente a verificação de presença. Ler a chave por meio de index também não fornece um: index causa uma interrupção em 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 provedor que renderiza a fonte: para um chart, o kind próprio de um documento renderizado, como Secret; para um arquivo compose, service, volume ou config; para um template do CloudFormation, o Type de um recurso, como AWS::S3::Bucket. Ele nomeia um tipo que a fonte renderiza e não tem relação com o kind: que um source: estruturado carrega. Um template. |
name | string | sim | O nome da unidade a deixar de fora, no vocabulário do provedor que renderiza a fonte: para um chart, o metadata.name próprio de um documento renderizado; para um arquivo compose, a chave da unidade sob services:, volumes: ou configs:; para um template do CloudFormation, o ID lógico do recurso, sua chave sob Resources. Um template. |
namespace | string | não | O namespace em que está a unidade a deixar de fora, quando a entrada deve corresponder apenas a uma unidade nesse namespace — para um provedor cuja saída tem namespaces, como acontece com os documentos renderizados de um chart. Se ausente, ou se renderizar para a string vazia, a entrada corresponde a uma unidade do seu tipo e nome, qualquer que seja o seu namespace. Um arquivo compose e um template do CloudFormation não têm namespaces, e seus provedores recusam uma entrada que nomeie um. Um template. |
subchart | string | não | O subchart de onde veio 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 é a partir de seus subcharts. Para um chart, o nome próprio do subchart, ou o alias que a dependência do seu pai lhe dá, com os nomes de um subchart aninhado unidos por / a partir do mais externo: 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 ausente, ou se renderizar para 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 o build, nomeando a entrada. Um arquivo compose e um template do CloudFormation não têm subcharts, e seus provedores recusam uma entrada que nomeie um. Um template. |
when | string | não | Template Go inline avaliado antes dos demais campos da entrada. Quando renderiza um valor falsy, a entrada é descartada: seus demais campos não são avaliados, nada é deixado de fora por causa dela e ela não precisa corresponder a nada. Um when vazio ou ausente mantém a entrada. A veracidade segue a convenção padrão 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 o build. |
Não são permitidas propriedades adicionais.
recipe.spec.boundary
O que esta Recipe contribui para a saída compartilhada da fronteira em que é renderizada, em vez de para a saída do seu próprio componente. A maioria das Recipes nunca precisa disso: serve para um arquivo que o destino lê uma única vez para toda a fronteira — uma configuração de provedor do Terraform, por exemplo, que o Terraform aceita apenas na configuração raiz de uma fronteira e nunca dentro do módulo de um único componente. Um provedor aceita esses arquivos apenas onde o seu contrato declara boundaryArtifacts, e uma Recipe que declara este bloco para um provedor que não o faz é recusada antes de qualquer renderização. Uma FeatureRecipe não traz nenhum bloco desse tipo.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
artifacts | mapa de string ou object | sim | Mapa do nome de arquivo para a autoria do conteúdo do arquivo, com a mesma forma dos artifacts próprios desta Recipe: os mesmos três modos — uma string de template Go inline, um $import: de um arquivo de template Go local ou um $import: de um bundle de uma ArtifactLibrary, cujos arquivos são aninhados sob a chave da entrada como <key>/<filename> —, a mesma regra de chave para nome de arquivo e o mesmo contexto de template, de modo que uma entrada pode ler .values, .infra, .locals e o resto exatamente como uma entrada de artifacts faz. O que muda é onde cada arquivo é escrito: uma única vez, no diretório que contém a saída montada da fronteira, ao lado dos arquivos que a montagem própria do provedor escreve ali, em vez de no diretório próprio deste componente. Cada entrada é avaliada para cada componente que esta Recipe renderiza na fronteira, e os arquivos que essas avaliações produzem são mesclados por nome: um mesmo nome avaliado em bytes idênticos por vários componentes, ou por várias Recipes, é um único arquivo, enquanto um mesmo nome avaliado em bytes diferentes interrompe o build nomeando o arquivo e cada contribuidor, assim como um nome que a montagem própria do provedor já escreve. Nada é carimbado em um arquivo desse tipo para dizer qual componente o escreveu, porque ele pertence a cada componente que o declarou. Uma entrada cujo template não renderiza nada não escreve nenhum arquivo. As entradas não são entregues ao provedor, que escreve o resto da saída da fronteira sem lê-las. Na forma de objeto, $import não deve corresponder a ^oci://; um valor que corresponde é recusado. Chaves: a chave nomeia o arquivo, então é limitada a um único nome de arquivo, segundo a regra que uma chave de artifacts segue: começa com uma letra ou um dígito e continua com letras, dígitos, pontos, hifens ou sublinhados. Uma / faria uma chave nomear um caminho em vez de um arquivo, e um . inicial admitiria .., que nomeia um local fora do diretório de saída da fronteira — a classe do primeiro caractere recusa ambos. Para uma importação de biblioteca, a chave nomeia o diretório sob o qual os arquivos do bundle são aninhados, então o mesmo limite se aplica. 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 esta etapa, único entre as etapas deste pipeline: um documento que declara um mesmo id em duas de suas etapas é recusado quando é lido. Uma etapa posterior do mesmo pipeline lê as saídas desta etapa como .steps.<id>.outputs. Padrão: ^[a-zA-Z0-9_]+$. |
plugin | string | sim | A referência à entidade Plugin que esta etapa 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 resolvível. O build resolve a entidade para o seu artefato .wasm endereçado por conteúdo — localizado a partir da identidade do plugin e do registro configurado, com o seu digest fixado no arquivo de bloqueio — e carrega os bytes. Uma simples referência a um .wasm ou a um artefato não é aceita aqui. |
function | string | sim | A função Wasm exportada a ser invocada. |
with | string | não | Template Go inline que é avaliado como um mapa JSON/YAML que satisfaz estritamente o esquema de entrada explícito deste plugin. |
optional | booleano | não | Quando true, uma falha desta etapa (um trap do guest, um patch direcionado a um documento ausente do conjunto, um patch malformado ou um diagnóstico com severidade de interrupção) é rebaixada para um aviso bem visível: o conjunto de documentos anterior à etapa é restaurado, a saída desta etapa é descartada e o pipeline continua. Quando false ou ausente, qualquer falha de etapa interrompe o build após restaurar o conjunto de documentos anterior à etapa. |
when | string | não | Template Go inline avaliado no momento de percorrer o pipeline. Quando renderiza um valor falsy, a etapa é pulada — uma passagem direta: o conjunto de documentos segue inalterado para a próxima etapa, sem contribuir com patches, efeitos colaterais ou registro da etapa. Um when vazio ou ausente sempre executa a etapa. A veracidade segue a convenção padrão 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: uma etapa pode declarar ambos. |
Não são permitidas propriedades adicionais.