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 da base de infraestrutura do Aggrega (FeatureRecipe)

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

ID do esquema: https://aggrega.ai/schemas/featurerecipe-v1beta1.schema.json

Definições escritas por Ops que mapeiam uma Feature abstrata do catálogo para uma implementação concreta e versionada para uma capacidade de provedor. Estritamente 1:1 com um provedor físico e uma funcionalidade do catálogo.

Consulte a referência de autoria da FeatureRecipe para orientações em prosa sobre como escrever entidades FeatureRecipe; esta página documenta o esquema estrutural que essa referência descreve.

Tipo de nível superior: object

Propriedades

PropriedadeTipoObrigatóriaDescrição
apiVersionconst “aggrega.ai/v1beta1”simConstante: "aggrega.ai/v1beta1"
kindconst “FeatureRecipe”simConstante: "FeatureRecipe"
metadataobjectsim
specobjectsimA associação à capacidade do provedor, o mapeamento, o pipeline e o mapeamento de injeção de uma FeatureRecipe. Traz os mesmos três tipos de entrada de uma Recipe (com fonte, sintetizado, artifacts) mais o injectMapping exclusivo da FeatureRecipe; uma FeatureRecipe de pura fiação que declara apenas capability e implements é válida e não renderiza nada.

Não são permitidas propriedades adicionais.

featurerecipe.metadata

PropriedadeTipoObrigatóriaDescrição
namestringsimPelo menos 1 caractere.
versionstringsimVersionamento semântico estrito da FeatureRecipe (por exemplo, 1.2.5). 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-]+)*))?$.
descriptionstringnãoO 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.
maintainersobject[]nãoLista de mantenedores responsáveis por esta entidade.
licensestringnãoIdentificador 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.
repositorystringnãoA URL do repositório Git onde ficam os arquivos-fonte.
homestringnãoA URL da página inicial, do wiki ou da documentação desta entidade.
keywordsstring[]nãoUma lista de palavras-chave descritivas para facilitar a descoberta na interface do usuário.

Não são permitidas propriedades adicionais.

featurerecipe.metadata.maintainers[]
PropriedadeTipoObrigatóriaDescrição
namestringsim
emailstringnão
urlstringnão

Não são permitidas propriedades adicionais.

featurerecipe.spec

A associação à capacidade do provedor, o mapeamento, o pipeline e o mapeamento de injeção de uma FeatureRecipe. Traz os mesmos três tipos de entrada de uma Recipe (com fonte, sintetizado, artifacts) mais o injectMapping exclusivo da FeatureRecipe; uma FeatureRecipe de pura fiação que declara apenas capability e implements é válida e não renderiza nada.

PropriedadeTipoObrigatóriaDescrição
capabilitystringsimA capacidade explícita do provedor à qual esta receita se associa (por exemplo, ‘helm’, ‘terraform’, ‘compose’) — o tipo de provedor que a renderiza.
implementsstringsimDeclara qual tipo de Feature do catálogo esta receita é capaz de implementar (incluindo Features de credenciais rotuladas com feature.aggrega.ai/kind: secret; versão exata, intervalo compatível com a versão principal ’^’ ou sem versão). 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. O mapeamento do Manifest é a escolha explícita de implementação do usuário, fixada no arquivo de bloqueio da Release.
localsmapa de stringnãoO estado privado de Ops. Resultados de computação internos disponíveis apenas dentro dos templates desta FeatureRecipe como ‘.locals.*’. Cada entrada é ela mesma um template Go, avaliado em relação a um contexto autocontido: ‘.context.instance_id’ (o COMPONENTE HOST para o qual esta vinculação está sendo resolvida, que é o que essa referência denota em toda superfície de template), ‘.attachment_name’ (a instância de vinculação sendo resolvida, e o único caminho até esse nome a partir de um local), os ‘.values’ e ‘.infra’ próprios da vinculação, 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.’ a uma entrada que este bloco define MAIS ABAIXO causa uma interrupção que nomeia a falha de ordenação; uma que nomeia uma chave que o bloco não declara de forma alguma causa uma interrupção que nomeia a chave. Ambas as verificações leem o caminho para o qual uma referência É RESOLVIDA em vez das teclas digitadas, então cobrem igualmente a forma direta, uma leitura dentro de um bloco ’{{ with .locals }}’, uma leitura por meio de uma variável associada diretamente a ‘.locals’ e uma chave lida do bloco entre parênteses, ‘(.locals).’ ou ’($.locals).’. Uma grafia que elas não cobrem: uma referência cujo caminho o texto do template não decide — uma alcançada por meio de uma função, como ‘index .locals’ ou ‘(default dict .locals).’, ou por meio de um bloco ‘with’ ou de uma atribuição de variável cujo pipeline aplica uma, já que o que esse pipeline produz é decidido na avaliação e não pelo seu texto. Ela não é analisada, e uma chave ausente alcançada dessa forma não causa interrupção: ela renderiza o texto literal '' em vez de nada. A única exceção é o próprio ‘index’: em toda superfície de template ele causa uma interrupção, nomeando a chave, quando o mapa que lê não contém a chave pedida, então uma chave ausente alcançada por meio de ‘index .locals’ causa uma interrupção. Os locals desta FeatureRecipe são resolvidos ANTES dos seus provides, então um template de provides pode ler ‘.locals’ e recebe valores resolvidos, enquanto um template de provides que nomeia uma chave que este bloco não declara causa uma interrupção. As regras são as mesmas que o bloco locals de uma Recipe segue. Quando executionScope é boundary, o bloco é avaliado uma vez para a vinculação à fronteira, em relação ao contexto de template com escopo boundary em vez do de um componente, e cada componente alcançado pela vinculação lê essas entradas resolvidas, incluindo os ‘.locals’ que seu injectMapping lê. Usado para exportar realidades físicas (por exemplo, contêineres de destino, caminhos JSON) para plugins Wasm a jusante. Nunca exposto aos chamadores — use provides para a API pública.
providesmapa de stringnãoA API pública do Desenvolvedor. Variáveis de saída contratuais disponíveis para a resolução do inject do Chamador a jusante. Quando executionScope é boundary, os provides são avaliados uma vez para a vinculação à fronteira, em relação ao contexto de template com escopo boundary, e cada componente alcançado pela vinculação lê essa única avaliação em ‘.features..provides’, assim como uma conexão que a vinculação carrega; o contrato provides que a Feature implementada declara é verificado uma vez, nessa avaliação, nomeando a vinculação à fronteira.
sourcestring ou objectnãoCaminho opcional para código de infraestrutura. Aceita uma string URI ou um objeto estruturado aberto. Se fornecido junto com valuesMapping, o compilador o renderiza, e os documentos renderizados se juntam à saída da FeatureRecipe antes que as etapas do seu pipeline sejam executadas.
valuesMappingstring ou objectnãoConteú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 que produz o formato de values esperado pelo provedor. 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.
workloadstring ou objectnãoProdutor 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 FeatureRecipe com workload: associada a um provedor que não consegue sintetizar é interrompida de forma explícita no momento da renderização. Uma carga de trabalho sintetizada de uma FeatureRecipe emite seus manifestos nativos do provedor no diretório de saída da funcionalidade. Na forma de objeto, $import não deve corresponder a ^oci://; um valor que corresponde é recusado.
artifactsmapa de string ou objectnãoMapa 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. Os recursos auxiliares que uma FeatureRecipe geradora de recursos emite (ConfigMap, ServiceMonitor, NetworkPolicy, CRD ExternalSecret etc.) têm formato de artefato; artifacts: é o principal mecanismo de geração de recursos. 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._-]*$.
omitsobject[]nãoO que deixar de fora do que a fonte desta FeatureRecipe 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 FeatureRecipes 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 FeatureRecipe 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. A chave é escrita de forma idêntica em uma Recipe e em uma FeatureRecipe. Pelo menos 1 entrada.
injectMappingstringnãoTemplate Go inline opcional avaliado durante a fase de interceptação pré-renderização, uma vez para cada componente alcançado pela vinculação, em relação ao contexto de template desse componente: ele lê ‘.context’ e ‘.features’ do componente e ‘.attachment_name’, ‘.values’, ‘.infra’ e ‘.locals’ da vinculação, seja o que for que executionScope diga, e uma referência a ‘.boundary’, que o contexto de nenhum componente carrega, interrompe o build. Produz um dicionário JSON/YAML que o compilador Go mescla em profundidade de forma nativa sobre o pipe de memória ‘.context.inject’ do Chamador. Usado para a mutação do lado do Chamador, sem Wasm, de variáveis de ambiente e contratos de entrega.
pipelineobject[]nãoLista 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.
executionScopestring (enum)nãoSe a Geração de recursos desta FeatureRecipe é executada por componente (o padrão) ou uma vez por vinculação a uma fronteira. As FeatureRecipes com escopo boundary são deduplicadas por (boundary_path, instância de FeatureRecipe) e todo template exceto o injectMapping lê um contexto de template com escopo boundary: os pilares .boundary.* em vez dos pilares .context.* por componente, e uma referência a eles interrompe o build. O injectMapping é executado uma vez para cada componente alcançado pela vinculação independentemente de executionScope, então ele lê o contexto desse componente e nunca .boundary. Valores permitidos: "component", "boundary" Valor padrão: "component"
readsCallerRenderFactsbooleanonãoDeclara que os templates desta FeatureRecipe leem o que renderizaram os Components que se conectam àquele ao qual ela está vinculada: os fatos de renderização que o provedor de cada um desses chamadores relata sobre a sua própria saída. Quando é true e a FeatureRecipe renderiza por componente, cada vinculação dela é renderizada depois que todo Component do build foi renderizado, em vez de logo após o Component ao qual está vinculada, de modo que a renderização de cada chamador está completa antes que a vinculação seja avaliada. Quando é false ou está ausente, a entrada de nenhum chamador em ‘.context.used_by’ traz fatos de renderização, a vinculação é renderizada logo após o seu Component, a menos que readsTargetRenderFacts seja true, e o build é interrompido em um template escrito inline nesta FeatureRecipe que lê os fatos de renderização de um chamador sob ‘.context.used_by’. Valor padrão: false
readsTargetRenderFactsbooleanonãoDeclara que os templates desta FeatureRecipe leem o que renderizaram os Components aos quais está conectado aquele ao qual ela está vinculada: os fatos de renderização que o provedor de cada um desses destinos relata sobre sua própria saída, em cada entrada de ‘.context.uses’. Quando é true e a FeatureRecipe renderiza por componente, cada vinculação dela é renderizada depois que todo Component do build foi renderizado, em vez de logo após o Component ao qual está vinculada, de modo que a renderização de cada destino está completa antes que a vinculação seja avaliada. É a mesma renderização posterior que readsCallerRenderFacts causa, então definir qualquer uma das chaves, ou ambas, faz a vinculação ser renderizada nesse momento. Quando é false ou está ausente, nenhuma entrada em ‘.context.uses’ traz fatos de renderização, a vinculação é renderizada logo após o seu Component, a menos que readsCallerRenderFacts seja true, e o build é interrompido em um template escrito inline nesta FeatureRecipe que lê os fatos de renderização de um destino sob ‘.context.uses’. Valor padrão: false
assertionsmapa de stringnãoValidaçã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 FeatureRecipe 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 FeatureRecipe 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.

featurerecipe.spec.omits[]
PropriedadeTipoObrigatóriaDescrição
kindstringsimO 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.
namestringsimO 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.
namespacestringnãoO 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.
subchartstringnãoO 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.
whenstringnãoTemplate 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.

featurerecipe.spec.pipeline[]
PropriedadeTipoObrigatóriaDescrição
idstringsimUm 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_]+$.
pluginstringsimA 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.
functionstringsimA função Wasm exportada a ser invocada.
withstringnãoTemplate Go inline que é avaliado como um mapa JSON/YAML que satisfaz estritamente o esquema de entrada explícito deste plugin.
optionalbooleanonãoQuando 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.
whenstringnãoTemplate 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.