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

Interrupções fatais

Uma interrupção fatal é um erro em tempo de compilação que para o build antes que qualquer saída seja produzida. Cada interrupção nomeia o arquivo, a entidade e o campo com problema, explica o que o compilador não conseguiu resolver e aponta a alteração concreta de autoria que a corrige. O compilador nunca repara nem reescreve silenciosamente a sua entrada — se algo estiver errado, o build para e diz a você onde.

Este catálogo está organizado pela etapa da compilação em que cada interrupção ocorre.

Cada entrada abaixo cita a mensagem que um build imprime para a condição que documenta: a frase fixa que declara a condição e, em seguida, o que essa ocorrência forneceu. Em um terminal, essa mensagem aparece dentro de um quadro — um cabeçalho entre colchetes com a categoria e o código curto da condição, um ponteiro para o arquivo e a chave com problema seguido da instância a que a falha se refere, como (instance <name>) — ou apenas essa instância, como instance <name>, quando nenhum arquivo se aplica — e a mensagem na linha de baixo — de modo que uma linha inteira colada de um build não corresponderá a uma entrada daqui, enquanto a mensagem dentro dela, sim; error-translation.md descreve o quadro por completo.

Ao chegar de um build com um código curto em mãos — a letra E e quatro dígitos, no cabeçalho entre colchetes do diagnóstico —, comece por Encontrando uma interrupção a partir do código curto que o build imprimiu no fim desta página, que lista cada condição catalogada aqui junto ao código curto que um build imprime para ela.

Ao carregar os seus arquivos

O compilador lê cada Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin e Release referenciado pelo seu build, valida cada um contra o seu esquema e interpola os parâmetros tipados da Release no Aggregate.

YAML anchor aliased inside its own content (Âncora YAML referenciada por um alias dentro do seu próprio conteúdo)

Um documento ancora um nó com &name e depois o referencia por alias com *name em algum lugar dentro do conteúdo que essa âncora cobre. Expandir o alias reproduz a âncora, cujo conteúdo traz o alias de novo, de modo que o documento descreve uma estrutura sem fim. Não há nada finito para ler, muito menos para validar, e o build para em vez de iniciar uma travessia que não pode terminar.

Ler YAML em uma árvore não expande aliases, então um documento com essa forma é lido sem reclamação e só falha quando algo o percorre. A recusa, portanto, fica entre a leitura e a travessia — e um build lê o YAML escrito pelo autor em mais de um ponto, então a mesma condição pode ser encontrada em mais de um. Quatro pontos a informam, cada um enquadrando a mesma explicação com o que localiza o documento naquela superfície:

  • Um arquivo de entidade, enquanto é lido. O build para antes que essa entidade seja verificada contra o seu esquema, então esta interrupção nomeia uma âncora em vez de um campo e não traz linha nem coluna: nesse momento, o documento não tem nenhuma posição para a qual um diagnóstico possa apontar de forma útil.
  • Um corpo de esquema, enquanto é compilado. Um pilar spec.schema: é compilado da forma compacta para um documento JSON Schema depois que o seu arquivo foi lido, então esta interrupção ocorre durante essa compilação e não antes dela, e traz, sim, uma linha. A forma que uma leitura anterior não consegue detectar é um corpo de escape $jsonschema:: um corpo de escape é um escalar de bloco — texto simples, sem âncoras — enquanto o arquivo ao redor é lido, e as suas âncoras só se tornam âncoras quando esse texto é, ele próprio, analisado, um nível abaixo. Quando o ciclo estava dentro de um bloco assim, a interrupção também nomeia $jsonschema como a palavra-chave cujo corpo o continha.
  • O esquema de carga de trabalho de um Plugin provedor, enquanto o Plugin é carregado. spec.provider.workloadSchema é escrito como um escalar de bloco: texto simples enquanto o próprio arquivo do Plugin é lido, sem âncoras nesse momento, e as suas âncoras só se tornam âncoras quando esse texto é analisado como um documento próprio, um nível abaixo. Essa análise e a compilação que a segue acontecem enquanto o Plugin é carregado, então esta interrupção ocorre ali e não quando o arquivo é lido, e traz uma linha. Quando o ciclo estava dentro de um escape $jsonschema: no corpo do esquema, a interrupção também nomeia $jsonschema como a palavra-chave cujo corpo o continha. Veja ../entities/plugin.md para a superfície de autoria do campo.
  • Um fragmento CloudFormation renderizado, enquanto o provedor o lê. Uma Recipe cloudformation cria um fragmento, e um corpo artifacts: é um template — então o que o provedor lê é o texto em que esse template foi renderizado, conteúdo que não existia enquanto os seus arquivos estavam sendo lidos. Por isso, esta interrupção ocorre enquanto a saída está sendo renderizada, depois que todas as verificações de esquema já passaram. Veja ../providers/cloudformation.md para a superfície de autoria do fragmento.

A recusa é da recursão, nunca da reutilização nem da profundidade. Ancorar conteúdo compartilhado e referenciá-lo a partir de muitos lugares é um padrão de autoria suportado — veja ../entities/aggregate.md “Padrões de âncoras YAML (bloco defs:)” e ../entities/manifest.md “Âncoras YAML para manifestos DRY” — e uma referência que se expande e termina é carregada normalmente, não importa quantas vezes apareça nem quão profundamente o documento esteja aninhado; a profundidade por si só nunca é motivo para esta interrupção. O que interrompe o build é uma âncora alcançada enquanto o build ainda está dentro dela, inclusive quando é alcançada indiretamente, por meio de uma segunda âncora declarada abaixo dela. A mensagem nomeia a âncora sobre a qual o laço se fecha, que não é necessariamente a âncora mais externa do documento.

Mensagens emitidas. Todas as quatro trazem a mesma explicação, e isso é deliberado: é uma única condição encontrada em quatro pontos, e um autor que aprendeu a lê-la uma vez não deveria ter de aprendê-la de novo. Só o quadro que localiza o documento muda.

anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (a âncora é referenciada por um alias dentro do seu próprio conteúdo, então o documento se expande sem fim; aponte esse alias para um conteúdo declarado fora da âncora, ou escreva o conteúdo por extenso)

Um arquivo de entidade é enquadrado pela verificação de envelope que o estava lendo e pelo caminho de onde foi lido:

document envelope validation failed: envelope: parse <path>: <the explanation above> (falha na validação do envelope do documento: envelope: análise)

Um corpo de esquema é enquadrado pela sua posição dentro do esquema e, quando o ciclo estava dentro de um bloco $jsonschema:, pela palavra-chave de escape. O build o informa sob uma tag CATALOG_ERROR, que também nomeia o arquivo, a entidade e o pilar cujo corpo não pôde ser compilado:

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above> (compactform na posição, palavra-chave)

O esquema de carga de trabalho de um Plugin provedor traz esse mesmo quadro de forma compacta; o que muda é a tag CATALOG_ERROR ao redor dele, que nomeia o Plugin e spec.provider.workloadSchema no lugar da entidade e do seu pilar.

Um fragmento renderizado é enquadrado pelo provedor que o leu:

cloudformation-provider: parse fragment: <the explanation above> (cloudformation-provider: análise do fragmento)

Como corrigir: aponte o alias para um conteúdo declarado fora da âncora em que ele está atualmente, ou escreva por extenso o conteúdo repetido no ponto de uso. Em um Aggregate ou em um Manifest, o bloco defs: de nível raiz é o lugar natural para âncoras compartilhadas — ele fica fora de todo bloco que o referencia, então uma âncora declarada ali não pode ser alcançada de dentro de si mesma. Nos outros tipos de entidade, que não têm bloco defs:, ancore o conteúdo compartilhado em algum lugar do qual o bloco que o referencia não seja descendente. Uma âncora pode ser referenciada de qualquer número de lugares e de qualquer profundidade; a única forma que ela não pode assumir é a de uma referência que volta a cair dentro do conteúdo que a âncora cobre.

O mesmo remédio se aplica onde quer que a interrupção tenha sido encontrada, e o quadro diz a você qual documento abrir: o próprio arquivo de entidade, o bloco $jsonschema: dentro de um pilar de esquema, o corpo workloadSchema dentro de um Plugin provedor, ou o corpo artifacts: cuja saída renderizada o provedor leu. Neste último caso, a âncora está no template que você escreveu, não no texto renderizado — a renderização a reproduziu fielmente.

Parameter type mismatch / contract violation (Tipo de parâmetro incompatível / violação de contrato)

A Release forneceu um valor cujo tipo ou forma não corresponde ao que o Aggregate declarou para esse parâmetro. O validador de contratos de parâmetros detecta incompatibilidades de tipo, violações de enum, violações de intervalo, violações de padrão, strings que não são instâncias válidas do format declarado, falhas de predicados validate: e parâmetros obrigatórios ausentes antes que qualquer interpolação de template seja executada. Os nomes que um format pode assumir, e o que cada um verifica, estão listados em Formatos nomeados.

Mensagem emitida — a frase que declara a condição, depois a entidade com falha, o caminho do campo e o detalhe da restrição:

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (contrato de parâmetro violado: o parâmetro esperava o tipo declarado e recebeu outro)

Para um parâmetro declarado required: true sem default: e sem valor fornecido pela Release, o relatório traz uma condição diferente e um código curto diferente:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (parâmetro obrigatório não fornecido: o parâmetro é obrigatório, mas a Release não o fornece)

Só o detalhe após o caminho do campo muda conforme a restrição não atendida. A frase e o enquadramento entre parênteses ao redor dela são sempre os mesmos, o que torna a frase a parte com a qual comparar e o detalhe a parte a ler. Os detalhes que um build imprime, um por tipo de restrição:

parameter "<parameter>" value <value> not in enum [<members>] (valor do parâmetro fora do enum) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (o valor do parâmetro não corresponde ao padrão) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (o valor do parâmetro não é válido para o formato) parameter "<parameter>" value <value> above max <max> (valor do parâmetro acima do máximo) parameter "<parameter>" failed validate predicate (o predicado validate do parâmetro falhou) parameter "<parameter>" validate predicate error: <detail> (erro no predicado validate do parâmetro)

O <reason> de uma falha de formato diz o que há de errado com o valor nos termos próprios desse formato. Um valor dentro de um contrato aninhado é nomeado pelo seu caminho, de modo que um format declarado por um contrato items: é verificado em cada elemento e o relatório nomeia o que falhou: o segundo elemento de um parâmetro hosts é relatado em .spec.parameters.hosts.1, e seu detalhe nomeia "hosts.1".

Um parâmetro que declara um validateMessage: substitui todo esse detalhe pelo próprio texto, de modo que o relatório diz parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) — o enquadramento não muda e sua frase fica onde estaria o detalhe da restrição.

A mesma condição abrange um contrato que, como está escrito, não consegue restringir nada. Um pattern: que não é uma expressão regular válida é recusado quando o contrato de parâmetros do Aggregate é lido, antes de qualquer valor da Release ser verificado, de modo que interrompe o build quer uma Release forneça o parâmetro, quer não. O relatório aponta para a chave — .spec.parameters.<parameter>.pattern, ou o caminho por um contrato aninhado como .spec.parameters.<parameter>.items.pattern — e seu detalhe nomeia a declaração, o padrão e o motivo:

parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (o padrão do parâmetro não compila)

Um format: que nomeia um formato fora do conjunto suportado também não consegue restringir nada, e é recusado no mesmo ponto, antes de qualquer valor da Release ser verificado, de modo que também interrompe o build quer uma Release forneça o parâmetro, quer não. Dentro de um contrato aninhado — sob items:, properties: ou valuesType: — é esta condição que o recusa: o relatório aponta para a chave, como .spec.parameters.<parameter>.items.format, e seu detalhe nomeia a declaração, o formato como foi escrito e cada nome suportado:

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (formato do parâmetro não suportado; os formatos suportados são email, uri, hostname, ipv4, ipv6, uuid, date-time, date)

Na própria declaração de um parâmetro, o mesmo nome é recusado um passo antes, pelo esquema do Aggregate, cujo format só admite os nomes suportados. Essa recusa é o documento falhando no esquema do seu tipo — uma condição diferente, com seu próprio código curto, E0215 — e aggrega pull e aggrega validate --release a listam depois de relatar a referência aggregate: da Release como não resolvível (E0170), já que o Aggregate que traz o nome não foi carregado:

document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (falha na validação do envelope do documento: o formato não está entre os valores permitidos; corrija o documento para que corresponda ao esquema do seu tipo)

O detalhe de erro do predicado abrange as duas maneiras pelas quais um predicado validate: pode deixar de produzir um veredito: uma função que a superfície não registra e uma referência a algo diferente de .value. Cada uma é relatada em relação ao predicado, e não ao valor, e cada uma nomeia o que não conseguiu resolver.

Um predicado validate: lê o valor em validação como .value, e esse é o único nome que ele define. Um predicado que nomeia qualquer outra coisa é recusado antes de ser executado, de modo que uma referência digitada errado é relatada como o erro de nomeação que é, em vez de se resolver em nada e aparecer como um valor que falhou na validação.

Como corrigir: altere o valor da Release para que atenda às restrições type / enum / min / max / pattern / format declaradas do parâmetro, forneça um parâmetro obrigatório ausente, corrija um pattern: que não compila, substitua um format: que nomeia um formato não suportado por um dos formatos nomeados ou remova-o, corrija um predicado validate: que nomeia algo diferente de .value ou que produz algo diferente de true ou false, ou amplie a declaração do Aggregate para aceitar a forma de que você realmente precisa.

Regras de forma da Recipe

Uma Recipe compõe sua saída a partir de três tipos de entrada — de origem, sintetizada e artefatos — descritos em ../../architecture/16-recipe-input-composition.md. A forma de uma Recipe válida é restringida pelas regras de composição abaixo. Elas diferem quanto ao momento em que são verificadas — quando a Recipe é carregada, quando um nó é renderizado ou quando a saída é emitida —, por isso leia cada entrada para saber em que ponto sua própria condição é verificada.

Cada regra é nomeada pelo que restringe. Não há numeração, e nenhum número é reservado: um nome diz qual parte da Recipe abrir, e continua dizendo isso por mais que a lista abaixo cresça ou seja reordenada. Quando você precisar registrar uma condição de forma duradoura — em uma verificação de CI, uma issue, um runbook —, use seu código, o identificador que sentinels.md lista para a condição e que permanece fixo à medida que os pacotes ao redor evoluem.

Uma interrupção por forma de Recipe é composta da mesma maneira. Ela começa com a frase que declara a regra, depois nomeia o que essa Recipe específica forneceu e, em seguida, o detalhe específico dela:

<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail> (a frase da regra, depois a Recipe com nome e versão, o nome da regra e a posição; em seguida, o detalhe específico da regra)

A frase inicial é fixa para cada regra — o mesmo texto sempre que essa regra interrompe o build, qualquer que seja a etapa que a detectou —, por isso é a parte da saída com a qual comparar, e é o texto que sentinels.md lista para a condição da regra. Tudo o que vem depois varia conforme a Recipe com falha: os valores entre parênteses dizem qual documento, qual regra pelo nome e onde, e a frase final é o conselho para essa ocorrência. A posição é o arquivo do qual a Recipe foi carregada quando a regra trata do documento como um todo, e um caminho com pontos até a chave que você escreveu — .spec.outputComponentLabels.hosting — quando a regra trata de uma única coisa dentro dele; uma chave que tem pontos próprios não pode ser escrita como mais um segmento sem ser lida igualmente como dois, por isso o caminho para no bloco que a contém e o conselho cita a chave em vez disso.

O build imprime a linha inteira sob uma tag CATALOG_ERROR, que sinaliza que a falha é atribuível à entidade do catálogo (a Recipe, ou o provedor ao qual ela se vincula), e não ao Aggregate ou à Release. O arquivo do qual a Recipe foi carregada é impresso ao lado da tag, de modo que uma regra posicionada em uma chave ainda informa qual arquivo abrir.

valuesMapping requires source (o mapeamento de valores requer uma fonte)

Uma Recipe declara valuesMapping, mas não source. Sem uma fonte sobre a qual sobrepor, não há nada para receber os valores mapeados. Esta regra é verificada quando a Recipe é carregada.

Mensagem emitida:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (Recipe: valuesMapping requer source; declare um ponteiro source: junto a valuesMapping, ou remova o valuesMapping se nenhuma sobreposição for pretendida)

Como corrigir: adicione um ponteiro source: (uma referência a um chart, módulo ou arquivo compose) junto ao valuesMapping, ou remova o valuesMapping e adote um tipo de entrada diferente (workload: para saída sintetizada, artifacts: para emissão direta de manifestos).

workload: requires a provider that can synthesize (requer um provedor capaz de sintetizar)

Uma Recipe declara workload: (modo sintetizado) para um provedor que não implementa a síntese de Workload. O suporte ao modo sintetizado é uma propriedade do provedor — o catálogo da biblioteca padrão declara workloadSchema nos provedores capazes de síntese por convenção, mas a verificação se baseia na capacidade do provedor, não na presença desse campo.

Duas superfícies o relatam, e só uma delas decide o build. A interrupção é gerada no momento da renderização, depois que o provedor do nó é vinculado e assim que os tipos de entrada que sua Recipe declara são lidos, por isso esse relatório nomeia o nó. aggrega validate relata o mesmo achado antes, antes de qualquer nó ser vinculado, lendo a Recipe sozinha — por isso esse relatório nomeia, em vez disso, a Recipe e sua versão. Os dois não leem o mesmo conjunto de Recipes: o relatório antecipado é gerado para qualquer Recipe que declare workload:, enquanto a interrupção é gerada para cada tipo de entrada declarado pelo nó que seu provedor não consegue atender. Assim, uma Recipe que combina um workload: com um source: ainda é interrompida, e é interrompida pela carga de trabalho — declarar um tipo de entrada que o provedor consegue renderizar não faz um tipo não suportado passar pela verificação.

O único limite a isso: artifacts: é verificado em relação ao suporte a artefatos independentes somente quando é o único tipo declarado do nó. Junto a um source: ou a um workload:, seus arquivos passam como saída composta, que essa capacidade não governa.

Mensagem emitida no momento da renderização. A categoria à qual a falha é atribuída chega até você no cabeçalho entre colchetes do diagnóstico, e não dentro da mensagem. A mensagem começa com a frase fixa que declara a condição e depois nomeia o nó, o provedor, o tipo declarado que foi recusado e os tipos que esse provedor suporta. Quando um nó declara dois tipos que seu provedor não consegue atender, o primeiro na ordem source → workload → artifacts é o relatado, de modo que o achado trata de uma única linha da sua Recipe:

provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode> (o provedor não suporta o tipo de entrada do nó; declare um dos tipos de entrada suportados ou aponte para um provedor que suporte o modo)

O cabeçalho traz a categoria e o código curto desta condição, E0265, que é o identificador a registrar quando você precisar nomear esta interrupção de forma duradoura — em uma verificação de integração contínua, uma issue ou um runbook. Um número é atribuído uma vez e depois fixado, por isso permanece o mesmo por mais que a redação ao redor melhore; a tabela de todas as condições o resolve, e a frase inicial acima é aquilo com que comparar quando você parte do texto, e não de um identificador.

aggrega validate relata a mesma cláusula sob a Recipe que traz o bloco, prefixada com a superfície que a leu e encabeçada pelo código curto desta condição, porque o relatório antecipado é a mesma condição:

input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (o provedor não suporta o modo sintetizado; declare um dos tipos de entrada suportados ou aponte para um provedor que suporte o modo sintetizado)

Em todo o catálogo, isso é uma linha; com --release, o cabeçalho fica em uma linha própria acima da cláusula. O diagnóstico do editor para o mesmo achado traz E0265 como código.

Como corrigir: vincule a Recipe a um provedor que sintetize (mais comumente helm ou compose) ou migre a Recipe para um tipo de entrada diferente (artifacts: para emissão direta de manifestos, ou source: + valuesMapping: se existir um chart/módulo).

Validação do conteúdo do Workload por provedor. Hoje, o workloadSchema do provedor serve apenas como documentação e não valida o corpo do Workload; os corpos são validados em relação ao esquema de Workload embutido de propriedade da plataforma. Quando o sintetizador de Workload baseado em Wasm for lançado, workloadSchema passará a ser o contrato por provedor em relação ao qual o sintetizador valida o corpo do Workload (uma interrupção distinta, no nível do conteúdo).

The provider does not support omits (O provedor não oferece suporte a omits)

Uma Recipe ou uma FeatureRecipe declara omits: e o provedor que a renderiza não declara que deixa documentos renderizados de fora. Deixar um documento de fora do que uma fonte renderiza é algo que só o provedor pode fazer — só o provedor sabe quais documentos a fonte renderiza e como cada um se chama —, então um provedor que não faz isso renderizaria todos os documentos que as entradas nomeiam e informaria sucesso. Em vez disso, o build recusa antes que qualquer coisa seja renderizada, para que a chave nunca deixe de ter efeito silenciosamente.

Se um provedor deixa documentos de fora é lido da própria declaração do provedor sobre o que ele suporta, não de uma lista de provedores mantida pelo compilador. Toda entrada conta, seja o que for que seu when: renderize, porque a capacidade do provedor de respeitar a chave não depende de quais entradas um build mantém. Os provedores helm, compose e cloudformation respeitam a chave. helm-chart e terraform repassam sua fonte para ser renderizada quando ela é implantada, então nenhum documento renderizado existe no momento do build para ser deixado de fora, e ambos são recusados.

A recusa é decidida assim que a Recipe de cada componente e a FeatureRecipe de cada vinculação estão associadas e cada provedor se descreveu — antes que o primeiro componente seja renderizado e antes que qualquer entrada seja avaliada, então um build recusado aqui não renderiza nada. A verificação é feita em todo documento que renderiza uma fonte: a Recipe de um componente; a FeatureRecipe que uma vinculação associa a um componente, uma vez para cada componente que carrega a vinculação; e uma FeatureRecipe que gera uma única vez para uma fronteira, uma vez, na fronteira que a declara. Todo documento com falha é relatado em um único build; quando há mais de um, os achados são agrupados sob documents declaring omits whose provider does not honour them. Um documento associado a um provedor que o build não consegue resolver não é relatado aqui: esse build é interrompido onde o provedor é selecionado, nomeando a associação.

Mensagem emitida, posicionada na própria chave do componente sob components: para as entradas de uma Recipe (um componente escrito dentro de um subsistema é posicionado primeiro sob a chave desse subsistema), na chave da vinculação no bloco features: que a escreveu para as de uma FeatureRecipe em um componente, e em .spec.boundaries.<boundary>.features.<attachment> na Release para uma FeatureRecipe que gera uma única vez para sua fronteira. A categoria chega a você no cabeçalho entre colchetes; a mensagem nomeia primeiro o provedor, depois o componente para o qual o documento é renderizado:

provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it (o provedor não oferece suporte a omits: o contrato deste provedor não declara que deixa documentos renderizados de fora; remova a chave omits ou renderize a fonte por meio de um provedor cujo contrato o declare)

O achado de uma FeatureRecipe nomeia a vinculação depois do componente — node "<node-id>", attachment "<attachment>" — e o de uma FeatureRecipe que gera uma única vez para sua fronteira nomeia a fronteira e a vinculação no lugar de um componente: boundary "<boundary>", attachment "<attachment>".

O cabeçalho traz o código curto desta condição, E0335.

Como corrigir: remova a chave omits: ou renderize a fonte por meio de um provedor que a respeite. Quando uma Recipe helm-chart ou terraform usa como fonte um chart ou módulo local, uma linha no .aggregaignore ao lado da Recipe deixa de fora, em vez disso, um arquivo dessa fonte, a partir da próxima vez que a Recipe for fixada — consulte aggrega pin.

The provider does not support boundary artifacts (O provedor não oferece suporte a artefatos de fronteira)

Uma Recipe declara spec.boundary.artifacts — arquivos para a saída compartilhada da fronteira em que ela é renderizada — e o provedor que a renderiza não declara que aceita tais arquivos. O próprio compilador grava esses arquivos, ao lado do que o provedor monta para a fronteira, e não entrega nenhum deles ao provedor, então se um arquivo colocado ali significa algo é uma propriedade do destino do provedor. Um destino que não o lê o entregaria e o ignoraria, e a configuração que ele carrega nunca entraria em vigor; em vez disso, o build recusa antes que qualquer coisa seja renderizada.

Se um provedor aceita os arquivos é lido da própria declaração do provedor sobre o que ele suporta, não de uma lista de provedores mantida pelo compilador. Qualquer entrada conta, seja qual for o resultado da sua renderização. O provedor terraform os aceita, gravando cada um ao lado da configuração raiz da fronteira; helm, compose, helm-chart e cloudformation não, e são recusados.

A recusa é decidida assim que a Recipe de cada componente está associada e cada provedor se descreveu — antes que o primeiro componente seja renderizado e antes que qualquer entrada seja avaliada, então um build recusado aqui não renderiza nada. Toda Recipe com falha é relatada em um único build, uma vez para cada componente que ela renderiza; quando há mais de um achado, eles são agrupados sob Recipes declaring boundary artifacts whose provider does not accept them. Uma Recipe associada a um provedor que o build não consegue resolver não é relatada aqui: esse build é interrompido onde o provedor é selecionado, nomeando a associação.

Mensagem emitida, posicionada em .spec.boundary na Recipe, onde a edição deve ser feita. A categoria chega a você no cabeçalho entre colchetes; a mensagem nomeia primeiro o provedor, depois o componente para o qual a Recipe é renderizada:

provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it (o provedor não oferece suporte a artefatos de fronteira: o contrato deste provedor não declara que aceita arquivos gravados na saída compartilhada de uma fronteira; remova o bloco boundary ou renderize a Recipe por meio de um provedor cujo contrato o declare)

O cabeçalho traz o código curto desta condição, E0351.

Como corrigir: remova o bloco boundary: ou renderize a Recipe por meio de um provedor que o aceite. Um arquivo que pertence ao componente e não à fronteira é, em vez disso, uma entrada de artifacts:.

At least one input kind must be present (Pelo menos um tipo de entrada deve estar presente)

Uma Recipe não declara nenhum tipo de entrada: nenhuma source combinada com valuesMapping, nenhum workload:, nenhum artifacts:. Uma Recipe assim não produz saída e não tem superfície de renderização. Esta regra é verificada quando a Recipe é carregada.

Um arquivo de Recipe com esse formato encontra primeiro o esquema da Recipe: o esquema exige, em todo provedor, um de source, valuesMapping, workload ou artifacts, então a verificação do envelope do documento recusa o arquivo com E0215 antes que esta regra seja executada, com um ramo para cada chave:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (a validação do envelope do documento falhou (Recipe): spec: nenhum ramo anyOf correspondeu: ramo[0]: validação: obrigatório: propriedades ausentes: [“source”]; ramo[1]: validação: obrigatório: propriedades ausentes: [“valuesMapping”]; ramo[2]: validação: obrigatório: propriedades ausentes: [“workload”]; ramo[3]: validação: obrigatório: propriedades ausentes: [“artifacts”]. corrija o documento para que corresponda ao esquema do seu tipo)

Mensagem emitida:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts (Recipe: pelo menos um tipo de entrada é obrigatório (Recipe, regra input-kinds). declare um de: source (com valuesMapping), workload, artifacts)

Como corrigir: adicione o tipo de entrada que corresponde à intenção com que a Recipe foi escrita. Uma Recipe para um serviço que o build não provisiona — um banco de dados ou uma API que já roda em outro lugar — declara um workload: de form: reference com seu endpoint (e opcionalmente port) e publica seus valores de conexão sob provides: como qualquer Recipe faz: helm a renderiza como um ExternalName Service, compose não renderiza nada para ela e, em ambos, seus consumidores leem os valores publicados.

artifacts: entry keys must be unique (As chaves das entradas de artefatos devem ser únicas)

Uma Recipe declara duas ou mais entradas sob artifacts: com a mesma chave. A chave determina o nome do arquivo emitido (seja o corpo da entrada escrito inline ou carregado via um $import: por entrada); chaves duplicadas emitiriam um arquivo com o mesmo nome no mesmo diretório da fronteira.

O build recusa a Recipe ao decodificar o documento para sua forma tipada, nomeando a chave repetida e a linha em que ela se repete. Essa etapa é executada depois da verificação do esquema do envelope e antes das regras de forma, então uma Recipe com uma chave artifacts: duplicada relata um esquema válido e depois esta interrupção, e as demais regras de forma não relatam nada sobre ela.

Como corrigir: renomeie uma das chaves de entrada em colisão para que cada entrada de artifacts: tenha um nome de arquivo único.

Emission-time filename collision across input kinds (Colisão de nomes de arquivo no momento da emissão entre tipos de entrada)

Uma Recipe e uma FeatureRecipe declaram, cada uma, tipos de entrada que produzem arquivos: uma source: que o provedor renderiza, um workload: que o provedor sintetiza, entradas de artifacts: e um pipeline: cujas etapas podem emitir. Cada um deles escolhe seus nomes de saída independentemente dos outros, e nada declara esses nomes como distintos — então dois deles podem produzir um arquivo sob um único nome, e só um dos dois sobreviveria. O build é interrompido e nomeia o nome de saída junto com cada bloco que o produziu.

A verificação é executada uma vez por documento emissor, assim que a emissão do próprio documento termina e antes que sua saída entre em qualquer montagem. Três documentos emitem, e cada um é verificado separadamente: a Recipe do próprio componente, a FeatureRecipe que uma vinculação associa a um componente e a FeatureRecipe que uma vinculação com escopo de fronteira associa. Mantê-los separados é o que faz o diagnóstico nomear o documento certo — os arquivos de uma vinculação são renderizados sob a identidade do componente que a hospeda, então uma colisão na FeatureRecipe da vinculação é relatada contra essa FeatureRecipe e não contra o hospedeiro.

Cada nome em colisão é relatado separadamente, então um documento cujos blocos se encontraram em dois nomes relata ambos. Um achado é posicionado no documento que você edita para corrigi-lo: a instância do componente para uma Recipe, e a própria FeatureRecipe para uma vinculação, cujo achado também nomeia a vinculação — um componente ou uma fronteira pode associar várias.

Um bloco que emite vários arquivos sob um mesmo nome não é esta interrupção. Trata-se de um único contribuinte, e não de dois blocos que se encontram, e chaves artifacts: duplicadas dentro de um bloco são recusadas enquanto o documento é decodificado.

Mensagem emitida:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (colisão de nomes de arquivo entre tipos de entrada: dois blocos de tipo de entrada produziram um arquivo sob um mesmo nome de saída)

Uma colisão em uma FeatureRecipe traz também a vinculação:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (colisão de nomes de arquivo entre tipos de entrada: dois blocos de tipo de entrada produziram um arquivo sob um mesmo nome de saída)

Como corrigir: renomeie o arquivo em colisão no tipo de entrada que você controla. Se a colisão envolver um nome de arquivo traduzido pelo Workload e uma entrada de artifacts:, os nomes traduzidos pelo Workload seguem as convenções de tradução do provedor (por exemplo, <release-name>-deployment.yaml para helm, onde o nome da release é {{ .context.rendered_name }}) — ajuste o nome de arquivo de artifacts: para um nome que o provedor não sintetiza.

An output-label key uses a reserved namespace (Uma chave de rótulo de saída usa um namespace reservado)

Uma Recipe nomeia uma chave de rótulo sob aggrega.ai/ ou app.kubernetes.io/ — em outputLabels:, o bloco que aplica rótulos literais à saída renderizada, ou em outputComponentLabels:, o bloco que nomeia chaves de rótulo do componente cujos valores são promovidos para ela. Ambos os prefixos pertencem ao próprio espaço de chaves de proveniência da plataforma: são as chaves que o próprio build aplica, então uma Recipe que aplicasse uma delas estaria escrevendo no espaço que diz de onde um recurso veio. Reservá-los é também o que mantém o conjunto de rótulos de uma Recipe disjunto do conjunto de proveniência, para que os dois nunca precisem ser reconciliados quando são mesclados. Esta regra é verificada quando a Recipe é carregada.

A reserva vale apenas para a raiz pura. Uma chave que apenas traz uma raiz reservada mais a fundo dentro de um namespace próprio — component.aggrega.ai/hosting, por exemplo — é um espaço de chaves diferente que não pertence à plataforma, e continua podendo ser usada.

Mensagem emitida. Uma única condição cobre os dois blocos, então sua frase não pode dizer qual dos dois foi escrito; a orientação que a segue nomeia o bloco citando a chave que você digitou e o bloco em que a digitou:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (restrição output-labels da receita: a chave usa um namespace reservado (Recipe, regra output-labels). a chave em outputLabels usa um namespace reservado (os dois prefixos são reservados para a proveniência da plataforma))

Uma chave escrita no bloco promovido é relatada sob o nome de regra desse bloco, que a orientação nomeia:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (restrição output-labels da receita: a chave usa um namespace reservado (Recipe, regra output-component-labels). a chave em outputComponentLabels usa um namespace reservado (os dois prefixos são reservados para a proveniência da plataforma))

As chaves do bloco literal são verificadas em ordem classificada e as do bloco promovido na ordem em que você as escreveu, então uma Recipe que viola a regra em vários pontos sempre relata primeiro a mesma chave.

Como corrigir: mova a chave para um namespace que pertença a você — seu próprio domínio, ou um com subprefixo como component.aggrega.ai/… — ou remova-a se o valor que você queria é um que o build já aplica. As chaves de proveniência que um recurso renderizado carrega estão listadas em ../providers/well-known-annotations.md; ler uma delas de volta não exige nenhuma declaração na Recipe.

A promoted component label is also declared literally (Um rótulo de componente promovido também é declarado literalmente)

Uma Recipe nomeia uma mesma chave tanto em outputComponentLabels: quanto em outputLabels:. Os dois blocos aplicam valores na mesma superfície de rótulos a partir de fontes diferentes — o primeiro promove o valor que o componente carrega, o segundo grava o valor que o autor da Recipe digitou —, então uma chave nomeada em ambos chegaria com dois valores candidatos e nada que diga qual prevalece. Esta regra é verificada quando a Recipe é carregada, depois da regra de namespace reservado acima, então uma Recipe que viola ambas relata primeiro o namespace reservado: a correção dessa falha não depende do que o outro bloco contém.

Mensagem emitida:

recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (restrição output-component-labels da receita: a chave também está declarada em outputLabels (Recipe, regra output-component-labels). a chave é promovida por meio de outputComponentLabels e também declarada literalmente em outputLabels; mantenha a fonte de onde o rótulo deve vir e remova a outra)

Como corrigir: decida de onde vem o valor do rótulo e exclua a outra declaração. Mantenha a entrada de outputComponentLabels: quando o valor deve acompanhar o que o componente carrega, para que dois componentes associados a uma mesma Recipe apliquem seus próprios valores; mantenha a entrada de outputLabels: quando o valor é da própria Recipe e é o mesmo onde quer que a Recipe esteja associada.

Regras de forma da FeatureRecipe

Uma FeatureRecipe compõe sua saída a partir dos mesmos tipos de entrada que uma Recipe, e a regra de composição abaixo a restringe como restringe uma Recipe. Ela é verificada quando a FeatureRecipe é carregada e relata no formato que uma interrupção de forma de Recipe assume — a frase da regra, depois o documento com falha, o nome da regra e a orientação para aquela ocorrência — sob uma tag CATALOG_ERROR.

Aqui, deliberadamente, não há nenhuma regra de pelo menos um tipo de entrada, e essa é a diferença em relação a uma Recipe. Uma FeatureRecipe que declara apenas um provedor e o que ela implementa é uma vinculação legítima de puro cabeamento: ela não renderiza nada, e seu efeito é a conexão que a Feature que ela implementa carrega. Uma FeatureRecipe que declara apenas injectMapping: é legítima da mesma forma.

A FeatureRecipe’s valuesMapping requires source (O mapeamento de valores de uma FeatureRecipe exige uma origem)

Uma FeatureRecipe declara valuesMapping, mas não source. Um mapeamento de valores é uma sobreposição, então, sem um chart, um módulo ou um arquivo sobre o qual se sobrepor, os valores mapeados não têm nada a alcançar.

Mensagem emitida:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping exige source (FeatureRecipe, regra values-mapping). declare um ponteiro source: junto a valuesMapping (ou remova o valuesMapping se nenhuma sobreposição for pretendida))

Como corrigir: adicione o ponteiro source: para o qual a sobreposição foi escrita, ou remova o valuesMapping e deixe a vinculação fazer seu trabalho de outra forma — artifacts: para emitir arquivos próprios, injectMapping: para remodelar o que ela entrega, ou nenhum dos dois, para uma vinculação de puro cabeamento.

A pipeline declares one step id twice (Um pipeline declara duas vezes um mesmo id de etapa)

Uma Recipe ou FeatureRecipe declara o mesmo id em duas etapas de seu spec.pipeline. Uma etapa publica as saídas que retorna sob seu id, e uma etapa posterior do mesmo pipeline as lê como .steps.<id>.outputs, então duas etapas que compartilhassem um id fariam essa etapa posterior ler as saídas daquela das duas que publicou por último, em vez das saídas daquela que você pretendia.

A regra abrange o pipeline próprio de um documento. A Recipe de um componente e as FeatureRecipes vinculadas a ele executam cada uma seu pipeline separadamente, e cada pipeline começa sem saídas de etapas, então uma etapa de uma Recipe e uma etapa de uma FeatureRecipe vinculada podem ter o mesmo id.

Nenhum schema consegue expressar esta regra — o JSON Schema não tem nenhuma palavra-chave para uma lista cujas entradas sejam únicas por um de seus campos —, então um editor que conhece o schema aceita um documento assim, e a verificação é executada enquanto o documento é lido, logo após a verificação do schema. Toda superfície que lê uma Recipe ou FeatureRecipe a relata: aggrega validate no arquivo ou no catálogo inteiro, um build que carrega o catálogo, um pull que admite uma entidade obtida, os diagnósticos do editor e uma edição de documento, que é recusada em vez de gravada. Um documento que também falha em seu schema relata primeiro os achados do schema, e esta recusa depois que eles forem corrigidos.

Cada repetição é um achado próprio, posicionado no id repetido e nomeando a etapa que declarou o id primeiro, com sua linha e coluna. Quando um id aparece três vezes, as duas etapas posteriores nomeiam a primeira.

Mensagem emitida, para uma FeatureRecipe cuja segunda etapa repete o id da primeira. A categoria e o código curto desta condição, E0370, chegam a você no cabeçalho entre colchetes:

a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (um pipeline declara duas vezes um mesmo id de etapa (FeatureRecipe); spec.pipeline[1].id: o id de etapa já está declarado em spec.pipeline[0].id. dê a cada etapa do pipeline seu próprio id, e aponte cada referência que uma etapa posterior faz para a etapa a que ela se refere)

Como corrigir: renomeie uma das duas etapas, para que cada id seja declarado uma única vez. Depois, leia os templates with: e when: de cada etapa posterior em busca de referências .steps.<id> ao id que você manteve, e aponte cada uma para a etapa cujas saídas ela pretende — é a renomeação que torna as saídas das duas etapas alcançáveis separadamente.

A document declares an API version this compiler no longer reads (Um documento declara uma versão de API que este compilador não lê mais)

A linha apiVersion de um documento declara aggrega.ai/v1alpha1. Todo tipo de documento que traz uma linha apiVersion declara aggrega.ai/v1beta1, a única versão que este compilador lê, e nenhuma conversão a partir da versão anterior ocorre: o documento é recusado ao ser lido, antes que qualquer outra coisa seja verificada, porque qualquer outra constatação diria respeito a uma versão do documento que o compilador não lê.

Toda superfície que lê um documento o relata: aggrega validate, um build, um pull que admite uma entidade obtida, os diagnósticos do editor e uma edição de documento. Um documento que declara uma versão que o compilador nunca leu é recusado, em vez disso, pelo esquema do seu tipo, sob E0215.

Mensagem emitida, para um Component. A categoria e o código curto desta condição, E0373, chegam a você no cabeçalho entre colchetes:

a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (um documento declara uma versão de API que este compilador não lê mais (Component); 1:1: apiVersion: o documento declara aggrega.ai/v1alpha1, e este compilador lê aggrega.ai/v1beta1. altere a linha apiVersion para aggrega.ai/v1beta1)

Como corrigir: altere a linha apiVersion do documento para apiVersion: aggrega.ai/v1beta1. Os campos de cada tipo não mudam entre as duas versões, então essa linha é a mudança inteira.

A plugin declares a plugin ABI version this compiler no longer speaks (Um plugin declara uma versão da ABI de plugins que este compilador não suporta mais)

Um plugin declara a ABI de plugins v1alpha1. Este compilador suporta a ABI de plugins v1beta1 e nenhuma outra, então um plugin compilado com a anterior é recusado em vez de executado. Um plugin informa sua ABI em dois lugares, e cada um é recusado sob esta mesma condição: o relatório describe() que seu módulo convidado retorna ao ser carregado, e o campo spec.abiVersion da sua entidade Plugin, recusado quando a entidade é lida, antes que qualquer outra coisa seja verificada. Um plugin que declara uma versão de ABI que este compilador nunca suportou também é recusado, pela verificação do descritor (E0085) ou pelo esquema Plugin (E0215).

Mensagem emitida, para um módulo convidado no carregamento. A categoria e o código curto desta condição, E0374, chegam a você no cabeçalho entre colchetes:

plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (o plugin declara abi_version “v1alpha1”, e este compilador suporta “v1beta1”; recompile o plugin com o kit de plugins atual e publique-o novamente: um plugin declara uma versão da ABI de plugins que este compilador não suporta mais)

Mensagem emitida, para uma entidade Plugin:

a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (um plugin declara uma versão da ABI de plugins que este compilador não suporta mais (Plugin); spec.abiVersion: o Plugin declara abiVersion v1alpha1, e este compilador suporta v1beta1. recompile o plugin com o kit de plugins atual e publique-o novamente; sua entidade Plugin então declara abiVersion v1beta1)

Como corrigir: recompile o plugin com a versão atual do seu kit de plugins, que grava v1beta1 no relatório describe() do módulo convidado, e publique-o novamente, para que a entidade gerada ao lado dele também declare abiVersion: v1beta1. Editar apenas a linha da entidade não basta: o próprio módulo convidado ainda informa a ABI anterior e é recusado ao ser carregado.

An artifact carries a media type this compiler no longer reads (Um artefato traz um tipo de mídia que este compilador não lê mais)

Um artefato obtido de um registro traz um tipo de mídia sob o qual uma versão anterior publicava — application/vnd.aggrega.<kind>.v1alpha1 com seu sufixo, no tipo de artefato do manifesto, em sua configuração ou em uma de suas camadas. Este compilador publica e lê os tipos de mídia v1beta1, então o artefato é recusado pelo nome quando seu manifesto é lido, antes que qualquer parte do seu conteúdo seja obtida: seja uma entidade de catálogo, um plugin e seu executável ou um pacote de documentação. Uma indexação de um registro ignora esse artefato, informando o motivo. Um tipo de mídia fora do namespace application/vnd.aggrega. próprio do Aggrega nunca é esta condição.

Mensagem emitida, para um Component publicado por uma versão anterior. A categoria e o código curto desta condição, E0375, chegam a você no cabeçalho entre colchetes:

"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (traz o tipo de mídia “application/vnd.aggrega.component.v1alpha1+yaml”, e este compilador lê “application/vnd.aggrega.component.v1beta1+yaml”; publique o artefato novamente com a versão atual: oci: o artefato traz um tipo de mídia que este compilador não lê mais)

Como corrigir: publique o artefato novamente com a versão atual do aggrega, que grava os tipos de mídia v1beta1. Um artefato que outra pessoa publica cabe a ela publicar novamente; até que o faça, ele não pode ser lido.

A file cannot be read, or its bytes do not parse (Um arquivo não pode ser lido, ou seus bytes não podem ser analisados)

Um arquivo que um build precisava ler, ou um documento Aggrega que uma verificação do catálogo inteiro leu nos diretórios do catálogo, não produziu nada que a superfície que o nomeou ou leu pudesse usar. Ou ele não pôde ser lido do disco, ou seus bytes foram analisados e a análise não foi concluída de forma limpa. Nada a jusante é executado sobre ele, porque não há conteúdo para verificar em relação a um schema, nenhum componente para posicionar e nenhum template para renderizar.

A condição não nomeia nenhum formato, e isso é proposital. A maioria dos arquivos que ela abrange é lida como YAML; os corpos workload, values-mapping e artifact de uma Recipe são lidos como código-fonte de template Go e nunca são analisados. Uma frase que prometesse YAML iniciaria um diagnóstico sobre um arquivo de template com uma afirmação sobre o formato desse arquivo. Qual das duas falhas ocorreu, e para que tipo de arquivo, é o que diz a cláusula após a frase.

Os documentos dos quais um build parte — o Aggregate, a Release e o Manifest — são os assuntos mais comuns, e a interrupção é gerada em todo ponto em que um dos três é lido. O diagnóstico nomeia qual documento estava sendo lido e o caminho de onde foi lido. O caminho é o que distingue um arquivo ausente de um malformado: uma falha de leitura cita o motivo do próprio sistema operacional, e uma falha de análise cita o do parser YAML, que traz a linha em que o parser desistiu.

Mensagem emitida, quando o arquivo não pôde ser lido:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Aggregate, falha ao ler o arquivo))

e quando seu texto não pôde ser analisado:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Aggregate, falha ao desserializar o YAML))

Release e Manifest aparecem no lugar de Aggregate quando um deles é o documento sendo lido. A mesma condição também abrange o contrato de parâmetros lido do bloco parameters: declarado de um Aggregate, que é lido do próprio texto do Aggregate antes que qualquer coisa seja interpolada nele.

Um parameters: { $import: … } de uma Release que nomeia um arquivo que o build não consegue obter também é relatado aqui, e nos dois casos: o caminho não nomeia nenhum arquivo que o build possa ler, ou o arquivo é lido e seus bytes não podem ser analisados. O assunto é a Release, e a cláusula nomeia a chave que apontava para o arquivo:

file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Release, falha ao ler o arquivo)) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Release, falha ao desserializar o YAML))

Um caminho relativo é resolvido a partir do diretório que contém a Release que o escreve — a Release que um comando nomeia, ou um elo de sua cadeia extends: —, de onde quer que o comando seja executado, de modo que a linha de comando e o editor leem o mesmo arquivo; um caminho absoluto nomeia seu próprio lugar. Confirme que o checkout sobre o qual o build é executado contém o arquivo nesse lugar: um arquivo de parâmetros presente na sua máquina e excluído do controle de versão está ausente durante uma execução de integração contínua, que é a forma comum de se deparar com este erro. Um caminho que sai do workspace — ou, para uma Release nomeada fora do workspace, do diretório próprio dessa Release — não é lido de forma alguma, e é relatado em “A reference to another file leads out of the directory it must stay inside” (Uma referência a outro arquivo sai do diretório em que deve permanecer) mais abaixo.

Um $import: de schema que nomeia um arquivo que o build não consegue obter também é relatado aqui, porque a falha é a mesma: a diretiva está bem formada e o arquivo que ela nomeia não produziu um documento. O assunto é então uma entidade de catálogo em vez de um dos três, então a cláusula nomeia a superfície de schema para a qual estava resolvendo — spec.schema, um de seus pilares como spec.schema.values, ou o valueSchema de um socket usesSchema — e o ponteiro de origem é a linha em que a diretiva foi escrita:

file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados. leitura do schema importado)

com resolve imported schema path no lugar de read para a falha mais rara de não conseguir sequer estabelecer o diretório próprio da entidade, e parse imported schema quando o arquivo foi lido e seu texto não é YAML bem formado. Uma falha na diretiva que você escreveu — uma chave irmã ao lado dela, um valor que não é um caminho, ou um conteúdo importado que foi analisado e não é um mapa — é uma condição diferente e é relatada em “A schema $import: cannot be applied” (Uma importação de schema não pode ser aplicada) mais abaixo.

Uma importação valuesMapping:, workload: ou artifacts.<name>: de uma Recipe ou FeatureRecipe também é relatada aqui, pelo mesmo motivo e com a mesma solução: a diretiva está bem formada e o arquivo que ela nomeia não produziu conteúdo. Esses três corpos são código-fonte de template Go em vez de documentos, então só a leitura pode falhar — nada os analisa neste ponto. A entidade e a chave que nomeou o caminho seguem na cláusula, e o ponteiro de origem é o caminho do próprio arquivo importado:

file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Recipe, importação de arquivo valuesMapping). se você quis dizer uma entrada de biblioteca em vez de um arquivo, a referência precisa do seu fragmento — um $import: sem nenhum é lido como caminho de arquivo, e um valor sem aspas termina onde um espaço antes de # inicia um comentário, então coloque a referência inteira entre aspas) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Recipe, importação de arquivo workload). se você quis dizer uma entrada de biblioteca em vez de um arquivo, a referência precisa do seu fragmento — um $import: sem nenhum é lido como caminho de arquivo, e um valor sem aspas termina onde um espaço antes de # inicia um comentário, então coloque a referência inteira entre aspas) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (Recipe, importação de arquivo de um artifact). se você quis dizer uma entrada de biblioteca em vez de um arquivo, a referência precisa do seu fragmento — um $import: sem nenhum é lido como caminho de arquivo, e um valor sem aspas termina onde um espaço antes de # inicia um comentário, então coloque a referência inteira entre aspas)

O fragmento é o que distingue uma referência de biblioteca de um caminho: <Library>#/mappings/<entry> é resolvido em relação às bibliotecas, e o mesmo texto sem o fragmento é um caminho relativo comum. É fácil perdê-lo sem perceber, porque um valor YAML simples termina onde um espaço antes de # abre um comentário — assim, $import: LibBeta:1.0.0 #/workloads/Web chega ao build como LibBeta:1.0.0, e o build então procura um arquivo com esse nome ao lado da Recipe. Coloque a referência inteira entre aspas para manter o fragmento.

As mesmas três chaves em uma FeatureRecipe relatam a mesma condição e são lidas da mesma forma. Uma importação de artifacts é lida duas vezes ao longo da vida de uma Release — uma vez quando aggrega pull congela o pin do seu conteúdo, e novamente quando a entrada é renderizada —, então o mesmo arquivo ausente relata esta condição naquele dos dois momentos que você alcançar primeiro. Uma falha de forma na própria diretiva, como uma chave irmã ao lado de $import: ou uma referência oci:// que inclui um host, é uma condição diferente e é relatada em sua própria entrada.

aggrega lint e aggrega validate do catálogo inteiro também relatam aqui, para um documento nos diretórios do catálogo que declara uma apiVersion Aggrega — uma linha que começa, sem recuo, com apiVersion: e um valor iniciado por aggrega.ai/ — e que não pode ser lido, não pode ser analisado ou não se decodifica no envelope que a verificação lê, como um metadata escrito como lista. Nenhum autor escreveu um caminho até ele: a verificação o leu porque ele está em um diretório de catálogo. Cada verificação lê todos os arquivos antes de parar, então uma única execução nomeia cada documento desse tipo; ela não verifica mais nada e não imprime nenhum resumo. YAML que não declara nenhuma apiVersion Aggrega — entre eles os templates de um chart Helm — é ignorado. O cabeçalho conta os documentos e nomeia seus arquivos, e cada um é listado abaixo dele com o motivo informado pela leitura ou pelo parser:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (documentos nos diretórios do catálogo declaram uma apiVersion Aggrega e não puderam ser carregados, então nada foi verificado) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (falha ao carregar o arquivo: o arquivo não pôde ser lido, ou seus bytes não puderam ser analisados (documento de catálogo, falha ao desserializar o YAML))

com failed to decode the envelope: e a linha e o que o decodificador encontrou ali — line 4 (metadata): a list is written where a map is expected para um metadata escrito como lista — para um documento que é analisado e não se decodifica, e failed to read file: e o motivo do sistema operacional para um arquivo que não pôde ser lido. Um documento que é carregado e declara um tipo que nenhum catálogo contém é nomeado pela mesma interrupção, contado no mesmo cabeçalho e listado sob sua própria condição — veja “A catalog document declares a kind a catalog does not hold” (Um documento de catálogo declara um tipo que um catálogo não contém) mais abaixo.

Como corrigir: leia o caminho na mensagem em vez do nome do documento — os dois diferem sempre que uma referência foi resolvida em um lugar inesperado. Para uma falha de leitura, confirme que o arquivo existe nesse caminho, que o caminho está escrito como o documento que o referencia o escreve, e que o build tem permissão para lê-lo; um arquivo presente localmente e ausente do checkout de um agente de build é o caso comum. Para uma falha de análise, abra o arquivo na linha que o parser nomeou — um valor sem aspas contendo dois-pontos, uma tabulação usada para indentação e um item de lista indentado sob a chave errada são os três que explicam a maioria delas.

A catalog document declares a kind a catalog does not hold (Um documento de catálogo declara um tipo que um catálogo não contém)

Um documento nos diretórios do catálogo declara uma apiVersion Aggrega — uma linha que começa, sem recuo, com apiVersion: e um valor iniciado por aggrega.ai/ — e um kind que nenhum catálogo contém: um erro de digitação como Componnent, um tipo com maiúsculas e minúsculas erradas como component, ou nenhum kind. Um catálogo arquiva cada documento sob o tipo que ele declara, então um documento assim não entra em nenhum catálogo: um build, inspect e todo outro comando que carrega o catálogo o ignoram, e uma referência à entidade que ele deveria declarar não se resolve em nada.

Um catálogo contém documentos Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate e Plugin. Três outros tipos ficam legitimamente em seus diretórios e nunca são relatados aqui: um Manifest e uma Release mantidos ao lado das entidades, e um Workload no diretório da Recipe ou FeatureRecipe que o importa.

aggrega validate e aggrega lint do catálogo inteiro relatam isso, assim como o lint restrito a uma release, que percorre os mesmos diretórios. Cada um lê todos os arquivos antes de parar, então uma única execução nomeia cada documento desse tipo junto com qualquer documento que não possa ser carregado de forma alguma, sob um único cabeçalho que os conta e nomeia seus arquivos; nada é verificado e nenhum resumo é impresso. Cada documento é listado com o tipo que declara, e a linha termina com os tipos que um catálogo contém:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (documentos nos diretórios do catálogo declaram uma apiVersion Aggrega e não puderam ser carregados, então nada foi verificado) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (um documento de catálogo declara um tipo que um catálogo não contém (kind “Componnent”). um catálogo contém documentos Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate e Plugin, e ignora um Workload, um Manifest ou uma Release; corrija o kind, ou mova o arquivo para fora dos diretórios do catálogo)

com no kind no lugar de kind "<kind>" para um documento que não declara nenhum.

Um build não para diante de um documento assim: ele o ignora como todo carregamento faz, e um documento que nenhuma Release alcança nunca faz um build falhar. Quando uma Release alcança a entidade, o build para na referência, em “A reference names no entity the catalog holds” (Uma referência não nomeia nenhuma entidade que o catálogo contém) mais abaixo, e a nota sob essa falha nomeia o arquivo quando ele declara o nome que a referência pede — veja essa entrada.

Como corrigir: abra o arquivo que a mensagem nomeia e corrija seu kind para o tipo que o documento é — tanto a grafia quanto as maiúsculas e minúsculas são significativas. Um arquivo que não é de forma alguma uma entidade de catálogo não pertence aos diretórios do catálogo; mova-o para fora, ou dê a ele uma apiVersion que não seja a do Aggrega se for o documento de outra ferramenta.

A path names content outside the entity’s own directory (Um caminho nomeia conteúdo fora do diretório da própria entidade)

O conteúdo de uma entidade fica no diretório da própria entidade, porque todo arquivo que uma publicação da entidade carrega é obtido dali. Um caminho que sai dele aponta para um arquivo que não viajaria com a entidade; portanto, o arquivo não está lá para quem recebe a entidade, e um pin registrado sobre ele garante bytes que esses destinatários não conseguem obter.

Por isso, todo caminho que uma entidade escreve para conteúdo que carrega é lido em relação ao diretório que contém o arquivo da entidade e deve permanecer dentro dele. Isso abrange a source: de uma Recipe e de uma FeatureRecipe — um caminho simples, ou a url: da forma estruturada —, o arquivo que cada entrada de valuesMapping:, workload: e artifacts: importa com $import:, e todo esquema que um Component ou uma Feature importa, inteiro, por pilar ou, para um socket usesSchema, seu valueSchema e seu infraSchema. Três formas saem do diretório: um caminho que sobe acima dele, um caminho absoluto, que nomeia um lugar na máquina em que foi escrito, e um caminho escrito dentro do diretório que um link simbólico no trajeto leva para fora dele — um diretório ao longo do caminho, assim como o arquivo no seu final, que seja um link que leva para fora do diretório da entidade. Um caminho que sobe e volta para dentro — ./charts/../values.tmpl — é um caminho comum dentro do diretório, e o mesmo vale para um que passa por um link que leva a outro lugar dentro dele. Uma subida que reentra no diretório pelo próprio nome dele — ../1.0.0/values.tmpl escrito em um diretório chamado 1.0.0 — é recusada, porque o nome do diretório não faz parte do que viaja: uma entidade publicada é lida de um diretório que o cache do destinatário nomeia, onde esse nome não encontra nada. Um caminho que passa por um link que leva para fora é recusado porque, caso contrário, uma publicação carregaria os bytes para os quais o link aponta, de onde quer que aponte, sob um nome dentro da entidade.

Ele é recusado onde quer que a entidade seja lida. Um aggrega validate do catálogo inteiro, aggrega validate sobre o arquivo da própria entidade, aggrega pull e aggrega build o recusam quando o arquivo da entidade é lido, e o mesmo fazem aggrega pin de uma Recipe ou de uma FeatureRecipe e aggrega push de qualquer um dos quatro tipos, antes que qualquer coisa seja baixada, escrita ou publicada. Uma source: escrita como template não nomeia nada até que o build a avalie; por isso, um template que produz um caminho fora do diretório é recusado pelo build, no momento em que o valor existe.

Uma Release é diferente, e uma referência a entidade também. Uma Release aponta para outras entidades — seu Aggregate, seu Manifest, a Release que ela estende — e nunca é publicada, então nada do que ela lê viaja para lugar nenhum: esses caminhos, e o arquivo que os parameters: de uma Release importam, são lidos como estão escritos. O type de um Aggregate nomeia outra entidade pela sua identidade, e não por conteúdo que o Aggregate carrega, e também é resolvido em seus próprios termos: pelos diretórios do catálogo, pelo cache e pelo registro, nunca como um caminho de arquivo.

Mensagem emitida, que nomeia o caminho como está escrito:

a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (um caminho nomeia conteúdo fora do diretório da própria entidade. correção: mova o arquivo para o diretório que contém a entidade, ou para um diretório abaixo dele, e nomeie-o com um caminho relativo a esse diretório. O conteúdo de uma entidade fica no diretório da própria entidade porque todo arquivo que uma publicação dela carrega é obtido dali; um caminho que sai dele aponta para um arquivo que não viajaria com a entidade)

e, para um caminho que um link leva para fora do diretório, nomeando o link e para onde ele leva:

a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (um caminho nomeia conteúdo fora do diretório da própria entidade. correção: substitua o link por uma cópia daquilo para onde ele leva, colocada dentro do diretório que contém a entidade. O conteúdo de uma entidade fica no diretório da própria entidade porque todo arquivo que uma publicação dela carrega é obtido dali; um link que sai dele carregaria os bytes para os quais aponta sob um nome dentro da entidade)

O campo de onde ele foi lido é nomeado na linha acima da mensagem: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema … ou, para uma origem gerada por template, node "<name>" source.

Como corrigir: mova o arquivo para o diretório da entidade, ou para um diretório abaixo dele, e escreva seu caminho relativo a esse diretório. Onde um link levar o caminho para fora, substitua o link por uma cópia daquilo para onde ele leva, dentro do diretório da entidade. Um chart que várias Recipes compartilham é copiado para o diretório de cada Recipe, já que cada uma é publicada separadamente; um esquema que vários Components compartilham pertence a uma SchemaLibrary, que cada Component então referencia pela sua identidade, e um corpo de mapping, de carga de trabalho ou de artefato que várias Recipes compartilham pertence ao tipo de biblioteca correspondente.

A Recipe’s source: names a kind nothing knows how to acquire (A origem de uma Recipe nomeia um tipo que nada sabe como adquirir)

A source: de uma Recipe diz para que tipo de coisa ela aponta — um chart, um módulo, um projeto compose — e cada tipo é adquirido pelo adaptador de origem que atende esse tipo. Esta condição relata um tipo que nenhum adaptador de origem atende, então nada do que este programa traz consegue baixar a origem. A source: de uma FeatureRecipe está sujeita à mesma regra.

Ele é recusado quando o documento é lido, antes que qualquer coisa seja baixada: verificar a Recipe sozinha o recusa, e o mesmo faz toda Release que chega a ela. Nada foi tentado, porque nada poderia tentá-lo — e é isso que o distingue de uma aquisição que foi executada e falhou.

Mensagem emitida, que nomeia o documento, o tipo como está escrito e os tipos atendidos:

no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (nenhum adaptador de origem atende o tipo de origem (Recipe, regra source-kind). a origem nomeia um tipo; nomeie um tipo que um adaptador de origem atenda, ou escreva a origem como um único URI cuja forma nomeie seu tipo)

Como corrigir: corrija o tipo na source: para um que a cadeia de ferramentas atenda — um erro de digitação e um tipo que realmente não tem adaptador produzem a mesma mensagem, e a mensagem cita o tipo como você o escreveu ao lado dos tipos atendidos; portanto, a primeira coisa a verificar é a grafia em relação a essa lista, que a página da Recipe também descreve. Se o tipo estiver escrito como você pretendia, esse tipo não é um que este build consiga adquirir, e nenhuma alteração na Recipe mudará isso; em vez disso, aponte a source: para uma forma atendida, ou escreva-a como um único URI cuja forma nomeie seu tipo.

No source adapter is registered in this program for a source kind (Nenhum adaptador de origem está registrado neste programa para um tipo de origem)

Uma origem é baixada pelo adaptador registrado para o seu tipo. Esta condição relata um download despachado para um tipo para o qual nenhum adaptador está registrado. Um tipo escrito pelo autor que nenhum adaptador atende é recusado quando a sua Recipe é lida (em “A Recipe’s source: names a kind nothing knows how to acquire (A origem de uma Recipe nomeia um tipo que nada sabe como adquirir)” acima), então nada do que um autor escreve chega até aqui: ela relata um programa montado sem o adaptador para um tipo que ele atende, ou um programa construído sobre os pacotes Go do Aggrega que despacha um download para um tipo que ele mesmo montou.

Mensagem emitida, que nomeia o tipo:

kind "<kind>": no source adapter is registered in this program for the source kind (tipo: nenhum adaptador de origem está registrado neste programa para o tipo de origem)

Como corrigir: nada nos seus arquivos de entidade causa isso. Relate o problema a quem compilou o binário que você está executando.

A source URL carries a credential (Uma URL de origem contém uma credencial)

A url de uma origem é registrada como você a escreveu — no arquivo de bloqueio da Release, no entity.lock ao lado da Recipe e no cache de origens — e a própria Recipe é um arquivo do qual você faz commit e que pode publicar. Assim, uma credencial escrita na URL viajaria para todo lugar aonde a URL vai. Esta condição relata uma source: de uma Recipe cuja url escreve um usuário antes do host: https://user:token@host/…, ou um token escrito sozinho como https://token@host/…, já que um serviço acessado por HTTP costuma aceitar um token no lugar do usuário. Em http e https, qualquer usuário escrito ali conta; em outro esquema, só uma senha conta, porque um usuário escrito sozinho ali nomeia uma conta — ssh://git@github.com/… é aceito, e o agente SSH fornece sua chave. A source: de uma FeatureRecipe está sujeita à mesma regra.

Ele é recusado quando o documento é lido, antes que qualquer coisa seja baixada: verificar a Recipe sozinha o recusa, e o mesmo faz toda Release que chega a ela, em uma validação, um pull, um pin ou um build. A mensagem nomeia o host e nunca a credencial. A verificação lê a parte da URL escrita antes do host e nada mais; por isso, um token levado em uma query string ou em um caminho não é detectado — e é registrado como está escrito, como o resto da URL.

Mensagem emitida em http ou https, que nomeia o documento, a chave e o host, e depois onde a credencial deve ficar:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (a URL de origem contém uma credencial (Recipe, regra source-url). spec.source.url nomeia um usuário ou uma senha para o host; remova-os da URL e, em vez disso, escreva a credencial no arquivo netrc, como uma entrada “machine … login … password …” (o arquivo que NETRC nomeia, senão .netrc no seu diretório pessoal, ou _netrc em %USERPROFILE% no Windows))

e em outro esquema, onde a correção é remover a senha:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (a URL de origem contém uma credencial (Recipe, regra source-url). spec.source.url nomeia uma senha para o host; remova-a da URL, que é gravada no arquivo de bloqueio e no cache como foi escrita)

Como corrigir: remova o usuário e a senha da url, deixando a URL que nomeia o host. Para uma origem baixada por http ou https, coloque a credencial em uma entrada machine para esse host no seu arquivo netrc, que todo download de um repositório clássico de charts Helm, de um fragmento compose ou de um repositório Git por HTTP ou HTTPS lê — Autenticação descreve qual arquivo e qual entrada. Para um repositório Git por SSH, o agente SSH fornece a chave, e o usuário pode permanecer. Se a Recipe já foi enviada em commit ou publicada com a credencial dentro dela, a credencial está nesse histórico: altere-a também no servidor.

A {{ .parameters.* }} reference cannot be interpolated (Uma referência a parâmetros não pode ser interpolada)

O texto do Aggregate é avaliado como um template antes de ser lido como um documento, para que uma referência {{ .parameters.<key> }} seja substituída pelo valor que a Release forneceu para ela. Esta interrupção ocorre quando essa avaliação não pode ser concluída: o texto não é analisado como template, ou é analisado e falha durante a execução.

A interpolação acontece antes de o Aggregate ser analisado como YAML, e é por isso que uma falha aqui é relatada contra o Aggregate como um todo, e não em uma chave dentro dele — nesse ponto o documento ainda não tem chaves. É também por isso que a referência pode ficar sem aspas: a substituição acontece nos bytes brutos, e a própria regra de aspas do YAML decide depois o tipo do valor; assim, uma referência sem aspas produz o tipo natural do valor e uma entre aspas produz uma string.

Uma referência que nomeia uma chave que a Release não forneceu não é esta interrupção. Uma chave ausente se resolve aqui em um valor vazio e é capturada, com seu tipo e seu contrato, pelas verificações de parâmetros descritas em “Parameter type mismatch / contract violation (Tipo de parâmetro incompatível / violação de contrato)” acima. O que esta interrupção relata é um texto que o mecanismo de templates não conseguiu processar de forma alguma — um {{ não fechado, um nome de função escrito errado, um pipeline cujos estágios não se encaixam. Ler um parâmetro por meio de index — {{ index .parameters "db_size" }} — quando a Release não forneceu esse parâmetro é uma falha durante a execução, e esta interrupção a transporta, nomeando a chave: index interrompe diante de uma chave de mapa que o mapa não contém em toda superfície de template, como descreve “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)” abaixo.

Um texto que não é analisado de forma alguma é recusado com o caminho do próprio Aggregate nomeado, porque esse arquivo está disponível antes que qualquer coisa o leia. Um módulo que a composição importa é avaliado da mesma forma um nível abaixo, onde seu texto é lido do catálogo em vez de ser entregue ao build. A interrupção é esta mesma condição e carrega este código em ambos os casos; para um módulo, ela também nomeia o import que estava seguindo e o arquivo do qual o texto do módulo foi lido, e a mensagem que ela carrega nomeia apenas o tipo — portanto, a posição que essa mensagem fornece é uma posição no texto do próprio módulo, não no Aggregate do qual você partiu.

Mensagens emitidas, para um template que não é analisado, para a mesma falha em um módulo que a composição importa, e para um template que falha durante a execução:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (referência de parâmetro inválida: verifique se a expressão {{ .parameters.* }} nomeia um parâmetro declarado e é analisada como um template Go (Aggregate, “erro de análise do template”)) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (referência de parâmetro inválida: verifique se a expressão {{ .parameters.* }} nomeia um parâmetro declarado e é analisada como um template Go (Aggregate, erro de análise do template)) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (referência de parâmetro inválida: verifique se a expressão {{ .parameters.* }} nomeia um parâmetro declarado e é analisada como um template Go (Aggregate, erro de execução do template))

O texto de um Aggregate tem uma única raiz, .parameters; por isso, uma referência por qualquer outra — {{ .values.app_token }} ou {{ $.values.app_token }} — não lê nada e falha durante a execução. O motivo então começa nomeando a referência que leu:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (referência de parâmetro inválida: verifique se a expressão {{ .parameters.* }} nomeia um parâmetro declarado e é analisada como um template Go (Aggregate, o template lê uma referência, e o texto de um Aggregate não define nenhuma raiz além de .parameters; erro de execução do template))

Como corrigir: abra o Aggregate e leia o motivo subjacente, que nomeia a posição no texto e a construção que falhou. Confirme que cada {{ tem seu }}, que uma função que você chamou é uma das que a superfície oferece — a interpolação de parâmetros oferece as funções do Sprig e nada mais, então a função auxiliar optional não está disponível aqui — e que os estágios de um pipeline aceitam o que o estágio anterior produz. Se o motivo nomear uma chave que index não encontrou, leia um parâmetro que pode não estar definido com um ponto ({{ .parameters.db_size }}) ou por meio de get ou hasKey do Sprig. Se nomear uma referência por outra raiz, declare o valor como um parâmetro do Aggregate e leia-o como {{ .parameters.<key> }}. Se nomear algo que você nunca quis como template — undefined variable "$json" vindo de uma expressão do n8n, ou uma função com o nome de um nó do Flowise — o texto contém chaves duplas próprias, incluindo as de um comentário: escreva cada {{ nele como {{"{{"}}, como descreve Texto que contém suas próprias chaves duplas.

The Release directory declares one Aggregate or Manifest twice (O diretório da Release declara duas vezes um Aggregate ou um Manifest)

Uma Release cuja referência aggregate: ou manifest: é uma identidade simples é resolvida examinando primeiro o próprio diretório da Release, e esse exame encontrou dois Aggregates — ou dois Manifests — com o mesmo metadata.name. Uma referência por identidade simples nomeia uma entidade por esse nome, então um nome reivindicado duas vezes é um nome pelo qual o diretório não pode responder.

O exame recusa o diretório como um todo, não apenas o nome que uma referência pediu. Ele lê cada Aggregate e cada Manifest que está ao lado da Release, então um par em colisão que nenhuma das duas referências nomeia também interrompe o build: o diretório é ambíguo, seja ou não esta a Release que estava prestes a ler essa entidade. Uma referência escrita como caminho (./aggregate.yaml, ../shared/manifest.yaml) aponta para um arquivo em vez de uma entidade e é resolvida sem o exame, então uma Release cujos aggregate: e manifest: são ambos caminhos nunca o executa.

Esta é a contrapartida, no mesmo diretório, da recusa por identidade duplicada do catálogo, e as duas são relatadas separadamente para que a mensagem nomeie o diretório em que você está, e não um nível do catálogo em que talvez você não estivesse pensando.

Mensagem emitida:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (identidade Aggregate/Manifest duplicada (metadata.name) no diretório da Release: Aggregate declarado mais de uma vez)

com Manifest no lugar de Aggregate quando dois Manifests colidem.

Como corrigir: dê a uma das duas entidades um metadata.name diferente, ou mova-a para fora do diretório da Release. Duas Releases que de fato implantam Aggregates diferentes com o mesmo nome pertencem a diretórios próprios; copiar uma Release para um arquivo vizinho sem renomear o que ela contém é a forma habitual como isso acontece.

A Release’s aggregate: or manifest: reference resolves to nothing (A referência de uma Release não se resolve em nada)

Uma Release nomeia um Aggregate ou um Manifest por identidade simples e nenhuma entidade com esse nome foi encontrada em nenhuma das superfícies em que uma identidade simples é procurada: o próprio diretório da Release, o catálogo e o registro.

Mensagem emitida, quando nada correspondeu em lugar nenhum:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (referência aggregate/manifest não resolvível: nenhum Aggregate com esse nome no diretório da Release, no catálogo ou no registro)

Um arquivo no diretório da Release que não pôde ser indexado muda o relatório, porque muda o que pode ser afirmado com honestidade. Esse arquivo pode ter sido a entidade, então a mensagem diz isso em vez de afirmar uma ausência que não consegue estabelecer, e traz a falha de análise que impediu sua leitura:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (referência aggregate/manifest não resolvível: Aggregate não encontrado; o arquivo não analisável não pôde ser indexado e pode ser ele)

e quando um arquivo não analisável é exatamente aquele que a referência nomeia:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (referência aggregate/manifest não resolvível: o Aggregate necessário é o arquivo não analisável)

Como corrigir: quando a referência realmente não existe, corrija sua grafia — a identidade é o metadata.name da entidade, não o nome do arquivo — ou adicione a entidade ao diretório da Release ou ao catálogo que o build lê. Quando a mensagem nomeia um arquivo não analisável, corrija primeiro esse arquivo: a falha de análise dele é citada na mensagem, e repará-lo muitas vezes resolve a referência na mesma edição. Uma referência ./ ou ../ é um caminho e não uma identidade, e é resolvida como tal, então um ponto inicial muda qual dos dois erros você está procurando.

A component is placed in more than one boundary (Um componente é colocado em mais de uma fronteira)

A árvore de fronteiras de uma Release coloca um componente em duas fronteiras diferentes. As duas colocações não são mescladas nem classificadas, e não poderiam ser: a fronteira de um componente decide onde sua saída é escrita, em qual subdiretório ela vai parar, a qual sync wave ele se junta e quais anotações e qual infra de fronteira ele herda — enquanto sua superfície uses: por aresta é lida por um percurso separado. Um componente nomeado duas vezes tiraria o local da sua saída de uma colocação e sua configuração por aresta da outra.

Uma fronteira coloca componentes de três maneiras, e as três contam. Nomear um diretamente sob components:, pelo id que ele carrega quando a composição está concluída, o coloca. Nomear um dentro do próprio components: de uma entrada de roteamento, pelo nome local que ele carrega dentro desse submódulo, também o coloca. E rotear um submódulo inteiro sob aggregates: coloca cada componente que esse módulo contém. Portanto, esta interrupção também cobre um submódulo roteado para duas fronteiras, um módulo roteado para uma fronteira com um módulo aninhado nele roteado para outra, e um componente nomeado em uma fronteira enquanto o módulo que o contém é roteado para uma fronteira diferente.

Rotear um módulo para uma fronteira e também nomear um de seus componentes sob essa mesma fronteira não é um conflito — as duas colocações concordam sobre onde o componente pertence — e o build é concluído. Um mesmo id escrito duas vezes sob uma única fronteira é um conflito mesmo aí: uma entrada no components: da fronteira e uma entrada para esse mesmo componente dentro da entrada de roteamento da fronteira são duas entradas que carregam configuração para um único componente, sem nada para escolher entre elas.

Toda colocação infratora é relatada. Uma Release que coloca vários componentes duas vezes é interrompida com uma destas mensagens por entrada infratora em um único build, cada uma na chave da entrada que ela contesta — de modo que várias delas juntas são um único build que nomeia tudo o que encontrou, e não uma única falha escrita mais de uma vez.

A colocação que uma mensagem relata como já em vigor nem sempre é a escrita primeiro no arquivo. As próprias entradas components: de uma fronteira são lidas antes dos componentes que suas entradas de roteamento nomeiam e antes dos submódulos que ela roteia, e uma fronteira é lida antes das fronteiras aninhadas nela; fronteiras escritas lado a lado são lidas na ordem em que aparecem. Quando mais de uma colocação anterior entra em conflito, a primeira lida é a nomeada. Os dois locais são nomeados em qualquer ordem em que apareçam, e nenhum é colocado acima do outro.

Mensagem emitida. A frase enuncia a regra; o que segue nomeia a entrada infratora, a fronteira em que está cada uma das duas colocações, o bloco em que cada uma foi escrita e o arquivo que contém as duas. Quando uma entrada sob o components: de uma fronteira encontra uma entrada anterior sob o de outra fronteira:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (componente declarado em mais de uma fronteira: declare cada componente em exatamente uma fronteira (Release; nomeado no bloco components de uma fronteira, enquanto já está nomeado no bloco components de outra fronteira; ambos declarados no mesmo arquivo))

As duas orações que nomeiam as fronteiras são redigidas conforme o bloco em que cada entrada foi escrita. A entrada infratora recebe uma destas:

  • named in the components block of boundary "<boundary>" — o próprio mapa components: da fronteira;
  • named inside a routing entry in boundary "<boundary>" — o mapa components: de uma entrada de roteamento sob o aggregates: dessa fronteira;
  • routed as a sub-module into boundary "<boundary>" — a própria entrada de roteamento.

A colocação anterior, continuando a mesma frase, recebe uma destas:

  • while it is already named in the components block of boundary "<boundary>";
  • while it is already named inside a routing entry in boundary "<boundary>";
  • while it is already placed by a sub-module routed into boundary "<boundary>".

As duas orações são escolhidas de forma independente, então qualquer combinação delas pode aparecer, e that earlier entry naming traz aquilo a que a colocação anterior se referia: o id do componente, ou o prefixo do submódulo quando foi um submódulo roteado que o colocou.

Quando a entrada infratora é ela mesma uma entrada de roteamento, aquilo a que ela se refere é um submódulo e não um único componente, e a mensagem diz isso em vez de apresentar um prefixo de módulo como nome de componente — aqui ao encontrar um submódulo anterior roteado para outra fronteira:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (componente declarado em mais de uma fronteira: declare cada componente em exatamente uma fronteira (Release; submódulo roteado como submódulo para uma fronteira, enquanto já está colocado por um submódulo roteado para outra fronteira; ambos declarados no mesmo arquivo))

Como corrigir: exclua, das duas colocações, aquela que você não pretendia. A mensagem nomeia ambas, então a escolha é sua, e não do compilador. Quando uma declaração direta e um módulo roteado discordam, decida se o componente pertence ao seu módulo ou fica por conta própria: rotear o módulo o coloca junto com tudo o mais que o módulo contém, e nomeá-lo diretamente o separa disso. Quando duas entradas de roteamento reivindicam um mesmo módulo, remova o roteamento que você não pretendia — rotear um módulo para uma fronteira coloca ali cada componente que ele contém, então duas entradas assim reivindicam o mesmo conjunto de componentes.

A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Uma associação de anotação do Manifest reivindica o prefixo reservado)

Um Manifest declara uma associação de anotação sob uma chave que começa com o prefixo simples aggrega.ai/. Esse prefixo é onde o build aplica as chaves que ele mesmo emite, então uma associação que reivindicasse uma chave dentro dele colocaria seu roteamento e a própria saída da plataforma em um único espaço de chaves, competindo pelos mesmos nomes.

Ele é interrompido, e não poderia ser um aviso. A reserva é tudo o que torna esse espaço de chaves da plataforma; admitir a associação e mencioná-la depois deixaria a colisão no build.

A regra trata do espaço de chaves que uma associação escrita pelo autor reivindica, então uma chave para a qual o Manifest apresentado não declara associação é ignorada em vez de relatada — não há associação que possa violá-la.

Mensagem emitida. A chave infratora vem primeiro, porque é dela que a frase trata, e os valores depois dela são introduzidos, cada um, pelo que são:

manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (a associação de anotação do manifest usa um prefixo reservado (Manifest; prefixo reservado; roteamento para uma Feature; escreva a associação sob um domínio seu))

Como corrigir: renomeie a chave da associação para um namespace que você controla. Uma chave com subprefixo é a forma suportada e não é reservada: feature.aggrega.ai/… para um atalho da biblioteca padrão, ou seu próprio domínio — acme.aggrega.ai/…, compliance.example.com/… — para um atalho corporativo. Renomear a chave muda o que um autor escreve em um componente para acionar a associação, então atualize as anotações que a usam na mesma edição. As chaves próprias da plataforma sob o prefixo simples estão listadas em ../providers/well-known-annotations.md.

Two Manifest annotation bindings compete for one routing slot (Duas associações de anotação do Manifest competem por um mesmo slot de roteamento)

Duas associações de anotação em um mesmo Manifest roteiam para a mesma Feature, pelo mesmo pilar, no mesmo caminho. A função de uma associação é dizer onde o valor de uma anotação vai parar, e duas associações que nomeiam um único destino deixam o valor com duas rotas e nada para escolher entre elas no momento da expansão.

Apenas uma associação pode declarar um dado par caminho-pilar por Feature de destino. Duas associações que apontam para a mesma Feature em caminhos diferentes são autoria comum e o build é concluído; o mesmo vale para duas associações que roteiam o mesmo caminho para duas Features diferentes.

As associações são percorridas na ordem em que o Manifest as declara, então a associação que uma mensagem nomeia primeiro é sempre a anterior no seu documento.

Mensagem emitida:

manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (as associações de anotação do manifest colidem no mesmo caminho+pilar da Feature (Manifest; as duas associações de anotação apontam para a Feature com um caminho que roteia para o pilar; apenas uma associação pode declarar um dado par (caminho, pilar) por Feature))

Como corrigir: decida qual associação é dona do destino e remova o caminho da lista maps.infra ou maps.values da outra, ou descarte a segunda associação por completo. Se as duas associações existem porque você queria que duas chaves de anotação chegassem a um único campo da Feature, mantenha uma associação e deixe as duas chaves de anotação serem roteadas por ela; se existem porque dois valores diferentes deveriam ir parar em dois lugares, corrija o caminho que foi escrito por engano.

A Release reached resolution without passing through the load path (Uma Release chegou à resolução sem passar pelo caminho de carregamento)

Uma Release chegou à resolução trazendo ao mesmo tempo uma superfície components: de nível superior não vazia e uma fronteira default sintetizada. Essa combinação não pode ser produzida por uma Release carregada normalmente: o caminho de carregamento incorpora um bloco components: de nível superior à fronteira padrão e o esvazia, e um documento que escreveu ambos explicitamente é recusado pelo seu esquema antes de chegar até aqui.

Portanto, esta interrupção não relata nada que você escreveu. Ela relata que algo chegou à resolução contornando o caminho de carregamento — na maioria das vezes, uma Release construída em memória por um programa que incorpora o compilador em vez de lida de um arquivo — e para ali em vez de deixar um build prosseguir sobre um documento cujas duas superfícies de componentes discordam. Lê-las em uma ordem ou na outra produziria uma saída que omite ou duplica componentes silenciosamente, e o percurso das fronteiras e o percurso por aresta nem sequer concordariam entre si sobre quais.

Mensagem emitida:

release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (a Release chegou à resolução sem normalização (componentes raiz não vazios ao lado de uma fronteira padrão sintetizada): construa as Releases pelo núcleo de normalização (types.NormalizeRelease pelo caminho de carregamento), não com um literal montado à mão)

Como corrigir: nada, se você está escrevendo YAML — chegar a esta interrupção a partir de aggrega build, aggrega validate ou do editor significa que o compilador tem um defeito que vale a pena relatar, e a Release que você estava compilando não tem culpa. Se você está incorporando o compilador e construindo um valor Release no seu próprio código, construa-o pelo caminho de carregamento em vez de montar a struct diretamente, para que seja executada a normalização que incorpora os componentes raiz à fronteira padrão.

A library reference expands into itself (Uma referência de biblioteca se expande em si mesma)

Uma cadeia de referências entre documentos volta a um documento que já alcançou, então expandi-la nunca terminaria. Duas superfícies de autoria chegam à mesma condição, e ambas são cadeias entre entidades de biblioteca, não algo dentro de um único arquivo: um $ref: de um pilar de esquema para uma entrada de uma SchemaLibrary que, de referência em referência, volta ao ponto de partida, e um $import: para uma entrada de uma MappingLibrary ou de uma WorkloadLibrary que faz o mesmo.

A cadeia é comparada por uma chave canônica — a identidade da biblioteca e o nome da entrada, sem host de registro nem grafia de versão — para que um ciclo não possa escapar da verificação nomeando a mesma entrada de duas formas diferentes ao longo do caminho. Uma referência que se expande e termina não é problema, quantas vezes apareça e por mais profunda que seja a cadeia; a profundidade sozinha nunca causa esta interrupção, e reutilizar uma entrada de biblioteca a partir de muitos lugares é o padrão para o qual as bibliotecas existem.

Mensagem emitida, para uma cadeia $import:, que nomeia o laço inteiro na ordem em que foi percorrido, para que você veja qual passo o fecha:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> (expansão circular de referências)

Uma cadeia $ref: é relatada, em vez disso, pelo compilador da forma compacta, que a enquadra com o documento e a palavra-chave que estava lendo:

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> (compactform, palavra-chave: expansão circular de $ref entre documentos)

Como corrigir: leia a cadeia na mensagem e quebre-a no passo que não era intencional. Um ciclo geralmente significa que duas entradas de biblioteca foram escritas, cada uma, para estender a outra; reúna a parte comum em uma terceira entrada à qual ambas façam referência, ou incorpore-a em uma delas. O último passo mostrado é o que fechou o laço, mas não é necessariamente o errado — a cadeia inteira é impressa justamente porque qual elo cortar é decisão sua.

A mesma condição também sustenta a recusa por recursão de âncora documentada acima em “YAML anchor aliased inside its own content (Âncora YAML referenciada por um alias dentro do seu próprio conteúdo)”. Aquela é um laço dentro do próprio texto de um único documento; esta é um laço entre documentos. A cadeia na mensagem distingue as duas num relance: um laço entre documentos nomeia entradas de biblioteca, e um laço dentro de um documento nomeia uma âncora.

A declared schema cannot be resolved (Um esquema declarado não pode ser resolvido)

Um esquema chegou ao ponto de ser usado para validar algo e não pôde ser montado como esquema. A causa mais comum é um $ref: que não nomeia nada resolvível; um esquema que não satisfaz o metaesquema do JSON Schema chega à mesma interrupção, assim como um ramo then: ou else: sob uma palavra-chave condicional que não pode ser resolvido por si só.

A recusa acontece antes de qualquer coisa ser validada contra o esquema, e essa ordem é o ponto central. Ignorar um esquema ilegível deixaria sem validação tudo o que ele cobre enquanto o build relata sucesso — uma verificação que parou de rodar sem nada que diga que ela parou.

Mensagem emitida, que nomeia a posição dentro do esquema, a palavra-chave que não pôde ser resolvida e o que a resolução relatou:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (validator/jsonschema: falha na resolução do esquema (posição, palavra-chave))

Quando a falha está na raiz do esquema, e não em uma palavra-chave dentro dele, a posição e a palavra-chave são omitidas e a frase traz apenas o motivo relatado.

Como corrigir: abra o esquema na posição que a mensagem nomeia. Um $ref: é o culpado habitual: confirme que o destino existe, que uma referência interna ao documento escreve exatamente seu caminho #/$defs/… e que uma referência entre documentos nomeia uma entrada de SchemaLibrary que o fechamento de dependências do build realmente contém. Quando a mensagem nomeia um ramo then: ou else:, esse ramo é um esquema por si só e precisa ser resolvível em seus próprios termos.

An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Não é possível avaliar um predicado)

Um esquema declara uma das duas palavras-chave de extensão cujo valor é um template, e o template não pôde ser usado: não é uma string, não é analisado como template, falhou durante a execução ou produziu algo diferente de true ou false.

x-aggrega-when: decide se um ramo condicional de um esquema se aplica; x-aggrega-validate: decide se um valor satisfaz uma regra que as próprias palavras-chave do esquema não conseguem expressar. Ambas são lidas como veredictos, e é por isso que um resultado que não seja um veredicto é recusado em vez de interpretado: um predicado que produzisse uma string vazia seria lido como falso e aposentaria silenciosamente a regra que ele foi escrito para impor.

Mensagem emitida:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: falha na avaliação da extensão x-aggrega)

com "x-aggrega-when" no lugar da palavra-chave quando o predicado da condicional é o que está com falha, e o motivo relatado nomeando o erro do template — uma posição de análise, uma função ausente ou o valor não booleano que o template produziu.

Como corrigir: abra o esquema na posição que a mensagem indica e leia o motivo relatado. Confirme que o valor da palavra-chave é uma string, que o template é analisado e que cada caminho que ele percorre existe de fato no valor sob validação — um predicado lê o valor como .value, e buscar qualquer outra coisa é o erro mais comum. Quando o motivo nomeia uma chave que index não encontrou, teste a chave com hasKey ou leia-a com get em vez disso: index para em uma chave que o mapa não contém, como descreve “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)” mais adiante. Certifique-se de que o template termine produzindo true ou false: uma comparação faz isso, enquanto um template que apenas renderiza o valor não faz.

A Workload does not satisfy the Workload schema (Um Workload não satisfaz o esquema Workload)

O bloco workload: de uma Recipe ou de uma FeatureRecipe foi lido e verificado em relação ao esquema Workload, e um ou mais campos não o satisfazem — uma chave com erro de grafia, um valor do tipo errado, um campo obrigatório omitido, um valor fora de um intervalo ou de uma enumeração declarados.

O relatório é agrupado: uma única interrupção traz todos os campos com falha, de modo que um Workload com quatro erros informa você sobre os quatro em um único build em vez de um por build. O cabeçalho nomeia o Workload, a Recipe que o declara e o arquivo; cada achado abaixo dele nomeia o caminho do campo dentro do Workload, o que o esquema exigia ali e a correção, quando é possível indicá-la.

Mensagem emitida:

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated> .initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated> (falha na validação da carga de trabalho (Workload na Recipe, etapa de esquema))

Uma falha sem detalhe por campo — o bloco não pôde ser lido de forma alguma, em vez de ser lido e considerado insuficiente — traz em vez disso o motivo inteiro como seu único achado.

Quando o template workload: lê um valor declarado sensível, nenhum achado cita um valor. Não é possível saber qual campo do documento renderizado veio desse valor, então cada achado cujo texto poderia conter um valor declara a restrição do esquema com <redacted> no lugar do valor, encerrado por um aviso que nomeia o motivo, e não traz nenhuma correção derivada do valor:

.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)

Um achado que não cita nenhum valor — uma chave ausente, uma chave que o Workload não admite — é lido como em qualquer outro template. Veja vocabulary/compact-form-authoring.md “O que uma recusa diz sobre um valor declarado”.

O build relata a interrupção sob uma tag CATALOG_ERROR, porque um bloco workload: é escrito pelo autor da Recipe e não pelo Aggregate ou pela Release.

Como corrigir: abra a Recipe nos caminhos de campo listados e corrija cada um. Os caminhos são dados a partir da própria raiz do Workload, então .containers.main.health.ready é o bloco ready sob a chave health do contêiner main. Um contêiner nomeado é endereçado pela sua chave e um contêiner de inicialização pela sua posição, e é por isso que os dois são lidos de forma diferente. O que cada campo aceita está na referência de autoria do Workload.

Um campo que o esquema quer como texto, recusado porque o valor é um número ou um booleano, quase sempre significa uma expressão de template sem aspas. Um bloco workload: é renderizado antes de ser verificado, então uma expressão escrita sem aspas se expande em texto puro e o YAML então lê esse texto como aquilo que ele parece ser. Uma quantidade de dimensionamento em núcleos inteiros, uma versão composta apenas de dígitos, uma porta e as palavras yes, no, on e off são todas lidas como algo diferente de texto. O achado informa qual tipo o YAML leu, e a solução é colocar a expressão entre aspas na Recipe — cpu: "{{ .infra.compute.cpu }}" em vez de cpu: {{ .infra.compute.cpu }} — para que o valor continue sendo texto, seja o que for que o operador forneça. Observe que o valor do próprio operador não é o problema aqui e que colocá-lo entre aspas na Release não muda nada: as aspas precisam estar na Recipe, em volta da expressão.

A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Uma vinculação de Workload nomeia um slot que a entidade não declara, ou uma entrega que o slot proíbe)

Uma entrada attachments: de um contêiner dentro de um bloco workload: se refere a um slot de vinculação, e a referência não corresponde aos slots que o Component ou a Feature declara em seu featuresSchema — ou, para uma entrada que nomeia uma conexão com connection:, aos slots que o socket dessa conexão declara. Uma entrada envFrom que nomeia uma conexão está sujeita às mesmas regras de conexão. O achado informa qual dessas formas você tem.

  • O slot não está declarado. O from: da entrada nomeia um slot que o featuresSchema da entidade não contém — um erro de digitação, ou um slot que foi renomeado de um lado só.
  • O slot é de caixa preta. O slot declara uma lista de permissões inject: vazia, que reserva a entrega à mecânica interna da própria Recipe. Um slot assim é preenchido e consumido internamente, então um Workload não pode acessá-lo.
  • A entrega está fora da lista de permissões do slot. O as: da entrada nomeia um mecanismo que a lista inject: do slot não permite.
  • A conexão não é uma das que o componente traça. O connection: da entrada nomeia um alias sob o qual nenhuma conexão do componente está escrita.
  • O socket da conexão não declara o slot. O from: da entrada (ou, em envFrom, secret:) nomeia um slot que o socket pelo qual essa conexão está cabeada não declara.
  • O slot está escrito com seu nome composto. O from: (ou secret:) da entrada é o nome que a vinculação de uma conexão assume no componente — o alias, um ponto e o slot — escrito sem connection:. O slot de uma conexão só é alcançado nomeando a conexão.

Todas as entradas com falha de todos os contêineres são relatadas juntas, de modo que um único build nomeia todas elas. Os achados são agrupados sob um único cabeçalho que nomeia o Workload, sua Recipe e o arquivo.

Mensagem emitida:

workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot> (falha na verificação cruzada do featuresSchema da carga de trabalho (Workload na Recipe, etapa featuresSchema): faz referência a um slot que não está declarado no featuresSchema do Component — declare o slot no featuresSchema do Component (ou da Feature), ou renomeie a referência para um slot existente; o slot é de caixa preta (sem lista de permissões) e não pode ser referenciado a partir de uma entrada attachments de um Workload — slots de caixa preta são entregues pela mecânica interna da Recipe; remova a referência do lado do Workload, ou amplie a lista de permissões inject do slot se a entrega do lado do Workload for pretendida; o mecanismo de entrega não é permitido pelo slot (lista de permissões inject) — use um dos mecanismos de entrega permitidos, ou amplie a lista de permissões inject do slot no featuresSchema do Component/Feature; nomeia uma conexão para o slot, mas o componente não traça nenhuma conexão sob esse alias — nomeie uma conexão que o componente trace, ou remova connection para ler um slot que o Component declara para suas próprias vinculações; nomeia um slot da conexão que o socket não declara — nomeie um slot que o socket declare, ou declare o slot no featuresSchema desse socket; nomeia o nome que o compilador compõe para um slot de uma conexão; um slot que o socket de uma conexão declara é nomeado nomeando a conexão — escreva connection: ao lado de from:)

Em uma entrada envFrom, os mesmos achados ficam em .containers.<name>.envFrom[<i>].connection e .containers.<name>.envFrom[<i>].secret.

Como corrigir: cada achado nomeia os dois lados, então a escolha é qual lado alterar. Para um slot não declarado, corrija a grafia de from: ou declare o slot no featuresSchema da entidade — o sufixo .from do caminho do campo aponta para a referência. Para um slot de caixa preta, remova a referência do lado do Workload e deixe a Recipe entregar o material, a menos que a entrega do lado do Workload seja realmente desejada, caso em que você deve dar ao slot uma lista de permissões inject:. Para um mecanismo recusado, troque as: por um que a lista de permissões nomeia, ou adicione o seu a ela. Para uma conexão que o componente não traça, corrija o alias para um dos que o achado lista, ou trace a conexão no Aggregate ou na Release. Para um slot que o socket não declara, nomeie um dos slots que o achado lista, ou declare o slot no featuresSchema do socket no Component. Para um nome composto, escreva a conexão e o slot separadamente, como o achado mostra.

A Workload references a slot whose fill publishes no locator (Um Workload faz referência a um slot cujo preenchimento não publica nenhum localizador)

Uma entrada attachments: de um contêiner nomeia um slot por referência, e a vinculação que preenche esse slot não publica as chaves provides que tal referência lê. Fazer referência a um slot pelo nome significa pedir que o recurso que ele representa seja endereçado na saída renderizada — pelo nome do recurso e pelo campo dentro dele. Um preenchimento que não publica nenhum dos dois não tem nenhum localizador para o qual apontar, então a referência não pode ser transformada em nada.

Quais chaves são exigidas depende da entrada, e o achado informa quais ele esperava. Uma entrada que nomeia sua própria key: fornece ela mesma o campo, então apenas o name do recurso precisa ser publicado — e é isso que permite que ela faça referência a um recurso com várias chaves. Uma entrada que não nomeia nenhuma key: lê o único campo publicado do slot, então tanto name quanto key precisam estar presentes.

A verificação lê apenas se as chaves estão presentes; ela nunca inspeciona seus valores. Todas as entradas com falha são relatadas juntas, sob um único cabeçalho.

Mensagem emitida:

workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference (o slot de vinculação da carga de trabalho não é referenciável (Workload na Recipe, etapa slotReferenceability): o slot não é referenciável: seus provides resolvidos não expõem a chave (uma referência de vinculação da carga de trabalho lê as chaves provides name e key) — faça referência a um slot preenchido por uma vinculação cujo schema.provides declare as chaves que esta referência lê, ou entregue-o pelo canal inject do slot em vez de por uma referência da carga de trabalho)

Como corrigir: duas direções, e qual é a certa depende do que você quis dizer. Quando a referência está correta, o que deve mudar é a vinculação que preenche o slot: vincule uma Feature cujo schema.provides declare name — e key, quando a entrada não nomeia uma própria — para que haja um localizador para o qual apontar. Quando o material nunca foi feito para ser endereçado pelo nome na saída, remova a referência e entregue-o em vez disso pelo canal inject: do slot, que transporta o valor em vez de um ponteiro para onde ele está.

A container gives one environment variable two values (Um contêiner dá dois valores a uma mesma variável de ambiente)

Um contêiner de um bloco workload: nomeia a mesma variável de ambiente duas vezes: uma vez como chave de suas variables e outra como chave de uma entrada attachments entregue as: env. São verificados tanto um contêiner principal quanto um contêiner de inicialização, igualmente no Workload que a Recipe de um componente renderiza e no Workload que uma FeatureRecipe renderiza — a vinculada a um componente e a declarada em uma fronteira — e a verificação lê o Workload tal como seu template o renderizou.

Por que o build é interrompido em vez de escolher um. O ambiente de um contêiner é escrito a partir dessas duas coleções em uma ordem fixa — os provedores helm e compose escrevem primeiro cada entrada lida de uma vinculação e depois as variables simples. Um nome escrito das duas formas chegaria, portanto, ao processo com o valor que essa ordem deixar prevalecer, o que é consequência de onde os dois tipos vão parar e não de algo que você escreveu, então o build recusa o par em vez de renderizá-lo. A verificação é executada uma única vez, seja qual for o provedor que renderiza o Workload, depois das demais verificações do Workload e antes que as entradas artifacts: sejam avaliadas ou que o Workload seja entregue a qualquer provedor, de modo que um par recusado nunca é renderizado. Uma entrada attachments entregue as: file é montada como arquivo em vez de ser definida no ambiente, então nunca forma um par.

A verificação compara apenas nomes; ela nunca lê um valor, então nenhum achado cita um. Dois tipos de entrada de ambiente ficam fora do que ela compara: uma entrada envFrom define as chaves do ConfigMap ou do Secret que nomeia, que não são conhecidas quando o build é executado, e uma entrada que uma etapa do pipeline escreve em um documento renderizado não faz parte do Workload que a verificação lê.

Cada par é um achado próprio, posicionado na chave workload: da Recipe ou FeatureRecipe que declara o Workload, e nomeia a variável e o contêiner — um contêiner principal pela sua chave, um contêiner de inicialização pela sua posição na lista initContainers. Os achados chegam primeiro para os contêineres principais, na ordem em que foram escritos, depois para os contêineres de inicialização por posição e, dentro de um contêiner, na ordem em que suas entradas attachments foram escritas.

Mensagem emitida, para um par em um contêiner principal do Workload de uma Recipe. A categoria e o código curto desta condição, E0345, chegam a você no cabeçalho entre colchetes, e a posição se lê <path> at .spec.workload:

a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (um contêiner declara uma mesma variável de ambiente duas vezes. Renomeie uma das duas ou escreva-as sob condições de template complementares para que apenas uma delas seja renderizada)

Um par em um contêiner de inicialização nomeia, em vez disso, sua posição na lista — init container "initContainers[<i>]" — e o achado de uma FeatureRecipe nomeia, depois do contêiner, a vinculação que a associa, attachment "<attachment>", porque um componente pode ter várias vinculações cujas FeatureRecipes são documentos separados.

Quando um Workload tem vários pares, os achados são agrupados sob uma linha que nomeia o documento: containers of the Workload this Recipe renders name one environment variable twice ou, para uma FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice.

O build relata a interrupção sob uma tag CATALOG_ERROR, porque um bloco workload: é escrito pelo autor da Recipe ou da FeatureRecipe e não pelo Aggregate ou pela Release.

Como corrigir: decida qual das duas o contêiner deve receber. Se você quer as duas, renomeie uma delas, para que o processo veja duas variáveis. Se forem alternativas — um valor de reserva simples para quando nenhuma credencial estiver vinculada, por exemplo — proteja-as com condições complementares para que exatamente uma seja renderizada: escreva a variável sob {{ if not (hasKey (default dict .features) "<slot>") }} e a entrada attachments sob {{ if hasKey (default dict .features) "<slot>" }}, ou sob os dois ramos de um mesmo {{ if }}/{{ else }}. Um par protegido dessa forma nunca chega à verificação, porque apenas uma das duas está no Workload renderizado.

A Release’s parameters: block is written in neither of its two shapes (O bloco de parâmetros de uma Release não está escrito em nenhuma de suas duas formas)

Uma Release atende aos parâmetros que um Aggregate declarou de uma de duas maneiras, e o bloco é lido pela sua forma. Ou é um mapeamento de nomes de parâmetros para valores escritos no próprio local, ou é um mapeamento de exatamente uma chave, $import:, cujo valor é o caminho de um arquivo YAML que contém esses valores. Um bloco que não é nenhum dos dois é recusado na leitura, antes que qualquer coisa compare os valores com as declarações do Aggregate.

Três formas são recusadas. Um valor parameters: que não é um mapeamento de forma alguma — um escalar ou uma lista. Um mapeamento que traz $import: ao lado de outras chaves, o que pede ao mesmo tempo os valores importados e os escritos e não dá nenhuma regra para combiná-los. E um $import: cujo valor não é uma string simples, que portanto não nomeia nenhum arquivo.

O schema da Release declara as mesmas duas formas, então um arquivo de Release que traga qualquer uma das três encontra primeiro a verificação do envelope do documento, sob E0215, que tenta as duas formas e diz por que cada uma falhou — aqui para uma lista:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (falha na validação do envelope do documento (Release); spec.parameters: nenhum ramo oneOf corresponde (2 ramos tentados): branch[0]: type: esperado object, obtido array; branch[1]: type: esperado object, obtido array. corrija o documento para que corresponda ao schema do seu tipo)

Para $import: ao lado de outra chave, o segundo ramo termina com additionalProperties: unexpected property: "<key>", e para um $import: escrito como lista em vez de string ele termina com validation: type: array has type "array", want "string".

Mensagem emitida quando o valor não é um mapeamento, nomeando o que foi escrito ali — a list, por exemplo:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: a forma deve ser um objeto inline ou {$import: caminho local}: na linha indicada há um valor escrito onde se espera um mapeamento)

e quando $import: divide o mapeamento com outra coisa, ou nomeia algo que não é um caminho:

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (parameters: a forma deve ser um objeto inline ou {$import: caminho local}: $import deve ser a única chave, foram encontradas várias chaves na linha indicada) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: a forma deve ser um objeto inline ou {$import: caminho local}: o valor de $import deve ser um escalar string na linha indicada)

Como corrigir: abra a Release na linha que a mensagem indica. Escreva os valores no próprio local sob parameters:, ou substitua o bloco inteiro por uma única entrada $import: cujo valor seja um caminho entre aspas. Se você queria valores escritos e um arquivo importado de valores padrão compartilhados, mova os escritos para uma Release que, com extends:, estenda a que contém a importação — sobrepor várias fontes de parâmetros é justamente a função de uma cadeia extends:, e esta única chave é lida de uma só fonte por design.

An inline-or-import field is written in neither shape (Um campo inline ou de importação não está escrito em nenhuma das duas formas)

Três campos que uma Recipe ou FeatureRecipe escreve — uma entrada artifacts.<name>:, um valuesMapping: e um workload: — aceitam as mesmas duas formas. Ou o corpo é escrito no próprio local, como escalar string (um bloco | é a grafia habitual para qualquer coisa com várias linhas), ou o valor é um mapeamento de exatamente uma chave, $import:, que nomeia em vez disso onde o corpo está. O que um $import: pode nomear varia conforme o campo: uma entrada de artifacts importa um caminho local ou um bundle de uma ArtifactLibrary, enquanto valuesMapping: e workload: importam um caminho local ou uma entrada de uma biblioteca por identidade.

Um único leitor verifica os três, então as recusas são as mesmas três seja qual for o campo com erro: um mapeamento que traz mais de uma chave, um mapeamento cuja única chave não é $import e um $import: cujo valor não é uma string simples. Um valor que não é nem um escalar nem um mapeamento — na maioria das vezes, uma lista — é recusado apenas pela sua forma.

Os schemas de Recipe e FeatureRecipe declaram as mesmas duas formas para cada um dos três campos, então um arquivo que traga qualquer um desses casos encontra primeiro a verificação do envelope do documento, sob E0215, que nomeia o campo e diz por que cada forma falhou — o primeiro ramo é a forma escrita no próprio local, o segundo a de $import::

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (falha na validação do envelope do documento (Recipe); spec.artifacts: nenhum ramo oneOf corresponde (2 ramos tentados): branch[0]: validação: type: object tem o tipo “object”, esperado “string”; branch[1]: additionalProperties: propriedade inesperada. corrija o documento para que corresponda ao schema do seu tipo)

Isso é um mapeamento que traz uma chave ao lado de $import:. Uma única chave que não é $import termina com required: missing required property: $import, additionalProperties: unexpected property: "<key>", uma lista termina com type: expected object, got array, e um $import: que não é uma string nomeia o tipo encontrado onde se esperava uma string, como em type: array has type "array", want "string".

Mensagens emitidas. Cada uma começa com a frase do campo com erro e depois diz o que o leitor encontrou e onde:

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (entrada de artifacts: a forma deve ser um escalar string ou {$import: caminho local}: foram encontradas várias chaves na linha indicada) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: a forma deve ser um escalar string ou {$import: caminho ou identidade de biblioteca}: foi encontrada outra chave na linha indicada) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: a forma deve ser um escalar string ou {$import: caminho ou identidade de biblioteca}: o valor de $import deve ser um escalar string na linha indicada)

Qualquer um dos três campos pode relatar qualquer um desses finais; um valor que não tem nenhuma das duas formas termina com line <line>: <shape> is written where text or a map is expected, nomeando o que foi escrito — na maioria das vezes, a list.

Como corrigir: abra a entidade na linha que a mensagem indica. Escreva o corpo no próprio local como escalar de bloco, ou substitua o valor inteiro por uma única entrada $import:. Um mapeamento que traz $import: e qualquer outra coisa não é nenhuma das duas formas — mova as chaves extras para dentro do arquivo importado, ou escreva o corpo no próprio local. Um $import escrito errado — na maioria das vezes, falta o $ — é lido como uma chave comum e relatado como a única chave que não é $import.

A reference to a library entry carries whitespace (Uma referência a uma entrada de biblioteca contém espaços em branco)

Uma referência que nomeia uma entrada dentro de uma biblioteca é escrita como um único token ininterrupto: a biblioteca, uma versão mínima :<version> opcional, depois # e o caminho da entrada — BaseWorkloads:1.0.0#/workloads/StatelessService. Nenhuma parte dela admite espaços em branco. Os nomes de biblioteca e os nomes de entrada são ambos restritos pelos schemas de biblioteca a grafias de identificador, e uma versão é uma versão, então um espaço, uma tabulação ou uma quebra de linha em qualquer ponto de uma referência não pertence a nenhuma das três partes.

A recusa cobre toda superfície que endereça uma entrada de biblioteca por identidade: um valuesMapping:, um workload: e uma entrada artifacts.<name>: escritos como $import:, e um $ref: de schema. Um caminho local escrito como $import: não traz # e não é uma referência a uma entrada de biblioteca, então um caminho com um espaço não é afetado.

O que faz valer a pena recusar em vez de arrumar é que a parte inicial de um valor assim costuma ser uma referência por si só. Cortar no espaço em branco resolveria essa referência e descartaria silenciosamente o resto do que o autor escreveu — e as duas metades de um build não precisam descartar a mesma quantidade, então uma poderia registrar uma dependência que a outra nunca viu. Recusar mantém o valor significando uma única coisa.

A recusa é relatada na linha do documento de onde a referência foi lida:

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (referência de biblioteca: uma referência a uma entrada de biblioteca não contém espaços em branco nem quebras de linha: destino de $import na linha indicada)

Uma referência chega a um build por mais um lugar: o corpo de uma entrada de biblioteca que um build já resolveu, em que um $import: na raiz do campo, na primeira linha, aponta para a entrada de outra biblioteca. Essa referência nunca foi lida de um documento que o build abriu, então é relatada sem linha:

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (referência de biblioteca: uma referência a uma entrada de biblioteca não contém espaços em branco nem quebras de linha)

Como corrigir: abra a entidade na linha que a mensagem indica e junte a referência para que ela seja um único token. Uma quebra de linha antes do # é a causa habitual — uma referência quebrada em duas linhas para caber em uma coluna é um único valor para o YAML e uma referência quebrada aqui, então escreva-a em uma única linha, por mais longa que fique. A outra é um espaço final antes da aspa de fechamento: ele fica dentro da versão mínima, onde nomeia uma versão que nenhum artefato publicado tem. Na segunda forma, a referência está dentro da biblioteca nomeada logo antes dela na mensagem; corrija-a onde essa biblioteca declara a entrada.

A library entry’s body is not the shape that library holds (O corpo de uma entrada de biblioteca não tem a forma que essa biblioteca contém)

Uma biblioteca publica corpos nomeados para outras entidades importarem, e cada tipo de biblioteca contém uma única forma. Uma entrada de MappingLibrary e uma entrada de WorkloadLibrary contêm cada uma um corpo de template, então o valor da entrada é um escalar — na prática, um bloco |. Uma entrada de ArtifactLibrary contém um bundle: os arquivos que ficam juntos sob um mesmo nome, então a entrada é um mapeamento do nome do arquivo de saída para o corpo desse arquivo, e cada corpo sob ela é um escalar.

Os corpos são capturados exatamente como foram escritos e não são analisados quando a biblioteca é carregada. O template contido em um corpo é analisado onde é importado, e é por isso que aqui se verifica apenas a forma — um corpo que não é um template de forma alguma é carregado sem reclamações e falha no ponto em que algo o renderiza.

Mensagens emitidas, cada uma nomeando a linha e o que foi escrito ali — a list, por exemplo:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: o corpo da entrada deve ser um escalar string: na linha indicada há um valor escrito onde se espera texto) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: o corpo da entrada deve ser um escalar string: na linha indicada há um valor escrito onde se espera texto) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: a entrada deve ser um mapeamento do nome de arquivo para um corpo string: na linha indicada há um valor escrito onde se espera um mapeamento)

e, para um bundle cuja entrada é um mapeamento mas um de cujos arquivos não é um escalar, nomeando o arquivo:

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: a entrada deve ser um mapeamento do nome de arquivo para um corpo string: no arquivo e na linha indicados há um valor escrito onde se espera texto)

O build relata esses erros sob uma tag CATALOG_ERROR que nomeia o arquivo que estava lendo, com a frase acima logo abaixo.

Como corrigir: escreva o corpo como escalar de bloco sob sua chave. Um corpo cuja primeira linha parece uma chave YAML — o que um template que produz YAML costuma ter — é lido como um mapeamento aninhado se o escalar de bloco não estiver lá, e essa é a causa comum. Para uma ArtifactLibrary, escreva uma chave por nome de arquivo de saída, com cada corpo como seu próprio escalar de bloco; um bundle escrito como um único corpo é o outro erro de forma comum.

A $instantiate: reference cannot be resolved (Não é possível resolver uma referência)

Uma SchemaLibrary pode declarar estruturas reutilizáveis em spec.templates, cada uma com seus próprios $params, e uma entrada de esquema então instancia uma delas nomeando-a em $instantiate: e fornecendo seus parâmetros em $args:. A substituição é literal: um escalar $<name> no corpo do template é substituído pelo valor do argumento. Não há avaliação de expressões, nem condicionais, nem laços, e um valor substituído é inserido como está, em vez de ser examinado em busca de outros marcadores.

Três falhas levam à recusa da instanciação. O nome em $instantiate: não é um dos que a biblioteca declara. Um parâmetro que o template declara sem um default: não tem nenhuma entrada em $args:. Ou o valor de um argumento não é do tipo que seu parâmetro declara — e uma chave de $args: que não nomeia nenhum parâmetro declarado é relatada da mesma forma, em vez de ser ignorada, de modo que um nome de argumento digitado errado é uma recusa em vez de um parâmetro que assume silenciosamente o valor padrão.

Mensagens emitidas:

schemalibrary: template not found: "<template-name>" not declared in spec.templates (schemalibrary: template não encontrado: não declarado em spec.templates) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (schemalibrary: parâmetro do template ausente) schemalibrary: template parameter type mismatch: <what the type check found> (schemalibrary: tipo do parâmetro do template incompatível) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (schemalibrary: tipo do parâmetro do template incompatível: o argumento não está declarado nos $params do template)

Como corrigir: para um template não encontrado, corrija o nome para um que a biblioteca declare em spec.templates — e verifique se você está importando a biblioteca que pretendia. Para um parâmetro ausente, adicione-o a $args:, ou dê ao parâmetro um default: no template para que quem o chama possa omiti-lo. Para uma incompatibilidade de tipo, altere o argumento para o tipo declarado ou amplie o type: do parâmetro; quando a mensagem nomeia um argumento não declarado, corrija sua grafia ou remova-o.

A schema uses a JSON Schema keyword the library does not admit (Um esquema usa uma palavra-chave de JSON Schema que a biblioteca não admite)

$dynamicAnchor e $dynamicRef não são admitidos no conteúdo de uma SchemaLibrary. Eles adiam a decisão sobre a qual esquema uma referência é resolvida até o momento em que o valor é validado, o que faz o significado de uma entrada de biblioteca depender de onde ela foi importada em vez do que ela diz — e o compilador resolve as estruturas de uma biblioteca antes de qualquer validação, então não há nada contra o qual uma referência adiada possa ser resolvida.

A recusa é aplicada em três pontos, que juntos fecham os dois caminhos pelos quais a palavra-chave poderia chegar. Uma entrada de esquema é examinada quando a biblioteca é carregada. O corpo de um template é examinado quando a biblioteca é carregada, de modo que um template que contém literalmente a palavra-chave falha nesse ponto, e não no primeiro build que o instancia. E o corpo substituído é examinado novamente após uma instanciação, de modo que fornecer a palavra-chave como valor de um argumento não passa pelas duas primeiras verificações.

Mensagem emitida:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (schemalibrary: palavra-chave de JSON Schema proibida, na linha indicada)

Como corrigir: substitua a referência adiada por um $ref que nomeie diretamente uma entrada de $defs. Onde a estrutura realmente varia a cada uso, expresse a variação como um template com $params e instancie-o a cada uso — essa é a substituição que esta superfície oferece, e ela é resolvida antes que qualquer coisa seja validada contra o resultado.

A document nests deeper than the reader will descend (Um documento se aninha mais fundo do que o leitor desce)

Todo mapeamento escrito pelo autor é lido em uma estrutura que preserva a ordem em que suas chaves foram escritas, porque essa ordem chega à saída renderizada e faz parte do que torna um build idêntico byte a byte entre execuções. Esse leitor desce um número limitado de níveis — cem — e se recusa a ir mais fundo, de modo que uma entrada que de outra forma esgotaria a própria pilha do leitor é relatada como a recusa que é.

Mensagem emitida:

a document nests too many levels deep: it is read at most 100 levels deep (um documento se aninha em níveis demais: ele é lido até no máximo 100 níveis de profundidade)

Como corrigir: documentos realmente escritos por um autor se aninham em poucos níveis, então um documento que chega a cem é gerado, traduzido automaticamente ou acidentalmente autorreferente. Procure um valor que se expandiu em si mesmo — uma âncora YAML que referencia o conteúdo dentro do qual está é recusada por sua própria interrupção mais acima, mas um gerador que emite repetidamente a mesma estrutura não é. Onde a profundidade é real, extraia o ramo profundo para uma entidade própria e referencie-a pelo nome.

A provider declares a well-known annotation at a scope it does not render (Um provedor declara uma anotação well-known em um escopo que ele não renderiza)

Um Plugin que atende a um provedor diz duas coisas sobre si mesmo que precisam concordar. Em spec.provider.wellKnownAnnotations ele lista as anotações sobre as quais atua, cada uma com os escopos em que as lê. Em contract.inputKinds ele diz quais tipos de entrada renderiza. Uma chave declarada em um escopo cujo tipo de entrada a mesma entidade não reivindica significa que essas duas afirmações se contradizem em um único arquivo, então a entidade é recusada ao ser carregada.

A verificação é uma comparação da entidade consigo mesma, e é por isso que ela não precisa de nenhum binário do plugin e é acionada onde quer que a entidade seja lida — inclusive em um percurso do catálogo em uma máquina que nunca baixou o artefato.

Duas entradas deliberadamente não são comparadas. Uma entrada com escopo de fronteira não nomeia nenhum tipo de entrada, porque é resolvida uma única vez para uma fronteira inteira, e não no caminho de renderização de um nó específico. Uma entrada que não declara nenhum escopo não faz nenhuma afirmação por caminho: ela diz apenas que o plugin lê a chave em algum lugar.

O que a recusa não estabelece é que uma declaração que permanece seja verdadeira. Nada pode provar que o plugin que atende a um provedor lê uma chave que diz ler; o que uma comparação de dois campos escritos pelo autor pode fazer é recusar o par que não pode ser verdadeiro nos dois termos. Uma chave declarada em um escopo que o provedor de fato renderiza, cujo plugin não lê nada ali, passa aqui.

Mensagem emitida:

provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render (o provedor declara uma anotação well-known em um escopo, mas seu contract.inputKinds não está reivindicado; declare a chave apenas em um escopo que o provedor renderiza, ou reivindique o tipo de entrada: wellKnownAnnotations: uma chave está declarada em um escopo que o contrato do provedor não renderiza)

Como corrigir: a mensagem nomeia as duas metades. Remova esse escopo da lista scope: da anotação, deixando os escopos que o provedor de fato renderiza, ou reivindique o tipo de entrada em contract.inputKinds se o provedor realmente o renderiza.

A compact-form schema uses a keyword the compact form does not know (Um esquema em forma compacta usa uma palavra-chave que a forma compacta não conhece)

Um esquema escrito na forma compacta contém uma chave que não é nem uma palavra-chave da forma compacta, nem uma das palavras-chave de JSON Schema que a forma repassa, nem um dos três marcadores que a forma reserva — $jsonschema:, $mode: e $ref:. Chaves desconhecidas são recusadas na leitura do esquema em vez de descartadas, porque uma restrição digitada errado que é ignorada se torna restrição nenhuma, e um esquema que parece aplicado e não aplica nada é pior do que um que falha.

A recusa ocorre onde quer que um esquema seja compilado. As entradas de uma SchemaLibrary são compiladas quando o catálogo é carregado; o spec.schema de um Component, seus valueSchema e infraSchema por socket, e os esquemas que uma Feature e um Plugin provedor declaram são compilados quando o catálogo é lido. O spec.schema de um Component ou de uma Feature relata essa condição por conta própria, nomeando a entidade e o campo; o valueSchema ou o infraSchema de um socket a relata dentro de “A declared schema contract cannot be read as a schema (Um contrato de esquema declarado não pode ser lido como esquema)” mais abaixo, trazendo a frase citada aqui como detalhe.

A própria frase do compilador da forma compacta nomeia a posição dentro do esquema, a linha de origem e a chave que ele não reconheceu:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (compactform: palavra-chave desconhecida)

Uma chave escrita ao lado de um $ref: entre documentos é relatada sob a mesma condição, com uma frase própria, porque apenas três chaves irmãs podem acompanhar uma referência desse tipo:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (compactform: chave irmã de um $ref entre documentos não permitida (permitidas: properties, required, description))

e, quando essa chave irmã pedia para reabrir a estrutura mesclada, a frase traz em vez disso a maneira de fazê-lo:

compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties (compactform: chave irmã de um $ref entre documentos não permitida (permitidas: properties, required, description); use $jsonschema: para incorporar um esquema de objeto aberto se a estrutura mesclada precisar aceitar propriedades arbitrárias)

A condição sob a qual ela é registrada é compactform: unknown keyword, que é aquilo a que seu código curto se resolve.

Como corrigir: corrija a chave na posição que a frase nomeia, de acordo com o vocabulário de palavras-chave em compact-form-authoring.md — um erro de digitação é a causa mais comum. Onde a estrutura realmente precisa de uma palavra-chave de JSON Schema que a forma compacta não traz, escreva esse fragmento em $jsonschema:, que incorpora JSON Schema literalmente. Ao lado de uma referência entre documentos, mantenha apenas properties:, required: e description:; todo o resto pertence à entrada de biblioteca para a qual a referência aponta.

A compact-form schema declares a field literally named type (Um esquema em forma compacta declara um campo chamado literalmente assim)

A forma compacta decide o que um mapeamento significa a partir da estrutura do seu conteúdo: uma chave type: marca uma folha de restrição, palavras-chave estruturais de JSON Schema marcam um fragmento a repassar, e um mapeamento de nomes simples marca um objeto cujos filhos são esquemas. Um esquema que declara um campo chamado type é a única estrutura que essas leituras não conseguem distinguir — parece uma folha de restrição e pretende ser um objeto com um único campo —, então a forma pede ao autor que diga qual, com uma chave $mode: definida como compact ou jsonschema.

Esta condição é o que um $mode: escrito com qualquer outro valor relata. O marcador existe para resolver a ambiguidade, então um valor que não resolve nada é recusado em vez de adivinhado.

A própria frase do compilador da forma compacta:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (compactform: o valor deve ser um dos dois indicados)

A condição sob a qual ela é registrada é compactform: ambiguous dispatch — $mode required, que é aquilo a que seu código curto se resolve.

Como corrigir: defina $mode: compact onde o mapeamento é um objeto em forma compacta cujos campos por acaso incluem um chamado type, ou $mode: jsonschema onde o mapeamento é um fragmento de JSON Schema a ser tomado como está escrito. Onde nenhuma das duas leituras era a pretendida, renomear o campo elimina a ambiguidade sem marcador algum.

A $jsonschema: escape carries content that is not a schema (Um escape contém um conteúdo que não é um esquema)

A chave $jsonschema: incorpora literalmente um fragmento de JSON Schema, para estruturas que a forma compacta não expressa. O que ela incorpora é tomado como está escrito e nunca é traduzido, então precisa ser um esquema: um escalar de bloco que seja analisado como YAML, ou um mapeamento aninhado. Um conteúdo que não é nenhum dos dois é recusado aqui em vez de ser repassado para servir de base a uma validação, onde a falha seria relatada contra o consumidor do esquema em vez de contra o esquema.

Quatro estruturas são relatadas sob esta condição, e a frase diz qual você tem. O corpo de escape não é analisado como YAML. O valor do escape não é nem um escalar de bloco nem um mapeamento. Uma chave properties: contém algo que não é um mapeamento de nomes para esquemas. E, no nível mais externo, o documento entregue ao compilador está vazio ou contém um nó para o qual o leitor não tem regra.

As próprias frases do compilador da forma compacta:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (compactform: o conteúdo do escape não é analisado como YAML) compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (compactform: esperava-se uma string escalar de bloco ou um mapeamento aninhado) compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (compactform: esperava-se um mapeamento de nomes de propriedades para esquemas) compactform: unsupported YAML node kind (compactform: tipo de nó YAML não suportado)

A condição sob a qual ela é registrada é compactform: $jsonschema content invalid, que é aquilo a que seu código curto se resolve.

Como corrigir: escreva o corpo de escape como escalar de bloco em $jsonschema: — caso contrário, um corpo cuja primeira linha é lida como uma chave YAML é absorvido pelo mapeamento ao redor, que é a causa comum — e verifique se o que ele contém é JSON Schema válido por si só. Onde o fragmento era pequeno o bastante para ser expresso na forma compacta, remover o escape é a resposta mais simples.

A compact-form constraint does not apply to the type it was written on (Uma restrição em forma compacta não se aplica ao tipo em que foi escrita)

As restrições em forma compacta são despachadas pelo tipo declarado do campo: min: e max: tornam-se um limite numérico em um número, um limite de comprimento em uma string e um limite de quantidade em um array. Portanto, uma restrição precisa estar em um campo cujo tipo a aceite, e o tipo precisa ser um único valor para que o despacho tenha alguma resposta.

Quatro estruturas são relatadas sob esta condição. Uma restrição escrita onde type: está ausente ou nomeia uma união, de modo que nada decide qual limite se pretendia. Uma restrição escrita em um tipo que não aceita nenhum limite desse gênero — um objeto, ou um booleano. Um type: cujo valor não é nem um nome escalar nem uma sequência de nomes. E um valuesType: que recebe algo diferente de um nome escalar.

As próprias frases do compilador da forma compacta:

compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint (compactform: a restrição se aplica a um único tipo declarado (integer/number/string/array); o tipo não está resolvido (união ou ausente) — restrinja o tipo a um único valor ou remova esta restrição) compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (compactform: a restrição se aplica a integer/number/string/array; o tipo declarado é o indicado) compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind (compactform: esperava-se um nome de tipo escalar ou uma sequência de nomes de tipo (array de tipos do JSON Schema 2020-12); obteve-se um tipo de nó não suportado) compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name (compactform: esperava-se um nome de tipo escalar)

A condição sob a qual ela é registrada é compactform: constraint not valid for declared type, que é aquilo a que seu código curto se resolve.

Como corrigir: a frase nomeia as duas metades — a restrição e o tipo que ela encontrou. Restrinja type: a um único nome onde ele contém uma união, adicione-o onde está ausente, ou remova a restrição onde o campo realmente aceita qualquer um de vários tipos. Um limite que precisa variar com o tipo é expresso como um conjunto de alternativas em $jsonschema:, onde cada ramo traz seu próprio tipo e seu próprio limite.

A $ref: is not written in a form the compiler can resolve (Uma referência não está escrita em uma forma que o compilador consiga resolver)

Um esquema referencia outra estrutura com $ref:, seja dentro do mesmo documento, seja entre documentos para uma entrada de uma SchemaLibrary. Duas condições cobrem as duas maneiras pelas quais uma referência falha, e a frase diz qual é o seu caso: a referência não está escrita em uma forma que o compilador lê, ou está bem formada e nomeia um destino que não existe.

A referência não é legível. O valor está vazio, ou sua forma entre documentos não é <Library>#/schemas/<Entry>, ou ele separa a versão com @ — o que é relatado com a grafia corrigida em vez de uma reclamação genérica, porque é o erro que essa forma mais atrai:

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL (compactform: era esperada uma URL de referência não vazia) compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> (compactform: um $ref entre documentos deve ter a forma indicada) compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written> (compactform: o separador de versão de um $ref entre documentos é ’:’, não ’@’ — use o valor corrigido)

A condição sob a qual eles são registrados é compactform: $ref unresolvable.

O destino não existe. A referência é lida corretamente e a biblioteca, ou a entrada dentro dela, está ausente — ou nenhum catálogo de bibliotecas foi fornecido para resolvê-la:

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> (compactform: SchemaLibrary não encontrada no catálogo) compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> (compactform: entrada não encontrada na SchemaLibrary) compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written> (compactform: $ref entre documentos, mas nenhum catálogo de SchemaLibrary fornecido)

A condição sob a qual eles são registrados é compactform: cross-document $ref target not found.

Manter os dois separados é o que torna o relatório acionável: o primeiro é um valor a reescrever no documento que você está vendo, e o segundo é uma pergunta sobre o que o build consegue ver. Uma referência que se expande em si mesma é ainda uma terceira coisa, e é relatada como “A library reference expands into itself (Uma referência de biblioteca se expande em si mesma)” acima.

Como corrigir: para uma referência ilegível, reescreva o valor — <Library>#/schemas/<Entry> para uma referência entre documentos, #/$defs/<name> para uma dentro do mesmo documento — e use : antes de uma versão mínima em vez de @. Para um destino ausente, confirme o nome da entrada com a biblioteca que a publica, e confirme que a biblioteca é alcançável a partir do fechamento de dependências da Release: uma biblioteca da qual nada declara depender não é carregada, então uma referência correta a ela ainda não resolve para nada.

Quando a biblioteca está apenas no cache de artefatos. O cache contém o que foi baixado para lá, e uma biblioteca em cache conta como conteúdo de catálogo apenas onde uma entrada no arquivo de bloqueio da Release garante seu digest. Quando o cache contém uma SchemaLibrary que nenhuma entrada do arquivo de bloqueio fixa e que nenhum diretório de catálogo fornece, o relatório é seguido de uma linha remediation: que nomeia cada uma dessas bibliotecas e a ação que funciona para o comando que a relatou:

  • aggrega build e aggrega validate --release leem o arquivo de bloqueio da Release, então a linha deles nomeia aggrega pull --release <release>, que resolve a biblioteca e registra sua entrada, ou a escrita da biblioteca sob um diretório de catálogo.
  • aggrega validate sem argumentos, e aggrega validate com o caminho de uma entidade, com ou sem --release, leem bibliotecas apenas de diretórios de catálogo e não leem nenhum arquivo de bloqueio, então uma entrada registrada não mudaria o veredito deles. A linha deles diz isso, e aponta para a escrita da biblioteca sob um diretório de catálogo, ou para aggrega pull --release <release> seguido de aggrega validate --release <release>, que verifica a Release em relação às bibliotecas que seu arquivo de bloqueio fixa.

Um pull que não encontra tal biblioteca relata isso em A reference names no entity the catalog holds (Uma referência não nomeia nenhuma entidade que o catálogo contenha), com uma linha própria.

A $ref: addresses a library by registry location (Uma referência endereça uma biblioteca pela sua localização no registro)

Um $ref: entre documentos nomeia sua biblioteca pela identidade — o nome simples da biblioteca, depois # e o caminho da entrada — e nunca pelo registro em que ela por acaso está publicada. Por qual registro um nome é resolvido é configuração do espaço de trabalho, e qual versão é usada é a resposta do arquivo de bloqueio, então uma referência que carrega um host fixaria no esquema duas coisas que cabe ao build decidir, e moveria o esquema entre espaços de trabalho como uma referência quebrada.

Onde o valor que carrega o host ainda pode ser decomposto em uma biblioteca e uma entrada, a frase traz a grafia em forma de identidade a ser usada no lugar:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written> (compactform: o $ref entre documentos carrega um host de registro; referencie a biblioteca pela identidade)

e onde não pode, a frase termina após o valor:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written> (compactform: o $ref entre documentos carrega um host de registro; referencie a biblioteca pela identidade)

A condição sob a qual ele é registrado é compactform: cross-document $ref carries a registry host; reference the library by identity, que é aquilo para o qual seu código curto é resolvido.

Como corrigir: remova o host e tudo antes do nome da biblioteca, deixando <Library>#/schemas/<Entry>. Onde se deseja uma versão mínima, escreva-a após o nome da biblioteca como :<version>. A mesma regra rege os campos $import: em uma Recipe e em uma FeatureRecipe, que são relatados separadamente em “A library $import: addresses its library by registry location (Uma importação de biblioteca endereça sua biblioteca pela localização no registro)” abaixo.

A schema $import: cannot be applied (Uma importação de esquema não pode ser aplicada)

O spec.schema de um Component ou de uma Feature — seu bloco inteiro ou um de seus pilares — e o valueSchema: ou o infraSchema: de um socket usesSchema podem cada um ser escritos como $import: nomeando um arquivo ao lado da entidade. A importação é aplicada quando a entidade é carregada, então todo leitor posterior vê o contrato importado em vez do ponteiro. Esta condição é o que acontece quando a falha está em algo que você escreveu: a própria diretiva, ou a estrutura do que o arquivo que ela nomeia acabou contendo.

Essas falhas são uma única condição porque cada uma deixa a mesma superfície inutilizável e dá a você a mesma coisa a fazer — corrigir a diretiva, ou o arquivo que ela nomeia. O diagnóstico começa com a frase fixa e depois diz qual é a falha, então a frase é a parte com a qual fazer a correspondência e a oração seguinte é aquilo sobre o que agir:

a schema $import: could not be applied. <surface>: <the clause for this occurrence> (não foi possível aplicar uma importação de esquema)

A oração nomeia a superfície que leu — spec.schema, um de seus pilares como spec.schema.values, ou o valueSchema de um socket — seguida da falha específica. As falhas, e o que cada uma significa:

  • $import: must be the only key when a schema is imported from a file. (A importação deve ser a única chave quando um esquema é importado de um arquivo.) A diretiva compartilha seu mapeamento com conteúdo de esquema escrito pelo autor. $import: substitui um valor inteiro, então uma chave irmã não tem com o que se combinar.
  • $import: value must be a path to a file. (O valor da importação deve ser o caminho de um arquivo.) O valor está vazio, ou não é uma única string.
  • $import: takes a file path beside this entity, not a registry location <value>. (A importação recebe o caminho de um arquivo ao lado desta entidade, não uma localização de registro.) O valor endereça um registro. Por qual registro um nome é resolvido é configuração do espaço de trabalho, então uma superfície de esquema nunca carrega um; a mensagem nomeia, em vez disso, a forma de referência a usar.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. (A importação recebe o caminho de um arquivo ao lado desta entidade; em vez disso, referencie a entrada da SchemaLibrary.) O valor endereça uma entrada de biblioteca. Uma entrada de biblioteca é referenciada, não importada — $ref: é a palavra-chave que resolve uma.
  • imported schema <value> must be a YAML map of schema content; it is not. (o esquema importado deve ser um mapa YAML de conteúdo de esquema; não é.) O arquivo foi encontrado, lido e analisado, e o que resultou é um escalar ou uma sequência, então não há conteúdo de esquema a substituir.

O cabeçalho traz a categoria e o código curto desta condição, E0266, que é o identificador a registrar quando você precisa nomear esta interrupção de forma duradoura — em uma verificação de integração contínua, uma issue ou um runbook. Um número é atribuído uma vez e depois fica fixo, então permanece o mesmo por mais que a redação ao seu redor melhore; a tabela de todas as condições o resolve.

Uma diretiva bem formada que nomeia um arquivo que o build não consegue obter é relatada em outro lugar, sob um código diferente. Um caminho que não se resolve, um arquivo que não existe ou não pode ser lido, e bytes que não são analisados como YAML não são falhas no que você escreveu — não há documento importado a julgar — então são relatados como o carregamento que são, em “A file cannot be read, or its bytes do not parse (Um arquivo não pode ser lido, ou seus bytes não podem ser analisados)” acima, que documenta a oração que cada um deles carrega. Faça a correspondência com essa condição, e registre seu código, quando o que você está capturando é um arquivo de importação ausente ou ilegível.

Um caminho é resolvido em relação ao diretório que contém o arquivo da entidade, a mesma base que todo outro campo que carrega importação usa. Uma importação cujo conteúdo declara por sua vez um $import: é seguida, e uma cadeia que retorna a um arquivo já em processamento é relatada como “A library reference expands into itself (Uma referência de biblioteca se expande em si mesma)” acima, e não aqui. Uma diretiva escrita dentro de um arquivo trazido por uma importação é relatada nesse arquivo e na linha dele, porque é lá que vai a correção; uma diretiva escrita na entidade é relatada na entidade.

Como corrigir: faça de $import: a única chave do seu mapeamento, e dê a ela um caminho relativo para um arquivo YAML ao lado da entidade cujo nível superior seja um mapa de conteúdo de esquema. Para consumir uma estrutura que uma SchemaLibrary publica, use em vez disso $ref: <Library>#/schemas/<Entry> — uma entrada de biblioteca é referenciada em vez de importada.

A schema block names a key that is not a data pillar (Um bloco de esquema nomeia uma chave que não é um pilar de dados)

O bloco spec.schema de um Component ou de uma Feature carrega os pilares de dados da entidade, e três chaves são tudo o que ele admite: values, a estrutura que o desenvolvedor preenche por instância; infra, o dimensionamento físico que o operador fornece; e provides, as chaves que a entidade expõe a quem a consome. Esta condição é o que acontece quando o bloco carrega alguma outra chave em seu nível superior.

O conjunto é fechado em vez de aberto, pela mesma razão pela qual o conteúdo de cada pilar é validado de forma fechada: um bloco que enumera uma superfície válida torna erro qualquer coisa fora dessa superfície. Uma chave que nada reconhece carregaria um contrato que nada jamais compila, contra o qual nada valida e que nada entrega a um consumidor — então o que você escreveu abaixo dela pareceria declarado e seria inerte. Isso é mais difícil de notar do que um contrato que você nunca escreveu, e é por isso que o bloco é recusado em vez de a chave avulsa ser ignorada.

O diagnóstico começa com a frase fixa, depois nomeia a entidade, a regra, o local em que a chave foi escrita e o que escrever no lugar:

a schema block declares a key that names no data pillar (<Kind> <name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set. (um bloco de esquema declara uma chave que não nomeia nenhum pilar de dados, regra schema-pillars; renomeie a chave para uma das chaves de pilar, ou remova-a junto com o contrato abaixo dela; permitidas: values, infra, provides. Veja vocabulary/data-pillars.md para o conjunto canônico de pilares.)

O cabeçalho traz a categoria e o código curto desta condição, E0267, que é o identificador a registrar quando você precisa nomear esta interrupção de forma duradoura — em uma verificação de integração contínua, uma issue ou um runbook. Um número é atribuído uma vez e depois fica fixo, então permanece o mesmo por mais que a redação ao seu redor melhore; a tabela de todas as condições o resolve.

Duas coisas escritas nessa posição não são chaves deste conjunto, e nenhuma delas é relatada aqui. Um $import: que nomeia um arquivo ao lado da entidade é substituído pelo conteúdo desse arquivo antes de o bloco ser lido, então o que esta condição inspeciona é o nível superior do próprio documento importado — uma chave avulsa dentro do arquivo importado é relatada aqui, e a própria diretiva nunca. E um Component que declara extends escreve a string simples inherited no lugar do bloco, que é um escalar sem nenhuma chave.

Como corrigir: a frase nomeia a chave que encontrou e as três que admite, então a causa mais comum — um erro de digitação, ou um singular onde o nome do pilar é plural — fica visível apenas pelo diagnóstico. Onde o conteúdo sob a chave avulsa pertence a um pilar, mova-o para values:, infra: ou provides: conforme sua posse determinar; data-pillars.md diz qual pilar possui o quê. Onde ele foi pensado como conteúdo de esquema por si só, ele pertence a um nível mais abaixo, dentro de um pilar, em vez de ao lado dos pilares. Uma estrutura publicada por uma SchemaLibrary é alcançada com $ref: <Library>#/schemas/<Entry> escrito dentro de um pilar, não no nível do bloco.

A plugin asks the host to parse a source while a parse is already running for it (Um plugin pede ao host que analise uma origem enquanto já há uma análise em andamento para ele)

Um plugin pode pedir ao host que analise uma origem e devolva o resultado, para que um plugin que precisa de um documento em algum formato não tenha de trazer um leitor para ele. O host executa o plugin que produz a análise e devolve o que ele produziu. Esta condição é o que acontece quando o plugin alcançado dessa forma pede, por sua vez, uma análise: a solicitação reentraria no mesmo mecanismo dentro do qual já está sendo executada, e o host recusa em vez de descer mais um nível. Um nível disso é o que o mecanismo oferece, e a recusa é o que o mantém em um.

A negação chega ao plugin, não ao build. O host não para ali nem desfaz a pilha; ele responde à chamada com um envelope de falha que traz a frase abaixo e um código que identifica a recusa, e o plugin que pediu o recebe como resposta à sua solicitação. O que o build faz em seguida depende do que esse plugin faz com a resposta — um plugin que a trata como fatal encerra o build, um que a relata e continua, não. A recusa em si é a mesma em ambos os casos.

Não é culpa de nenhum dos dois plugins em particular: a proteção cobre qualquer par de plugins pelo qual a solicitação tenha passado, em vez de um pareamento específico, de modo que a mesma recusa é encontrada onde quer que se reentre no mecanismo.

Mensagem emitida, tal como o plugin a recebe:

aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (reentrada no consumo de produtor negada: um produtor alcançado por meio do host não pode emitir outra chamada de consumo de produtor)

Como corrigir: nada nos seus próprios arquivos causa isso e nenhuma mudança no que você escreve o resolve — é uma propriedade dos plugins com os quais o build está configurado. O plugin a corrigir é o que pede uma análise de dentro de uma análise, então relate a condição a quem o publica, citando a mensagem. Se esse plugin for seu, faça-o ler diretamente a origem que recebeu, em vez de pedir ao host que analise outra enquanto ele mesmo está atendendo a uma análise.

The workspace configuration is invalid (A configuração do espaço de trabalho é inválida)

Um espaço de trabalho é descrito por um .aggrega-config.yaml em sua raiz: em qual registro ele publica e de qual baixa, onde fica o cache de artefatos, quais plugins estão vinculados a quais sockets e qual é a postura de assinatura de cada registro. Esse arquivo é lido e verificado em relação ao seu esquema antes que qualquer arquivo de entidade seja aberto, porque tudo o que vem depois é lido dele.

Um arquivo ausente não é uma falha. Um espaço de trabalho sem arquivo de configuração recebe os padrões documentados, então esta interrupção nunca nomeia um arquivo ausente. Ela nomeia o arquivo que trazia o valor — ou, para uma configuração que uma variável de ambiente sobrescreve e que o esquema nunca vê, a variável.

A verificação é executada antes de o documento ser transformado em configurações tipadas. Essa ordem é o que permite que a mensagem nomeie o caminho do campo ao qual o esquema objetou, em vez de relatar uma incompatibilidade de tipo de algum ponto mais adiante, sem nenhum campo para apontar.

Estas estruturas são relatadas aqui além de uma simples objeção do esquema, cada uma porque o esquema sozinho só consegue dizer algo genérico demais para que se possa agir: uma chave workspace: escrita sem nada abaixo dela, uma chave cujo lugar é o nível superior escrita em vez disso abaixo de workspace:, um bloco cache: escrito com um nome que o arquivo não usa, um host de registro não escrito da forma como um host de registro é escrito, e três configurações cujos valores o esquema admite mas o espaço de trabalho não pode usar — um artifact_cache_dir que é absoluto ou que nomeia a própria raiz do espaço de trabalho, uma entrada de signing.kinds que nomeia algo que não é um tipo de artefato publicável, e uma entrada de plugins.providers ou providers_append cujo uri é uma localização de registro escrita com oci://. Uma associação de provedor nomeia seu plugin pela sua identidade, provider/<name> com um :<version> opcional, porque é com essa identidade que a associação é comparada quando uma capacidade é resolvida; uma localização de registro diz onde um plugin é publicado, não qual plugin ele é, então uma entrada escrita assim nunca poderia selecionar nada. Uma entrada que nomeia uma função de entrada com function: e nenhum uri: também é relatada aqui, quando é uma entrada de plugins.linter ou linter_append ou uma entrada de plugins.governance ou governance_append em um papel de veredito, ir-verdict ou render-verdict: essas vinculações selecionam seu plugin por uri, então uma entrada assim não vincula nenhum plugin e a função que ela nomeia nunca seria chamada — um lint continuaria como se a entrada não existisse, e um build só pararia mais tarde, ao precisar resolver um plugin que a entrada nunca nomeou.

Um diretório de catálogo que a configuração lista — em workspace.catalog_dirs ou catalog_dirs_append, ou na própria entrada de uma Release em workspace.releases, em qualquer arquivo do qual a configuração é lida — também é relatado aqui quando não é um diretório: nada existe no caminho, ou há ali um arquivo ou um link que não leva a lugar nenhum. Ele é avaliado quando um catálogo está prestes a ser lido por meio dele, de modo que todo comando que lê o catálogo o recusa antes de ler ou gravar qualquer coisa, enquanto um comando que não lê nenhum catálogo continua sendo executado. Continuar a leitura sem ele faria o build com menos catálogos do que você listou, sem nada que dissesse quais. Um diretório que AGGREGA_CATALOG_DIRS lista está sujeito à mesma regra, e a recusa nomeia a variável no lugar de um arquivo.

Um host de registro — o host de uma entrada de registries, ou o host com que default_registry começa quando não nomeia uma dessas entradas pelo seu name:, caso em que representa o host dessa entrada — é escrito como o próprio host: em minúsculas, contendo um ponto, ou localhost, ou um único nome seguido de uma porta, ou um endereço IP (um IPv6 entre colchetes), cada um com um :port opcional, e sem esquema nem credenciais. O host de uma entrada de registries não traz caminho; default_registry pode seguir seu host com / e um caminho de repositório — segmentos em minúsculas unidos por /, sem tag, digest nem / final. Um valor que nomeia um host com outra grafia é recusado indicando a grafia a escrever — para default_registry, a localização inteira, caminho incluído — para que a política de confiança mantida sob esse host se aplique a ele; isso inclui a porta 443 em um host acessado por HTTPS, já que é a porta padrão desse host. Um caminho que não é um caminho de repositório é recusado nomeando o host que ele segue, e o name: de uma entrada seguido de um caminho é recusado nomeando as duas grafias a escrever em seu lugar, o nome sozinho ou o host da entrada seguido do caminho, já que um nome representa o host da sua entrada e não uma localização abaixo dele. Um valor que não nomeia host algum — um único nome sem porta que nenhuma entrada traz, um texto com espaços ou chaves — é recusado como não sendo um host, e para default_registry a recusa diz que o nome de uma entrada também serviria. AGGREGA_DEFAULT_REGISTRY está sujeito à mesma leitura e é recusado da mesma forma, nomeando a variável.

Mensagens emitidas. Uma objeção do esquema nomeia o arquivo, o caminho do campo e o que o esquema disse:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (a configuração do espaço de trabalho é inválida)

As formas com correção começam pelo arquivo e dizem uma frase sobre a estrutura específica no lugar do caminho do campo e da objeção do esquema. Um artifact_cache_dir que nomeia a raiz do espaço de trabalho:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir nomeia a própria raiz do espaço de trabalho; um diretório de catálogo na raiz do espaço de trabalho seria então ignorado como cache, sem deixar nada para carregar — dê ao cache seu próprio subdiretório: a configuração do espaço de trabalho é inválida)

uma entrada de signing.kinds inutilizável, que também nomeia o curinga que cobre todos os tipos:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (a entrada de signing.kinds não é um tipo de artefato assinável; use um tipo de entidade de catálogo ou de plugin, ou o curinga para todos os tipos: a configuração do espaço de trabalho é inválida)

uma associação de provedor escrita como uma localização de registro, que nomeia a entrada, a capacidade e a forma a escrever:

<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (plugins.providers associa a capacidade a uma localização, que diz onde um plugin é publicado em vez de qual plugin ele é; uma associação de provedor nomeia seu plugin pela sua identidade — escreva uri com a identidade do provedor, com uma versão opcional: a configuração do espaço de trabalho é inválida)

uma vinculação de linter ou de governança em papel de veredito que nomeia uma função de entrada e nenhum plugin, cuja mensagem nomeia a lista, a entrada e a função, aqui em plugins.linter:

<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (plugins.linter nomeia a função de entrada, mas nenhum uri de plugin; uma vinculação nesta lista seleciona seu plugin por uri, então esta não vincula nenhum plugin e a função nunca é chamada — adicione o uri do plugin que a exporta: a configuração do espaço de trabalho é inválida)

um host de registro escrito com outra grafia, aqui HUB.AGGREGA.AI:

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry não está escrito como o host de registro que nomeia; escreva-o — em minúsculas, sem esquema, caminho, credenciais nem porta padrão — que é a grafia sob a qual a política de confiança desse host é mantida: a configuração do espaço de trabalho é inválida)

um registro padrão cujo host está escrito com outra grafia antes do seu caminho de repositório, aqui GHCR.io/acme, cuja mensagem nomeia a localização inteira a escrever:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry não está escrito como a localização de registro que nomeia; escreva-a — o host do registro em minúsculas, sem esquema, credenciais nem porta padrão, seguido do caminho de repositório — o que mantém a política de confiança desse host aplicada a ela: a configuração do espaço de trabalho é inválida)

o nome de uma entrada seguido de um caminho, aqui local/acme onde a entrada chamada local é para 127.0.0.1:5000:

<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry é o nome da entrada de registries seguido de um caminho, e o nome de uma entrada representa apenas o host dessa entrada; escreva só o nome para usar a entrada, ou o host dela seguido do caminho: a configuração do espaço de trabalho é inválida)

um valor que não nomeia nenhum host, cuja frase lista as formas que um host assume:

<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (o host da entrada de registries não é um host de registro; escreva um nome de host em minúsculas contendo um ponto (registry.example.com), localhost, um único nome seguido de uma porta (registry:5000) ou um endereço IP, um IPv6 entre colchetes — cada um com um :port opcional e nada mais: a configuração do espaço de trabalho é inválida)

um diretório de catálogo listado onde nada existe, cuja mensagem nomeia o arquivo e a linha, a lista, a entrada como foi escrita e o caminho para o qual foi resolvida — a lista é workspace.catalog_dirs, workspace.catalog_dirs_append ou a lista de uma entrada de Release, como `catalog_dirs` of the `workspace.releases` entry "release.yaml":

<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (a entrada de workspace.catalog_dirs nomeia um diretório que não existe; crie esse diretório ou remova a entrada: a configuração do espaço de trabalho é inválida)

e um marcador workspace: vazio:

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspace deve ser um mapeamento; escreva um mapeamento vazio para marcar uma raiz de espaço de trabalho sem diretórios de catálogo: a configuração do espaço de trabalho é inválida)

Outras duas nomeiam uma chave escrita no lugar errado — default_registry, offline, auto_pull e artifact_cache_dir ficam todas no nível superior e não abaixo de workspace:, e o bloco do cache de análise é parse_cache:. Cada uma diz qual chave quer dizer e onde essa chave deve ficar.

Como corrigir: abra o arquivo que a mensagem nomeia e vá ao caminho do campo que ela cita. Quando a mensagem traz uma frase de correção, ela nomeia diretamente a grafia ou a posição correta e não é preciso ler mais nada. Quando traz, em vez disso, uma objeção do esquema, o caminho do campo é a chave com problema e a objeção diz o que o esquema esperava ali — as páginas de entidades não regem este arquivo, então leia a objeção em vez de procurar um contrato de entidade. Um artifact_cache_dir é escrito em relação à raiz do espaço de trabalho e precisa de um subdiretório próprio, para que um diretório de catálogo na raiz do espaço de trabalho não seja confundido com cache e ignorado. Uma associação de provedor escrita como localização de registro é reescrita à mão com a identidade do plugin — oci://hub.aggrega.ai/plugin/provider/compose passa a ser provider/compose — porque todo comando que lê o arquivo o recusa até que isso seja feito, aggrega plugin remove inclusive; aggrega plugin add provider escreve por si mesmo a forma com a identidade. Uma entrada de linter ou de governança em papel de veredito que nomeia uma função e nenhum plugin recebe o uri do plugin que exporta essa função; onde nenhum a exporta, remova a entrada — na lista de linters, o linter padrão é então executado como quando nenhum linter está configurado. Um diretório de catálogo listado que não é um diretório é criado no caminho que a recusa nomeia, ou sua entrada é removida da linha que a recusa nomeia; uma cópia de um projeto feita sem um checkout irmão que ele lista remove essa entrada.

A plugin binding sets a key the socket it attaches to does not read (Uma associação de plugin define uma chave que o socket ao qual ela se vincula não lê)

Os sockets na configuração do espaço de trabalho vinculam plugins de duas maneiras diferentes, e uma chave que pertence a uma delas não significa nada na outra. Em vez de aceitar a chave e ignorá-la silenciosamente, a configuração é recusada, para que um operador saiba que o ajuste é inerte em vez de se perguntar mais tarde por que ele não teve efeito.

As duas incompatibilidades são imagens espelhadas uma da outra.

  • Um socket transversal associado por capacidade. Os sockets de governança, de linter e de importador vinculam um plugin diretamente por uri:. Um plugin de governança ou de linter não atende a nenhuma capacidade, então uma associação capability: ali seria procurada contra nada e não corresponderia a nada — uma vinculação que nunca pode ser resolvida. Um importador de fato anuncia os formatos que trata, mas qual formato é desejado cabe à importação dizer, e não à vinculação: uma vinculação de importador nomeia seu importador por uri:, e é isso que o escolhe entre os importadores que anunciam o formato pedido por uma importação.
  • Um socket de provedor definindo uma chave sem referente. Uma associação de provedor nomeia uma capacidade e o plugin que a atende, e o plugin aciona um conjunto fixo de exportações em vez de uma única entrada selecionável, então function: não nomeia nada nela. with: é recusado por outro motivo: a configuração de renderização de um provedor é escrita na Recipe, então colocá-la na associação do espaço de trabalho a põe do lado errado da separação entre desenvolvedor e operador.

Mensagens emitidas. Uma capacidade em um socket transversal:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (o socket está associado por capacidade, mas os sockets transversais se vinculam por uri: o plugin deles não atende a nenhuma capacidade, então uma busca por capacidade não corresponde a nada; vincule-o por uri em vez disso: um socket transversal está associado por capacidade, mas se vincula por uri)

um function: inerte em uma associação de provedor:

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (a associação do socket de provedor para a capacidade define este campo, mas um provedor aciona um conjunto fixo de exportações associadas a fases em vez de uma única entrada selecionável, então o campo não nomeia nada ali; remova-o: uma associação de socket de provedor define um campo sem referente nesse socket)

e um with: inerte, que é relatado com a mesma estrutura e indica, em vez disso, onde a configuração deve ficar:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (a associação do socket de provedor para a capacidade define este campo, mas a configuração de renderização do provedor fica na Recipe, não na associação de provedor do espaço de trabalho; remova-o: uma associação de socket de provedor define um campo sem referente nesse socket)

Um function: escrito em .aggrega-config.yaml não chega à sua frase acima: o esquema da configuração do espaço de trabalho não declara essa chave em uma associação de provedor, então o arquivo é recusado antes, sob E0224, e a solução é a mesma — remover a chave:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (plugins.providers[].function: em relação a /$defs/FixedEntryPluginRef: propriedade inesperada: “function”: a configuração do espaço de trabalho é inválida)

Como corrigir: a correção fica em .aggrega-config.yaml e cada mensagem nomeia a edição exata. Em uma vinculação de governança, linter ou importador, substitua o capability: pelo uri: do plugin que você pretendia vincular. Em uma associação de provedor, remova a chave nomeada — e, se era with:, mova essa configuração para a Recipe que renderiza por meio do provedor, que é a superfície que a lê.

A capability is bound to more than one provider plugin (Uma capacidade está associada a mais de um plugin provedor)

Uma capacidade nomeia uma forma de transformar uma carga de trabalho em artefatos, e exatamente um plugin a atende em um espaço de trabalho resolvido. Duas associações para uma capacidade não deixam resposta sobre qual delas renderiza, e uma configuração do espaço de trabalho é montada a partir de várias camadas — um arquivo compartilhado, um arquivo do espaço de trabalho e os arquivos complementares de anexação com que cada um pode contribuir —, então a segunda associação muitas vezes é contribuída por uma camada cujo autor não podia ver a primeira.

A recusa é o que torna isso visível. Deixar uma associação vencer silenciosamente faria a saída renderizada depender de qual camada por acaso foi lida por último.

Mensagem emitida, nomeando a capacidade e a regra:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (a capacidade está associada a mais de um plugin provedor; mantenha exatamente uma entrada plugins.providers por capacidade: a capacidade está associada a mais de um plugin provedor)

Como corrigir: mantenha uma entrada plugins.providers para a capacidade que a mensagem nomeia e remova a outra. Quando as duas vêm de camadas de configuração diferentes, a camada a editar é a que você controla — remover sua própria entrada adota a que a camada compartilhada contribui, e manter a sua significa que a entrada da camada compartilhada é que precisa sair. Dois plugins que realmente atendem ambos ao espaço de trabalho atendem a duas capacidades diferentes, então, se ambos forem desejados, dê a cada um sua própria capacidade em vez de associar uma duas vezes.

An importer is attached by more than one plugins.importer entry (Um importador está vinculado por mais de uma entrada)

Uma entrada plugins.importer vincula o importador que seu uri nomeia: quando esse importador anuncia o formato pedido por uma importação, a entrada decide qual versão dele é executada e lhe entrega os with.sources e with.settings da entrada. Uma entrada faz isso para um importador, então uma segunda entrada que nomeie o mesmo importador — a mesma identidade, na mesma versão ou em outra — não seria lida por nada, e seu with não chegaria a nenhum importador sem que uma palavra fosse dita. Em vez disso, a configuração é recusada ao ser carregada, qualquer que seja o comando que a leia.

Uma configuração do espaço de trabalho é montada a partir de vários arquivos — o arquivo global, cada .aggrega-config.yaml da raiz do projeto até o diretório em que um comando é executado, o arquivo complementar importer_append que cada um pode ter e o .aggrega-config-append-ci.yaml de um pipeline —, então a segunda entrada muitas vezes é escrita em um arquivo diferente do da primeira. A mensagem nomeia o importador e ambas as entradas, a anterior primeiro, cada uma pela chave e pela posição sob as quais está escrita, pelo arquivo em que foi escrita e pelo seu uri como escrito ali.

Apenas a lista de importadores é avaliada: as listas de governança e de linter aceitam um plugin vinculado mais de uma vez, cada vinculação levando seu próprio with. Uma entrada cujo uri é um caminho do sistema de arquivos não nomeia nenhum importador, então não é comparada.

Mensagem emitida:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (o importador está vinculado por uma entrada em um arquivo e novamente por uma entrada em um arquivo; mantenha exatamente uma entrada plugins.importer por importador, com seu uri nomeando a versão desejada: o importador está vinculado por mais de uma entrada plugins.importer)

Como corrigir: mantenha uma entrada para o importador que a mensagem nomeia — aquela cujo uri nomeia a versão desejada, levando o with que você quer entregar a esse importador — e remova a outra. Quando as duas estão em arquivos diferentes, o arquivo a editar é o que você controla: remover sua entrada adota a do outro arquivo, e manter a sua significa que a entrada do outro arquivo é que precisa sair.

A provider binding names a capability containing a colon (Uma associação de provedor nomeia uma capacidade que contém dois-pontos)

O capability: de uma Recipe é lido como o nome da capacidade até seus últimos dois-pontos e uma fixação de versão depois deles — helm:1.0.0 pede a capacidade helm na versão 1.0.0. Uma entrada plugins.providers é procurada por esse nome, então a capacidade que uma associação nomeia nunca contém dois-pontos, e uma entrada cuja capacidade os contenha é uma que nenhuma Recipe pode alcançar. Em vez de deixá-la na configuração sem ser lida, a configuração é recusada ao ser carregada, qualquer que seja o comando que a tenha lido.

Apenas a lista de provedores é avaliada. A lista de importadores compartilha a estrutura das entradas, mas seus plugins são vinculados por uri: e nomeiam seus formatos import:<format>, em que os dois-pontos fazem parte do nome. O uri: de uma associação ainda pode terminar em :<version>; essa não é a parte que esta regra lê.

Mensagem emitida, nomeando a capacidade:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (a associação do socket de provedor para a capacidade: a referência de capacidade de uma Recipe é lida como a capacidade até seus últimos dois-pontos e uma fixação de versão depois deles, então a capacidade que uma associação nomeia não contém dois-pontos; associe apenas o nome da capacidade e deixe cada Recipe fixar a versão de que precisa: uma associação de socket de provedor nomeia uma capacidade que contém dois-pontos, que nenhuma Recipe pode selecionar)

Como corrigir: escreva apenas o nome da capacidade na entrada — capability: helm — e fixe as versões onde elas pertencem: uma Recipe fixa a versão do provedor de que precisa em seu próprio capability:, e uma associação que deva selecionar uma versão específica de seu plugin a escreve na identidade do plugin, uri: provider/helm:1.0.0.

A governance attachment declares no role, or one that is not a known role (Uma vinculação de governança não declara nenhum papel, ou declara um que não é um papel conhecido)

Uma vinculação de governança leva um papel, e é o papel — não o tipo declarado pelo próprio plugin — que determina onde a vinculação é executada e o que ela pode fazer: se aceita ou rejeita um build, e se lê o grafo ou os artefatos renderizados. As vinculações são despachadas pela leitura desse papel, então uma vinculação que não leve nenhum, ou que leve um que ninguém reconhece, não se vincularia a nada e seria ignorada silenciosamente.

Esse silêncio é o que a recusa impede. Um plugin de governança que está configurado e nunca é consultado produz exatamente a saída de um build que nunca passou por governança, e nada no resultado diz qual dos dois você tem em mãos.

Mensagens emitidas, ambas nomeando a vinculação e listando os papéis que existem. Um papel ausente:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (a vinculação de governança não declara nenhum papel; defina o papel como um dos papéis conhecidos: uma vinculação de governança não declara nenhum papel ou declara um papel desconhecido)

e um não reconhecido:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (a vinculação de governança declara um papel desconhecido; use um dos papéis conhecidos: uma vinculação de governança não declara nenhum papel ou declara um papel desconhecido)

Como corrigir: defina role: na vinculação sob plugins.governance como um dos papéis que a mensagem lista. Qual escolher é uma decisão sobre o que você quer que o plugin faça, não sobre o plugin: um papel que aceita ou rejeita lê o build e retorna um veredito, e um papel que transforma é uma instrução explícita para deixar o plugin alterar o que recebe. A mensagem lista o conjunto completo, então a grafia a usar está na própria mensagem.

A registry alias matches more than one host (Um alias de registro corresponde a mais de um host)

Um registro pode receber um alias curto na configuração do espaço de trabalho para que comandos e referências possam nomeá-lo sem escrever o host por extenso. Um alias seleciona exatamente um host. Essa condição é o que relata um token que corresponde ao alias de duas entradas de registro: não há resposta sobre qual host era o pretendido, e escolher um enviaria silenciosamente artefatos para um registro que o autor não nomeou, ou os baixaria dele.

Mensagem emitida, nomeando o alias, quantas entradas o reivindicaram e quais hosts são:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (o alias de registro corresponde a vários hosts; designe o registro pelo host ou remova o alias duplicado: o alias de registro corresponde a mais de um host)

Como corrigir: abra .aggrega-config.yaml e dê o alias a um dos hosts que a mensagem lista, ou designe o registro pelo host e retire o alias da referência. A mensagem nomeia cada host que detém o alias, então as entradas a examinar estão na mensagem. Quando as entradas vêm de camadas de configuração diferentes, edite a camada que pertence a você.

The lockfile does not satisfy its schema (O arquivo de bloqueio não satisfaz seu esquema)

O arquivo de bloqueio de uma release registra aquilo para que o build foi resolvido: para cada entidade, biblioteca e plugin que ele alcança, a versão selecionada e o digest dos bytes nessa versão. Ele é lido e verificado em relação ao seu esquema antes de ser transformado em fixações tipadas, de modo que um documento que não se encaixa é recusado com o caminho do campo em que falhou, em vez de produzir silenciosamente fixações com lacunas.

O arquivo de bloqueio é escrito por máquina. Ele é produzido pelo pull que resolve uma release e é commitado para que o mesmo build seja resolvido da mesma forma mais tarde. Por isso, uma falha de esquema é quase sempre uma edição manual, um merge que deixou o documento resolvido pela metade ou um arquivo de bloqueio escrito para uma forma anterior do arquivo — um cujas entities não carregam nenhum kind, por exemplo —, e não algo escrito deliberadamente.

Um arquivo de bloqueio ausente é uma condição diferente e é relatado de outra forma — o arquivo de bloqueio é obrigatório, então sua ausência é relatada onde o build o procura, com a instrução de executar o pull que o cria.

Mensagem emitida, nomeando o arquivo, o caminho do campo e a objeção do próprio esquema:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: lockfile: o arquivo falhou na validação de esquema)

Um build, assim como aggrega pull --verify, acrescenta o comando que escreve o arquivo de bloqueio novamente:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: o arquivo falhou na validação de schema; execute o comando para escrevê-lo novamente a partir da Release)

Um documento totalmente vazio é relatado separadamente, já que não há campo a nomear:

lockfile: <path>: document is empty (lockfile: o documento está vazio)

Como corrigir: não conserte o arquivo de bloqueio à mão. Execute novamente o pull para a release, que reescreve o documento a partir da resolução que realiza, e faça commit do resultado — é a nova resolução que produz um documento cujas fixações concordam com o que a release realmente alcança. Quando a falha veio depois de um merge, resolver o conflito executando o pull de novo em vez de editar é o que evita um documento que é analisado corretamente, mas fixa as versões erradas. Vale a pena ler primeiro o caminho do campo na mensagem: ele diz se o dano está em uma entrada ou na estrutura geral do documento.

Ao resolver o catálogo

Após o carregamento, o compilador percorre os dois níveis do Manifest (mapeamento de tipos, depois mapeamento de nomes) para escolher a Recipe de cada Component, e percorre todas as cadeias extends em Manifests, Components ou Features. A própria cadeia extends de uma Release é seguida pelo mesmo percurso, um passo antes: ela é seguida enquanto a Release é resolvida, antes que o Manifest ou o Aggregate que ela nomeia seja procurado, de modo que as condições abaixo são relatadas contra a Release e não contra um ponteiro irmão que a cadeia iria fornecer.

Cyclic extends chain (Cadeia extends cíclica)

Uma cadeia de ponteiros extends volta sobre si mesma. Todo tipo que declara extends — Component, Feature, Manifest e Release — é percorrido por um único percurso de cadeia, de modo que um laço é relatado com as mesmas palavras onde quer que seja encontrado.

Mensagem emitida. Ela começa com a frase que nomeia a condição, depois a entidade da qual a resolução partiu e a regra que a recusou, e então a aresta que fecha o laço — a entidade que carrega o extends: problemático e a referência que ela declara:

cyclic extends chain (<kind> <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (cadeia extends cíclica (tipo e nome, regra extends). A entidade estende a referência, que já está na cadeia; remova o extends da entidade ou aponte-o para uma entidade fora da cadeia)

A entidade nomeada primeiro e a entidade nomeada na aresta são geralmente diferentes, e é exatamente esse o ponto: um laço é relatado contra cada entidade que faz parte dele, enquanto a linha extends: a editar é a que a aresta nomeia. Siga a aresta, não o cabeçalho.

Para um Manifest, <kind> é Manifest, cada entidade é nomeada pelo seu metadata.name, e <reference> é o valor de extends: exatamente como escrito — um caminho relativo como ./base.yaml, ou o metadata.name simples de um Manifest ao lado da Release. Qual das duas formas você escreveu não muda o que é relatado: um elo de Manifest é o arquivo para o qual ele se resolve, de modo que dois arquivos de Manifest que por acaso declaram um mesmo metadata.name são dois elos e uma cadeia que passa por ambos não é um laço.

Uma Release se lê da mesma forma, e a questão da identidade do arquivo importa mais ali porque a estrutura que ela protege é comum: <kind> é Release, <reference> é o caminho relativo que extends: nomeia, e um elo de Release é o arquivo para o qual ele se resolve. Dois arquivos de Release que nomeiam o sistema implantado em vez do ambiente — ambos metadata.name: shared-release, um estendendo o outro — são dois elos, e uma cadeia que passa por ambos não é um laço.

Um laço é relatado como laço, seja qual for o seu comprimento. O percurso de cadeia aplica o seu limite de profundidade apenas a uma cadeia que termina, de modo que um ciclo que abrange mais entidades do que o limite permite ainda é relatado aqui e não como uma cadeia profunda demais — o remédio para um laço nunca é encurtá-lo.

Como corrigir: abra a entidade que a aresta nomeia e remova o seu extends: ou aponte-o para uma entidade que ainda não esteja na cadeia. Onde vários níveis deveriam compartilhar conteúdo, reunir o conteúdo duplicado em uma única entidade base remove o laço e a duplicação ao mesmo tempo.

Recipe implements does not match the mapped component type (A declaração de implementação da Recipe não corresponde ao tipo de componente mapeado)

A entrada de mapeamento do Manifest aponta para uma Recipe cuja declaração spec.implements: não corresponde à chave de tipo de componente dessa entrada de mapeamento. spec.implements é uma âncora de consistência e não um mecanismo de despacho: o valor do mapeamento nomeia a Recipe diretamente, e esta verificação confirma que a Recipe que o autor nomeou é uma que declara o tipo que ele mapeou.

A verificação lê o Manifest composto antes que qualquer Recipe seja resolvida, de modo que relata a entrada de mapeamento que o autor escreveu e não um sintoma posterior dela.

Mensagem emitida:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (a spec.implements da receita da entrada de mapeamento do manifesto não corresponde à chave de tipo de componente / tipo de funcionalidade mapeada (mapeamento do manifesto do tipo de componente para o URI da receita, a spec.implements da receita é o valor declarado, esperado o tipo de componente ou um tipo que ele estende))

Todo comando que lê as dependências de uma Release executa esta verificação; o que muda é o que cada um faz com o resultado. aggrega build e aggrega pull se interrompem, porque ambos produzem algo que você usaria em seguida — artefatos renderizados e um arquivo de bloqueio. aggrega validate e aggrega lint relatam o achado junto com todos os outros diagnósticos encontrados e então saem com código diferente de zero: o trabalho deles é dizer a você tudo o que está errado no espaço de trabalho, então uma única falha não interrompe o relatório. No editor, o achado é publicado como um diagnóstico ao lado dos outros, e o que mais aquele documento tivesse a relatar não é afetado. Observe onde ele aparece: o editor publica o achado no Manifest em que o mapeamento está escrito, na chave da entrada de mapeamento que ele nomeia, e não no Aggregate — na primeira linha do Manifest quando o texto aberto dele não escreve essa entrada, como no caso de uma entrada que ele herda por meio de extends. Os demais achados em nível de dependências da Release, que não nomeiam nenhum documento do seu espaço de trabalho, permanecem no Aggregate. Executar aggrega validate o relata qualquer que seja o documento que você tenha aberto.

Uma entrada de mapeamento que nomeia uma Recipe que o catálogo não contém não é esta condição: a verificação não tem nada com que comparar e pula a entrada, e a Recipe que não pode ser resolvida é relatada quando as receitas são resolvidas.

As entradas de FeatureRecipe seguem a mesma estrutura; a verificação do mapeamento features.type emite manifest feature mapping ... featurerecipe spec.implements is ... (expected ...), e o ramo de funcionalidades compara com a própria chave de mapeamento, então não nomeia nenhuma alternativa extends.

Uma chave components.type também é avaliada por instância sempre que alcança uma instância de outra versão. Uma chave que não nomeia o tipo exato de uma instância a alcança pela base do tipo, quando nenhuma chave nomeia esse tipo exato e nenhuma outra chave está escrita para a mesma base — então uma chave escrita sem versão, ou uma que nomeia outra versão, pode alcançá-la. A entrada sozinha, portanto, não pode dizer se a sua Recipe serve, então o build avalia a Recipe novamente para cada instância de componente que a chave alcança dessa forma, com o tipo próprio da instância, na versão com que o build a compila, no lugar da chave: a versão que a instância nomeia ou, para uma instância que não nomeia nenhuma, a versão mais alta desse Component que o catálogo contém. Uma instância cuja versão a spec.implements: da Recipe não satisfaz — exatamente, por intervalo caret, por não ter versão, ou por meio de uma base que o tipo da instância estende com extends — gera esta condição, relatada no caminho .spec.components.<instance> da instância e não no arquivo do Manifest:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (a spec.implements da receita da entrada de mapeamento do manifesto não corresponde à chave de tipo de componente / tipo de funcionalidade mapeada (Manifest, no caminho da instância, instância do tipo de componente, compilada como tipo e versão, alcançada pela chave de mapeamento do manifesto, mapeada para a receita, cuja spec.implements é o valor declarado). mapeie este tipo nesta versão para uma receita que o implemente, com uma chave de mapeamento que nomeie a versão)

O valor compiled as aparece apenas para uma instância cujo tipo não nomeia versão; uma instância que nomeia uma mostra a sua versão em of type. Uma chave que nomeia a versão própria da instância não precisa de uma segunda avaliação, já que a verificação sobre a entrada já fez essa pergunta, e uma entrada já recusada pela sua chave é relatada uma vez, como acima, e não mais uma vez para cada instância. aggrega build e aggrega pull se interrompem nela, e aggrega validate --release a relata e sai com código diferente de zero. aggrega lint avalia as entradas de mapeamento de um Manifest e não as instâncias que elas alcançam, então não a relata.

Como corrigir: corrija a declaração spec.implements: da Recipe para que corresponda à chave de tipo de componente do Manifest, ou altere a entrada do Manifest para apontar para uma Recipe cuja spec.implements: corresponda à chave de tipo de componente. Para uma instância que uma chave alcança em outra versão, adicione uma chave de mapeamento que nomeie a versão da instância, mapeada para uma Recipe que a implemente, ou aponte a chave que a alcança para uma Recipe assim.

Manifest mapping value is not a shape a recipe reference accepts (O valor de mapeamento do Manifest não tem uma estrutura que uma referência de receita aceite)

Um valor de mapeamento do Manifest nomeia uma Recipe ou FeatureRecipe em uma estrutura que a gramática de referências não consegue expressar. Uma referência de receita aceita um nome simples, um nome com versão, um nome qualificado por capacidade ou um nome qualificado por capacidade com versão — no máximo uma /. Um valor que carrega mais do que isso (um caminho no estilo de tipo de componente como core/helm/eso-aws-fetcher:1.0.0) nunca pode nomear uma entidade do catálogo, seja o que for que o catálogo contenha.

A estrutura é avaliada enquanto o Manifest é composto, antes de qualquer consulta — o veredito vem da contagem de separadores em uma string, então não precisa de catálogo algum. Avaliá-la ali é o que torna o diagnóstico honesto: a receita que o valor pretendia indicar costuma estar presente e nomeada corretamente, e ouvir que ela está faltando faz você procurar a coisa errada. Todo comando que resolve as dependências de uma Release a relata da mesma forma, então não depende de qual você executar.

Mensagem emitida:

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (referência de receita malformada em um valor de mapeamento do Manifest: a chave é mapeada para um valor que carrega vários segmentos separados por barra; uma referência de receita aceita nome, nome:versão, capacidade/nome ou capacidade/nome:versão; corrija o valor de mapeamento no Manifest)

A seção features produz a mesma mensagem com a sua própria coordenada, e uma referência de receita de funcionalidade é nomeada como tal.

Um valor cujo segmento de capacidade carrega uma fixação de versão — compose:1.2.3/svc:1.0.0 — é recusado da mesma forma, antes de qualquer consulta, de modo que nada é baixado de um registro. Uma fixação pertence à capability que a Recipe declara, onde seleciona qual versão do plugin que atende essa capacidade a renderiza; uma referência nomeia a Recipe pela sua capacidade simples (compose/svc:1.0.0).

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (referência de receita malformada em um valor de mapeamento do Manifest: a chave é mapeada para um valor que carrega uma fixação de versão no seu segmento de capacidade; uma fixação pertence à capacidade que a receita declara, e uma referência de receita nomeia a receita pela sua capacidade simples, como nome, nome:versão, capacidade/nome ou capacidade/nome:versão; corrija o valor de mapeamento no Manifest)

Como corrigir: encurte o valor de mapeamento para uma estrutura que a gramática aceite. Uma receita é identificada pelo seu próprio metadata.name — opcionalmente prefixado com a sua spec.capability e sufixado com a sua versão —, nunca pelo caminho do tipo de componente que ela implementa. A chave do mapeamento é o tipo de componente; o valor do mapeamento é a receita.

Não confundir com um valor bem formado que nomeia uma receita que o catálogo não contém: essa é uma entidade realmente ausente e continua sendo relatada como tal, nomeando o URI e a entrada de mapeamento que a referenciava.

Several Recipes implement one Component type (Várias Recipes implementam um mesmo tipo de Component)

Duas ou mais Recipes declaram o mesmo tipo de Component em spec.implements: — duas Recipes de versão exata para um mesmo tipo, ou uma Recipe sem versão ao lado de uma fixada.

Isto não gera nenhuma interrupção própria, e não é uma ambiguidade que o build precise resolver. A seleção da Recipe é feita apenas pelo mapeamento: nada lê spec.implements: para escolher entre os candidatos, então, por mais Recipes que implementem um tipo, a que renderiza uma instância é aquela para a qual o Manifest a mapeia. spec.implements: é lido como âncora de consistência — para confirmar que a Recipe que um autor mapeou é uma que declara o tipo sob o qual ele a mapeou — e como a origem dos candidatos de fixação que uma interrupção sugere. Ele nunca seleciona.

O que você encontra em vez disso é a interrupção para uma instância que o Manifest não mapeia para nada, e essa interrupção lista cada Recipe que implementa o tipo para que você possa fixar uma — veja “No Recipe is mapped for a component or feature instance (Nenhuma Recipe está mapeada para uma instância de componente ou de funcionalidade)” mais abaixo. Ela é relatada da mesma forma quer uma Recipe implemente o tipo, quer cinco, e é por isso que não existe uma condição de ambiguidade separada para consultar.

Como corrigir: adicione o mapeamento. Uma entrada com chave de tipo roteia cada instância do tipo; uma entrada com chave de nome roteia uma instância nomeada e é lida primeiro, então é também a forma de dar a uma instância uma Recipe diferente da de suas irmãs.

Divergent Release (extends + aggregate pointer) (Release divergente (extends + ponteiro aggregate))

Uma Release usa extends: para herdar de uma Release base, mas também declara o seu próprio ponteiro aggregate:. O JSON Schema da Release rejeita essa estrutura na validação do esquema (Camada 1, a verificação do envelope) por meio de uma restrição allOf: quando extends: está presente, aggregate: é proibido; quando extends: está ausente, tanto aggregate: quanto manifest: são obrigatórios.

Ela é interrompida como uma violação comum do envelope, então o diagnóstico assume a estrutura dessa classe — veja “A classe de falhas do envelope do documento” em error-translation.md — e o achado aponta para a chave que não é permitida aqui:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (falha na validação do envelope do documento (Release, no caminho); linha e coluna: spec.aggregate: o valor corresponde a uma estrutura que não é permitida aqui. corrija o documento para que corresponda ao esquema do seu tipo)

Como corrigir: remova o campo aggregate: da Release filha. A herança obriga intencionalmente a filha a implantar a mesma intenção do desenvolvedor que a Release pai; se você precisa implantar um Aggregate diferente, escreva uma nova Release sem extends:.

A feature attached by both the Aggregate and the Release cannot be merged (Uma funcionalidade vinculada tanto pelo Aggregate quanto pela Release não pode ser mesclada)

Quando um Manifest local estende um Manifest base com extends, os dois níveis (mapeamento type:, mapeamento name:) são mesclados de forma independente. Dentro de cada nível, as chaves do filho sobrescrevem as chaves do pai no nível superior — trata-se de uma substituição rasa, não de uma mesclagem profunda. Uma entrada do filho para uma determinada chave substitui completamente a entrada do pai para essa chave.

Quando o mesmo nome de instância de funcionalidade aparece tanto no lado do Aggregate quanto no lado da Release com estado conflitante não mesclável (além da sobreposição de infra permitida), o compilador se interrompe e posiciona o diagnóstico na vinculação que não conseguiu conciliar. As duas declarações conflitantes seguem em uma ordem fixa — primeiro o tipo que o Aggregate declarou, depois o tipo que a Release declarou — para que você saiba qual documento disse o quê sem abrir os dois.

Mensagem emitida:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (conflito de mesclagem de funcionalidade: concilie as declarações do Aggregate e da Release para a funcionalidade (Aggregate, no caminho da vinculação, tipo declarado pelo Aggregate, tipo declarado pela Release))

O mesmo vale para uma vinculação que uma conexão carrega. Quando a entrada de conexão do Aggregate e a entrada da Release para a mesma conexão escrevem ambas uma vinculação sob um mesmo slot e nomeiam Features diferentes, o build é interrompido na entrada da Release — onde o segundo tipo foi escrito — depois que a composição é achatada, nomeando os dois tipos, o slot, a conexão, o socket e o componente:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (conflito de mesclagem de funcionalidade: concilie as declarações do Aggregate e da Release para a funcionalidade (Release, no caminho da conexão, o Aggregate nomeia um tipo, a Release nomeia outro, para o slot, na conexão, através do socket, do componente). Remova o tipo da entrada da Release para que ela dimensione a vinculação que o Aggregate declara, ou nomeie a mesma Feature nos dois documentos.)

Como corrigir: concilie as duas declarações. As declarações do lado do Aggregate e do lado da Release da mesma instância de funcionalidade se combinam por pilar — o Aggregate contribui com values, a Release contribui com infra. Se os dois lados especificam o mesmo campo fora dos pilares (como type:), os valores precisam coincidir; corrija um lado para corresponder ao outro, ou remova a declaração redundante.

Annotation binding does not resolve against its target Feature (A associação da anotação não se resolve em relação à sua Feature de destino)

O campo feature: de uma associação de anotação do Manifest nomeia uma Feature que o catálogo não carrega, ou as listas maps.infra / maps.values da associação declaram caminhos com pontos que o spec.schema da Feature nomeada na verdade não contém. Qualquer uma das condições interrompe o carregamento do espaço de trabalho — a associação sintetizaria vinculações de Feature que roteiam valores para caminhos que o ambiente de execução não consegue resolver.

Uma única condição cobre as três maneiras pelas quais o roteamento de uma associação deixa de se resolver, e o diagnóstico indica qual delas ocorreu:

  • Feature não encontrada. O valor de feature: referencia um URI de Feature ausente do catálogo carregado.
  • O esquema da Feature não se resolve. A Feature nomeada é carregada, mas seu spec.schema: não se resolve em uma representação JSON Schema 2020-12 — o conteúdo está malformado, ou nomeia uma referência entre documentos que não pode ser seguida. Esta variante traz atrás de si o diagnóstico próprio da falha de resolução, de modo que o motivo pelo qual o esquema não se resolveu pode ser lido na mesma interrupção.
  • Caminho da associação ausente do esquema de destino. A entrada maps.infra ou maps.values da associação nomeia um caminho com pontos que o spec.schema.<pillar>.<path> da Feature não declara.

Mensagem emitida (variante de Feature não encontrada):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (a associação da anotação não se resolve em relação à sua Feature de destino (Manifest: roteia para uma Feature que o catálogo deste build não contém; corrija ou publique a Feature nomeada na associação))

Mensagem emitida (variante em que o esquema não se resolve):

annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (a associação da anotação não se resolve em relação à sua Feature de destino (Manifest: a associação da anotação roteia para uma Feature cujo esquema declarado não se resolve))

Esta variante nomeia a Feature e a falha de resolução, e não traz nem a chave da associação nem uma posição na origem — a falha está no próprio spec.schema: da Feature, que a associação apenas nomeia. Para encontrar a associação responsável, procure em mappings.features.annotations o URI de Feature que a mensagem cita.

Mensagem emitida (variante de caminho não encontrado):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (a associação da anotação não se resolve em relação à sua Feature de destino (Manifest: roteia para uma Feature, um pilar e um caminho para o qual essa Feature não declara nenhuma propriedade em seu esquema))

Como corrigir: confirme que o URI feature: da associação existe no catálogo e corresponde ao URI, que diferencia maiúsculas de minúsculas, que uma Recipe declara em implements:. Se a variante de caminho não encontrado disparar em um caminho que o esquema da Feature de fato declara, confirme a grafia do caminho com pontos (diferencia maiúsculas de minúsculas) e o nome do pilar (infra ou values).

A bound annotation value does not conform to the target Feature’s schema (Um valor de anotação associado não está em conformidade com o esquema da Feature de destino)

Uma anotação que você escreveu roteia um valor, por meio de uma associação, para um caminho da Feature de destino — e o valor não satisfaz o subesquema que a Feature declara nesse caminho, ou a Feature não declara ali nenhuma propriedade. A condição é avaliada sobre o valor e não sobre a associação, e é por isso que ela é separada da interrupção sobre o destino da associação descrita acima: aquela recusa o que o Manifest declara, esta recusa o que foi escrito por meio dele.

Validação completa no caminho localizado; salto suave apenas quando o caminho não pode ser localizado. Uma vez localizado o subesquema da subchave associada, o valor é validado contra o conjunto completo de restrições do JSON Schema 2020-12 nesse caminho (tipo, enum, pattern, intervalo numérico, estrutura aninhada de objeto ou array) — um $ref / allOf / oneOf terminal é resolvido contra as definições do esquema e validado, não ignorado. A disciplina do salto suave se aplica apenas à navegação: quando o percurso encontra uma via de escape ($ref, patternProperties, oneOf/anyOf/allOf, ou additionalProperties com corpo de esquema) em um segmento intermediário — antes de chegar à folha associada — o caminho não é resolvível estaticamente, então o validador continua sem gerar o erro em vez de arriscar uma interrupção falsa; o ambiente de execução continua sendo a superfície de validação para essa associação.

Mensagem emitida (variante de conformidade do valor):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (a subchave da anotação não está em conformidade com o esquema da Feature de destino no pilar roteado: o valor da subchave da anotação não está em conformidade com o esquema da Feature)

Mensagem emitida (variante de subchave não declarada):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (a subchave da anotação não está em conformidade com o esquema da Feature de destino no pilar roteado: a subchave da anotação não está declarada no esquema da Feature)

A interrupção é gerada sobre a anotação tal como foi escrita, antes de ser expandida em uma vinculação de Feature, então o diagnóstico nomeia o documento e o escopo em que o valor foi escrito — a fronteira e o componente para uma anotação do lado da Release, o caminho do componente para uma do lado do Aggregate — e a chave de anotação da qual ele veio.

Uma anotação injetada por um plugin de governança é avaliada da mesma maneira, e o diagnóstico diz quem a escreveu. Um plugin vinculado para injetar anotações define seu valor em um componente da Release, então o valor é verificado exatamente como um que um operador tivesse escrito ali — mas a linha da Release para a qual o diagnóstico aponta é uma que ninguém escreveu. Por isso o diagnóstico acrescenta qual plugin injetou o valor e o papel de governança ao qual ele está vinculado, e a correção está na decisão desse plugin e não na Release.

Como corrigir: corrija o valor associado para que satisfaça o subesquema declarado, ou amplie o esquema dessa propriedade se o valor for legítimo. A variante de subchave não declarada costuma ser antecipada pela interrupção sobre o destino da associação descrita acima; chegar a ela significa que a associação declara o caminho e o esquema da Feature não o contém, então corrija qual dos dois estiver errado. Quando um operador de composição intermediário torna um caminho não resolvível e o ambiente de execução o rejeita depois, restrinja o esquema para expor a propriedade diretamente no caminho da associação.

An annotation subkey is not routed by its binding (Uma subchave de anotação não é roteada pela sua associação)

Uma anotação que você escreveu traz subchaves sob uma chave que uma associação de anotação do Manifest reivindica, e uma dessas subchaves é um nome que a associação não roteia: ela não aparece nem em maps.infra nem em maps.values. Cada subchave é roteada por conta própria, para o caminho de Feature que a associação declara para ela, então uma subchave que a associação não nomeia não tem para onde ir. Expandir a anotação sem ela deixaria fora do build um valor que você escreveu sem que nada fosse dito, e uma subchave digitada errado é a causa habitual — por isso o build é interrompido, nomeando a subchave, a chave de anotação sob a qual ela foi escrita e cada subchave que a associação roteia.

A interrupção é gerada sobre a anotação tal como foi escrita, antes de ser expandida em uma vinculação de Feature, como acontece com as duas condições vizinhas: “A bound annotation value does not conform to the target Feature’s schema (Um valor de anotação associado não está em conformidade com o esquema da Feature de destino)”, acima, recusa uma subchave que a associação roteia quando a Feature recusa seu valor, e “An annotation routes through a pillar its authoring side may not use (Uma anotação é roteada por um pilar que seu lado de autoria não pode usar)”, abaixo, recusa uma roteada pelo pilar errado. Uma chave que nenhuma associação reivindica não se enquadra nesta condição: nada a roteia, e o build a deixa de lado.

Mensagem emitida, nomeando o documento e o local em que a anotação foi escrita, a subchave, a chave de anotação e as subchaves que a associação roteia:

annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (a subchave da anotação não é roteada pela associação da anotação (Release: a subchave, escrita sob a anotação cuja associação roteia apenas as subchaves indicadas))

Uma anotação escrita em um Aggregate é nomeada da mesma forma, no local em que foi escrita ali — (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) para uma escrita em um subsistema. O build relata uma anotação do lado da Release sob uma tag OPS_ERROR e uma do lado do Aggregate sob uma tag DEVELOPER_ERROR, conforme o documento que a escreveu.

Como corrigir: compare a subchave com as que a mensagem lista. Quando for um erro de digitação, corrija-a para a subchave que a associação roteia. Quando o valor deve chegar à Feature, a associação precisa roteá-lo: adicione o caminho a maps.infra ou maps.values da associação no Manifest — um caminho que o esquema da Feature declare — ou remova a subchave da anotação.

A bare annotation value does not route to exactly one path of its binding (Um valor de anotação simples não é roteado para exatamente um caminho da sua associação)

Uma anotação que você escreveu como valor simples — feature.aggrega.ai/monitoring: "30s" em vez de um mapa de subchaves — não nomeia nenhuma subchave, então nada nela diz qual caminho de Feature ela preenche. Ela é colocada no único caminho que a associação declara, contando maps.infra e maps.values juntos. Uma associação que declara mais de um caminho deixa ao valor vários destinos possíveis e nada para escolher entre eles, então o build é interrompido em vez de escolher um. A contagem abrange as duas listas, então uma associação que roteia um caminho por infra e outro por values recusa um valor simples em qualquer documento em que ele seja escrito.

A interrupção é gerada sobre a anotação tal como foi escrita, antes de ser expandida em uma vinculação de Feature, como acontece com as condições vizinhas, então o diagnóstico nomeia o documento e o local em que o valor foi escrito. A verificação é feita uma vez por anotação que você escreveu: um valor escrito em uma fronteira ou em um subsistema é recusado ali, uma única vez, quer um componente dentro dele o aproveite ou não. Cada valor desse tipo no build é relatado, não apenas o primeiro. O build relata uma anotação do lado da Release sob uma tag OPS_ERROR e uma do lado do Aggregate sob uma tag DEVELOPER_ERROR, conforme o documento que a escreveu. A condição é a scalar annotation value does not route to exactly one path of its binding, que é o que aggrega explain imprime para o seu código.

Mensagem emitida, nomeando o documento e o local em que a anotação foi escrita, a chave de anotação, o valor e os caminhos que a associação roteia:

a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (um valor de anotação escalar não é roteado para exatamente um caminho da sua associação (Release: a chave traz um valor simples, cuja associação roteia os caminhos indicados))

Um valor vazio não escreve nada, então ele é colocado onde quer que uma das duas listas contenha um único caminho, e é recusado apenas onde nenhuma delas o contém. Uma associação que não declara nenhum caminho é recusada quando o Manifest é carregado, porque o esquema do Manifest exige um, então um build não chega a esta condição por essa via.

Uma anotação injetada por um plugin de governança é avaliada da mesma maneira, e seu diagnóstico acrescenta qual plugin injetou o valor e o papel de governança ao qual ele está vinculado, como fazem as condições vizinhas.

Como corrigir: escreva a anotação como um mapa que nomeie a subchave a que cada valor se destina — feature.aggrega.ai/monitoring: {interval: 30s} — para que cada valor seja roteado pelo próprio nome; ou dê ao valor único uma associação própria, sob outra chave de anotação, que declare apenas o caminho que ele preenche.

An annotation routes through a pillar its authoring side may not use (Uma anotação é roteada por um pilar que seu lado de autoria não pode usar)

As anotações são divididas por lado de autoria, e a divisão é a mesma que rege todos os outros pilares escritos: uma anotação do lado do Aggregate só pode ser roteada por um caminho da associação que aponte para values, e uma anotação do lado da Release só por um caminho que aponte para infra. Qualquer outra combinação causa uma interrupção.

A divisão é o que impede o atalho das anotações de se tornar uma forma de escrever o pilar do outro lado. A anotação de um desenvolvedor contribui com values; a de um operador contribui com o dimensionamento infra. Uma associação que declara caminhos nos dois pilares não é em si um erro — cada lado roteia o subconjunto que lhe é permitido, e os caminhos do outro lado simplesmente não são alcançáveis a partir dele.

Uma associação que declara um mesmo caminho em ambas as listas de pilares é o caso que mais frequentemente chega a esta interrupção. O critério de desempate do roteamento envia esse caminho por infra, o que o torna inalcançável a partir do lado do Aggregate, e uma anotação do lado do Aggregate roteada para ele é interrompida aqui. O aviso que aponta essa estrutura de associação antes que um build chegue a esta interrupção é descrito em warnings.md.

Mensagem emitida:

annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (a anotação é roteada por um pilar que seu lado de autoria não pode usar: a anotação é roteada por um pilar em um caminho, mas as anotações desse lado só podem ser roteadas pelo pilar permitido)

Uma anotação injetada por um plugin de governança fica em um componente da Release, portanto é uma anotação do lado da Release e a mesma divisão se aplica a ela. Seu diagnóstico acrescenta qual plugin a injetou e o papel de governança ao qual ele está vinculado, porque a chave da Release para a qual ele aponta é uma que ninguém escreveu.

Como corrigir: roteie a anotação a partir do lado cujo pilar é o destino da associação, ou adicione uma associação — sob sua própria chave de anotação — cujos caminhos apontem para o pilar permitido ao lado de autoria. Quando uma associação declara o mesmo caminho nas duas listas de pilares, divida-a em duas associações para que cada lado tenha um caminho que consiga alcançar. Quando o diagnóstico nomeia um plugin que injeta, a anotação vem da decisão desse plugin: corrija o plugin, ou a associação sob a qual ele injeta.

Authored values or infra do not conform to the declared schema (Os values ou infra escritos não estão em conformidade com o esquema declarado)

Os values: ou infra: resolvidos de uma instância de componente — ou de uma Feature vinculada — não estão em conformidade com o esquema de catálogo declarado. O build valida cada pilar contra seu esquema declarado antes da renderização, então uma chave digitada errado, um valor de tipo errado, um número fora do intervalo ou um campo obrigatório ausente é detectado na origem em vez de produzir um manifesto defeituoso no momento da implantação.

A verificação cobre as restrições de esquema padrão: um valor do tipo errado (uma string onde o esquema declara um inteiro), um valor fora de um intervalo declarado ou de um enum, um valor que não satisfaz um pattern declarado, uma string que não é uma instância válida do seu format declarado — um dos formatos nomeados — e um campo obrigatório que não foi fornecido. Uma falha de formato nomeia a palavra-chave e traz o valor, o formato e o que há de errado com ele — como aggrega pull e aggrega validate --release a imprimem para um campo uri que recebe ::::, "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:". Ela leva em conta os valores padrão: um campo ao qual o esquema dá um default: é considerado fornecido mesmo quando omitido, de modo que um campo obrigatório com padrão nunca aciona a verificação “ausente”.

O pilar values é a superfície de autoria do desenvolvedor. Ele é validado de forma fechada — uma propriedade que o esquema não declara é rejeitada como provável erro de digitação. Um esquema de values que se compõe dentro do próprio documento (um #/$defs $ref local ou allOf) é resolvido e validado em relação a esse contexto de definições.

O pilar infra é a superfície de dimensionamento do operador, e só é verificado quando o Component declara um pilar schema.infra — essa declaração é o contrato ao qual o componente adere. Ele é validado de forma fechada em relação a essa declaração e a nada mais, exatamente como o pilar values é validado em relação a schema.values: uma chave que o Component não declara é rejeitada como erro de digitação, e uma chave que ele declara tem seu tipo e seu intervalo impostos. Um componente que quer que uma chave sobreposta pelo provedor, como replicas, seja validada declara essa chave em seu próprio schema.infra; o vocabulário aceito por um provedor é alcançado pelo valuesMapping da sua Recipe, em vez de ser sobreposto à superfície infra escrita.

A verificação mede o dimensionamento de todo componente que a Release colocou, e uma entrada que não escreve nenhum bloco infra: também é medida: um bloco ausente é um bloco vazio, então uma chave required: sem default: é relatada como ausente — que é justamente o caso que essa chave existe para detectar. As duas formas de colocar um componente contam. Nomeá-lo sob os components de uma fronteira o coloca, e o mesmo faz rotear sob aggregates o submódulo que o contribui; uma entrada de roteamento coloca componentes sem dizer nada sobre nenhum deles, então um componente colocado dessa forma parte de um bloco de dimensionamento vazio e uma chave required: sem padrão no seu tipo é relatada como ausente. Um componente que a Release não coloca por nenhuma das duas vias não é medido de forma alguma em relação a este contrato. Ele tem uma falha diferente, e o build relata essa no lugar: um componente que não está colocado em nenhuma fronteira, com as duas formas de colocá-lo nomeadas.

O contrato se aplica a um componente onde quer que ele tenha sido escrito: um componente que um submódulo contribui é medido exatamente como um que o próprio Aggregate da Release declara. O quão profundamente um componente está aninhado não muda quais restrições do seu tipo se aplicam.

As vinculações de Feature são validadas da mesma forma, em relação ao schema.values / schema.infra declarados pela Feature vinculada. As vinculações compartilham uma única superfície, então uma Feature de credenciais — uma rotulada feature.aggrega.ai/kind: secret — é medida em relação ao seu próprio esquema declarado exatamente como qualquer outra vinculação. O valor verificado é o resultado mesclado efetivo depois que os valores das vinculações se propagam em cascata pelos escopos (componente, subsistema, fronteira e específico do componente) — então um valor introduzido legalmente em um escopo, mas sobrescrito com um valor ilegal em um escopo mais específico, é detectado no resultado mesclado, não no fragmento. Uma vinculação cujo tipo não declara nenhum esquema não é validada; o infra de uma vinculação é validado em relação ao próprio schema.infra da vinculação (uma vinculação é uma sobreposição e não carrega nenhuma união de provedores).

O achado de uma vinculação é relatado no documento que escreveu o pilar com falha, sob o nome desse documento, e atribuído ao seu autor. Seus values são relatados no bloco do Aggregate que os escreveu — a própria entrada features: do componente, .spec.components.<component>.features.<attachment>.values.<field>, antes do bloco de um subsistema que alcança o componente — como falha do desenvolvedor. Seu infra é relatado no bloco da Release que o escreveu — a entrada da Release para o componente, sob a fronteira que o nomeia, antes do próprio bloco features: da fronteira — como falha do operador. Um pilar que o documento ao qual pertence não escreveu é relatado onde a própria vinculação foi escrita, que é onde seu type é nomeado. Assim, uma vinculação que só a Release faz, que não carrega values, relata um campo que os values da sua Feature exigem na entrada da Release e como falha do operador, em um caminho que a Release contém — a entrada do componente, ou o bloco features: da fronteira para uma vinculação que a fronteira faz para todo componente sob ela:

[OPS_ERROR E0168] .spec.boundaries.main.components.app.features.check.values.schema
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))

A mesma vinculação escrita no componente no Aggregate relata [DEVELOPER_ERROR E0168] em .spec.components.app.features.check.values.schema, sob o nome do Aggregate. Um editor mostra cada um no documento que o escreveu, na chave mais profunda desse caminho que o documento contém.

Uma vinculação que uma conexão carrega é medida da mesma forma, e relatada na entrada de conexão do documento que escreveu o pilar com falha, em vez de no próprio bloco features: do componente, que não a contém. Seus values são relatados na entrada de conexão do Aggregate, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> — no próprio documento do submódulo, para um componente que um submódulo contribui — e seu infra na entrada da Release para essa conexão, sob a fronteira que nomeia o componente quando a Release nomeia fronteiras. Uma vinculação que só a Release faz é relatada na entrada da Release para os dois pilares: essa vinculação não carrega values, então uma Feature cujos values exigem um campo o relata como ausente ali, na entrada que o operador escreveu.

A configuração de conexão por aresta é validada da mesma forma em relação ao contrato por aresta do socket: os values de uma aresta escritos pelo desenvolvedor em relação ao valueSchema do socket, e o infra de uma aresta escrito pelo operador (a partir de uma Release) em relação ao infraSchema do socket. Um socket que não declara nenhum esquema por aresta para um pilar não aceita nenhuma configuração validada para ele (omissão = nenhum contrato, nada a verificar). O diagnóstico nomeia a aresta por consumidor, socket e alias. Em um componente que o próprio Aggregate da Release declara, o infra do operador é medido para cada entrada que a Release escreve para uma de suas conexões — incluindo uma entrada que não carrega infra, que é como uma chave required: sem padrão é relatada como ausente — e relatado nessa entrada na Release, sob a fronteira que nomeia o componente quando a Release nomeia fronteiras, que é onde o operador o edita; os values do desenvolvedor são relatados na entrada de conexão no Aggregate.

Uma folha declarada sensitive: true tem sua falha de restrição omitida. O texto da falha cita o valor problemático, e um diagnóstico de build é lido por qualquer pessoa que acompanhe o build, então em uma folha declarada sensível — ou em qualquer lugar dentro de um objeto declarado sensível — o <constraint failure> abaixo traz <redacted> no lugar. O mesmo vale em uma posição que contém uma folha declarada sensível abaixo dela, incluindo o próprio pilar: um $ref escrito ao lado de outras palavras-chave é verificado inteiro onde está escrito, então uma falha dentro da definição que ele nomeia é relatada nessa posição e, do contrário, citaria o valor da folha. A entidade, o caminho do campo, o pilar e o nome do contrato continuam todos nomeados, então o diagnóstico ainda diz a você onde está a falha; só o texto que reproduziria o valor é removido. A sensibilidade é lida por pilar, então uma folha nomeada da mesma forma em values e infra é omitida apenas no pilar que a declara.

Mensagem emitida:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (o pilar escrito não está em conformidade com seu esquema declarado) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (o pilar escrito não está em conformidade com seu esquema declarado) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (o pilar escrito não está em conformidade com seu esquema declarado: o pilar values não está em conformidade com o esquema da Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (o pilar escrito não está em conformidade com seu esquema declarado: o pilar infra não está em conformidade com o esquema da Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (o pilar escrito não está em conformidade com seu esquema declarado: o pilar values não está em conformidade com o esquema da Feature) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (o pilar escrito não está em conformidade com seu esquema declarado) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (o pilar escrito não está em conformidade com seu esquema declarado: o pilar values não está em conformidade com o esquema da Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (o pilar escrito não está em conformidade com seu esquema declarado: o pilar values não está em conformidade com o esquema da Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (o pilar escrito não está em conformidade com seu esquema declarado)

Como corrigir: corrija o valor problemático para que satisfaça o esquema declarado ou — se o valor for legítimo — amplie o esquema que o declara (o schema.values/schema.infra do Component, ou o da Feature vinculada) para que o declare. Inspecione o esquema declarado de um Component com aggrega inspect <component-type> para ver os tipos exatos, os intervalos, os padrões e os campos obrigatórios que cada pilar espera.

A declared schema contract cannot be read as a schema (Um contrato de esquema declarado não pode ser lido como esquema)

Um Component ou uma Feature declara um contrato de esquema que não oferece nada contra o qual validar, então a configuração que ele cobre é medida contra nada. Três contratos podem carregar a falha, cada um escrito em seu próprio campo: o próprio spec.schema da entidade e os dois contratos por aresta que um socket de dependência declara — valueSchema para o lado do desenvolvedor de uma conexão e infraSchema para o do operador. Uma entrada de SchemaLibrary, que esses contratos podem referenciar, também pode carregar a terceira das falhas abaixo; como esse caso é relatado está explicado mais adiante.

Três falhas levam a esta interrupção, e duas delas passam facilmente despercebidas porque o contrato parece correto. Um contrato de socket pode não compilar de jeito nenhum para JSON Schema 2020-12 — uma palavra-chave digitada errada é a causa mais comum; um spec.schema próprio de uma entidade que não compila é relatado, em vez disso, sob a condição de forma compacta que sua compilação encontrou (E0120 para uma palavra-chave desconhecida, E0116 para uma restrição que seu tipo não aceita). Ou ele pode compilar sem problemas e ainda assim não construir nenhum validador: o corpo é legível como forma compacta e não é um esquema contra o qual se possa validar algo, como um escalar simples onde deveria estar o esquema de uma propriedade (items: nonsense). Ou ele pode estar bem formado em todos os outros aspectos e nomear um formato fora do conjunto suportado — format: password, ou um erro de grafia como format: emial — que é recusado em vez de lido como uma restrição que não verifica nada, quer algum valor chegue ao campo, quer não; os nomes que um format pode assumir estão listados em Formatos nomeados. Os três são uma única condição, porque o remédio é o mesmo e deixar passar qualquer um deles tem a mesma consequência.

Não declarar nenhum contrato e declarar um que não pode ser lido são situações diferentes, e o build as trata de forma diferente. Um campo que não declara nada é ignorado: a conformidade por pilar e por aresta é opcional, então um socket que não restringe nenhum dos dois pilares é autoria comum e não gera nenhum diagnóstico. Um campo que declara algo ilegível é recusado. Deixá-lo passar deixaria sem validação toda carga útil que ele cobre enquanto o build relatava sucesso — uma verificação que parou de rodar sem nada que diga que ela parou. Então a recusa é o que mantém os dois separados: silêncio significa que não havia nada a verificar, e uma interrupção significa que havia algo e não foi possível lê-lo.

A recusa nomeia a entidade que declarou o contrato, e não o documento que escreveu a configuração, porque é ali que a correção deve ser feita. Um autor de Aggregate que recebe um tipo de componente cujo contrato não pode ser lido não tem nada a mudar no próprio arquivo. A recusa chega quando o catálogo é lido, onde a entidade declarante, o pilar, o campo escrito e a linha de origem são todos conhecidos — então a mesma falha é relatada de forma idêntica, quer você a alcance a partir de um build, de aggrega validate ou da ferramenta de build que aggrega mcp expõe. Um contrato que a entidade lê por meio de $import: — seu spec.schema inteiro, um de seus pilares ou o contrato de um socket — é relatado no arquivo importado: a localização nomeia esse arquivo e a linha nele em que o fragmento está escrito, enquanto a mensagem ainda nomeia a entidade e o campo que declarou o contrato. As interrupções de forma compacta que o próprio spec.schema de uma entidade encontra são localizadas da mesma forma.

Uma entrada de SchemaLibrary que nomeia um formato fora do conjunto suportado chega a esta interrupção quando sua biblioteca é lida, e a recusa nomeia a biblioteca e a entrada e aponta para a entrada no arquivo da biblioteca. aggrega validate sobre o catálogo inteiro lê todas as bibliotecas, então relata a entrada quer algum esquema a referencie, quer não, enquanto uma Release cuja resolução de dependências nunca alcança a biblioteca não a lê. Uma Release cujos esquemas de fato alcançam a entrada por meio de um $ref: também é recusada, mas a recusa não nomeia o formato: aggrega pull relata a biblioteca como não encontrada no catálogo (E0114), e aggrega validate --release relata o destino da referência como não encontrado (E0121). Execute aggrega validate sobre o catálogo para ver a entrada e o nome com falha.

A mensagem traz a falha como a ferramenta que a encontrou a relatou: para uma falha de compilação, a chave dentro do contrato, a linha de origem e a palavra-chave problemática; para um corpo que não constrói nenhum validador, a posição que o validador rejeitou; para um nome de formato fora do conjunto suportado, o campo, a palavra-chave format, o nome como foi escrito e cada nome suportado. Um $ref: entre documentos em um contrato de socket cuja entrada de SchemaLibrary não está no fechamento carregado chega à mesma interrupção quando aggrega validate verifica a entidade ou a Release; no próprio spec.schema de uma entidade, ele é relatado como descreve “A $ref: is not written in a form the compiler can resolve (Uma referência não está escrita em uma forma que o compilador consiga resolver)” acima. aggrega pull lê os dois lugares para as bibliotecas de que uma Release precisa, então uma biblioteca ausente do catálogo interrompe o pull mais cedo, como descreve “A reference names no entity the catalog holds (Uma referência não nomeia nenhuma entidade que o catálogo contenha)” (E0114), seja qual for dos dois que a referencie — e uma biblioteca que o catálogo contém é fixada no arquivo de bloqueio para qualquer um deles.

Uma restrição bem formada ao lado de uma ilegível não é aplicada. Um contrato é lido como um único documento, então um único fragmento ilegível desativa toda restrição declarada junto com ele. É por isso que a interrupção vale mais do que as restrições que custa: a alternativa é um contrato que parece aplicado, é lido como aplicado e não aplica nada.

Mensagem emitida, nomeando a entidade com sua versão e o campo que declara o contrato, depois o pilar que esse contrato restringe, depois a falha — aqui um contrato de socket com uma palavra-chave digitada incorretamente:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (o contrato de esquema declarado não pôde ser compilado em um esquema utilizável, então nada foi validado com base nele: corrija o contrato onde ele é declarado, ou remova-o se a configuração que ele cobre não precisa de validação. Component: spec.usesSchema.valueSchema do socket declara um esquema a partir do qual nenhum validador pode ser construído, então os valores que ele restringe ficariam sem medição: compactform na chave e na linha indicadas: palavra-chave desconhecida)

e um nome de formato fora do conjunto suportado no pilar values de um Component:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (o contrato de esquema declarado não pôde ser compilado em um esquema utilizável, então nada foi validado com base nele: corrija o contrato onde ele é declarado, ou remova-o se a configuração que ele cobre não precisa de validação. Component: spec.schema.values declara um esquema a partir do qual nenhum validador pode ser construído, então os valores que ele restringe ficariam sem medição: validator/jsonschema: a resolução do esquema falhou (no campo sob values, palavra-chave format: o formato não é suportado; os formatos suportados são email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Uma Feature é nomeada como Feature "<name>:<version>", o contrato de um socket pelo seu próprio campo, como spec.usesSchema.<socket>.infraSchema, e o pilar por aquele que o contrato restringe — values, infra ou provides. aggrega validate, quando recebe o próprio arquivo da entidade, nomeia a entidade sem sua versão. Uma entrada de SchemaLibrary é nomeada pela sua biblioteca e pela sua entrada:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (o contrato de esquema declarado não pôde ser compilado em um esquema utilizável, então nada foi validado com base nele: corrija o contrato onde ele é declarado, ou remova-o se a configuração que ele cobre não precisa de validação. SchemaLibrary: o esquema nomeia um formato que nenhum validador consegue verificar, então os valores que ele restringe ficariam sem medição: validator/jsonschema: a resolução do esquema falhou (no campo indicado, palavra-chave format: o formato não é suportado; os formatos suportados são email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Como corrigir: abra o campo que o diagnóstico nomeia e corrija o fragmento na chave e na linha informadas — na maioria das vezes uma palavra-chave digitada incorretamente, conferida com o vocabulário de palavras-chave em vocabulary/compact-form-authoring.md, ou um valor escrito onde cabe um esquema aninhado. Quando a falha nomeia um formato que não é suportado, escreva um dos formatos nomeados ou remova o format:; um campo que contém material secreto declara sensitive: true em vez disso, já que password não é um formato. Para uma entrada de SchemaLibrary, a correção vai no arquivo de biblioteca que o diagnóstico nomeia. Quando a falha nomeia uma referência entre documentos, confirme que a entrada de SchemaLibrary existe e que a biblioteca é alcançável a partir do fechamento de dependências da Release. Se a configuração que esse campo cobre realmente não precisa de validação, remova o campo em vez de deixar um contrato que nada consegue ler.

Recipe source: is an empty string (O campo source da Recipe é uma string vazia)

Uma Recipe declara source: "" — uma string vazia. O source: de uma Recipe escolhe entre dois modos de autoria: o modo sourceless, em que não há nenhum artefato externo e a saída é produzida inteiramente a partir dos outros tipos de entrada da Recipe, e o modo sourced, em que source: nomeia um chart, um módulo ou um arquivo externo a partir do qual renderizar. Omitir o campo seleciona o primeiro, um valor não vazio seleciona o segundo, e uma string vazia não seleciona nenhum dos dois — portanto é uma ambiguidade e não um valor com significado. Um source: escrito como null equivale a omiti-lo.

A Recipe é recusada em vez de o compilador escolher por você uma das duas leituras. A forma mais comum de escrever um source: vazio é apagar um URI e deixar a chave para trás: o modo sourced era o pretendido, e admitir a string vazia como sourceless entregaria o componente sem o artefato e nunca diria qual das duas leituras adotou.

Esta regra é verificada quando a Recipe é carregada, lendo o valor exatamente como você o escreveu, de modo que todo comando que carrega a Recipe nomeia esta condição antes que qualquer coisa tente usar o valor vazio. aggrega validate sobre o arquivo da Recipe a recusa; aggrega pull, um build, aggrega validate --release e a ferramenta de build que aggrega mcp expõe a relatam para uma Release que alcança a Recipe, antes da referência à Recipe que, por causa dela, não pôde mais ser resolvida. Um pull, portanto, nomeia esta condição em vez de relatar a referência vazia como uma cujo tipo de source ele não consegue determinar. Ela é verificada antes das regras que verificam se um source está declarado, de modo que uma Recipe cujo source: está vazio é informada sobre o source:, e não sobre um valuesMapping sem nada para sobrepor ou sobre um tipo de entrada ausente.

Mensagem emitida, posicionada no arquivo da Recipe em que o source: vazio foi escrito e na chave dentro dele — .spec.source — em vez de em um componente que associa a Recipe, porque a entrada é compartilhada por todos os componentes que o fazem:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (o campo source da receita é uma string vazia, que não nomeia nem o modo sourceless nem o modo sourced. omita o campo source para o modo sourceless, ou nomeie um caminho ou URI não vazio para o modo sourced)

O build imprime a linha sob uma tag CATALOG_ERROR com o código curto desta condição, E0251, e o arquivo da Recipe ao lado.

Como corrigir: omita totalmente o campo source: (ou defina-o como null) se a Recipe for sourceless, ou forneça um caminho / URI / objeto source estruturado não vazio se a Recipe for sourced.

No Recipe is mapped for a component or feature instance (Nenhuma Recipe está mapeada para uma instância de componente ou de funcionalidade)

O tipo de uma instância não tem nenhum mapeamento do Manifest que se resolva em uma Recipe que o catálogo contém. A seleção de Recipe é somente por mapeamento: o compilador nunca escolhe uma Recipe lendo spec.implements: e escolhendo entre os candidatos, então um tipo sem mapeamento interrompe o build, não importa quantas Recipes o implementem. implements informa a escolha; o autor a faz; o Manifest a registra.

A mesma condição cobre um mapeamento que existe, mas não leva a lugar nenhum — um valor em uma estrutura de referência aceita que nomeia uma Recipe que o catálogo não contém, incluindo uma presente com uma versão diferente da que o valor fixa, e uma cujo nome simples duas capacidades oferecem ao mesmo tempo. Nenhuma delas se resolve em uma Recipe que se possa dizer que o autor escolheu. Um valor de mapeamento cuja estrutura nenhuma referência consegue expressar é relatado separadamente, em “Manifest mapping value is not a shape a recipe reference accepts (O valor de mapeamento do Manifest não tem uma estrutura que uma referência de receita aceite)” acima, de modo que a afirmação de que uma entidade está ausente só é feita sobre uma referência que poderia ter sido resolvida.

Mensagens emitidas, para uma instância de componente. Quando um mapeamento existe e nomeia algo ausente:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names (nenhuma receita resolvida para a instância de componente/funcionalidade: adicione um mapeamento explícito do Manifest para o seu tipo (Manifest, com a instância, o seu tipo e a receita para a qual está mapeada). corrija o valor do mapeamento no Manifest, ou publique a receita que ele nomeia)

Quando não existe nenhum mapeamento e há Recipes que implementam o tipo, elas são listadas como os candidatos a fixar:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest (nenhuma receita resolvida para a instância de componente/funcionalidade: adicione um mapeamento explícito do Manifest para o seu tipo (Manifest, com a instância, o seu tipo e as receitas que o implementam). fixe uma delas no Manifest)

E quando nada implementa o tipo, não há nada a listar:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it (nenhuma receita resolvida para a instância de componente/funcionalidade: adicione um mapeamento explícito do Manifest para o seu tipo (Manifest, com a instância e o seu tipo). nenhuma receita no catálogo implementa este tipo; escreva uma e depois mapeie o tipo para ela)

Em um espaço de trabalho que não nomeia nenhum diretório de catálogo, as Recipes pesquisadas são apenas as que o lockfile fixa: as de um registro não são listadas, e um Manifest que não mapeia nenhuma para o tipo não fixa nenhuma. Nesse caso, quando nenhuma Recipe fixada implementa o tipo, a ausência é afirmada em relação ao que está fixado, e não ao catálogo, e a mensagem diz isso:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (nenhuma receita resolvida para a instância de componente/funcionalidade: adicione no Manifest um mapeamento explícito para o seu tipo (Manifest, na posição, para a instância e do tipo indicados). nenhuma receita fixada pelo lockfile implementa este tipo; sem diretório de catálogo, as receitas pesquisadas são apenas as que o lockfile fixa, não as de um registro; fixe no Manifest uma que um registro publique, ou escreva uma e depois mapeie o tipo para ela)

A um tipo que o Aggregate escreve sem versão são oferecidas as Recipes que implementam a versão com que o build o compila — a versão mais alta desse Component que o catálogo contém. A uma instância de core/datastore/postgres, com o catálogo contendo esse Component em 1.0.0, é oferecida toda Recipe que declara spec.implements: core/datastore/postgres:1.0.0, assim como qualquer uma que declare o tipo sem versão ou um intervalo caret que admita 1.0.0. A um tipo do qual o catálogo não contém nenhum Component são oferecidas apenas as Recipes que declaram esse próprio tipo sem versão.

Uma instância de funcionalidade relata esses casos em uma forma própria, cada um após a frase da condição. Um tipo de funcionalidade que o Aggregate escreve sem versão é correspondido da mesma forma que um tipo de componente, na versão em que o build o compila — a versão mais alta dessa Feature que o catálogo contém —, e uma mensagem que nomeia <type>:<version> nomeia o tipo nessa versão, que é o que foi procurado no catálogo. Quando a Recipe para a qual o componente de uma associação está mapeado é conhecida, as FeatureRecipes são diferenciadas pela capacidade à qual essa Recipe se vincula: as que se vinculam à capacidade do componente são oferecidas primeiro, e uma FeatureRecipe que se vincula a outra capacidade ainda é renderizada, como sua própria saída ao lado da saída do componente em vez de dentro dela; assim, quando nenhuma se vincula à capacidade do componente, essas são oferecidas no lugar. Um mapeamento que não leva a lugar nenhum diz feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog. Quando FeatureRecipes implementam o tipo para a capacidade do componente, apenas essas são listadas: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. Quando o implementam apenas para outras capacidades: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. Quando nenhuma implementa o tipo: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. E quando a capacidade não é conhecida — o próprio mapeamento do componente não se resolve em nenhuma Recipe, o que é relatado separadamente, ou a associação está escrita em uma fronteira, cujos componentes podem ser renderizados por várias capacidades —, cada implementação é listada: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. Em um espaço de trabalho que não nomeia nenhum diretório de catálogo, as FeatureRecipes pesquisadas são apenas as que o lockfile fixa: as de um registro não são listadas, e um Manifest que não mapeia nenhuma para o tipo não fixa nenhuma. Nesse caso, as afirmações de ausência são feitas em relação ao que está fixado, e não ao catálogo, e dizem isso. Quando nenhuma implementa o tipo: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — e quando a capacidade não é conhecida, a mensagem não nomeia nenhuma e termina com pin one a registry publishes in the Manifest, or write one, then map the type to it. Quando FeatureRecipes fixadas o implementam apenas para outras capacidades, a mensagem para esse caso diz no feature recipe the lockfile pins implements no lugar de no feature recipe in the catalog implements, com a mesma oração após a capacidade.

Como corrigir: adicione o mapeamento que a mensagem pede, sob spec.mappings.components.type no Manifest, com o tipo de componente como chave e a Recipe como valor. Quando a mensagem lista candidatos, escolha um deles — essa lista é exatamente o conjunto das Recipes que declaram implementar o tipo na versão para a qual o build o resolve. Quando ela nomeia uma Recipe que não está no catálogo, corrija o valor ou adicione a Recipe a um diretório de catálogo que o build lê; uma versão no valor tem de corresponder a uma versão que o catálogo contém. Quando nada implementa o tipo, a peça que falta é a própria Recipe. Quando a mensagem diz que as receitas ou receitas de funcionalidade pesquisadas são apenas as que o lockfile fixa, o espaço de trabalho não lê nenhum diretório de catálogo, então um registro ainda pode publicar uma Recipe ou FeatureRecipe que implemente o tipo: mapear o tipo para ela no Manifest é o que faz o pull buscá-la e fixá-la.

A Manifest name mapping names nothing in the build (Um mapeamento por nome do Manifest não nomeia nada no build)

Uma chave sob spec.mappings.components.name ou spec.mappings.features.name não nomeia nenhuma instância de componente, nem nenhuma vinculação, que o build contenha. O nível name é comparado com o nome exato do que está sendo realizado: uma chave components.name com o nome de uma instância de componente tal como o Aggregate o escreve, e uma chave features.name com o nome próprio de uma vinculação — a chave sob a qual ela está escrita nos features: de um componente, ou <alias>.<slot> para uma vinculação escrita em uma conexão — nunca com o nome do componente em que a vinculação está. Uma chave que não nomeia nada nunca seria consultada: cada instância a que ela se destinava seria resolvida pelo nível type, e o build terminaria sem dizer uma palavra sobre a entrada que ignorou. Por isso, o build é interrompido, antes que qualquer coisa seja renderizada.

A mensagem nomeia o Manifest, a chave e a seção em que ela está escrita, os nomes desse gênero que o build de fato contém — restritos ao tipo que a Recipe ou a FeatureRecipe da entrada implementa, quando esse tipo é conhecido e o build contém um dele — e, quando consegue determinar, o nome que você provavelmente quis dizer: para uma chave features.name que é o nome de um componente, as vinculações desse tipo que o componente carrega; para uma chave components.name que é o nome de uma vinculação, o componente que a carrega; e, caso contrário, um nome a uma edição de distância.

Mensagem emitida, para uma chave features.name escrita como o nome do componente em que a vinculação está:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (a chave de um mapeamento por nome do Manifest não nomeia nenhuma instância de componente nem vinculação neste build, então a entrada não associa nada: Manifest, chave sob mappings.features.name: nenhuma vinculação neste build tem esse nome; uma chave features.name nomeia uma vinculação pelo seu próprio nome — a chave sob a qual ela está escrita nos features de um componente, ou o alias e o slot para uma escrita em uma conexão — nunca o componente ao qual está vinculada; vinculações do tipo indicado neste build: listadas; esse nome é um componente, e uma chave features.name nomeia a vinculação em vez do componente ao qual ela está vinculada — você quis dizer a vinculação sugerida?)

E para uma chave components.name a uma edição de distância do nome de uma instância:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (a chave de um mapeamento por nome do Manifest não nomeia nenhuma instância de componente nem vinculação neste build, então a entrada não associa nada: Manifest, chave sob mappings.components.name: nenhuma instância de componente neste build tem esse nome; uma chave components.name nomeia uma instância de componente exatamente como o Aggregate a escreve; instâncias de componente do tipo indicado neste build: listadas; você quis dizer a instância sugerida?)

Cada chave que não nomeia nada é relatada em um único build, na ordem em que o Manifest as escreve.

Como corrigir: renomeie a chave para o nome que a mensagem sugere, ou para um dos nomes que ela lista — para uma vinculação, o nome sob o qual ela está escrita, não o do seu componente. Se a entrada não for mais desejada, remova-a; as instâncias desse tipo passam então a ser resolvidas pelo nível type.

A Manifest maps two version-distinct keys onto one type (Um Manifest mapeia duas chaves de versões distintas para um mesmo tipo)

Uma busca por tipo correspondeu a mais de uma chave de mapeamento do Manifest. As chaves de tipo são comparadas com tolerância de versão, de modo que core/api-server, core/api-server:1.0.0 e core/api-server:2.0.0, escritas como chaves de mapeamento separadas, respondem todas pelo mesmo tipo base — e uma busca que alcança duas delas tem duas Recipes entre as quais escolher e nenhuma regra para preferir uma.

O build é interrompido em vez de resolver a chave que por acaso leu primeiro. Escolher uma faria a saída renderizada depender da ordem em que o mapeamento foi percorrido, que é exatamente o que a saída idêntica byte a byte exclui.

Mensagem emitida:

manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (o Manifest mapeia várias chaves de versões distintas para o mesmo tipo base; a busca de tipo para Recipe é ambígua: o tipo corresponde a chaves de versões distintas — fixe a versão do tipo escrito ou remova as chaves de mapeamento duplicadas)

Como corrigir: duas direções, e a mensagem nomeia ambas. Remova as chaves de mapeamento duplicadas, mantendo a que deve responder pelo tipo — isso é o certo quando as chaves extras são sobras de um aumento de versão. Ou fixe a versão no lado da autoria, para que o tipo que o componente declara nomeie exatamente a chave que você pretendia, o que é o certo quando as várias chaves são deliberadas e componentes diferentes realmente querem Recipes diferentes.

Two catalog entities in one directory share an identity (Duas entidades do catálogo em um mesmo diretório compartilham uma identidade)

Duas entidades do mesmo tipo, carregadas do mesmo diretório de catálogo, têm a mesma identidade. Uma identidade é o que uma referência nomeia, então dois arquivos que reivindicam uma mesma identidade deixam cada referência a ela com duas respostas.

Dentro de um diretório isso interrompe o build; entre diretórios, não. A mesma identidade presente em dois diretórios de catálogo diferentes é resolvida como um sombreamento em que o primeiro vence — o diretório listado antes vence —, que é o que permite a um diretório local sobrescrever deliberadamente uma entidade publicada. Apenas uma colisão dentro de um mesmo diretório é um erro de autoria que nenhuma leitura torna intencional.

A regra é a mesma para todo tipo de entidade indexado: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary e Aggregate. A interrupção é posicionada no segundo arquivo e nomeia o tipo e a identidade que colidiram.

Mensagem emitida:

duplicate entity identity within a single catalog directory (Component identity "<identity>") (identidade de entidade duplicada dentro de um único diretório de catálogo (identidade de Component))

com a palavra própria do tipo no lugar de Component — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity e assim por diante.

Como corrigir: renomeie uma das duas entidades ou mova-a para um diretório próprio. Para uma Recipe ou uma FeatureRecipe, a identidade inclui o escopo do provedor e a versão, então dois arquivos que diferem apenas na versão não colidem — uma colisão real ali significa que a mesma versão foi publicada duas vezes. A causa usual é copiar o arquivo de uma entidade para começar uma nova e esquecer de alterar metadata.name.

Dois lugares são lidos como um todo em vez de um arquivo por vez: um diretório de catálogo, de qualquer documento abaixo do qual uma busca por nome pode obter a resposta, e o diretório que contém uma Release, em relação a cujos Aggregates e Manifests é resolvida uma Release que os nomeia por identidade. Um link simbólico entre esses arquivos pode levar a qualquer lugar da máquina, então cada um desses diretórios tem um diretório dentro do qual suas leituras devem permanecer, e um link que sai dele não é lido. A fronteira do workspace estabelece a regra que se aplica aqui e os outros caminhos que ela abrange.

Qual diretório é esse depende de onde fica o diretório que está sendo lido:

  • O workspace, para um diretório de catálogo ou o diretório de uma Release dentro dele. Isso vale para o diretório convencional catalog do workspace sempre que ninguém o nomeou — quando ele é lido apenas porque está lá: ele é então do próprio workspace, de modo que um catalog que seja ele próprio um link que leva para fora do workspace não é lido.
  • Um diretório que você nomeou e que fica fora do workspace, para o que fica abaixo dele: um diretório de catálogo que você passa com --catalog, ou que a configuração do workspace lista em catalog_dirs — para o workspace ou para uma única Release —, e o diretório de uma Release que você nomeia, ou que a configuração nomeia, que fica fora do workspace. O próprio diretório é usado como você o nomeou — um que seja um link é lido onde aponta — e o que é lido abaixo dele permanece dentro dele. Isso inclui o diretório convencional catalog assim que você o nomeia: listado em catalog_dirs, ou passado com --catalog, um catalog que seja um link que leva para fora do workspace é lido onde aponta, como qualquer outro diretório que você nomeie. Nomear, em vez disso, o lugar para onde ele aponta, em qualquer grafia, ou um diretório acima desse lugar, também o nomeia: o diretório que você nomeou já lê o que está lá, então ele é lido uma só vez, por meio desse diretório. Nomear um diretório na configuração é a forma como um workspace lê entidades mantidas fora dele.

O que é avaliado é cada entrada da qual a leitura tiraria algo: um link para um arquivo nomeado como um documento YAML, e um link para um diretório, que pode conter documentos próprios. Um link que leva a algum lugar dentro do diretório no qual a leitura deve permanecer é lido onde o percurso o encontra. Um link para um arquivo do qual nenhuma leitura do catálogo tira nada — um arquivo de notas, um arquivo compactado de chart — não é avaliado aqui, e um link que não leva a lugar nenhum não tem nada por trás para ler.

Uma busca da qual depende uma compilação para em um link desses em vez de passar por cima dele. A entidade por trás do link pode ser a que uma referência nomeia, e passar por cima dela silenciosamente deixaria outra entidade de mesmo nome, de um diretório de catálogo posterior, ser resolvida em seu lugar. Assim, aggrega build, aggrega pull, aggrega validate, aggrega inspect onde quer que leia o catálogo, um lint de uma única Release, e as solicitações do editor e de um assistente que fazem build, pré-visualizam, montam o grafo, validam ou descrevem uma Release param todos antes que qualquer coisa seja resolvida, nomeando o link. Um lint do catálogo inteiro para da mesma forma: seu veredito responde por cada documento que os diretórios de catálogo contêm, então ele não relata um catálogo limpo enquanto um deles não pôde ser lido. O diretório da Release está sujeito à mesma regra onde quer que uma Release nomeie seu Aggregate ou seu Manifest por identidade, ou que um Manifest nomeie dessa forma o Manifest que estende, e a varredura para em um link entre os documentos ao lado da Release mesmo quando o link não é o que uma referência nomeia, pelo mesmo motivo pelo qual uma duplicata a interrompe ali: o diretório não pode responder por um nome enquanto um de seus documentos não puder ser lido. A Release sobre a qual a operação foi invocada — ou um Manifest que você inspeciona isoladamente — não é um desses documentos: ela foi lida onde foi nomeada, então uma Release que seja ela própria um link que leva para fora é lida onde aponta, e o que ela nomeia é procurado ao lado do link, no diretório em que você a nomeou (Uma Release ou um Manifest nomeado por meio de um link).

Uma listagem, em vez disso, passa por cima de um link desses e não lista nada por trás dele. O índice de entidades do editor, seus preenchimentos automáticos e os candidatos que ele oferece não listam uma entidade representada por um link que leva para fora, e o índice de entidades nomeia um link desses dentro do workspace entre os links que não leu.

Os arquivos de configuração do workspace são vinculados ao workspace da mesma forma. Cada .aggrega-config.yaml desde a raiz do workspace até o diretório em que um comando é executado, e o .aggrega-config-append-ci.yaml que um pipeline mantém ao lado de qualquer um deles, é conteúdo próprio do workspace. Um que seja um link que leva para fora do workspace — ou que seja alcançado por meio de um link de diretório que leva para fora — não é lido, e como todo comando, o servidor de linguagem do editor e as ferramentas de um assistente leem a configuração antes de qualquer outra coisa, cada um para ali, nomeando o link, em vez de rodar com uma configuração feita do que restou. O servidor de linguagem, e o servidor de um assistente que se comunica por seus próprios fluxos, ainda assim iniciam sobre um workspace desses: as listagens de suas Releases e de suas entidades respondem, lidas sem nada configurado, e nomeiam o arquivo entre os links que não leram, enquanto toda outra solicitação que a configuração decide é recusada com esta condição, nomeando o link. A solução que esta mensagem indica é a da própria configuração: o arquivo de configuração global é a única configuração lida onde quer que seja mantida, nomeada com --config ou AGGREGA_CONFIG.

O arquivo de bloqueio de uma Release é vinculado da mesma forma, tanto onde é lido quanto onde é escrito. O arquivo de bloqueio ao lado de uma Release é lido para obter as fixações em relação às quais resolvem um build, um pull, uma validação, um lint, uma inspeção, aggrega cache prune e as solicitações do editor e de um assistente, e ele é vinculado ao diretório ao qual sua escrita é vinculada: o workspace, ou o diretório próprio da Release para uma Release nomeada fora dele. Um que seja um link que leva para fora não é lido, e cada uma dessas operações para nomeando o link em vez de resolver em relação a fixações mantidas em outro lugar da máquina, ou sem eles. A solução que esta mensagem indica é a do próprio arquivo de bloqueio: ele tem um único lugar, ao lado da Release, onde um pull o escreve.

Um arquivo lido ao lado de uma entidade é vinculado da mesma forma. Duas operações leem um arquivo que fica ao lado do próprio documento de uma entidade, em vez de um que uma referência nomeia. Fixar uma entidade, ou publicá-la, lê todos os outros documentos YAML do diretório da entidade para saber se outra entidade o compartilha. Carregar uma entidade Plugin escrita em um diretório de catálogo lê o .wasm compilado colocado ao lado dela. Cada um é vinculado ao diretório sob o qual o próprio documento da entidade foi lido — o workspace, um diretório de catálogo que você nomeou fora dele ou, para uma entidade que você fixa ou publica nomeando seu documento fora do workspace, o diretório próprio desse documento — e um que seja um link que leva para fora dele não é lido. aggrega pin, aggrega push com ou sem --dry-run, um pull que fixa, e a fixação e a publicação do editor e de um assistente param nomeando o link, porque um documento deixado sem ler poderia ser a entidade que atrapalha. Um build ou um pull que carrega o plugin também para nomeando o link, em vez de executar bytes mantidos em outro lugar da máquina ou de procurar o plugin em outro lugar. A solução que esta mensagem indica é a de um arquivo ao lado de uma entidade: mantenha ali o próprio arquivo.

O cache de artefatos do workspace é vinculado da mesma forma, tanto onde é lido quanto onde é escrito. Tudo o que é lido do cache em artifact_cache_dir — uma entidade, um plugin ou uma biblioteca em cache e o manifesto ao lado, um arquivo de código-fonte e seus metadados, uma entrada externa fixada, um bundle de assinatura, o índice de busca local de um registro — e toda entrada do workspace que aggrega cache status, aggrega cache prune e aggrega cache clear listam, é vinculado ao diretório ao qual uma escrita no cache é vinculada: o próprio diretório do cache, tanto o padrão .aggrega/cache quanto um que a configuração nomeie subindo para fora da raiz do workspace. Qualquer coisa nele que seja um link que leva para fora do diretório do cache — para outro lugar dentro do workspace tanto quanto para qualquer outro lugar — não é lida, e tampouco qualquer coisa por trás de um diretório de cache escrito dentro da raiz do workspace que seja ele próprio um link que leva para fora do workspace: um build, um pull, uma validação, uma busca, os três comandos de cache e as solicitações do editor e de um assistente que leem o cache param nomeando o link — incluindo o conteúdo que o cache mantém sob um digest registrado, já que um digest diz o que os bytes são, não de onde eles podem ser lidos. Um diretório de cache escrito dentro da raiz do workspace que seja um link para outro lugar dentro do workspace é lido onde leva. O aviso de descontinuação que aggrega inspect imprime, que não decide nada, fica de fora. Um prune ou um clear trata um dos diretórios próprios do cache que seja um link que leva para fora do diretório do cache, ou um diretório de cache que seja ele próprio um link que leva para fora do workspace, como a remoção que seria, sob “A path the operation writes leads through a link out of the directory it must stay inside (Um caminho que a operação escreve leva, por meio de um link, para fora do diretório dentro do qual deve permanecer)”, antes de listar qualquer coisa. A solução que esta mensagem indica é a do próprio cache: com o link removido, um pull preenche o cache novamente, e um cache mantido em outro lugar é nomeado com artifact_cache_dir, relativo à raiz do workspace, em vez de ser alcançado por meio de um link.

Um repositório que uma fonte busca é vinculado ao seu próprio checkout. Quando um pull — aggrega pull, ou um build ou uma solicitação do editor ou de um assistente que resolve as dependências de uma Release — busca uma fonte git-repository, ele faz o checkout do repositório e arquiva o diretório que a fonte nomeia, e o checkout é um diretório à parte: todo link que o repositório contém, incluindo o próprio module_subdir, é vinculado a ele. Um link para um arquivo ou um diretório dentro do repositório é arquivado como aquilo para o qual aponta, com o nome do link. Um link que leva para fora do repositório — que poderia apontar para qualquer arquivo da máquina que executa o pull — não é lido: o pull para nomeando o link e para onde ele leva, e nada é colocado em cache. O checkout é um diretório temporário removido assim que o pull para, então a mensagem nomeia o link por sua posição no repositório — chart/secret.txt, como na primeira linha da saída da linha de comando e na frase — e o diretório dentro do qual ele deve permanecer como o repositório e a revisão que a fonte nomeia: which must stay inside the repository <url> at <ref> (commit <commit>), ou at commit <commit> quando a fonte não nomeia nenhum ref ou nomeia o próprio commit. Para onde o link leva é nomeado como o lugar na sua máquina que ele é. A solução que esta mensagem indica é a do próprio repositório: o link está commitado lá, então é lá que ele é alterado — fazendo-o apontar para dentro do repositório, ou substituindo-o pelo próprio arquivo — e a fonte então nomeia uma revisão que contém a alteração. Um link de diretório que leva de volta a um diretório que o arquivamento já está lendo por meio dele também interrompe o pull, porque a árvore que ele representa não tem fim; essa recusa é um erro comum, e não esta condição.

As sobreposições que uma geração de catálogo lê são vinculadas da mesma forma. aggrega plugin gen-catalog --from-embedded lê cada sobreposição abaixo do diretório de sobreposições que recebe — digitado com --overlay, escolhido no editor ou nomeado por um assistente — e vincula cada uma ao diretório sob o qual esse diretório de sobreposições é lido: o workspace, para um diretório de sobreposições dentro dele, e o próprio diretório de sobreposições para um nomeado fora do workspace. O diretório de sobreposições é usado como você o nomeou — um que seja um link é lido onde aponta. Uma sobreposição abaixo dele que seja um link que leva para fora do diretório ao qual está vinculada não é lida, e tampouco um link de diretório que leva para fora dele, que pode conter sobreposições próprias: a geração para nomeando o link, sem nada escrito, em vez de gerar sem a sobreposição. Uma sobreposição que seja um link que leva para outro lugar dentro do diretório ao qual está vinculada é lida onde aponta; um link de diretório que leva para dentro dele não é percorrido. A solução que esta mensagem indica é a de uma sobreposição: mantenha a própria sobreposição abaixo do diretório de sobreposições, ou nomeie como diretório de sobreposições um diretório que contenha todas as sobreposições.

Um diretório que você importa fica restrito a si mesmo. aggrega import com um diretório, a ferramenta de importação do assistente e o método aggrega/import da sessão entregam ao importador os arquivos do diretório que seus padrões de arquivo selecionam, cada um em seu lugar no diretório, de modo que o diretório é aquele dentro do qual essas leituras permanecem, onde quer que ele esteja — dentro do espaço de trabalho tanto quanto fora dele. O que é avaliado é cada entrada da qual a importação tomaria algo: um link para um arquivo que um dos padrões relevantes seleciona — os padrões do importador que atende o formato indicado ou, onde o formato é reconhecido, os de cada importador entre os quais a importação escolhe, incluindo os importadores core do compilador — e um link para um diretório, no qual nunca se entra. Um link que sai do diretório, para outro lugar do espaço de trabalho ou qualquer outro lugar, não é lido: a importação para, nomeando o link, antes que qualquer arquivo do diretório seja aberto, sem nada gravado. Um link selecionado para um arquivo em outro lugar dentro do diretório é lido onde aponta, sob o próprio nome do link, e um link para um arquivo que nenhum padrão seleciona não é avaliado nem lido. O próprio diretório é usado como você o nomeou — um que é um link é lido onde aponta. Alcançada por meio de um listener, a ferramenta do assistente nomeia o link por seu lugar no espaço de trabalho e não diz nada sobre para onde ele leva. A solução que esta mensagem indica é a própria de um diretório importado: mantenha o próprio arquivo no diretório em vez de um link para ele, ou importe o diretório para o qual o link leva.

Mensagem emitida. Ela começa com a frase própria da condição, depois o caminho que a leitura alcançou, o diretório dentro do qual ele deve permanecer, o link que encontra no caminho e o lugar para onde esse link leva, depois a solução:

a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link (um arquivo que esta operação lê sai, por meio de um link, do diretório dentro do qual deve permanecer (ao ler um arquivo que deve permanecer dentro do espaço de trabalho, o link leva a outro lugar). nada foi lido por esse link. Remova o link, ou faça-o levar a um lugar dentro do espaço de trabalho. Para ler o que é mantido fora, liste o diretório que o contém como diretório de catálogo na configuração do espaço de trabalho, em vez de alcançá-lo por um link sob um deles: um diretório listado é lido onde leva, mesmo quando ele próprio é um link)

O diagnóstico não traz categoria: o que está errado é a disposição no disco, não um documento que você escreveu.

Como corrigir: substitua o link por uma cópia daquilo para onde ele leva, ou remova-o; ou, onde a entidade deve permanecer fora do espaço de trabalho, liste o diretório que a contém em catalog_dirs na configuração do espaço de trabalho, ou passe-o com --catalog, para que o diretório seja lido como um diretório de catálogo próprio. Liste o diretório para o qual o link leva, não aquele em que ele está: um link encontrado sob um diretório é avaliado da mesma forma, seja qual for a maneira como esse diretório passou a ser lido, então listá-lo não muda nada. Onde o link é o próprio diretório catalog convencional do espaço de trabalho, basta listar catalog — ou o diretório para o qual ele aponta — em catalog_dirs, ou passar qualquer um dos dois com --catalog, já que um diretório que você nomeia é lido onde aponta. Onde o link é o arquivo de bloqueio de uma Release, remova-o e faça o pull da Release novamente, o que grava um arquivo de bloqueio novo ao lado dela. Um Manifest não tem nível de catálogo, então um Manifest que a Release lê é mantido ao lado da própria Release. Onde o link é um arquivo de configuração, substitua-o por uma cópia mantida no espaço de trabalho; uma configuração que você pretende compartilhar entre espaços de trabalho é lida nomeando-a como o arquivo de configuração global, com --config ou AGGREGA_CONFIG, abaixo dos arquivos próprios de cada espaço de trabalho. Onde o link fica ao lado de uma entidade sendo fixada ou publicada, substitua-o pelo próprio arquivo, ou mova um documento que é uma entidade para um diretório próprio; onde ele é o .wasm ao lado de uma entidade Plugin, coloque ali o próprio .wasm compilado. Onde o link é o diretório do cache de artefatos ou algo dentro dele, remova-o — um pull preenche o cache novamente — ou, para manter o cache em outro lugar, defina artifact_cache_dir para esse diretório, escrito em relação à raiz do espaço de trabalho (../shared-cache). Onde o link está commitado em um repositório que uma fonte git-repository busca, altere-o nesse repositório — faça-o apontar para dentro do repositório, ou faça commit do próprio arquivo — e nomeie a revisão que traz a alteração. Onde o link é uma sobreposição sob o diretório de sobreposições de uma geração de catálogo, substitua-o pela própria sobreposição, ou nomeie como diretório de sobreposições um diretório que contenha todas as sobreposições. Onde o link fica em um diretório que você importa, mantenha o próprio arquivo no diretório em vez de um link para ele, ou importe o diretório para o qual o link leva.

A reference to another file leads out of the directory it must stay inside (Uma referência a outro arquivo sai do diretório dentro do qual deve permanecer)

Uma Release e um Manifest podem nomear outro arquivo por um caminho: os aggregate: e manifest: de uma Release escritos como ./… ou ../…, seu extends:, o extends: de um Manifest escrito como caminho, e os parameters: { $import: … } de uma Release. Um documento no espaço de trabalho alcança dessa forma apenas arquivos dentro do espaço de trabalho. Uma Release que fica fora do espaço de trabalho — uma que você nomeia na linha de comando, ou uma que a configuração do espaço de trabalho nomeia — e um Manifest que você nomeia sozinho na linha de comando fora do espaço de trabalho alcançam apenas arquivos dentro do próprio diretório: esse diretório é uma raiz própria, como é um diretório que você nomeia fora do espaço de trabalho, e cada Release à qual sua cadeia extends: leva fica restrita ao mesmo diretório. Um caminho que, tal como está escrito, sobe para fora desse diretório, e um caminho que permanece dentro tal como está escrito mas encontra no caminho um link simbólico que leva para fora, são ambos recusados, e nada é lido do arquivo que nomeiam. Um caminho que leva a um arquivo que ainda não existe sob o diretório não é recusado aqui; ele é relatado como um arquivo que não pôde ser lido. A fronteira do espaço de trabalho explica por que uma referência é restrita, assim como o caminho que você nomeia.

De onde um caminho é resolvido segue a mesma regra que a referência da linguagem ensina para cada chave: os aggregate: e manifest: de uma Release, e o extends: de um Manifest, ao lado da Release que um comando ou uma solicitação nomeia — ou, para um Manifest que você nomeia sozinho, ao lado desse Manifest; o extends: de uma Release e um $import: dos parâmetros, ao lado da Release que o escreve, de modo que cada elo de uma cadeia extends: nomeia seu pai ao lado de si mesmo. O diagnóstico nomeia o diretório a partir do qual foi resolvido.

Um nome em vez de um caminho não é avaliado aqui — aggregate: payments, extends: base-manifest. Ele é procurado entre os documentos ao lado da Release e, para um Aggregate, nos diretórios de catálogo, que ficam restritos pela regra em “A file the operation reads leads through a link out of the directory it must stay inside (Um arquivo que a operação lê leva, por meio de um link, para fora do diretório dentro do qual deve permanecer)” acima.

Toda superfície que resolve o que uma Release nomeia para nele, antes que o arquivo seja lido: aggrega pull, aggrega build, aggrega validate, aggrega inspect de uma Release ou de um Manifest, um lint de uma única Release, e as solicitações do editor e de um assistente que compilam, visualizam, representam como grafo, validam ou descrevem uma Release. No editor, o diagnóstico é colocado na chave da Release que levou ao arquivo.

Mensagem emitida. Ela começa com a frase própria da condição, depois a referência tal como está escrita, o documento em que está escrita para um extends: e um $import: dos parâmetros, o diretório a partir do qual é resolvida, o lugar para onde leva, o diretório dentro do qual deve permanecer, e o link onde um a leva para fora; depois a solução. Para um documento no espaço de trabalho:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (uma referência que um documento faz a outro arquivo sai do diretório dentro do qual deve permanecer: a referência, resolvida a partir do espaço de trabalho, leva para fora do espaço de trabalho. nada foi lido desse arquivo. Um documento no espaço de trabalho alcança apenas arquivos dentro do espaço de trabalho: mova o arquivo para lá — ou, onde um link leva a referência para fora, faça o link levar para lá — ou abra o espaço de trabalho em um diretório que contenha ambos os documentos. Um Aggregate mantido fora desse diretório é alcançado pelo nome em vez de por um caminho, a partir de um diretório de catálogo que a configuração do espaço de trabalho lista)

e para uma Release ou um Manifest nomeados fora do espaço de trabalho, cujo próprio diretório é aquele dentro do qual devem permanecer:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (uma referência que um documento faz a outro arquivo sai do diretório dentro do qual deve permanecer: a referência, resolvida a partir do diretório, leva para fora do diretório de um documento nomeado fora do espaço de trabalho. nada foi lido desse arquivo. Uma Release ou um Manifest nomeados fora do espaço de trabalho — na linha de comando, ou pela configuração do espaço de trabalho — alcançam apenas arquivos dentro do próprio diretório: mova o arquivo para lá — ou, onde um link leva a referência para fora, faça o link levar para lá — ou nomeie o documento a partir de um espaço de trabalho que contenha ambos os documentos. Um Aggregate mantido fora desse diretório é alcançado pelo nome em vez de por um caminho, a partir de um diretório de catálogo que a configuração do espaço de trabalho lista)

com written in <document> após a referência para um extends: ou um $import: dos parâmetros, e the link <link> leads to <place> no final, onde um link leva o caminho para fora. Uma referência aggregate: ou manifest: não nomeia nenhum documento: uma Release que estende outra pode tê-la herdado de uma Release mais acima na cadeia, e ela é resolvida ao lado da Release que o comando nomeia em qualquer caso.

A categoria do diagnóstico é [OPS_ERROR]: a referência está escrita em uma Release ou em um Manifest.

Como corrigir: para um Aggregate mantido fora do espaço de trabalho, escreva seu metadata.name em vez de um caminho, e liste o diretório que o contém em catalog_dirs na configuração do espaço de trabalho, ou passe-o com --catalog — um diretório de catálogo é a forma como um espaço de trabalho alcança entidades mantidas fora dele. Um Manifest, uma Release que um extends: nomeia e um arquivo de parâmetros são lidos ao lado da Release e nunca procurados pelo nome, então mantenha-os dentro do espaço de trabalho, ou abra o espaço de trabalho em um diretório que contenha tanto a Release quanto o arquivo. Para uma Release ou um Manifest que você nomeou de fora do espaço de trabalho, mantenha o que ele nomeia no próprio diretório, ou compile-o no espaço de trabalho que contém tanto o documento quanto o que ele nomeia. Onde um link leva o caminho para fora, substitua o link por uma cópia daquilo para onde ele leva, ou faça-o levar para dentro do diretório.

No catalog version satisfies a version constraint (Nenhuma versão do catálogo satisfaz uma restrição de versão)

Uma referência nomeia uma entidade que o catálogo contém e fixa uma versão que o catálogo não contém: uma versão exata ausente, ou um intervalo caret ao qual nada disponível corresponde. Isso é distinto de uma simples ausência, em que o próprio nome é desconhecido — aqui a entidade existe e apenas a versão não pode ser satisfeita, e é por isso que a mensagem diz isso em vez de relatar a entidade como ausente e mandar você procurar um erro de digitação no nome.

Todo tipo de entidade chega aqui por uma única seleção, então uma fixação impossível de satisfazer se comporta da mesma forma onde quer que esteja escrita: um erro de digitação de versão no mapeamento de uma Recipe de um Manifest é recusado exatamente como o mesmo erro em um tipo de componente.

A condição é recuperável, o que permite ao editor mostrá-la como diagnóstico enquanto você continua digitando, em vez de abandonar o documento. Na linha de comando, ela é reunida em uma interrupção.

Mensagem emitida, para uma referência que as dependências de uma Release alcançam — um tipo de componente, um valor de mapeamento de um Manifest — indicando onde foi coletada:

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (nenhuma versão do catálogo satisfaz a restrição de versão referenciada)

Mensagem emitida, para uma fixação em um ponteiro extends::

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (nenhuma versão do catálogo satisfaz a restrição de versão referenciada: nenhuma versão do catálogo satisfaz o pai de extends)

com Feature no lugar de Component onde é a cadeia de uma Feature que traz a fixação.

Como corrigir: altere a fixação para uma versão que o catálogo contém, ou adicione essa versão ao catálogo. aggrega inspect lista as versões em que uma entidade está disponível. Um intervalo caret ao qual nada corresponde geralmente significa que as versões disponíveis estão todas abaixo do mínimo que ele indica — amplie o intervalo, ou publique a versão que a referência está aguardando.

Uma fixação que não tem nenhuma das formas que uma fixação assume é uma condição diferente, descrita em “A version pin is none of the forms a pin takes (Uma fixação de versão não tem nenhuma das formas que uma fixação assume)” abaixo.

A version pin is none of the forms a pin takes (Uma fixação de versão não tem nenhuma das formas que uma fixação assume)

Uma referência nomeia outra entidade e pode fixar a versão que deseja após dois-pontos, em uma de duas formas: uma fixação exata, que é uma versão semântica como 1.0.0 — a forma que o metadata.version de toda entidade assume — ou uma fixação caret, ^ seguido de uma versão como ^1.0.0, que seleciona a versão mais alta compatível com ela. Uma fixação que não é nenhuma das duas — um caret cujo texto não se lê como um intervalo de versões, como ^garbage, ou uma fixação exata que não é uma versão semântica, como 1.x, 1.0 ou v1.0.0 — não nomeia versão alguma, então nenhum catálogo poderia conter o que ela pede.

Uma fixação assim é relatada como malformada em vez de como uma entidade ou uma versão que o catálogo não contém, de modo que o diagnóstico leva você ao texto que digitou em vez de fazê-lo procurar algo que não existe. É a mesma condição onde quer que a fixação esteja escrita: o type de um componente ou de uma funcionalidade, o extends: de um Component ou de uma Feature, uma chave ou um valor de mapeamento de um Manifest, o spec.aggregate de uma Release, o implements: de uma Recipe ou de uma FeatureRecipe, a versão que o capability: de uma Recipe fixa quando o plugin que a serve é selecionado, e o plugin: de uma etapa de pipeline.

Ela é relatada onde é relatada uma referência que não pôde ser resolvida, de modo que uma fixação malformada nunca muda quais referências se resolvem — ela muda o que a falha diz. Uma fixação bem formada, mas que nenhuma versão disponível satisfaz, mantém a condição que essa superfície relata para ela: “No catalog version satisfies a version constraint (Nenhuma versão do catálogo satisfaz uma restrição de versão)” acima, ou a condição de não encontrado da superfície em que está escrita.

Apenas o texto após os últimos dois-pontos é uma fixação, e somente quando não contém /. Uma referência a um host de registro com uma porta, como localhost:5000/core/api-server, portanto não carrega fixação alguma — o texto após os dois-pontos da porta continua a referência — e nunca é relatada como uma fixação malformada.

Mensagem emitida, para uma fixação caret em um tipo de componente:

reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (a referência carrega uma fixação de versão malformada (referência, fixação, o texto após ^ não é um intervalo de versões, referenciada a partir do local em que está escrita). escreva a referência como nome, como nome:versão com uma versão semântica como 1.0.0, ou como nome:^versão para a versão mais alta compatível com ela)

Uma fixação exata traz an exact pin must be a semantic version no lugar da cláusula do caret. O valor que vem depois diz onde a referência foi escrita, nas palavras da superfície que a relata — referenced from e o local em que está escrita, in the Release's spec.aggregate ou in the recipe's spec.implements. Onde um mapeamento de um Manifest é avaliado em relação ao implements: de sua Recipe, a entrada do mapeamento e o lado dela que carrega a fixação — in the mapping key ou in the recipe's spec.implements — vêm, em vez disso, antes da referência, e o extends: de um Component ou de uma Feature nomeia a entidade que estende e o campo antes dela.

Como corrigir: reescreva a fixação em uma das duas formas, ou remova-a para selecionar a versão mais alta disponível. Um curinga como 1.x é escrito como uma fixação caret, ^1.0.0; uma versão com um v inicial ou com menos de três números é escrita por extenso, 1.0.0.

Every version a reference could select has been withdrawn (Toda versão que uma referência poderia selecionar foi retirada)

Uma referência se resolve em um repositório que o registro contém, e toda versão entre as quais a descoberta de versões poderia ter escolhido foi marcada como retirada. Não resta nada elegível para selecionar.

Isso deliberadamente não é relatado como uma entidade ausente. O repositório existe e ainda contém essas versões; chamá-lo de ausente nomearia o problema errado, faria você procurar um erro de digitação e pareceria um recurso alternativo silencioso em vez da recusa que é. A mensagem nomeia cada versão retirada com o motivo registrado para ela, de modo que o que lhe é dito é o que quem a publicou registrou.

Nomear uma versão retirada explicitamente não é esta interrupção. Uma versão exata ignora completamente a descoberta de versões, então fixar uma é a forma de continuar a usá-la deliberadamente; o build relata a retirada e prossegue.

Mensagem emitida:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (toda versão publicada que esta referência poderia selecionar foi retirada: retiradas, cada uma com o motivo registrado)

Como corrigir: leia os motivos registrados, que costumam nomear para onde migrar. Migre para o que substitui a entidade retirada — esse é o resultado que uma retirada pede. Onde você precisar manter a antiga por enquanto, fixe uma versão exata na referência: nomear a versão é o que diz que você a aceita, e o build então relata a retirada a cada vez em vez de recusar.

A plugins.providers binding names a plugin that does not serve the capability (Uma associação nomeia um plugin que não serve a capacidade)

O bloco plugins.providers do espaço de trabalho seleciona uma identidade de plugin para uma capacidade, e nenhum Plugin de renderização de provedores que sirva essa capacidade carrega essa identidade. A associação é uma escolha explícita que o catálogo não pode honrar, então ela causa uma interrupção em vez de recorrer silenciosamente a outro plugin — um recurso alternativo renderizaria sua saída por meio de um plugin que você disse para não usar, sem dizer nada.

Uma associação seleciona pela identidade de coordenada do plugin — o tipo de plugin e o nome do plugin, que também é o que o arquivo de bloqueio fixa — e pode carregar uma versão depois dela.

Ela é avaliada quer uma Recipe peça a capacidade, quer não. Caso contrário, uma associação só é lida quando o capability: de uma Recipe a nomeia, então uma associação cuja capacidade está escrita errado não seria consultada por nada nem relatada por nada. Todo build e todo aggrega validate --release verificam, portanto, cada associação que nomeia um plugin: um pull resolve uma associação assim quer uma Recipe a use, quer não, de modo que o build contém o plugin e sabe o que ele serve, e uma capacidade que esse plugin não serve está certamente errada. A verificação lê as associações na configuração do espaço de trabalho, não o arquivo de bloqueio, e não muda nada sobre qual plugin renderiza uma Recipe — isso continua a cargo do arquivo de bloqueio. Uma associação que nomeia um plugin que o build não contém — um plugin de registro que nenhum pull baixou ainda — não é avaliada até que um pull o tenha baixado. Uma associação que não nomeia nenhum plugin é avaliada de outra forma, como um aviso: veja “A provider binding names a capability no plugin the build reads serves (Uma associação de provedor nomeia uma capacidade que nenhum plugin lido pelo build serve)” em “Condições que não interrompem um build” abaixo.

Mensagem emitida, que acrescenta o que o plugin nomeado de fato serve, e uma grafia a uma edição de distância quando a capacidade da associação está a uma:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (a entrada plugins.providers nomeia um plugin ao qual não corresponde nenhum plugin de renderização de provedores que sirva a capacidade: a capacidade está associada ao plugin, mas nenhum plugin de renderização de provedores que a sirva corresponde a essa identidade; o plugin serve outra capacidade, e a capacidade está a uma edição de distância dela)

Onde o plugin que a associação nomeia não está no catálogo que o build lê, a mensagem termina após “matches that identity (corresponde a essa identidade)”, porque não há nada a dizer sobre o que ele serve.

Como corrigir: verifique primeiro a grafia da associação em relação à coordenada do próprio plugin — uma associação que nomeia a capacidade onde deveria nomear o plugin é o deslize comum. Onde a mensagem nomeia uma capacidade a uma edição de distância da que você escreveu, o erro de digitação está no capability: da associação. Em seguida, confirme que o plugin está no catálogo que o build lê e que ele lista essa capacidade em spec.provider.capabilities; um plugin que já serviu a capacidade e não a declara mais produz exatamente essa mensagem. Remover a associação é a correção certa onde apenas um plugin serve a capacidade, já que a associação então não tem nada a desambiguar.

No provider plugin version satisfies a Recipe’s provider pin (Nenhuma versão de plugin provedor satisfaz a fixação de provedor de uma Recipe)

Uma Recipe associa um provedor com versão fixada — helm:1.0.0 ou helm:^1.0.0 — e nenhuma versão de Plugin de renderização de provedores satisfaz a fixação. A fixação é uma solicitação explícita, então o build é interrompido em vez de ignorá-la e renderizar por meio de qualquer versão que sirva o provedor no momento; sobrepor uma fixação silenciosamente produziria uma saída que a própria declaração do autor diz que não deveria existir.

Duas situações levam a ela, e a mensagem as distingue: nada serve a capacidade, ou algo a serve e nenhuma de suas versões satisfaz a restrição.

Isso é diferente de uma versão de entidade insatisfazível acima. Aquela trata de uma entidade do catálogo nomeada em uma versão que o catálogo não contém; esta trata da seleção do plugin que renderiza uma capacidade.

Mensagens emitidas:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (nenhuma versão de plugin de renderização de provedores satisfaz a fixação de versão de provedor da Recipe: a capacidade fixa uma versão, mas nenhum plugin de renderização de provedores a serve) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (nenhuma versão de plugin de renderização de provedores satisfaz a fixação de versão de provedor da Recipe: a capacidade fixa uma versão, mas nenhuma versão de plugin que a sirva a satisfaz)

Como corrigir: amplie ou corrija a fixação no campo capability: da Recipe, ou adicione ao catálogo a versão do plugin que ela pede. Uma fixação caret corresponde a versões iguais ou superiores ao piso dentro da mesma versão principal, então uma fixação ^2.0.0 não é satisfeita por um plugin 1.x, por mais recente que seja. Onde a mensagem diz que nada serve a capacidade, a fixação não é o problema: o plugin está totalmente ausente, e remover a fixação não vai ajudar.

No plugin advertises a requested parse or import format (Nenhum plugin anuncia um formato de análise ou de importação solicitado)

Um formato foi solicitado e nenhum plugin o anuncia. Os dois sockets que roteiam por formato têm cada um sua própria condição, e diferem apenas no trabalho que foi pedido: um plugin analisador lê um formato de origem externo, e um plugin importador traz conteúdo externo como entidades do Aggrega.

O espaço de formatos é aberto e pertence inteiramente aos plugins. Nenhum dos dois sockets contém uma lista de formatos que o compilador conhece: um plugin declara como capacidades os formatos que trata, e um novo formato é distribuído como um novo plugin, sem nenhuma alteração no compilador. Por isso esta interrupção relata o conjunto anunciado como ele está em vez de uma enumeração fixa, e toda ausência é relatada explicitamente: a solicitação ou tem um plugin que a anuncie ou não pode ser atendida. Nada substitui um plugin ausente, com a única exceção dos analisadores que o compilador traz consigo, descrita abaixo.

Mensagens emitidas:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (nenhum plugin analisador anuncia o formato solicitado) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (nenhum plugin importador anuncia o formato solicitado)

Um único plugin analisador que anuncia o formato, mas carrega uma estrutura de versão que não pode ser resolvida, é tratado como se nenhum plugin anunciasse o formato, em vez de passar silenciosamente, e diz isso:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (nenhum plugin analisador anuncia o formato solicitado: nenhuma versão de plugin analisador se resolve para o formato)

Uma análise recorre aos analisadores que o compilador traz consigo. Um build analisa cada arquivo que entrega a uma política render-verdict em um formato que a política não lê nativamente, um importador lê sua origem por meio do analisador da sintaxe que ele nomeia, e uma importação que não nomeia nenhum formato analisa a origem na sintaxe que cada assinatura aplicável nomeia. Para cada sintaxe, é usado o analisador que o catálogo do espaço de trabalho serve e, onde o catálogo não serve nenhum, o analisador que o próprio compilador traz para ela — entre eles o analisador HCL por meio do qual um build lê a saída do Terraform e o analisador JSON por meio do qual leem os importadores core do compilador, de modo que nem uma política sobre a saída do Terraform nem uma importação por meio de um importador core precisa de um analisador no catálogo. Onde o catálogo serve um analisador para uma sintaxe, o do compilador não tem papel algum, e dois de nomes diferentes no catálogo são recusados como descreve A parse or import format is advertised by more than one plugin (Um formato de análise ou de importação é anunciado por mais de um plugin). Assim, esta interrupção nomeia uma sintaxe para a qual nem o catálogo nem o compilador servem um analisador.

Como corrigir: confirme que o formato está escrito como o plugin o anuncia — a capacidade é o prefixo do socket e o nome do formato, então um plugin que anuncia parse:hcl serve o formato hcl e nada mais. Em seguida, confirme que o plugin está presente no catálogo que o build lê. Onde não existe nenhum plugin para o formato, esse plugin é a peça que falta; o compilador não pode ler um formato que nada anuncia.

A parse or import format is advertised by more than one plugin (Um formato de análise ou de importação é anunciado por mais de um plugin)

Dois ou mais plugins distintos anunciam o mesmo formato, e a solicitação não pode ser roteada sem adivinhar qual usar.

Um catálogo que contém ambos é válido e carrega sem objeções. Dois publicadores podem cada um distribuir um analisador ou um importador para um mesmo formato, e federar seus catálogos é algo suportado. A ambiguidade é uma condição no ponto de uso: ela causa uma interrupção quando o formato disputado é de fato solicitado, de modo que um par concorrente fora do alcance de um build nunca o bloqueia.

Cada candidato é nomeado, em ordem, de modo que a mensagem é a mesma em toda execução.

Mensagens emitidas:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (o formato é anunciado por mais de um plugin analisador) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (o formato é anunciado por mais de um plugin importador)

Para um importador, a interrupção é levantada em mais uma estrutura: as entradas plugins.importer do espaço de trabalho vinculam mais de um dos importadores que anunciam o formato, e os importadores que ela nomeia são então os vinculados.

Os importadores entre os quais uma importação escolhe são os do catálogo do espaço de trabalho e os importadores core do compilador, que anunciam seus formatos em todo espaço de trabalho. Assim, um catálogo que contém seu próprio importador de outro nome para um formato que um importador core serve — import:langflow ou import:flowise — encontra esta interrupção em uma importação que não vincula nenhum dos dois, e a mensagem nomeia o importador core ao lado do importador do catálogo. Um importador que o catálogo contém com o próprio nome de um importador core não é um segundo plugin que anuncia o formato: dentro de um mesmo nome, a versão mais alta é escolhida, e um na versão própria do importador core, com o seu módulo ao lado, é executado em seu lugar. Um sem módulo ao lado não é candidato onde um importador com esse nome que possa ser executado anuncia o formato, como descreve Qual é executado ao lado dos seus próprios importadores.

Como corrigir: para um importador, mantenha ambos no catálogo — ou mantenha o seu ao lado do importador core — e vincule o que você quer — uma entrada plugins.importer cujo uri o nomeie por sua identidade e versão, uri: importer/<name>:<version>, como aggrega plugin add importer a escreve. O importador vinculado é escolhido entre os que anunciam o formato, assim como uma entrada plugins.providers escolhe entre os plugins que servem uma capacidade no socket provedor, descrito em “A capability is served by more than one provider plugin (Uma capacidade é servida por mais de um plugin provedor)” abaixo. Onde os importadores nomeados são os que suas entradas vinculam, mantenha a entrada daquele que você quer e remova a outra. O socket de análise não tem esse tipo de seleção, então, para um analisador, a solução é restringir o catálogo que o build lê para que apenas o plugin que você quer esteja nele — apontar --catalog para o diretório que contém sua escolha é o caminho direto.

A plugins.importer entry pins a version of its importer the catalog does not hold (Uma entrada fixa uma versão do seu importador que o catálogo não contém)

Uma entrada plugins.importer vincula um importador pela sua identidade e uma versão — uma exata, uri: importer/<name>:1.2.0, ou um intervalo, uri: importer/<name>:^1.2.0 — e esse importador anuncia o formato que a importação pede, mas nenhuma versão dele entre as quais a importação escolhe satisfaz a fixação — as versões que o catálogo do espaço de trabalho contém e, para um importador core, também a versão do próprio compilador: a versão exata não está lá, ou nenhuma de suas versões cai no intervalo. A versão é uma escolha explícita, então a importação é recusada antes que qualquer importador seja executado, em vez de executar outra versão do importador no lugar dela.

Isso é diferente de nenhum importador anunciar o formato, descrito acima: aqui o importador é um daqueles entre os quais a importação escolhe e anuncia o formato, e só falta a versão que a entrada nomeia. Uma fixação que não tem nenhuma das formas que uma fixação de versão assume, como :latest, é relatada como malformada, como descreve “A version pin is none of the forms a pin takes (Uma fixação de versão não tem nenhuma das formas que uma fixação assume)”.

Mensagem emitida, que nomeia a capacidade do formato e a versão que a entrada fixa:

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it (nenhuma versão de plugin importador satisfaz a fixação de versão da entrada plugins.importer: a capacidade fixa uma versão, mas nenhuma versão de plugin que a atende a satisfaz)

Como corrigir: altere a versão no uri da entrada para uma que o catálogo contenha — para um importador core, a versão do próprio compilador também conta —, ou amplie o intervalo, ou adicione ao catálogo a versão que a entrada nomeia. Um intervalo caret corresponde a versões iguais ou superiores ao seu piso dentro da mesma versão major, então ^2.0.0 não é satisfeito por um importador 1.x, por mais recente que seja.

A plugin reference carries a registry host or an artifact path (Uma referência de plugin contém um host de registro ou um caminho de artefato)

Uma referência de Plugin começa com um segmento em formato de host de registro — um que contém um ponto ou dois-pontos, como um nome DNS ou um par de host e porta — ou com um caminho de artefato. Um Plugin é endereçado pela sua identidade de coordenada: seu tipo de plugin, uma barra, seu nome e, opcionalmente, uma versão. O pull associa essa identidade a um local físico prefixando o registro configurado e o próprio caminho do plugin, então uma referência que já contém um seria prefixada duas vezes e associada a um local que não pode ser baixado.

Ela é recusada onde o local é formado, e não ao baixar, para que a mensagem nomeie o que você escreveu em vez de surgir mais tarde como um erro de tag ilegível.

Mensagem emitida, enquadrada pelo pull que estava formando o local, com a solução na linha abaixo:

catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" (catálogo: pull de nível 3: a referência de plugin wasm deve ser a identidade de coordenada do plugin, não um caminho qualificado por registro nem um caminho de artefato) remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice (correção: remova o host do registro e o caminho do artefato, deixando só a coordenada; o pull prefixa o registro configurado por conta própria, então uma referência que já contém um é prefixada duas vezes)

Como corrigir: remova tudo o que vem antes do tipo de plugin, deixando a coordenada sozinha — provider/helm:1.0.0, não hub.example.com/plugin/provider/helm:1.0.0. O registro do qual um build faz pull é configuração do espaço de trabalho, e não parte de uma identidade, e é isso que permite servir um catálogo a partir de mais de um registro sem editar as entidades nele.

A plugin or recipe reference carries no scope (Uma referência de plugin ou de receita não tem escopo)

Uma referência de Plugin ou de Recipe não tem um segmento de escopo inicial — nenhuma barra, ou um segmento vazio antes da barra, como em /name. Os dois tipos são identificados por duas partes, e a primeira é o que mantém separadas duas entidades de mesmo nome: um Plugin pelo seu tipo de plugin e seu nome, uma Recipe pelo seu provedor e seu nome. Dois sockets podem conter cada um um plugin chamado redact, e dois provedores podem distribuir cada um uma receita chamada postgres, então o escopo faz parte da identidade em vez de ser uma decoração sobre ela.

Um local construído a partir de um escopo vazio contém um segmento de caminho vazio — uma barra dupla — que não pode ser resolvido, então a referência é recusada onde o local é formado, em vez de ser deixada para falhar mais tarde ao baixar, de forma ilegível.

As duas soluções são o oposto do caso do plugin qualificado acima e uma da outra, e é por isso que cada uma é redigida separadamente: aqui falta um segmento a uma referência e você adiciona um, enquanto uma referência qualificada tem um a mais e você o remove.

Mensagens emitidas, cada uma enquadrada pelo pull e com sua própria solução abaixo:

catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" (catálogo: pull de nível 3: a referência de plugin wasm deve ter um escopo pluginType; um escopo vazio não pode ser associado a um local OCI) remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType (correção: adicione o segmento pluginType ausente — escreva a referência como tipo de plugin, barra e nome — usando o pluginType que a entidade do plugin declara)

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" (catálogo: pull de nível 3: a referência de receita deve ter um provedor como escopo; um provedor vazio não pode ser associado a um local OCI) remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable) (correção: nenhum diretório de catálogo local continha esta referência, então ela foi procurada no registro, onde um segmento de provedor é obrigatório; execute o pull novamente indicando com a opção de catálogo o diretório que a contém, para que ele seja pesquisado primeiro; a opção pode ser repetida)

Como corrigir: para um plugin, prefixe o tipo de plugin que a entidade Plugin declara em metadata.pluginType. Para uma receita, prefixe o provedor que a Recipe declara em spec.capability. A solução para a receita aponta uma segunda possibilidade que vale a pena ler: chegar ao registro significa que os diretórios de catálogo locais foram pesquisados primeiro e nenhum continha a referência, então, se a receita deve vir de um diretório local, aponte o build para esse diretório em vez de adicionar um escopo.

The build consumes an artifact its publisher has deprecated (O build consome um artefato que seu publicador descontinuou)

Uma referência que este build resolve tem um marcador de descontinuação registrado pelo seu publicador, e a severidade desse marcador é igual ou superior à severidade que o espaço de trabalho configurou como seu limiar de interrupção. Um marcador é anexado a um artefato publicado a posteriori, então um artefato que ontem era compilado sem problemas pode ter um hoje sem que nada tenha mudado nos seus próprios arquivos.

Relatar e interromper são coisas separadas, e só a interrupção é configurável. Todo marcador registrado é relatado, em qualquer severidade, e nenhuma configuração o silencia. Se um marcador também interrompe o build é o que halt_on_deprecated_severity decide, comparando a severidade registrada com o limiar configurado na ordem warning < error < retracted. Sem limiar configurado, nada é interrompido e todo marcador é um aviso. Uma severidade fora das três, ou um limiar fora delas, nunca corresponde: um valor malformado não pode nem causar uma interrupção nem suprimir uma.

Toda notificação é impressa antes que o build pare, não só a que causou a interrupção, então elevar o limiar nunca faz você perder um achado — a própria interrupção nomeia a única referência em que parou. Os achados são ordenados por referência, então o mesmo arquivo de bloqueio relata a mesma sequência em toda execução e o que causa a interrupção é sempre o mesmo.

Dois armazenamentos são verificados e ambos relatam da mesma forma: as referências que o arquivo de bloqueio fixa e os plugins registrados como confiáveis para um veredito de aceitar ou rejeitar. Nenhuma das verificações acessa um registro — ambas leem o que já foi registrado —, então o build continua ahead-of-time.

Mensagem emitida. Cada achado é impresso à medida que é percorrido, e a interrupção então repete o que atingiu o limiar e nomeia a configuração que parou o build:

deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)

deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error" (descontinuação: o build consome uma entidade descontinuada: a referência foi retirada, com a mensagem registrada pelo publicador (registrada no arquivo de bloqueio no pull; execute o pull novamente para atualizá-la): halt_on_deprecated_severity tem o valor indicado)

Um marcador em uma das duas severidades de aviso é indicado como deprecated (warning) ou deprecated (error) no lugar de retracted. A distinção é mantida porque os dois significam coisas diferentes — desaconselhado mas ainda selecionável, contra excluído da seleção — e relatar o mais forte como o mais fraco subestimaria o que aconteceu.

Como corrigir: leia a mensagem registrada, que é a explicação do próprio publicador sobre para onde migrar, e migre. Onde você ainda não puder migrar, elevar halt_on_deprecated_severity — ou remover sua configuração — transforma a interrupção de volta em um aviso que você continua vendo; isso é uma aceitação deliberada e não uma solução alternativa, e a notificação continua sendo impressa. Um marcador registrado para uma versão que você não usa mais desaparece quando o arquivo de bloqueio é atualizado com aggrega pull.

A trusted plugin’s recorded digest disagrees with the cached artifact (O digest registrado de um plugin confiável diverge do artefato em cache)

Um plugin vinculado em um papel que aceita ou rejeita um build tem um digest registrado como confiável, e o manifesto em cache do plugin relata um diferente. Os dois são comparados antes de o executável do plugin ser lido, e uma divergência interrompe a resolução ali.

A comparação é o que faz do digest registrado uma autoridade, e não uma repetição. Sem ela, os bytes de um plugin só são verificados contra uma fixação derivada do mesmo manifesto cujos bytes ela então valida — consistente consigo mesma por construção, e incapaz de perceber que o artefato inteiro foi substituído. Comparar o que foi registrado com o que o manifesto relata agora é o que dá a essa verificação uma opinião externa.

Isso é diferente de uma divergência do digest de conteúdo, que relata bytes resolvidos em desacordo com o digest declarado para eles. Aqui nada foi lido, e os bytes podem muito bem concordar com o manifesto; o que diverge é qual artefato está sendo resolvido. Manter os dois separados importa porque as soluções são opostas — um é um artefato corrompido ou adulterado, o outro um plugin legitimamente alterado cuja nova identidade ainda não foi revisada.

Mensagem emitida:

resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports (resolver o plugin em cache: o digest registrado como confiável para ele difere do que o manifesto do plugin no cache de conteúdo relata; revise o que mudou e registre novamente o digest confiável, ou restaure o artefato registrado: o digest registrado como confiável para este plugin não corresponde ao digest que seu manifesto em cache relata)

Como corrigir: descubra o que mudou antes de registrar qualquer coisa novamente — este é um plugin que pode rejeitar seus builds, e o digest registrado é a declaração de que alguém o examinou. Onde a mudança é esperada, porque você atualizou o plugin deliberadamente, revise o novo artefato e registre novamente o digest confiável para ele. Onde não é esperada, restaure o artefato registrado; a divergência está dizendo que a identidade mudou sem que ninguém decidisse que deveria.

An extends: chain cannot be assembled (Uma cadeia de extensão não pode ser montada)

A cadeia extends: de um Component, de uma Feature, de um Manifest ou de uma Release nomeia um pai que não pode ser resolvido, então a cadeia não pode ser transformada em uma única entidade resolvida.

Isso é diferente de um ciclo, que tem sua própria condição e sua própria solução — veja “Cyclic extends chain (Cadeia extends cíclica)” acima —; de uma cadeia além do limite de profundidade, que tem sua própria condição abaixo; e de uma fixação de versão insatisfazível, em que o pai existe e só a versão não.

Mensagem emitida, que nomeia a entidade que contém o extends: não resolvível e a referência que ela declara:

inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (falha na mesclagem de herança: a entidade estende uma referência que nenhuma entidade do catálogo fornece. Verifique se a referência extends nomeia uma entidade presente no catálogo)

Quando a verificação que o relata lê um pai do cache de artefatos sob a fixação de um arquivo de bloqueio — a verificação extends de um build e de aggrega validate --release, aggrega validate sobre todo o catálogo e aggrega inspect, além das mesmas verificações executadas a partir do editor e da ferramenta validate do assistente —, a orientação continua e nomeia o pull: “a base published to a registry is fetched by aggrega pull --release <release>” (uma base publicada em um registro é obtida pelo comando indicado). Validar um único arquivo de entidade não lê nenhum arquivo de bloqueio; portanto, um pull não mudaria nada do que é lido, e a mensagem para no catálogo.

Feature aparece no lugar de Component quando a cadeia que falhou é a de uma Feature. Assim como em um laço, a entidade nomeada primeiro é aquela a partir da qual a resolução começou, e a entidade nomeada na aresta é aquela cuja linha extends: deve ser aberta; ao longo de uma cadeia de vários níveis, as duas diferem.

O extends: de um Manifest é resolvido em relação a outro lugar, então recebe outra orientação. Um Manifest é configuração do operador escrita ao lado da Release, e não conteúdo do catálogo, e seu extends: nomeia um arquivo por caminho relativo ou o metadata.name de um Manifest no próprio diretório da Release — nunca uma entidade do catálogo. Por isso sua mensagem termina com aquilo para o qual a referência não conseguiu ser resolvida e com onde procurar em vez disso:

inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (falha na mesclagem de herança: a entidade estende uma referência que não pôde ser resolvida. Verifique se a referência extends é um caminho relativo ou o nome de um Manifest no diretório da Release)

Esse detalhe final é a falha que a própria busca relatou — o arquivo que não pôde ser lido, ou a varredura que não indexou nenhum Manifest com esse nome —, então ele geralmente diz qual das duas formas foi tentada e por que voltou vazia.

O extends: de uma Release é resolvido em relação a um diretório e aceita uma única forma. Uma Release nomeia seu pai como um caminho relativo — ./base-release.yaml, ou ../shared/base-release.yaml. O diretório em relação ao qual é resolvido é o que contém a Release que escreve a referência, e cada elo de uma cadeia é resolvido em relação ao seu próprio diretório — assim, uma Release no meio da cadeia mantida em um subdiretório nomeia seu pai ao lado de si mesma, onde quer que esteja a Release que um comando nomeia. Um token simples não é um caminho e não nomeia uma Release que o compilador vá procurar, então ele é relatado aqui em vez de ser procurado em um lugar onde não pode ser encontrado:

inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (falha na mesclagem de herança: a entidade estende uma referência que não pôde ser resolvida. Verifique se a referência extends é um caminho relativo para um arquivo de Release, como ./base-release.yaml, resolvido a partir do diretório que contém esta Release)

Como corrigir: para um Component ou uma Feature, confirme que o valor de extends: nomeia uma entidade que o catálogo contém, escrita como o próprio metadata.name dessa entidade — incluindo maiúsculas e minúsculas. Uma base publicada em um registro é lida do cache de artefatos sob a fixação que o arquivo de bloqueio da Release registra para ela; assim, quando a base está em um registro, execute aggrega pull --release <release>: o pull segue a cadeia, obtém a base e a fixa. Para um Manifest, confirme que o arquivo está onde o caminho relativo aponta, ou que um Manifest com esse metadata.name está no diretório da Release e é analisado corretamente. Para uma Release, confirme que o valor começa com ./ ou ../ e que o arquivo para o qual aponta existe e é analisado como uma Release.

An extends: chain runs past the depth bound (Uma cadeia de extensão ultrapassa o limite de profundidade)

A cadeia extends: de um Component, de uma Feature, de um Manifest ou de uma Release termina corretamente, mas passa por mais entidades do que o limite de dez permite.

Ela tem uma condição própria em vez de compartilhar a de cima, porque as duas soluções não têm nada em comum: um pai ausente é uma referência a corrigir, e uma cadeia profunda demais é uma estrutura a achatar. O limite é uma proteção contra um acidente de autoria, e não um limite estrutural — os arquitetos normalmente estendem uma base em um ou dois níveis, e uma cadeia com dez níveis de profundidade costuma ser uma árvore base que cresceu, e não um design deliberado.

Só uma cadeia que TERMINA chega a ela. Uma cadeia que volta sobre si mesma é relatada como um laço, qualquer que seja seu comprimento, então esta condição nunca substitui um ciclo e sua orientação — encurtar a cadeia — nunca é dada para um.

Mensagem emitida, que nomeia o limite e o comprimento que a cadeia atingiu:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (a cadeia extends excede a profundidade máxima. o limite é 10 e esta cadeia vai além dele; encurte a cadeia, ou estenda uma base que fique mais perto da sua raiz)

Feature, Manifest ou Release aparece no lugar de Component quando uma dessas cadeias é a que falhou. O limite é o mesmo dez para todo tipo que declara extends, e ele conta as entidades da cadeia, e não os elos entre elas: uma cadeia de exatamente dez entidades é compilada, e a décima primeira entidade é o que isto relata. Assim, uma entidade que estende uma base que estende uma base — três entidades, dois elos — chegou a três.

Como corrigir: condense o meio da cadeia. Uma cadeia tão profunda geralmente significa que cada nível acrescenta pouco, e juntar vários níveis em uma única entidade base é ao mesmo tempo a correção e a estrutura mais clara. Onde os níveis são de fato distintos, uma entidade mais abaixo na cadeia pode estender diretamente uma base mais perto da raiz em vez de herdar por cada nível intermediário. Uma cadeia de Manifest tão profunda costuma ser uma pilha de sobreposições por ambiente — junte os níveis que ninguém varia na base que eles sobrepõem.

An assertion name is declared twice along an extends: chain (Um nome de asserção é declarado duas vezes ao longo de uma cadeia de extensão)

Uma entidade e algo que ela estende declaram ambos uma asserção com o mesmo nome, e as duas declaram regras diferentes. As asserções de uma entidade que estende se somam às da sua base; nunca substituem uma. Assim, um nome declarado duas vezes com duas regras diferentes aposentaria silenciosamente o invariante da base, o que é o oposto daquilo para que serve estender uma entidade.

Declarar o mesmo nome com a regra idêntica não é uma colisão e é compilado. É isso que mantém a verificação idempotente ao longo de uma cadeia: sem isso, uma cadeia de três níveis colidiria com seu próprio nível intermediário toda vez.

A ordem faz parte do contrato, e não é incidental. As asserções são avaliadas na ordem mesclada e a primeira que falha causa a interrupção, então o invariante de uma base é verificado antes do de um descendente, e ao longo de uma cadeia o conjunto se acumula da raiz para baixo.

Mensagem emitida:

assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (nome de asserção declarado duas vezes ao longo da cadeia extends. a asserção já é declarada pelo Component base, com uma regra diferente; renomeie a asserção da entidade que estende; as asserções de uma entidade que estende se somam às da base e nunca substituem uma)

Como corrigir: renomeie a asserção da entidade que estende, que a mensagem nomeia junto com a base que já a declara. Onde você pretendia substituir a regra da base, isso não é algo que a extensão suporta — restrinja a asserção da base para que ela valha para toda entidade que a estende, ou mova a regra para baixo, para as entidades que realmente precisam dela. Onde as duas regras devem ser iguais, torne-as textualmente idênticas e a colisão desaparece.

Uma Release roteia os componentes do seu Aggregate de uma de duas maneiras: fronteiras nomeadas sob boundaries:, ou componentes de nível superior sob components:. As duas são mutuamente exclusivas, e um único documento que declare ambas é recusado já na leitura. Esta condição é a mesma regra ao longo de uma cadeia extends:: uma base que declara fronteiras nomeadas e um filho que declara componentes de nível superior são, cada um, bem formados por si sós, e é apenas ao fundi-los que as duas escolhas se reúnem em uma única Release resolvida.

Nenhum dos dois documentos está errado por si só, e é por isso que a mensagem nomeia ambos e ambas as chaves. Um diagnóstico que nomeasse apenas a Release para a qual a build foi apontada levaria você ao arquivo que não tem nada de errado.

Uma cadeia cujos elos concordam não é afetada. Todo elo que declara fronteiras nomeadas é composto normalmente, assim como todo elo que declara componentes de nível superior. É a mistura que para.

Mensagem emitida, nomeando os dois arquivos e a chave que cada um declara:

release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (a cadeia de extensão da Release compõe tanto fronteiras nomeadas quanto componentes de nível superior: declare uma única estrutura de roteamento em toda a cadeia, nunca ambas — Release, arquivo que declara as fronteiras, arquivo que declara os componentes)

Como corrigir: escolha a estrutura de roteamento que a cadeia deve usar e escreva-a em toda a cadeia. Onde a base declara fronteiras nomeadas, um filho que quer configurar componentes os endereça dentro da fronteira que os contém, e não na raiz da Release — e é também isso que permite a ele alterar o dimensionamento de um componente sem redeclarar a topologia. Onde a base declara componentes de nível superior, um filho que precisa de fronteiras nomeadas está descrevendo uma estrutura de roteamento diferente da de sua base, e é melhor escrevê-lo como uma Release própria do que como filho daquela.

An external input’s URL uses a scheme that is not allowed (A URL de uma entrada externa usa um esquema não permitido)

Uma URL para a qual uma entidade aponta usa um esquema fora do conjunto permitido. Três são permitidos: https; http, mas apenas para um host de loopback, de modo que texto não criptografado só possa alcançar a máquina local; e oci, para conteúdo baixado de um registro.

Mensagens emitidas, para uma URL http que não é de loopback e para qualquer outro esquema:

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: http não criptografado só é permitido para hosts de loopback (esquemas permitidos: https, http para um host de loopback, oci): externalinputs: o esquema da URL não é permitido) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: o esquema não é permitido (esquemas permitidos: https, http para um host de loopback, oci): externalinputs: o esquema da URL não é permitido)

Como corrigir: mude a URL para https, ou para oci onde o conteúdo estiver publicado em um registro. Uma URL http não criptografada para um host remoto é recusada em vez de rebaixada, então apontá-la para o esquema seguro é a correção; um servidor de desenvolvimento local continua funcionando sobre http porque um host de loopback é permitido.

A render requests an external input the lockfile does not pin (Uma renderização solicita uma entrada externa que o arquivo de bloqueio não fixa)

Algo de que uma build precisa é baixado de uma URL que o arquivo de bloqueio não fixa. Uma build renderiza o fechamento que seu arquivo de bloqueio registra e não baixa nada, então não existe nenhuma configuração que permita a esta execução adquirir a URL em vez disso: o fechamento congelado é o que torna uma build reproduzível, e ampliar silenciosamente o conjunto de entradas é a única coisa que ela não deve fazer.

Chegar a esta interrupção é, portanto, informativo, e não um erro de configuração. As fixações estavam completas quando a Release foi resolvida, então uma URL não fixada agora significa que algo mudou desde então — um valor que orienta quais referências uma renderização solicita, um chart que passou a apontar para outro lugar, ou um arquivo de bloqueio resolvido em relação a uma Release diferente.

Mensagem emitida:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (não está fixada no arquivo de bloqueio; execute o comando para fixar cada entrada externa que a renderização desta Release consome e faça a build novamente: externalinputs: a aquisição está desabilitada para entradas não fixadas)

Como corrigir: fixe a entrada. aggrega pull --release <path> renderiza a Release para descobrir quais entradas externas ela consome, baixa cada uma e registra seu digest no arquivo de bloqueio ao lado das fixações de dependências — depois disso, cada build posterior a serve a partir do registro fixado e não precisa de rede alguma. Onde a URL é nova porque algo que você escreveu passou a apontar para ela, resolver a Release novamente é a etapa que foi pulada; onde ela é inesperada, vale a pena encontrar a referência que a introduziu antes de fixá-la.

Fetched bytes do not match a pinned digest (Os bytes baixados não correspondem a um digest fixado)

Uma URL fixada foi baixada novamente — porque sua cópia armazenada estava faltando — e o que voltou não é o que o arquivo de bloqueio fixou. O digest registrado sempre prevalece: nada é gravado no armazenamento e nenhum byte é retornado.

Uma recarga é baixada pelo digest registrado, e não pela tag da URL, de modo que uma tag que foi movida para apontar para outro conteúdo não pode mudar o que uma entrada fixada serve. Chegar a esta interrupção significa, portanto, que foi o próprio conteúdo por trás do digest que não voltou íntegro.

Mensagens emitidas, para conteúdo baixado de um registro e para conteúdo baixado via HTTPS:

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: o digest do manifesto recarregado difere do digest fixado: externalinputs: os bytes baixados não correspondem ao digest fixado) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: o hash dos bytes baixados novamente difere do digest fixado: externalinputs: os bytes baixados não correspondem ao digest fixado)

Como corrigir: trate isso primeiro como uma questão de cadeia de suprimentos, e não como um arquivo de bloqueio a atualizar — a fixação é a afirmação de que exatamente esses bytes eram aquilo contra o que você fez a build, e a recusa é essa afirmação se mantendo. Confirme que a origem ainda publica o conteúdo que o digest nomeia e verifique se algo entre você e ela está reescrevendo as respostas; um proxy ou um espelho servindo um substituto é uma causa comum. Somente quando você souber o que mudou e aceitar a mudança deve fixar novamente com aggrega pull, que registra o novo digest.

A stored external input no longer matches its record (Uma entrada externa armazenada não corresponde mais ao seu registro)

Uma entrada fixada foi lida de volta do armazenamento local e não corresponde ao registro fixado para ela. A verificação é executada a cada leitura, antes de os bytes serem servidos, de modo que um armazenamento corrompido ou adulterado aparece no ponto de uso, em vez de alimentar silenciosamente uma build.

O que é comparado depende de como a entrada é fixada. O conteúdo baixado via HTTPS é fixado calculando o hash do payload, então seu hash é recalculado a cada leitura e ambos os digests são informados. O conteúdo baixado de um registro é fixado pelo digest do seu manifesto, que compromete o payload por meio do próprio manifesto do registro em vez de calcular seu hash diretamente, então uma cópia armazenada é verificada em relação ao tamanho registrado — a verificação completa do digest se ancora, em vez disso, na aquisição e em cada recarga endereçada por digest.

Mensagens emitidas:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: o sha256 do blob no armazenamento difere do digest fixado: externalinputs: o blob no armazenamento não corresponde ao seu registro fixado) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: o tamanho em bytes do blob sha256 no armazenamento difere do que o registro fixado indica: externalinputs: o blob no armazenamento não corresponde ao seu registro fixado)

Como corrigir: exclua o blob problemático do armazenamento e deixe a próxima execução recarregá-lo a partir da origem, o que é verificado em relação ao digest registrado antes que qualquer coisa seja gravada. Se uma recarga então também relatar uma divergência de digest, o desacordo está a montante, e não no local, e a entrada acima é a que deve ser lida. Um armazenamento compartilhado entre máquinas, ou um restaurado de um backup feito no meio de uma gravação, é a causa local habitual.

A guard needs a catalog entity the build resolved and cannot see (Uma guarda precisa de uma entidade do catálogo que a build resolveu e que ela não consegue ver)

Uma guarda semântica procurou a entidade do catálogo por trás do tipo de um componente, e a entidade está ausente da visão que a guarda recebeu — embora a resolução tenha resolvido esse tipo como uma referência ao catálogo. Uma referência realmente impossível de resolver é interrompida antes, na resolução, então chegar a uma guarda com a entidade ausente significa que o conjunto resolvido da build e a visão da guarda se separaram.

A build para em vez de pular a guarda. Pular a guarda aposentaria uma verificação sem nada que dissesse que ela deixou de existir, e os componentes de que a guarda tratava passariam sem exame enquanto a build relataria sucesso.

Um tipo escrito como caminho relativo — começando com ./ ou ../ — não é avaliado aqui: um tipo nunca é lido como arquivo, então um valor assim não nomeia nenhuma entidade do catálogo e é recusado antes, quando as dependências da Release são resolvidas, como uma referência que nenhum catálogo contém. Apenas uma referência ao catálogo na forma de token simples chega a esta interrupção.

Onde quer que a condição ocorra, ela é relatada com as mesmas palavras, de modo que o texto nomeia o tipo e a falha, e não a verificação que a gerou.

Ela também não nomeia nenhum documento nem nenhuma chave dentro de um, o que é deliberado e é o único ponto em que esta interrupção se lê de forma diferente de todas as outras. Toda outra interrupção se posiciona no arquivo e no campo que você editaria para eliminá-la; aqui não existe tal arquivo, então uma posição levaria você a uma chave que não tem culpa. Em vez disso, é relatado o tipo sobre o qual as duas visões divergem, porque é isso que torna a divergência reproduzível para quem a investigar.

Mensagem emitida:

the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (as próprias visões do compilador sobre o catálogo divergem (erro interno: esta build resolveu um tipo de componente para o qual o catálogo que ela lê não tinha depois nenhuma entrada. Trata-se de uma falha no compilador, e não em um documento escrito por um autor, então não há nada a corrigir no Aggregate, na Release ou no catálogo. Relate-a, informando o comando que produziu esta build e o tipo sobre o qual as visões divergem))

Como corrigir: nada nos seus próprios arquivos — isto relata uma inconsistência dentro do compilador, e não uma falha no que você escreveu, e vale a pena relatá-la como um defeito com o tipo que a mensagem nomeia. O tipo do componente quase certamente está correto.

A reference names no entity the catalog holds (Uma referência não nomeia nenhuma entidade que o catálogo contenha)

Antes que uma build renderize qualquer coisa, todo o conjunto de entidades das quais uma Release depende é percorrido e cada uma é fixada, de modo que o arquivo de bloqueio registre exatamente o que a build lerá. Uma referência que o catálogo não consegue responder interrompe esse percurso: nada pode ser fixado para ela, e continuar gravaria um arquivo de bloqueio sem uma entrada de que a build precisará depois, sem nada que avisasse.

A recusa nomeia a referência e o ponto em que ela foi coletada, porque uma entidade é alcançada a partir de muitos pontos e o ponto que a nomeia é onde a correção deve ser feita. Uma referência a biblioteca é relatada sozinha, sem caminho de coleta — uma biblioteca é alcançada a partir das entidades que a referenciam com $ref ou $import, e o nome que falha é toda a falha.

Mensagem emitida, para uma entidade do catálogo — a parte final lista os pontos que a referenciam:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: nenhuma entidade do catálogo corresponde a esta URI: entidade, com os caminhos a partir dos quais é referenciada)

para uma biblioteca:

resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: nenhuma entidade do catálogo corresponde a esta URI: biblioteca)

e para um plugin associado a um socket de provedor, que é nomeado pela chave de configuração do espaço de trabalho que o continha, e não por um documento do catálogo:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: nenhuma entidade do catálogo corresponde a esta URI: entidade, referenciada a partir de .aggrega-config.yaml.plugins.providers)

Onde um arquivo sob os diretórios de catálogo declara o nome que a referência pede sob um tipo de entidade que nenhum catálogo contém — um kind escrito errado, por exemplo —, a nota abaixo desta falha nomeia esse arquivo, o tipo que ele declara e os tipos que um catálogo contém, e omite o conselho sobre onde as entidades locais são lidas, tanto em uma build que preenche seu arquivo de bloqueio quanto em uma que o lê, e em toda outra superfície que relata esta falha; veja Um arquivo do catálogo recusado e a falha que ele explica.

Como corrigir: leia a referência exatamente como a mensagem a cita. Um nome que não existe, uma versão que nunca foi publicada e um nome simples para cujo registro o espaço de trabalho não aponta chegam todos aqui de forma idêntica, então verifique os três nesta ordem: corrija a grafia; confirme que a versão existe; confirme que o registro que a contém está configurado e acessível. Onde a entidade é uma que você escreve localmente, confirme que o arquivo está dentro do catálogo que a build percorre.

Onde aggrega pull, ou aggrega build --auto-pull, para em uma referência a biblioteca enquanto o cache de artefatos contém uma SchemaLibrary que nenhuma entrada do arquivo de bloqueio fixa e que nenhum diretório de catálogo fornece, uma linha remediation: segue a mensagem, nomeando cada uma dessas bibliotecas. Uma biblioteca em cache conta como conteúdo do catálogo somente onde uma entrada do arquivo de bloqueio atesta o seu digest, e o pull registra essa entrada a partir do registro que serve a biblioteca. No modo offline, o pull não pode nem baixar a biblioteca nem registrar uma entrada para ela, então a linha diz para executar aggrega pull --release <release> onde ele consiga alcançar um registro, ou para escrever a biblioteca sob um diretório de catálogo. Com conexão, nenhum diretório de catálogo nem registro que o pull lê serve a biblioteca, então não há entrada a registrar, e a linha indica escrever a biblioteca sob um diretório de catálogo.

A library reference is not written in the identity form (Uma referência a biblioteca não está escrita na forma de identidade)

Um $ref: ou $import: entre bibliotecas nomeia a biblioteca por identidade e depois a entrada dentro dela: o nome simples da biblioteca, opcionalmente um : e uma versão mínima, depois # e o caminho da entrada na superfície que o campo lê. Não há host de registro nessa forma. Por qual registro um nome é resolvido é configuração do espaço de trabalho, e qual versão uma build usa é a resposta do arquivo de bloqueio, então uma referência que trouxesse qualquer um dos dois fixaria no documento algo que a build deveria decidir.

São recusados aqui: um valor que traz um host de registro; uma âncora interna ao documento escrita onde se esperava uma referência entre bibliotecas; um nome de biblioteca vazio; e @ escrito como separador de versão, que é relatado com a grafia corrigida em vez de como uma reclamação genérica sobre a estrutura, porque é o erro que esta forma mais atrai.

Mensagem emitida:

resolve: invalid library reference URI: "<the value as written>" (resolve: URI de referência a biblioteca inválida)

e onde @ foi usado como separador, citando o que o valor deveria conter em vez disso:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: URI de referência a biblioteca inválida: o separador de versão é ’:’, não ’@’ — use o valor corrigido)

Como corrigir: reescreva o valor como <Library>#<entry-path>, adicionando :<version> após o nome da biblioteca somente onde você precisar de um mínimo para a versão que pode ser selecionada. Remova qualquer host de registro. Onde a referência deveria apontar para dentro do mesmo documento, uma âncora interna ao documento é algo diferente de uma referência a biblioteca, e o campo em que você a escreveu espera a forma de biblioteca.

Two consumers of one library require incompatible versions (Dois consumidores de uma mesma biblioteca exigem versões incompatíveis)

Várias entidades podem referenciar uma mesma biblioteca, cada uma indicando uma versão mínima ou nenhuma, e a versão que a build seleciona é a maior versão mínima indicada por qualquer uma delas. É isso que permite que um consumidor que pede menos ainda receba uma versão que o satisfaz, e é por isso que adicionar um consumidor com uma versão mínima mais alta move todos para cima em vez de dividir a build entre duas cópias.

A regra só vale enquanto as versões mínimas concordarem no número de versão inicial. Dois consumidores que indicam versões principais diferentes estão pedindo duas bibliotecas que por acaso têm o mesmo nome, e nenhuma seleção única satisfaz as duas — então, em vez de escolher uma e deixar o outro consumidor ler uma estrutura para a qual não foi escrito, a build para e indica a divergência. Um consumidor que não indica nenhuma versão mínima não participa de nada aqui: a seleção é decidida pelos consumidores que fixaram uma versão.

Mensagem emitida. Os consumidores são comparados em ordem, depois de ordenados: o primeiro a indicar uma versão mínima define a versão principal, e a mensagem lista cada consumidor comparado, até o primeiro, inclusive, cuja versão mínima indica uma versão principal diferente, junto com a versão que ele exigiu — assim, os mesmos documentos sempre nomeiam os mesmos consumidores:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (resolução: conflito na seleção de versão mínima — requisitos de versão de biblioteca incompatíveis: a biblioteca tem consumidores que exigem versões principais incompatíveis: o consumidor quer a versão; o consumidor quer a versão)

Como corrigir: eleve a versão mínima do consumidor mais baixo para a mesma versão principal, que é a resposta comum quando a estrutura mais nova é a que todos querem. Quando as duas versões principais são realmente necessárias ao mesmo tempo, elas são duas bibliotecas: publique a estrutura mais antiga com um nome próprio e aponte para lá o consumidor que precisa dela, para que cada referência nomeie aquilo para o qual foi escrita.

The chain of module imports is deeper than the pin walk descends (A cadeia de importações de módulos é mais profunda do que o percurso de fixação desce)

A fixação percorre cada módulo que um Aggregate importa e depois cada módulo que esses importam, de modo que o conjunto inteiro chega ao arquivo de bloqueio, e não apenas o primeiro nível. Um módulo já registrado não é percorrido uma segunda vez, e é isso que encerra um laço comum — um Aggregate que importa um módulo que o importa de volta termina sem reclamação, tendo registrado cada um uma única vez.

Um limite de profundidade de dez serve de proteção para a cadeia que a detecção de repetições não consegue ver: uma que apresenta uma identidade nova a cada nível, como faz um módulo republicado com uma nova versão a cada passo. O limite é o mesmo que o construtor do grafo aplica, de modo que uma composição que pode ser fixada é também uma composição que pode ser construída.

Mensagem emitida:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (resolução: profundidade de inclusão de subagregados excedida: na profundidade)

Como corrigir: encurte a cadeia. Uma cadeia tão profunda costuma refletir como uma organização está estruturada, e não como a Release está estruturada, então procure níveis que não contribuem com componentes próprios e funda-os no seu pai. Quando cada nível existe apenas para republicar o nível abaixo dele com uma nova versão, as versões são a cadeia: importe diretamente o módulo que você realmente quer, na versão que você quer.

Este é o limite do percurso de fixação. O construtor do grafo aplica o seu próprio, relatado mais abaixo como “Sub-aggregate nesting depth exceeded (Profundidade de aninhamento de subagregados excedida)”, e os dois são relatos separados do mesmo limite atingido em dois pontos — o primeiro enquanto o arquivo de bloqueio está sendo preenchido, o segundo enquanto o grafo está sendo construído.

The catalog view a build was given cannot load the bodies pinning needs (A visão do catálogo fornecida a uma build não consegue carregar os corpos de que a fixação precisa)

Dois dos eixos que a fixação percorre precisam de mais do que uma resposta de versão do catálogo: precisam dos próprios documentos. Os módulos que um Aggregate importa precisam ser lidos para encontrar o que eles importam por sua vez. As Recipes, FeatureRecipes e Plugins que uma build associa precisam ser lidos para encontrar os artefatos e as bibliotecas que eles nomeiam. Uma visão do catálogo que consegue resolver uma versão, mas não consegue devolver esses corpos, deixa os dois eixos sem nada para ler.

Ambos são recusados logo de início em vez de ignorados, e o motivo é o que um salto produziria: um arquivo de bloqueio sem uma classe inteira de entradas, escrito sem reclamação, que uma build posterior reconstrói fielmente e encontra incompleto. Nenhuma das mensagens traz valores próprios, porque nenhuma delas trata de um documento que você escreveu — cada uma indica qual eixo não pode ser calculado:

resolve: catalog lookup cannot load resolved sub-aggregate bodies (resolução: a consulta ao catálogo não consegue carregar os corpos dos subagregados resolvidos) resolve: catalog lookup cannot load resolved recipe and plugin bodies (resolução: a consulta ao catálogo não consegue carregar os corpos de Recipe e de plugin resolvidos)

Como corrigir: nada nos seus arquivos produz nenhuma das duas, e não há nenhuma alteração no que você escreveu que elimine uma delas — a falha está em como a build foi montada, e não no que foi pedido a ela que construísse. Relate-a com o comando que você executou e a configuração do espaço de trabalho com a qual ele foi executado.

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Um plugin annotation-transform nomeia um componente que não lhe foi entregue, ou injeta um valor que nenhuma anotação aceita)

Um operador pode vincular um plugin de governança em um papel que adiciona anotações, e essa vinculação é uma declaração: o operador pediu a transformação, então o que o plugin adiciona é explícito, e não injetado pelas costas de ninguém. O papel é restrito de acordo. O plugin recebe as coordenadas de componentes que os seus documentos declaram e pode adicionar anotações sobre elas, cada uma com um valor que você mesmo poderia ter escrito nessa anotação: uma string ou um objeto de subchaves. A estrutura que ele devolve não admite nenhum outro campo, então o que resta verificar quando a sua saída é aplicada é se cada injeção nomeou uma coordenada que lhe foi entregue e se cada valor é um que uma anotação aceita.

Uma injeção que nomeia um par de fronteira e componente fora desse conjunto interrompe a build. Um plugin que alcançasse um componente que os seus documentos nunca expuseram estaria configurando uma infraestrutura que ninguém declarou, e as anotações que ele adiciona são expandidas em vinculações de Feature exatamente como as escritas pelo autor, de modo que o efeito seria o surgimento de recursos a partir de um componente que o operador não colocou diante dele.

Uma injeção cujo valor é null, uma lista, um número, um booleano ou um objeto sem subchaves também interrompe a build. Null e um objeto vazio são lidos como o valor que você escreve para excluir um componente de uma anotação que ele herdaria, e o papel adiciona anotações em vez de removê-las; as outras estruturas não são valores que uma anotação aceita. A saída inteira é verificada antes que qualquer parte dela seja aplicada, de modo que uma saída recusada não altera nada.

Cada injeção aceita também carrega uma anotação acompanhante, aggrega.ai/injected-by, que nomeia o plugin que a fez. É o host que escreve essa anotação; um plugin não pode fornecer uma, de modo que o que ela diz sobre a origem de uma anotação injetada não cabe ao plugin moldar.

Mensagem emitida, para uma coordenada que não foi entregue ao plugin e para um valor que nenhuma anotação aceita:

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (a saída do plugin annotation-transform foi rejeitada: uma injeção aponta para uma coordenada de componente que o host não forneceu, ou carrega um valor que não é uma string nem um objeto de subchaves: a injeção aponta para a fronteira, componente (anotação)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (a saída do plugin annotation-transform foi rejeitada: uma injeção aponta para uma coordenada de componente que o host não forneceu, ou carrega um valor que não é uma string nem um objeto de subchaves: a injeção para a fronteira, componente (anotação) carrega uma lista; um valor de anotação injetado é uma string ou um objeto de subchaves)

Como corrigir: a falha é do plugin, e não dos seus documentos — corrija-o para que injete apenas nas coordenadas que lhe são entregues, cada uma das quais chega na sua entrada, e apenas uma string ou um objeto de subchaves como valor. Se o componente na mensagem é um que você esperava que o plugin visse, verifique se a Release o declara dentro de uma fronteira: apenas coordenadas de componentes declarados são repassadas. Remover a vinculação de plugins.governance é a forma imediata de desbloquear uma build enquanto o plugin é corrigido.

A plugin reference is not a Plugin entity (Uma referência de plugin não é uma entidade Plugin)

Um plugin é referenciado pela sua entidade Plugin, sempre com o escopo do próprio tipo de socket do plugin: <pluginType>/<name>, opcionalmente com uma versão, como em parser/yaml ou parser/yaml:1.0.0. O escopo é obrigatório, e não uma forma entre várias — um name:version sem escopo é recusado, porque dois sockets podem conter um plugin com o mesmo nome e é o escopo que torna a entidade resolvível. O binário para o qual a entidade aponta é alcançado por meio da entidade, nunca nomeado diretamente, de modo que é a entidade que carrega a declaração de capacidade, os limites de execução e o conjunto de comandos registrado com os quais o carregamento verifica o binário. Uma referência que não nomeia nenhuma entidade Plugin, portanto, não tem nada com que verificar o binário, e a build para em vez de carregar bytes a partir de uma referência não verificada.

Duas estruturas são relatadas aqui, e elas são verificadas em momentos diferentes. Uma referência cuja forma não pode ser uma entidade — um caminho do sistema de arquivos, ou uma referência de artefato como uma URL oci://, um .wasm simples ou um digest @sha256: — é recusada logo de início nas superfícies que aceitam apenas referências de entidade. Uma referência que não nomeia nenhuma entidade que algo contenha é recusada após a consulta, e o que a mensagem diz depende de como ela está escrita: uma URI de entidade Plugin — <pluginType>/<name>, opcionalmente com versão — é relatada como uma entidade que nenhum diretório de catálogo contém, que o binário não inclui e que nenhum pull baixou, e a qualquer outra referência é dito que adote essa forma. As duas estruturas relatam a mesma condição, de modo que a resposta de uma build a qualquer uma delas é a mesma.

Um pull recusa a segunda estrutura antes que uma build a encontre. Cada Plugin que a pipeline de uma Recipe ou de uma FeatureRecipe nomeia é resolvido junto com o restante das dependências da Release — a partir de um diretório de catálogo, da cópia dentro do binário do compilador, do cache de conteúdo ou de um registro — e um que nenhum deles contém interrompe o aggrega pull antes que ele escreva o arquivo de bloqueio, com esta condição e a mesma mensagem, nomeando a Recipe ou a FeatureRecipe cuja pipeline o nomeia.

Nem toda superfície recusa uma forma que não é uma entidade. A superfície de plugins de pipeline aceita apenas referências de entidade; as superfícies às quais um operador vincula um plugin diretamente aceitam qualquer forma e repassam uma referência que não é uma entidade para ser resolvida como artefato. Assim, a mesma referência pode ser aceita em um ponto de vinculação e recusada em outro, e essa diferença é da superfície, e não da referência.

Mensagens emitidas. Um caminho do sistema de arquivos:

plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (a referência de plugin não é uma entidade Plugin: é um caminho do sistema de arquivos, mas um plugin de pipeline deve ser uma URI de entidade Plugin com escopo de tipo de plugin (opcionalmente com versão))

uma referência de artefato:

plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (a referência de plugin não é uma entidade Plugin: é uma referência de artefato (um esquema de URL, um arquivo Wasm simples ou um digest), mas um plugin de pipeline deve ser uma URI de entidade Plugin com escopo de tipo de plugin (opcionalmente com versão))

uma URI de entidade Plugin que nada contém:

plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (a referência de plugin não é uma entidade Plugin: é uma URI de entidade Plugin, mas nenhum diretório de catálogo contém a entidade que ela nomeia, o binário não a inclui e nenhum pull a baixou para o cache de conteúdo; coloque a entidade Plugin em um diretório de catálogo, ou publique-a em um registro e execute o pull)

e qualquer outra referência que não nomeie nenhuma entidade — uma sem escopo de tipo de plugin, com mais de uma / antes da sua versão, ou que carregue um host de registro:

plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (a referência de plugin não é uma entidade Plugin: deve ser uma URI de entidade Plugin com escopo de tipo de plugin (opcionalmente com versão); uma referência a um arquivo Wasm simples ou uma referência de artefato não nomeia nenhuma entidade Plugin)

Como corrigir: escreva a referência como a identidade da entidade Plugin com escopo de tipo de socket, opcionalmente com a sua versão — <pluginType>/<name> ou <pluginType>/<name>:<version>. Se você estava apontando diretamente para um arquivo ou um artefato, publique ou escreva uma entidade Plugin para ele e referencie-a no lugar — a entidade é onde ficam as declarações que o carregamento verifica, então não existe forma equivalente que a dispense. Se a mensagem diz que a referência é uma URI de entidade Plugin, a sua forma está correta e o que falta é a entidade: coloque a entidade Plugin em um diretório de catálogo que o espaço de trabalho lista, com o seu .wasm compilado ao lado, ou publique o plugin em um registro que o espaço de trabalho lê e execute aggrega pull, que o baixa para o cache de conteúdo — e verifique se a versão que você indica existe.

A cached signature bundle does not match the digest recorded for it (Um bundle de assinatura em cache não corresponde ao digest registrado para ele)

Um artefato cuja assinatura foi verificada quando ele foi baixado leva esse fato adiante em sua entrada do arquivo de bloqueio — ou, para um plugin vinculado a um papel de veredito, em sua entrada em plugins-trust.yaml — como um digest registrado do material de assinatura, armazenado em cache ao lado do artefato. Antes que qualquer coisa seja renderizada, a build relê esse material em cache para cada entrada que lê e que registra um — uma entidade de catálogo de qualquer tipo, uma biblioteca, um plugin — e recalcula o hash, que precisa ser o registrado. Um plugin que o arquivo de bloqueio fixa, e um plugin vinculado a um papel de veredito, tem seu material verificado novamente quando seus bytes são carregados, e é isso que alcança os comandos que carregam um plugin fora de uma build — entre eles aggrega lint --release e aggrega validate --release. Um bundle ausente, ilegível ou cujo hash é outro significa que o material revisado não é o que está no disco agora, e a execução é interrompida em vez de usar um artefato cuja evidência de assinatura mudou sem que o registro acompanhasse.

A nova verificação é uma comparação de hashes e nada mais. Ela não verifica novamente nenhuma assinatura, não contata nenhuma rede e não consulta nenhum material de confiança, então vale mesmo em uma build sem nenhum acesso à rede — e é isso que permite que um artefato verificado uma vez continue verificado nas builds offline posteriores.

O próximo pull o repara. Um pull submete à mesma verificação cada entrada que o cache de conteúdo serviu e, onde a verificação recusa uma entrada, pergunta novamente ao registro do artefato sobre a assinatura — seja qual for o requisito de assinatura, pela mesma verificação que recebe um artefato que ele baixa —, registra na entrada o que essa verificação confirma e armazena em cache o bundle que ela nomeia, reescrevendo uma cópia em cache que não corresponde mais ao seu digest. Um plugin vinculado a um papel de veredito é verificado novamente a cada pull, seja o que for que sua entrada registre, e seu bundle é armazenado em cache da mesma forma. Por isso a mensagem de uma entrada que o cache de conteúdo serviu nomeia esse pull. Uma entrada lida de um diretório de catálogo, da cópia dentro do binário do compilador ou de junto da Release nunca é consultada em um registro, então um pull deixa como está uma assinatura registrada nela, e sua mensagem não nomeia nenhum pull.

Mensagens emitidas, que nomeiam o artefato, o arquivo em cache e — para uma entrada que o cache de conteúdo serviu — o pull que a repara, o arquivo em que ele registra a assinatura e a Release que ele baixa. Da verificação da build, ilegível ou ausente:

artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefato: o bundle de assinatura em cache está ilegível: o bundle de assinatura em cache não corresponde ao seu digest registrado. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

e divergente:

artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefato: o bundle de assinatura em cache tem um digest diferente do registrado: o bundle de assinatura em cache não corresponde ao seu digest registrado. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

e, quando os bytes de um plugin são carregados do cache de conteúdo, nomeando também de onde vieram:

plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin resolvido a partir de sua origem: o bundle de assinatura em cache está ilegível: o bundle de assinatura em cache não corresponde ao seu digest registrado. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin resolvido a partir de sua origem: o bundle de assinatura em cache tem um digest diferente do registrado: o bundle de assinatura em cache não corresponde ao seu digest registrado. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

<file> é o arquivo de bloqueio da Release, ou plugins-trust.yaml no diretório da Release. Para uma entrada sobre a qual nenhum pull pergunta, a mensagem termina antes de remediation:.

Um pull que não tem nenhum registro a consultar é interrompido em vez disso. Uma entidade de catálogo ou uma biblioteca é nomeada sem registro e é associada a um por meio do default_registry do espaço de trabalho. Onde o espaço de trabalho não nomeia nenhum — nomeava quando a assinatura foi registrada, e não nomeia mais —, nenhum registro está configurado para ser consultado novamente sobre a entrada, então o pull é interrompido com esta condição em vez de escrever um arquivo de bloqueio que a próxima build recusa, e deixa o arquivo de bloqueio como estava. Sua mensagem traz, depois da etapa que o pull estava executando:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (verify: registra uma assinatura que uma build não aceita, e nenhum registro está configurado para ser consultado novamente sobre ela: o bundle de assinatura em cache está ilegível: o bundle de assinatura em cache não corresponde ao seu digest registrado)

Como corrigir: nada nos seus arquivos de entidade causa isso — o cache é da build, não seu. Execute aggrega pull --release <release>, o comando que a mensagem nomeia: ele verifica novamente a assinatura do artefato e grava juntos a assinatura e seu bundle, o que repara um bundle removido ou alterado desde o pull que o armazenou em cache. No modo offline esse pull é interrompido — com a recusa offline, porque reparar significa consultar o registro, ou, para um plugin vinculado a um papel de veredito, antes disso, nomeando o .wasm do plugin como um que não conseguiu resolver, porque um pull resolve esse .wasm a partir do registro do plugin; permitir a rede para essa única execução o repara. Onde o pull é interrompido dizendo que nenhum registro está configurado para ser consultado sobre a entrada, defina default_registry como o registro do qual o pull do artefato foi feito, e faça o pull novamente. Onde o espaço de trabalho ignora a verificação de assinatura para o artefato, o pull, em vez disso, não registra nenhuma assinatura na entrada, o que a build admite sob essa mesma configuração. Onde a assinatura que o registro serve não é verificada, o pull é interrompido com a recusa da própria verificação: a assinatura registrada e o material que o publicador serve realmente divergem, e essa é uma questão para quem publica o artefato. Para uma entrada cuja mensagem não nomeia nenhum pull — uma lida de um diretório de catálogo, da cópia dentro do binário do compilador ou de junto da Release —, remova a signature da sua entrada: uma entrada assim nunca é submetida a um requisito de assinatura, então a build segue em frente.

A recorded signature was made for a different artifact (Uma assinatura registrada foi feita para um artefato diferente)

Uma assinatura diz para qual artefato foi feita. Quando um pull verifica a assinatura de um artefato, ele registra o fato na entrada do arquivo de bloqueio do artefato — ou, para um plugin vinculado a um papel de veredito, na sua entrada em plugins-trust.yaml — e armazena em cache a assinatura que verificou. Antes que qualquer coisa seja renderizada, a build lê, na assinatura em cache de cada entrada que o cache de conteúdo serviu, para qual artefato ela foi feita, e esse tem de ser o artefato que a própria build leu para a entrada: aquele cujo manifesto é mantido ao lado dos seus bytes no cache de conteúdo, nunca algo que a entrada registra. Uma assinatura feita para um artefato diferente interrompe a build. É assim que se apresenta uma signature copiada de uma entrada para outra: a assinatura em cache que ela nomeia está intacta — ainda corresponde ao digest registrado para ela — e foi feita para o artefato da outra entrada.

Não depende de um requisito de assinatura. Uma assinatura registrada é confrontada com o que afirma, seja ou não exigida uma assinatura, assim como acontece com a verificação de que a assinatura em cache corresponde ao seu digest registrado.

Um plugin é verificado da mesma forma onde quer que seja carregado. Um plugin que o arquivo de bloqueio fixa, e um plugin vinculado a um papel de veredito, tem sua assinatura registrada confrontada com o artefato do qual seus bytes foram lidos quando esses bytes são carregados do cache de conteúdo, o que alcança os comandos que carregam um plugin fora de uma build — entre eles aggrega lint --release e aggrega validate --release, e as mesmas operações acessadas por meio de aggrega serve e aggrega mcp.

O que a verificação lê e o que ela não consegue distinguir. Ela lê a assinatura em cache e o manifesto ao lado do artefato, e compara hashes: não verifica nenhuma assinatura, não contata nenhuma rede e não consulta nenhum material de confiança, então vale mesmo em uma build sem nenhum acesso à rede. Ela lê para qual artefato uma assinatura foi feita nas duas formas que um pull aceita — uma assinatura feita sobre o próprio artefato, que é o que os signatários da própria cadeia de ferramentas produzem, e uma declaração assinada que nomeia o artefato —, então uma assinatura copiada de uma entrada para outra é recusada em qualquer das duas formas. É a mesma leitura que um pull aplica a cada assinatura que aceita: um pull recusa uma assinatura que é verificada, mas que a leitura não encontra feita para o artefato, ou da qual não consegue ler o artefato de forma alguma, então nenhuma assinatura que um pull registra é uma que a verificação não consiga ler. Uma entrada lida de um diretório de catálogo, da cópia dentro do binário do compilador ou de junto da Release vem sem manifesto, então sua assinatura registrada é confrontada apenas com seu digest registrado; o mesmo vale para uma assinatura colocada à mão no cache em uma forma que não é nenhuma dessas duas. E como nenhuma assinatura é verificada, uma assinatura escrita à mão no cache, emitida para o próprio artefato da entrada, não é distinguida de uma que um pull verificou.

O próximo pull o repara. Um pull submete à mesma verificação cada entrada que o cache de conteúdo serviu e, onde a verificação recusa uma entrada, pergunta novamente ao registro do artefato sobre a assinatura — seja qual for o requisito de assinatura — e registra na entrada o que essa verificação confirma no lugar da assinatura copiada. Um plugin vinculado a um papel de veredito é verificado novamente a cada pull, seja o que for que sua entrada registre. Somente em uma entrada que o cache de conteúdo serviu se verifica para qual artefato sua assinatura foi feita, então cada recusa desta condição por uma build ou por um carregamento de plugin nomeia esse pull.

Mensagens emitidas, que nomeiam a entrada, o arquivo que registra a assinatura, a assinatura em cache, o manifesto que a build leu para a entrada e o pull que a repara. Da verificação da build:

artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artefato: signing: a assinatura registrada foi feita para um artefato diferente, com o arquivo que a registra, o bundle de assinatura em cache e o manifesto do artefato lido. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

e, quando os bytes de um plugin são carregados, nomeando também de onde vieram:

plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin resolvido a partir de sua origem: signing: a assinatura registrada foi feita para um artefato diferente, com o arquivo que a registra, o bundle de assinatura em cache e o manifesto do artefato lido. correção: execute o pull para verificar novamente a assinatura do artefato em seu registro, registrá-la no arquivo e armazenar em cache o bundle que ela nomeia)

<file> é o arquivo de bloqueio da Release, ou plugins-trust.yaml no diretório da Release.

Um pull que não tem nenhum registro a consultar é interrompido em vez disso, como acontece com um bundle de assinatura em cache que não corresponde mais ao seu digest: onde uma entidade de catálogo ou uma biblioteca traz uma assinatura copiada e o espaço de trabalho não nomeia mais um default_registry ao qual associá-la, o pull é interrompido com esta condição e deixa o arquivo de bloqueio como estava. Sua mensagem traz, depois da etapa que o pull estava executando:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>) (verify: registra uma assinatura que uma build não aceita, e nenhum registro está configurado para ser consultado novamente sobre ela: signing: a assinatura registrada foi feita para um artefato diferente, com o bundle de assinatura em cache e o manifesto do artefato lido)

Como corrigir: nada nos seus arquivos de entidade causa isso — a assinatura que a entrada registra pertence a outro artefato. Execute aggrega pull --release <release>, o comando que a mensagem nomeia: ele verifica a própria assinatura da entrada em seu registro e a registra no lugar da copiada, tanto para uma entrada do arquivo de bloqueio quanto para um plugin vinculado a um papel de veredito. Restaurar do controle de versão a própria assinatura registrada da entrada, onde o arquivo está commitado, também funciona. No modo offline o pull é interrompido — com a recusa offline, porque reparar significa consultar o registro, ou, para um plugin vinculado a um papel de veredito, antes disso, nomeando o .wasm do plugin como um que não conseguiu resolver, porque um pull resolve esse .wasm a partir do registro do plugin; permitir a rede para essa única execução o repara. Onde o pull é interrompido dizendo que nenhum registro está configurado para ser consultado sobre a entrada, defina default_registry como o registro do qual o pull do artefato foi feito, e faça o pull novamente. Onde o espaço de trabalho ignora a verificação de assinatura para o artefato, o pull, em vez disso, não registra nenhuma assinatura na entrada, o que a build admite sob essa mesma configuração.

No verified signature is recorded for an artifact that requires one (Nenhuma assinatura verificada está registrada para um artefato que exige uma)

Um pull que baixa um artefato de um registro verifica sua assinatura em relação à política de confiança desse registro e registra o fato verificado na entrada do arquivo de bloqueio do artefato. Uma build não alcança nenhum registro, então lê o fato registrado em vez de verificar de novo — e, antes que qualquer coisa seja renderizada, submete cada entrada que lê ao requisito que o pull aplicou quando baixou o artefato. Uma entrada servida pelo cache de conteúdo, para um artefato para o qual uma assinatura é exigida, que não registra nenhuma assinatura verificada interrompe a build: nada do que a build tem diz que o artefato a partir do qual ela está prestes a renderizar foi alguma vez verificado.

O requisito é o do pull, configuração por configuração. Uma assinatura é exigida onde a política de assinatura de todo o espaço de trabalho cobre o tipo do artefato, ou onde a própria entrada do registro em .aggrega-config.yaml — ou, para hub.aggrega.ai sem entrada própria, a política embutida do hub oficial — exige uma; um artefato cujo tipo não pôde ser determinado conta como exigido sob uma política ativa. O que permite a um pull admitir um artefato sem assinatura permite também à build admitir sua entrada: skip_signature_verification no nível superior, a mesma opção na própria entrada do registro, exceto para um tipo que a política de todo o espaço de trabalho exige, e um registro marcado como advisory.

De onde uma entrada veio é lido da build, nunca do arquivo de bloqueio. Toda entrada servida pelo cache de conteúdo é submetida ao requisito, independentemente do que mais a entrada registre, então remover o digest do manifesto de uma entrada junto com sua assinatura não a isenta. Uma entrada lida de um diretório de catálogo, da cópia embutida no binário do compilador ou de junto da Release nunca é submetida a ele, porque não existe nenhuma assinatura de registro para bytes que não vieram de um. Entradas de todas as seções são verificadas igualmente — entidades de catálogo, bibliotecas e artefatos de plugin — e toda entrada que a verificação recusa é nomeada na mesma execução.

Um plugin vinculado em um papel de veredito é submetido à mesma verificação, por meio de plugins-trust.yaml. Uma vinculação plugins.governance em um papel ir-verdict ou render-verdict, e toda vinculação plugins.linter, não molda nenhum byte renderizado, então não tem entrada no arquivo de bloqueio; o arquivo de confiança ao lado do arquivo de bloqueio carrega sua assinatura verificada em vez disso. Cada plugin desse tipo que a build lê do cache de conteúdo é submetido ao mesmo requisito, pelas mesmas configurações: uma entrada nesse arquivo de confiança que não registra nenhuma assinatura interrompe a build, e o mesmo acontece se não houver nenhuma entrada para o plugin — excluir o arquivo de confiança não o isenta. Um plugin servido de um diretório de catálogo ou da cópia embutida no binário do compilador não é submetido a ele. O requisito vale para esse plugin onde quer que ele seja carregado para uma Release, não só em uma build: aggrega lint --release e aggrega validate --release, e as mesmas operações alcançadas por meio de aggrega serve e aggrega mcp, falham nessa condição quando o carregam.

Mensagens emitidas, nomeando a entrada, o arquivo que não registra nenhuma assinatura para ela, as configurações que exigem sua assinatura e o comando que a registra nesse arquivo. Para uma entrada do arquivo de bloqueio, nomeando o arquivo de bloqueio:

signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (signing: nenhuma assinatura verificada está registrada para um artefato que exige uma: o arquivo de bloqueio não registra nenhuma assinatura para ele, exigida pelas configurações indicadas. correção: execute o pull para verificar a assinatura do artefato no seu registro e registrá-la no arquivo de bloqueio)

e para um plugin vinculado em um papel de veredito, nomeando seu arquivo de confiança:

signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (signing: nenhuma assinatura verificada está registrada para um artefato que exige uma: o arquivo de confiança não registra nenhuma assinatura para o plugin, exigida pelas configurações indicadas. correção: execute o pull para verificar a assinatura do plugin no seu registro e registrá-la no arquivo de confiança)

Ambos os arquivos são nomeados pelo seu caminho ao lado da Release que foi dada ao comando: <lockfile-path> é o arquivo de bloqueio da Release, e <record-path> é plugins-trust.yaml no diretório da Release.

As configurações são nomeadas com as próprias palavras do arquivo de configuração: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>" ou the official hub's built-in signature requirement for "hub.aggrega.ai", unidas onde mais de uma se aplica.

Como corrigir: execute o pull que a mensagem nomeia. Para uma entrada servida pelo cache de conteúdo que não registra nenhuma assinatura onde uma é exigida, o pull pede ao registro do artefato sua assinatura, pelo digest do manifesto que a entrada registra, exatamente como faz para um artefato que baixa, e registra a assinatura verificada na entrada — assim a próxima build a lê. Sobre um plugin vinculado em um papel de veredito a pergunta é feita a cada pull de qualquer forma, e o pull registra o que verificou na entrada do plugin em plugins-trust.yaml, criando a entrada onde não houver nenhuma. Um registro que não vincula nenhuma assinatura, ou uma assinatura que a configuração de confiança não aceita, interrompe esse pull em vez disso, nomeando o artefato, e essa é uma questão para quem o publica. No modo offline o pull não pode perguntar: sobre uma entrada do arquivo de bloqueio ele recusa indicando como permitir a rede para uma execução, e sobre um plugin vinculado em um papel de veredito ele para antes de perguntar, nomeando o .wasm do plugin como um que não conseguiu resolver, porque um pull resolve esse .wasm a partir do registro do plugin. Restaurar a assinatura registrada da entrada a partir do controle de versão resolve isso sem a rede, onde o cache ainda contém o material de assinatura que essa entrada nomeia. Onde o artefato não deve ser assinado, o que deve mudar é o requisito, e a mensagem nomeia qual configuração é — mas relaxá-lo significa que os artefatos desse registro deixam de ser verificados também em um pull, então prefira restringir os tipos da política de todo o espaço de trabalho a desativar um requisito.

A recorded signature is not the one a pull would record (Uma assinatura registrada não é a que um pull registraria)

aggrega pull --verify relata se executar aggrega pull agora mudaria os arquivos que um pull grava, e a assinatura que um pull verificou para um artefato faz parte do que ele escreve: a signature em uma entrada do arquivo de bloqueio, e em uma entrada de plugins-trust.yaml para um plugin vinculado em um papel de veredito. Esta condição é o que uma verificação relata para cada assinatura registrada que um pull simples escreveria de forma diferente — uma que registraria onde nenhuma está registrada, uma que substituiria ou uma que apagaria. A verificação não escreve nenhum dos dois arquivos e nomeia cada uma dessas entradas, em qualquer dos arquivos, na mesma execução.

Duas entradas do arquivo de bloqueio são relatadas sem perguntar a um registro, porque um pull as reescreve seja qual for a resposta do registro, então elas são relatadas também no modo offline: uma entrada servida pelo cache de conteúdo que não registra nenhuma assinatura onde a configuração de confiança exige uma — o pull registra a assinatura do artefato, ou para onde não consegue estabelecer uma — e uma entrada cuja assinatura registrada foi feita para outro artefato, que o pull substitui pela própria do artefato.

Sobre toda outra entrada que um pull consultaria de novo é feita a pergunta, porque só a resposta do registro diz se o pull a mudaria: uma entrada cujos bytes a verificação baixou porque o cache de conteúdo não os continha, e uma entrada cujo bundle de assinatura em cache foi removido, está ilegível ou foi alterado. A verificação pergunta ao registro como o pull faria, relata a entrada onde a resposta registra, substitui ou apaga sua assinatura, e guarda em cache o bundle que verificou como um pull o guarda. No modo offline não se pergunta sobre essa entrada nem ela é relatada: a verificação imprime uma linha que a nomeia e diz que sua assinatura não foi verificada.

Para o arquivo de confiança de plugins, todo pull verifica a assinatura de cada plugin vinculado em um papel de veredito no seu registro, e uma verificação também: é relatada uma entrada cuja assinatura essa verificação registraria, substituiria ou apagaria, e também um plugin para o qual o arquivo de confiança não contém nenhuma entrada onde uma build o recusa por não registrar nenhuma assinatura, porque um pull escreve uma entrada com sua assinatura e a build recusa o plugin até lá. Qualquer outro plugin que o arquivo de confiança ainda não contém é uma primeira aparição e não é relatado. No modo offline uma verificação não pergunta a nenhum registro sobre esses plugins: ela lê cada um do cache de conteúdo, como uma build o lê, e verifica sua identidade e suas funções host como faz uma verificação conectada. Ela relata sem perguntar um plugin que uma build recusa por não registrar nenhuma assinatura — sua entrada não registra nenhuma, ou o arquivo de confiança não contém nenhuma entrada para ele — e um que uma build recusa porque a assinatura que sua entrada registra foi feita para outro artefato, porque um pull reescreve essa entrada seja qual for a resposta do registro; ela imprime uma linha que nomeia cada outra entrada e diz que sua assinatura não foi verificada.

Marcadores de descontinuação não são comparados. Um marcador vinculado a um artefato depois do pull é o estado do registro e muda sem que nada no espaço de trabalho mude, então uma verificação que falhasse por causa dele faria falhar uma checagem sobre arquivos que ninguém tocou — o motivo pelo qual um marcador registrado avisa uma build em vez de interrompê-la.

Mensagens emitidas, uma por entrada, nomeando a entrada, o arquivo e o que ele registra, o que um pull registraria em vez disso, e o pull que atualiza o arquivo. Onde a resposta do registro, ou a própria verificação do arquivo de confiança, fornece a assinatura que um pull registraria:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: uma assinatura registrada não é a que um pull registraria: o arquivo registra uma assinatura, um pull registraria outra. correção: execute o pull para atualizar o arquivo)

para uma entrada que não registra nenhuma assinatura onde uma é exigida — uma entrada do arquivo de bloqueio ou, no modo offline, uma entrada do arquivo de confiança de plugins:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: uma assinatura registrada não é a que um pull registraria: o arquivo não registra nenhuma assinatura, um pull pediria ao seu registro a assinatura que um requisito exige e a registraria. correção: execute o pull para atualizar o arquivo)

para uma entrada cuja assinatura registrada foi feita para outro artefato — uma entrada do arquivo de bloqueio ou, no modo offline, uma entrada do arquivo de confiança de plugins:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: uma assinatura registrada não é a que um pull registraria: o arquivo registra uma assinatura feita para outro artefato, um pull pediria ao seu registro a própria assinatura deste artefato e a registraria. correção: execute o pull para atualizar o arquivo)

e para um plugin para o qual o arquivo de confiança não contém nenhuma entrada, onde uma build o recusa por não registrar nenhuma assinatura — a segunda forma no modo offline, em que a verificação não pergunta a nenhum registro:

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: uma assinatura registrada não é a que um pull registraria: o arquivo de confiança não contém nenhuma entrada para o plugin e uma assinatura é exigida para ele, um pull registraria uma assinatura. correção: execute o pull para atualizar o arquivo de confiança)

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: uma assinatura registrada não é a que um pull registraria: o arquivo de confiança não contém nenhuma entrada para o plugin e uma assinatura é exigida para ele, um pull pediria ao seu registro a assinatura que um requisito exige e a registraria. correção: execute o pull para atualizar o arquivo de confiança)

<signature> indica uma assinatura pelo seu modo, seu signatário e o digest do seu bundle — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, com issued by <issuer> depois do signatário para uma assinatura sem chave — ou é no signature. <file> é o arquivo de bloqueio da Release, <lockfile-path>, ou plugins-trust.yaml no diretório da Release, <record-path>.

Como corrigir: execute o pull que a mensagem nomeia. Ele escreve no arquivo nomeado a assinatura que a mensagem diz que escreveria, e guarda seu bundle em cache, de modo que a próxima verificação passa. Onde a mensagem diz que um pull perguntaria ao registro, o pull registra o que o registro verifica — e para em vez disso, nomeando o artefato, onde o registro vincula uma assinatura que a configuração de confiança não aceita, ou nenhuma onde uma é exigida, o que é uma questão para quem o publica. No modo offline esse pull para: sobre uma entrada do arquivo de bloqueio com a recusa offline, porque precisa perguntar ao registro, e sobre um plugin vinculado em um papel de veredito antes disso, nomeando o .wasm do plugin como um que não conseguiu resolver, porque um pull resolve esse .wasm a partir do registro do plugin. Permitir a rede para essa única execução atualiza o arquivo. Onde a mensagem diz que um pull não registraria nenhuma assinatura, o registro não vincula mais nenhuma e nada a exige: o pull apaga a assinatura da entrada, o que uma build admite sob as mesmas configurações — se você não esperava que o registro deixasse de assinar o artefato, essa também é uma questão para o seu publicador.

A plugin’s .wasm is not on this machine (O arquivo Wasm de um plugin não está nesta máquina)

O .wasm de um plugin é lido de um de quatro lugares, nesta ordem: os plugins embutidos no binário do compilador, um arquivo ao lado da entidade Plugin do plugin em um diretório de catálogo, um caminho explícito do sistema de arquivos que a referência nomeia e o cache de conteúdo do espaço de trabalho que aggrega pull preenche. Resolver um plugin só lê o que já está na máquina e não baixa nada, então esta condição relata que nenhum dos quatro contém os bytes — não que um download falhou. Um plugin é a exceção: um importador core de que uma importação precisa. Seu módulo é lido apenas do binário ou do cache de conteúdo, nunca de ao lado de uma entidade de catálogo, e, onde nenhum dos dois o contém, a importação o baixa uma vez do registro padrão do espaço de trabalho; a condição então relata também que o download não foi possível — o espaço de trabalho está offline, seu registro não pôde ser alcançado ou não contém o módulo, ou o espaço de trabalho não nomeia nenhum registro padrão. Um módulo que foi baixado e não passa na verificação é recusado sob sua própria condição, uma divergência de digest ou uma recusa de assinatura, e nada é mantido.

O arquivo ao lado da entidade recebe o nome a partir do tipo de plugin e do nome da entidade, e a recusa do pull mais abaixo dá o nome: para pipeline-step/patch é pipeline-step--patch.wasm, no diretório em que fica o documento da entidade.

Uma entidade Plugin escrita em um dos seus diretórios de catálogo é recusada quando o pull a resolve. Um pull nunca baixa o .wasm de uma entidade assim: ele procura nos quatro lugares acima, exatamente onde uma build procura. Uma etapa de pipeline, um provedor ou um plugin vinculado a um papel de veredito não é fixado de forma alguma, e uma build lê sua entidade do diretório de catálogo toda vez. Um plugin vinculado a um papel de transformação é fixado, porque seus bytes moldam a saída renderizada: o pull registra sua entidade e o digest de conteúdo do .wasm que encontrou ali, e uma build recusa um .wasm que não corresponde mais. Assim, um pull que não encontra o artefato em nenhum dos quatro lugares se interrompe ali, antes de escrever o arquivo de bloqueio ou qualquer entity.lock, em vez de deixar uma build falhar mais tarde, na etapa que carrega o plugin. Um .wasm que o binário traz, ou um que já está no cache de conteúdo, satisfaz o pull exatamente como satisfaz a build, então uma entidade para um plugin que é distribuído dentro do compilador não precisa de nenhum arquivo ao lado.

Mensagens emitidas. A recusa do pull, apontando para o diretório em que esperava o arquivo, com a resolução sobre a qual perguntou logo abaixo:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (artefato de plugin não encontrado nesta máquina: a entidade Plugin está escrita em um diretório de catálogo e o arquivo indicado era esperado no diretório indicado. Coloque o .wasm compilado ao lado da entidade com esse nome, ou publique o plugin e faça referência à entidade Plugin publicada em vez da que está no diretório de catálogo)

um plugin que uma build ou uma importação carrega sem nenhuma fonte que contenha seus bytes — e um plugin vinculado a um papel de veredito que aggrega pull --verify no modo offline lê do cache de conteúdo como uma build faz. Onde a entidade Plugin do plugin fica em uma pasta de catálogo, nomeando a versão em que ele está e para onde vai seu módulo:

plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (o plugin, na versão indicada, não está nesta máquina; coloque seu módulo, com o nome indicado, ao lado da sua entidade Plugin no diretório indicado: artefato de plugin não encontrado nesta máquina)

e, nos demais casos, nomeando cada lugar em que o módulo foi procurado:

plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (o plugin não está nesta máquina: o binário não traz seu módulo, nenhuma pasta de catálogo contém sua entidade Plugin e o cache de conteúdo no qual um pull baixa não o contém: artefato de plugin não encontrado nesta máquina)

Um lint, que procura apenas no binário, nomeia somente o primeiro desses lugares.

e o mesmo para uma referência escrita como um local de registro:

plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (plugin não resolvível: uma URI de plugin OCI exige um pull anterior, para que seus bytes estejam em cache, ou um caminho local explícito; a resolução de plugins não baixa de um registro: artefato de plugin não encontrado nesta máquina)

um importador core que uma importação não conseguiu nem ler nem baixar, nomeando o importador, sua versão e o motivo — aqui, o espaço de trabalho estar offline — e depois o que coloca seu módulo na máquina:

core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (o importador core, na versão indicada, não está nesta máquina, e o espaço de trabalho está offline, então seu registro não é consultado; execute a importação uma vez com a rede disponível, o que o baixa do registro padrão do espaço de trabalho, o verifica e o mantém no cache de conteúdo para toda importação posterior, ou coloque seu módulo, com o nome indicado, ao lado de uma entidade Plugin desse importador nessa versão em uma pasta de catálogo: artefato de plugin não encontrado nesta máquina)

Os outros motivos dizem its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version> e the workspace names no default registry to fetch it from; os dois últimos nomeiam apenas a segunda solução, porque uma execução com a rede disponível não os mudaria.

Como corrigir: onde a entidade é uma que você escreve, compile o plugin e coloque seu .wasm ao lado da entidade com o nome que a mensagem dá — ou publique o plugin com aggrega push e faça referência à entidade publicada no lugar da cópia do catálogo, já que nem um pull nem uma build baixam o .wasm de uma entidade do seu catálogo. Onde o plugin é um que você consome de um registro, execute aggrega pull para a Release, o que o coloca em cache. Onde você esperava que o compilador trouxesse o próprio plugin, verifique se o binário que você executa o traz: aggrega plugin list nomeia os plugins embutidos. Onde se trata de um importador core, execute a importação uma vez onde o espaço de trabalho possa alcançar seu registro padrão — essa execução o baixa, o verifica e o coloca em cache, e toda importação posterior é offline — ou, onde esse registro não o contém, coloque seu módulo ao lado de uma entidade Plugin desse importador nessa versão em uma pasta de catálogo, com o nome que a mensagem dá; essa entidade então é executada no lugar do importador core.

A plugin recorded as a trusted gate is no longer attached (Um plugin registrado como controle confiável não está mais vinculado)

Um plugin que retorna um veredito de aceitação ou rejeição sobre uma build é registrado assim que é resolvido, de modo que o espaço de trabalho mantém um arquivo de confiança de quais controles foram revisados. Esta condição é o que relata um controle registrado que nada mais vincula. O motivo pelo qual ela interrompe a build em vez de deixá-la passar silenciosamente é que, caso contrário, sua saída seria indistinguível de uma saída que o controle aprovou: uma build com o controle silenciosamente ausente e uma build que o controle deixou passar produzem os mesmos arquivos, e ninguém que revisasse o resultado conseguiria dizer qual das duas tem em mãos.

É uma questão diferente da de um plugin cujos bytes mudaram. Aquela recusa executar um plugin que não é o revisado — uma questão de identidade. Esta recusa fazer a build com um controle revisado totalmente ausente — uma questão de presença. As soluções diferem de acordo: restaurar o artefato, contra restaurar a vinculação.

O que estabelece e o que não estabelece. Manter a configuração fiel ao arquivo de confiança estabelece que todo controle registrado ainda está vinculado e que o artefato de cada um é o registrado. Não estabelece nada sobre se um controle vinculado retorna algum veredito: uma vinculação cuja função de entrada nomeia uma exportação declarada que não retorna nenhum veredito é executada, não relata nada e deixa a build passar, e nenhuma comparação com o arquivo de confiança percebe isso — o plugin que foi executado é exatamente o registrado e simplesmente não executou nada. Dois casos vizinhos de fato interrompem a build, e são nomeados para que este limite não seja lido como mais amplo do que é: uma função de entrada que nomeia uma exportação que o plugin não declara é recusada quando o plugin é carregado, e uma saída que traz uma chave que a estrutura do veredito não declara é recusada em vez de ser lida como uma lista de vereditos vazia.

Mensagem emitida, nomeando o arquivo de confiança, os controles removidos e as duas soluções:

a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (um plugin registrado como confiável para um veredito de aceitação ou rejeição não está mais vinculado a nenhum papel de veredito: o arquivo de confiança registra o plugin como confiável, mas nenhuma vinculação de veredito na configuração do espaço de trabalho o nomeia; um controle que foi revisado e agora está ausente deixa uma saída indistinguível de uma saída que esse controle aprovou. Vincule o plugin novamente na seção de governança dos plugins a um papel de veredito de IR ou de veredito de renderização, ou na seção do linter; ou, se ele devia sair, execute a atualização direcionada para removê-lo do arquivo de confiança — um pull comum deixa o arquivo de confiança como está, então só uma atualização explícita remove uma entrada)

Onde mais de um controle foi removido, eles são nomeados juntos em um único comando de atualização em vez de um comando cada: uma atualização direcionada aceita vários alvos e deixa intacta toda fixação que não nomeou, então nomeá-los juntos é ao mesmo tempo mais curto e mais restrito do que a atualização completa que a alternativa exigiria.

Como corrigir: a mensagem oferece duas soluções porque só você sabe qual se aplica. Se o controle foi removido por engano, vincule o plugin novamente em plugins.governance a um papel de veredito, ou em plugins.linter. Se ele devia sair, diga isso explicitamente com a atualização direcionada que a mensagem descreve, que é o que remove sua entrada. Não edite nem exclua o arquivo de confiança para eliminar esta condição — ele é o arquivo, confirmado no repositório, do que foi revisado, e um pull comum o deixa como está deliberadamente, porque adotar uma remoção silenciosamente é exatamente o que esta recusa existe para impedir.

A gate recorded as trusted resolves to a different identity (Um controle registrado como confiável é resolvido para uma identidade diferente)

Um plugin que retorna um veredito de aceitação ou rejeição sobre uma build é registrado assim que é resolvido, junto com a versão e o digest do artefato para os quais foi resolvido. Esta condição é o que relata uma resolução posterior quando chega a uma versão diferente ou a bytes diferentes para um controle que o arquivo de confiança já contém, e a execução nunca pediu que essa identidade fosse adotada.

Uma única condição cobre tanto uma versão que mudou quanto bytes que mudaram, porque o arquivo de confiança é endereçado pela identidade do plugin e traz a versão e o digest como campos de uma única entrada: comparar uma resolução com ele é uma única comparação com um único resultado. Uma republicação que não mudou nenhum byte e um novo push na mesma versão são o mesmo evento para quem revisa — a identidade não é mais a que foi revisada.

É uma questão diferente da de um controle registrado que nada mais vincula, que é uma questão de presença e não de identidade. Também é diferente da de um plugin cujos bytes em cache não concordam com o digest registrado: aquela recusa executar um plugin que não é o revisado, e sua solução é restaurar ou registrar novamente o artefato, enquanto esta recusa adotar uma nova identidade sem que isso seja pedido, e sua solução é nomear o plugin em uma atualização. Duas soluções, duas condições.

Pedir a nova identidade é o que um pull já oferece, e há duas maneiras de pedi-la. Uma atualização completa resolve tudo de novo, e uma atualização direcionada resolve de novo os plugins que nomeia; qualquer uma das duas é lida como um pedido da nova identidade, e o arquivo de confiança é atualizado. Qualquer outro pull mantém a identidade registrada e se interrompe, que é o objetivo de registrá-la — um arquivo de confiança que adotasse o que quer que fosse resolvido em seguida seguiria a resolução em vez de governá-la. Uma primeira aparição não é uma divergência: uma identidade que o arquivo de confiança ainda não contém é simplesmente preenchida.

A comparação também é executada em um pull que apenas verifica, que não escreve nem o arquivo de confiança nem o arquivo de bloqueio. Uma verificação que pulasse o arquivo de confiança enquanto verifica o arquivo de bloqueio ao lado dele relataria uma concordância que nunca procurou.

Mensagem emitida, nomeando o plugin, as duas identidades e as duas soluções:

plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (plugin: o arquivo de confiança registra para ele uma versão e um digest como confiáveis, mas esta resolução relata outra versão e outro digest; revise o que mudou e adote-o com a atualização direcionada, ou restaure a identidade registrada: a identidade do plugin registrada como confiável não corresponde mais ao que esta resolução relata)

Como corrigir: decida qual das duas identidades é a que você quer, porque só você pode fazer isso. Se a mudança é intencional — o controle foi republicado e você revisou o que mudou — adote-a com a atualização direcionada que a mensagem descreve, que resolve de novo esse plugin e reescreve sua entrada. Se você não a esperava, a identidade registrada é a que foi revisada: restaure a versão ou o artefato que o arquivo de confiança nomeia e investigue por que a referência agora é resolvida em outro lugar. Não edite o arquivo de confiança para eliminar esta condição — ele é uma declaração, confirmada no repositório, do que foi revisado, e um pull comum o deixa como está deliberadamente, porque adotar silenciosamente um controle alterado é exatamente o que esta recusa existe para impedir.

A Plugin entity’s claims disagree with the plugin’s own self-report (As afirmações de uma entidade Plugin divergem da autodescrição do próprio plugin)

Uma entidade Plugin indica o que oferece o plugin para o qual ela aponta: quais exportações ele tem, sobre o que cada uma delas opera e com qual escopo, e — para um plugin que serve um provedor — como ele se comporta ao renderizar. O plugin informa as mesmas coisas sobre si mesmo quando é carregado. Esta condição é o que uma divergência entre os dois informa.

A comparação é feita por exportação, indexada pelo nome, e corre em uma só direção: tudo o que a entidade afirma deve corresponder, e o plugin pode oferecer mais. Uma entidade que descreve parte da superfície do plugin não é obrigada a enumerar o resto, então uma exportação que o plugin declara e a entidade omite não é uma divergência. O que é uma divergência é uma exportação afirmada que o plugin não declara, ou uma exportação afirmada cujo operates ou scope difere do que o plugin informa. O seletor de forma livre não é comparado.

Quando a entidade também define um bloco de comportamento de renderização, seus campos são comparados um a um — os tipos de entrada, o modo de montagem, o par de delimitadores dos templates de artefato, a anotação do nome de montagem, a afirmação de instância reutilizável, a afirmação de ligação entre fronteiras, a afirmação de entradas omitidas e o diretório de aninhamento — e o primeiro a divergir é o que é nomeado. Uma entidade que não define nenhum bloco desse tipo pula essa comparação inteiramente.

A mesma verificação é executada na publicação, então uma incompatibilidade normalmente aparece antes de a entidade ser publicada, e não quando uma build a carrega.

Mensagens emitidas. Uma exportação afirmada que o plugin não tem:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (a entidade afirma uma exportação que o describe() do plugin não declara: wasm: a afirmação do contrato da entidade não corresponde ao describe() do plugin)

um campo de uma exportação afirmada:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (a exportação da entidade declara um valor de operates, mas o describe() do plugin informa outro: wasm: a afirmação do contrato da entidade não corresponde ao describe() do plugin)

e um campo de comportamento de renderização, informado com a mesma estrutura, nomeando o campo que divergiu:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (a entidade declara um valor de boundary_assembly, mas o describe() do plugin informa outro: wasm: a afirmação do contrato da entidade não corresponde ao describe() do plugin)

Como corrigir: é a afirmação da entidade Plugin que deve ser corrigida, não o seu Aggregate ou a sua Release. Alinhe a afirmação ao que o plugin informa — a mensagem nomeia os dois valores, então em que direção ela precisa mudar fica visível na própria mensagem. Quando a entidade é uma que você publica, regenerá-la a partir do binário é a maneira confiável de fazer os dois concordarem; quando você consome uma entidade publicada, selecione uma versão cuja afirmação corresponda ao binário para o qual ela aponta e relate a divergência a quem a publicou.

A Plugin entity’s recorded command set does not match the plugin (O conjunto de comandos registrado de uma entidade Plugin não corresponde ao plugin)

Um plugin que contribui com comandos de terminal tem esses comandos registrados na sua entidade Plugin. Esse registro é escrito por máquina, e não por um autor: é lido do plugin e anotado, então reflete o binário exatamente. Esta condição é o que informa um registro que deixou de refleti-lo — uma diferença no nome de um comando, no seu texto de ajuda curto ou na ordem em que os comandos são declarados.

A comparação é de igualdade total, e isso é deliberado. As afirmações de capacidade e de exportação em outras partes da entidade são curadas: um autor pode legitimamente descrever parte da superfície e deixar o resto de fora, por isso elas são verificadas como um subconjunto. O registro de comandos não é curado, então qualquer coisa aquém de uma concordância exata significa que o registro se afastou do que o plugin realmente oferece, e uma lista de comandos próxima mas não correta é o que rotearia mal uma invocação.

Um plugin carregado sem uma entidade não é verificado aqui. O registro fica na entidade, então bytes carregados diretamente não trazem nenhum e a comparação não tem contra o que ser executada.

Mensagem emitida, nomeando os dois conjuntos e como registrá-los novamente:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: para o plugin indicado, o espelho de comandos registrado não corresponde aos comandos do describe() do plugin; execute novamente a sincronização de plugins e faça commit do resultado: wasm: o espelho de comandos registrado não corresponde ao describe() do plugin)

A mesma comparação na publicação informa os conjuntos sem a instrução de registrá-los novamente:

plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (para o plugin indicado, o espelho de comandos registrado não corresponde aos comandos do describe() do plugin: wasm: o espelho de comandos registrado não corresponde ao describe() do plugin)

Como corrigir: registre novamente o conjunto a partir do binário e faça commit do resultado — a mensagem nomeia o comando que faz isso. Não edite o registro à mão para que corresponda: ele é gerenciado por máquina, e uma edição à mão que concorda hoje é derivada novamente e sobrescrita na próxima vez que for registrado. Quando você consome uma entidade publicada em vez de publicá-la, a entidade foi publicada com um registro que o seu próprio binário não sustenta, e essa é uma questão para quem a publicou.

A Plugin entity’s recorded version does not match the plugin (A versão registrada de uma entidade Plugin não corresponde ao plugin)

Um plugin informa a versão que a sua build registrou nele, e a sua entidade Plugin também registra uma versão; as duas precisam ser a mesma string. As receitas de build com que os plugins do Aggrega são construídos tiram essa versão da tag que lança o plugin — a própria tag do compilador para um plugin distribuído com o compilador, uma tag própria do plugin para um distribuído fora dele —, então uma build do commit que a tag nomeia informa a versão de lançamento, e uma build de qualquer outro commit informa uma versão de desenvolvimento como 1.0.0-3-g1a2b3c4. Esta condição é o que informa um par que se separou, e ela é verificada antes que qualquer byte seja publicado, para que um par divergente não chegue a um catálogo.

A comparação é uma correspondência exata de strings. Um plugin construído sem uma versão de build registrada informa uma vazia, e esse valor vazio é então o que a versão da entidade precisa igualar — a verificação não trata “nenhuma versão informada” como “qualquer versão aceita”, porque o objetivo dela é que a versão de uma entidade publicada sempre diga o que o seu binário realmente informa.

Mensagem emitida:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (para o plugin indicado, o metadata.version registrado não corresponde à versão do describe() do plugin: wasm: o metadata.version da entidade não corresponde ao describe() do plugin)

Na publicação, a recusa também nomeia o arquivo da entidade, o .wasm e a correção:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (para o Plugin indicado, o metadata.version no arquivo da entidade não corresponde à versão do describe() do .wasm no caminho indicado — defina metadata.version como o lançamento que você está publicando e construa o plugin a partir de um checkout limpo do commit que a tag desse lançamento nomeia, para que ele mesmo informe essa versão; para um novo lançamento, faça commit da entidade com o código-fonte que ela lança e aplique primeiro a tag a esse commit: para o plugin indicado, o metadata.version registrado não corresponde à versão do describe() do plugin: wasm: o metadata.version da entidade não corresponde ao describe() do plugin)

Como corrigir: defina o metadata.version da entidade como o lançamento que você está publicando e construa o plugin a partir de um checkout limpo do commit que a tag desse lançamento nomeia, para que ele mesmo informe essa versão. Para um novo lançamento, faça commit da entidade com o código-fonte que ela lança e aplique primeiro a tag a esse commit — a tag precisa nomear um commit que já contenha a entidade. Não copie para a entidade a versão que o plugin informa: uma build de qualquer outro commit informa uma versão de desenvolvimento, e copiá-la publicaria essa build sob uma versão que nenhuma tag de lançamento nomeia. Quando o plugin não informa versão nenhuma, ele foi construído sem a sua versão registrada; construa-o com a sua versão registrada.

A plugin was built from a working tree with uncommitted changes (Um plugin foi construído a partir de uma árvore de trabalho com alterações sem commit)

A build de um plugin registra a sua versão a partir do commit do qual foi construída, e uma build feita a partir de uma árvore de trabalho com alterações sem commit traz a marca -dirty no final dessa versão — 1.0.0-dirty em uma tag, 1.0.0-3-g1a2b3c4-dirty depois de uma. Uma versão assim é uma versão semântica válida, mas nomeia um commit que não contém os bytes que foram construídos, então ninguém consegue reconstruir o que seria publicado a partir da versão sob a qual seria publicado. Publicar um Plugin recusa um plugin cuja própria versão traz a marca, antes que qualquer byte seja publicado e antes que o registro seja contatado; uma execução de teste também o recusa.

Só a marca é recusada. Uma versão de desenvolvimento construída a partir de um commit, como 1.0.0-3-g1a2b3c4, nomeia um commit que de fato contém o que foi construído, e é publicada; o mesmo vale para uma versão de pré-lançamento como 1.0.0-rc.1. Validar um plugin em relação à sua entidade fora de uma publicação não gera esta condição, já que uma build em desenvolvimento é rotineiramente feita a partir de uma árvore editada.

A verificação lê a versão que o plugin informa sobre a sua própria build, e ela é executada antes da comparação com o metadata.version da entidade — então um plugin construído com alterações sem commit sob uma entidade que registra a versão limpa é informado aqui, e não como uma versão registrada que não corresponde ao plugin.

Mensagem emitida, nomeando o plugin, a versão que ele informa e a solução:

Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty") (para o Plugin indicado, o .wasm no caminho indicado foi construído a partir de uma árvore de trabalho com alterações sem commit — defina metadata.version no arquivo da entidade como o lançamento que você está publicando e construa o plugin a partir de um checkout limpo do commit que a tag desse lançamento nomeia, para que ele mesmo informe essa versão; para um novo lançamento, faça commit da entidade com o código-fonte que ela lança e aplique primeiro a tag a esse commit: o plugin foi construído a partir de uma árvore de trabalho com alterações sem commit, então nenhum commit reproduz a versão que ele informa (com o plugin e a sua versão do describe(), que termina com a marca dirty))

Como corrigir: construa o plugin a partir de um checkout limpo do commit que a tag do lançamento nomeia, para que ele informe a versão de lançamento que a entidade registra. Para lançar a própria alteração, defina o metadata.version da entidade como o novo lançamento, faça commit da entidade com a alteração, aplique a tag a esse commit e construa ali. Fazer commit da alteração e reconstruir, por si só, não abre caminho para um lançamento: o plugin reconstruído informa uma versão de desenvolvimento, e copiá-la para a entidade publicaria a build sob uma versão que nenhuma tag de lançamento nomeia.

A Plugin entity’s recorded host functions do not match the binary (As funções host registradas de uma entidade Plugin não correspondem ao binário)

Um plugin declara quais das chamadas próprias do host ele usa, e esse conjunto é registrado na sua entidade Plugin quando o plugin é publicado — lido do próprio binário, e não escrito por um autor. Quando o plugin é baixado, o conjunto é derivado novamente dos bytes cujo conteúdo acabou de ser verificado, e comparado com o registro. Uma diferença em qualquer das duas direções interrompe o download.

Isso se soma à fixação do conteúdo em vez de repeti-la, e detecta duas coisas que a fixação sozinha não detecta: um binário publicado por algo que não o caminho de publicação comum, que não traz nenhum registro ou traz um que não descreve os seus próprios bytes; e uma falha na própria etapa de registro. A fixação estabelece que os bytes são os bytes que foram fixados; isto estabelece que o que foi anotado sobre eles é verdadeiro para eles.

Uma entidade que não traz nenhum registro é comparada com um conjunto vazio, que corresponde a um plugin que não usa nenhuma das chamadas do host — a mesma concordância benigna em qualquer sentido, então uma entidade sem registro não é recusada por não ter um.

Mensagem emitida, nomeando o plugin, os dois conjuntos e o artefato de onde vieram os bytes:

plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports (para o plugin indicado, o spec.runtime.hostFunctions carimbado não corresponde ao conjunto derivado do .wasm verificado: wasm: o registro carimbado de funções host não corresponde às importações do .wasm)

A mesma comparação executada enquanto um plugin está sendo validado informa os dois conjuntos sem o artefato:

plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports (para o plugin indicado, o registro de funções host registrado não corresponde às importações do .wasm: wasm: o registro carimbado de funções host não corresponde às importações do .wasm)

Como corrigir: nada nos seus arquivos de entidade causa isto e nenhuma alteração no que você escreve resolve. Publique o plugin novamente pelo caminho de publicação comum, que deriva o registro do binário e grava os dois juntos. Quando você consome um plugin publicado, a entidade e o binário para o qual ela aponta foram publicados fora de sincronia, então relate a incompatibilidade a quem o publica, citando os dois conjuntos da mensagem — e não edite o registro à mão para que concorde, já que ele é derivado, e não escrito, e a próxima derivação descarta a edição.

The lockfile no longer matches what the release resolves to (O arquivo de bloqueio não corresponde mais àquilo em que a Release se resolve)

O arquivo de bloqueio de uma Release fixa cada entidade, biblioteca e plugin que a Release alcança, cada um com a versão selecionada e um digest, e registra os próprios arquivos de Release — a Release e cada Release que ela estende — pelo digest de seu conteúdo. O digest de uma entidade cobre o que uma publicação dela carrega: seu documento e cada arquivo que ela nomeia ao seu lado, cada um por seu caminho e seus bytes. O de uma biblioteca e o de um plugin cobrem seus bytes. Resolver a Release novamente produz o mesmo conjunto, e os dois são comparados. Esta condição é o que um desacordo informa.

Todo desacordo é coletado antes que qualquer um deles seja informado, em tudo o que o arquivo de bloqueio fixa, de modo que uma única execução mostra a você o quadro completo, em vez de uma entrada por vez.

Estas estruturas de desacordo são informadas, e vale a pena distingui-las porque as soluções diferem:

  • Uma referência que o arquivo de bloqueio não fixa. A Release agora alcança algo para o qual o arquivo de bloqueio não tem entrada — uma dependência adicionada desde o pull que o escreveu. A entrada nomeia onde a Release a solicita, de modo que uma Recipe ou FeatureRecipe que o Manifest associa é informada com a entrada de mapeamento que a associa, e uma que o nível name associa nomeia a instância ou a vinculação para a qual foi escolhida.
  • Uma referência fixada cujo par se moveu. O arquivo de bloqueio fixa um par de versão e digest e a resolução produziu outro. Trata-se de conteúdo vendorizado cujos bytes mudaram, ou de algo no espaço de trabalho que mudou: o documento de uma entidade ou de uma biblioteca editado, um arquivo que uma entidade nomeia — um chart sob sua fonte, um arquivo que ela importa, o entity.lock ao seu lado — editado, adicionado ou removido, ou o .wasm ao lado da entidade de um plugin substituído. A entrada nomeia a entidade em vez do arquivo; um aggrega pull --release <release> simples nomeia um arquivo que se moveu sob o lock de uma Recipe ou de uma FeatureRecipe, como descreve An entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação). Um registro que serve outros bytes sob uma versão fixada não é informado aqui: o pull que os baixa os recusa, como descreve Fetched or cached bytes do not match the digest committed for them (Os bytes baixados ou em cache não correspondem ao digest declarado para eles).
  • Uma referência fixada que a Release não alcança mais. O arquivo de bloqueio ainda fixa algo de que nada na Release depende mais.
  • Um arquivo de Release editado desde o pull. A Release, ou uma Release que ela estende, não contém mais os bytes que o arquivo de bloqueio registrou para ela. Tudo o que a Release solicita — qual versão da fonte baixar, quais componentes colocar onde — é resolvido a partir do que o arquivo contém, de modo que as fixações registradas podem não descrever mais o que ela agora solicita. Isso é informado aqui, antes que qualquer coisa seja renderizada, em vez de como aquilo em que a renderização teria falhado: uma versão da fonte editada surgiria de outra forma mais tarde como um download que não encontra nenhuma fixação. Um arquivo de bloqueio que não registra nenhum arquivo de Release informa a Release como não registrada, e um arquivo de Release que a Release não estende mais é informado como não mais lido.
  • Uma referência de fonte que se moveu no seu remoto. Uma fonte escrita em um ref: do git é registrada no commit para o qual o ref se resolveu. Cada pull que não é uma atualização pergunta ao remoto para onde o ref aponta agora, e o mesmo faz aggrega pull --verify onde a rede pode ser alcançada; um ref que se resolve para um commit diferente é informado aqui em vez de adotado. Somente esses dois o informam: uma build lê o commit registrado e não pergunta.

A comparação é sobre o conteúdo, de modo que um conteúdo idêntico alcançado por outro caminho não diverge: o que precisa diferir para que isso dispare são os bytes. Para um arquivo de Release, isso inclui um comentário ou uma alteração de espaços em branco, exatamente como acontece com o Aggregate e o Manifest que a Release nomeia. Para uma entidade, é o conteúdo do que ela carrega, de modo que a mesma entidade lida de um diretório de catálogo e baixada de um registro não diverge, nem um checkout cujos arquivos diferem apenas nos bits de permissão, incluindo o bit de execução, nem uma publicação cujo pacote foi compactado de outra forma.

Mensagem emitida. A própria frase da condição a abre, e cada divergência coletada vem em seguida, cada uma nomeando seu eixo — e, para uma entidade, seu tipo, porque uma entidade é identificada pelo tipo e pelo URI juntos; assim, uma Release cujo Aggregate e cujo Manifest compartilham um nome tem duas entradas, e uma edição em qualquer um deles é relatada para aquele que foi editado:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: desatualizado; não corresponde mais àquilo em que sua Release se resolve: entidade, com seu tipo, ausente do arquivo de bloqueio, com o local de onde ela é referenciada) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (a referência indicada mudou no eixo indicado: a versão e o digest do arquivo de bloqueio diferem dos atuais) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (a entidade indicada, do tipo indicado, mudou: a versão e o digest do arquivo de bloqueio diferem dos atuais) <axis> "<uri>" no longer used by the release (a referência indicada no eixo indicado não é mais usada pela Release) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (o documento de Release indicado foi editado depois que o arquivo de bloqueio foi escrito: seu conteúdo não corresponde mais ao digest registrado, então as fixações podem não descrever mais o que ele solicita; resolver a Release novamente registra os arquivos que ela lê como estão agora)

<site> é o local onde a Release solicita a referência, escrito como o caminho até a entrada que a nomeia — manifest.spec.mappings.components.name.db-primary, por exemplo — com até três desses locais listados em ordem e ... depois deles quando há mais. Uma referência cuja resolução não registra nenhum local assim é informada sem o parêntese.

Um pull que informa uma referência de fonte que se moveu nomeia o artefato como seu autor o escreveu, com chart= e module_subdir= onde a fonte os nomeia:

source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release> (source-artifact: a referência indicada se moveu — o arquivo de bloqueio fixa um commit, e ela agora se resolve para outro; adote o destino atual com um pull de atualização)

Uma build imprime a solução depois das entradas:

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile (execute o pull para resolver a Release novamente e reescrever seu arquivo de bloqueio)

Quais comandos exigem que uma release corresponda ao seu arquivo de bloqueio. aggrega build compara antes de renderizar e se interrompe. aggrega validate --release e toda seleção de aggrega inspect que resolve uma release — a visualização padrão, --resolved, --ir-graph e --closure — executam a mesma comparação assim que as dependências da release são resolvidas e se interrompem com a mesma mensagem e a mesma correção, sem escrever nada na saída padrão; assim, nenhum deles deixa passar um arquivo de bloqueio que um build recusa por estar desatualizado. As ferramentas do assistente build, validate com um release e describe com um release recusam nos mesmos termos. aggrega pull executa a comparação em relação ao arquivo de bloqueio que está prestes a escrever, e aggrega pull --verify em relação ao que está no disco. Um comando que não resolve nenhuma release — aggrega validate sem argumento, que lê as fixações do arquivo de bloqueio apenas para encontrar um pai de extends, ou com o caminho de uma entidade, e aggrega inspect --raw ou --output yaml sem --ir-graph — não é submetido a um arquivo de bloqueio, e uma release sem arquivo de bloqueio ao lado também não. O servidor de linguagem do editor interrompe seus builds por causa disso e, em uma solicitação de grafo, relata o problema como um aviso no arquivo de bloqueio, enquanto ainda desenha o grafo.

Como corrigir: resolva a Release novamente e faça commit do arquivo de bloqueio reescrito. Para tudo o que uma build informa, um aggrega pull --release <release> simples — o comando que a build imprime — é toda a correção: ele resolve a Release como ela está agora, reescreve as fixações que se moveram e mantém todas as outras, de modo que nada que você não tocou se mova. Onde o que se moveu é um arquivo sob a fonte local de uma Recipe ou de uma FeatureRecipe, esse pull primeiro é interrompido nomeando aggrega pin para a entidade, porque registrar a nova fixação ao lado dela é a etapa do autor; execute-o, ou passe --pin-sources ao pull, e o pull elimina a divergência. A única entrada que um pull simples não elimina é uma referência de fonte que se moveu no seu remoto, porque eliminá-la significa adotar o commit que a referência nomeia agora: aggrega pull --upgrade --release <release> faz isso, e a entrada o diz — onde o entity.lock da Recipe registra essa fonte, a atualização é interrompida da mesma forma até que o novo commit seja fixado ao lado dela. Leia as entradas antes de fazer isso, porque a terceira estrutura é a que merece uma pausa: uma referência que a Release não alcança mais costuma ser uma dependência que você removeu de propósito, mas onde você não a removeu, outra coisa mudou e a tornou inalcançável. Um par que se moveu em uma referência que você não tocou significa que o conteúdo naquela versão não é o conteúdo que foi revisado, o que é uma questão para quem o fornece, e não algo a adotar sem olhar.

Um pull executa essa mesma comparação com o arquivo de bloqueio que está prestes a escrever e não escreve um que a comparação recuse, de modo que um arquivo de bloqueio que um pull acabou de escrever passa nela para uma build que recebe as mesmas entradas. Onde esta condição volta logo após um pull que foi concluído, as duas execuções receberam entradas diferentes: um diretório de catálogo passado a uma e não à outra, ou uma configuração do espaço de trabalho editada entre elas. Execute o pull e a build sobre as mesmas entradas.

An artifact is not at the source the build was told to find it (Um artefato não está na fonte em que a build foi instruída a encontrá-lo)

Uma referência de catálogo nomeia um artefato e uma versão. Esta condição informa que nada responde a esse par — nem no registro para o qual a referência se resolve, nem no cache local de artefatos do qual a build lê.

Uma build lê o cache; ela não sai para buscar por conta própria. A aquisição é uma etapa separada: o pull que resolve uma Release baixa o que a Release precisa e o grava no cache, e a build então lê o que está lá. Assim, esta condição chega a uma build como uma falha de cache, e chega a um pull como um registro que não tem esse artefato. Onde uma build está configurada para preencher seu arquivo de bloqueio ao iniciar, a aquisição que ela executa é esse mesmo pull.

Mensagens emitidas. Um registro sem essa tag, e um download que resolveu um manifesto cujo blob de conteúdo está ausente:

oci: "<reference>:<version>": oci: artifact not found at remote source (oci: para a referência e a versão indicadas: oci: artefato não encontrado na fonte remota)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: conteúdo para a referência e a versão indicadas: oci: artefato não encontrado na fonte remota)

uma leitura do cache que não encontrou nenhuma entrada, que é a estrutura que uma build encontra:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: falha de cache para a referência e a versão indicadas: oci: artefato não encontrado na fonte remota)

e o mesmo para um artefato em cache cujo manifesto está ausente ao lado dele:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: falha de cache do manifesto para a referência e a versão indicadas: oci: artefato não encontrado na fonte remota)

Como corrigir: verifique primeiro a referência e a versão — uma versão que não existe mais e um nome com um erro de digitação produzem a mesma resposta, e a mensagem cita ambos para que possam ser comparados com o catálogo. Onde a referência está correta, o artefato não foi adquirido: execute o pull para a Release, que baixa o que a Release alcança e preenche o cache. Onde o espaço de trabalho está offline, esse pull precisa ser executado de algum lugar com acesso à rede; uma build offline lê apenas o que já está em cache, e é isso que ela diz quando o cache não o contém.

The registry will not serve an artifact without credentials it accepts (O registro não serve um artefato sem credenciais que ele aceite)

O registro respondeu, e recusou: ou nenhuma credencial foi apresentada, ou as apresentadas não foram aceitas. Isso é diferente de um registro que não pôde ser alcançado de forma alguma — aqui a conversa aconteceu e a resposta foi não.

Quatro momentos a informam, todos enquanto artefatos estão sendo adquiridos ou publicados: a resolução de uma referência, o pull do seu conteúdo, a listagem das versões que um repositório contém, e a verificação de uma credencial no momento em que ela é armazenada.

Mensagens emitidas, cada uma nomeando o que estava sendo solicitado e citando o que o registro respondeu:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: resolução da referência indicada, com a resposta do registro: oci: autenticação necessária ou com falha)

a listagem das versões de um repositório, que nomeia o status em vez disso:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list do repositório indicado, com o código de status: oci: autenticação necessária ou com falha)

e a verificação de uma credencial enquanto ela é armazenada:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: verificação da credencial para o host indicado, com a resposta do registro: oci: autenticação necessária ou com falha)

Onde a falha é exposta por uma etapa que fornece correção, a linha termina com o login a executar no host que ela derivou:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (correção: execute aggrega login, ou docker login, para o host indicado antes de executar novamente aggrega pull —release para a Release indicada)

e, quando uma importação estava buscando um dos importadores core do compilador, o mesmo login antes de executar a importação novamente:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (correção: aggrega login (ou docker login) antes de executar a importação novamente)

Um repositório clássico de charts do Helm ou um arquivo de chart, um fragmento de compose e um repositório Git obtidos por http ou https também relatam esta condição quando o servidor recusa a solicitação como não autorizada, e a remediação deles nomeia a entrada do netrc a adicionar em vez de um login, já que é nesse arquivo que essas obtenções leem sua credencial:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (remediação: adicione ao arquivo netrc uma entrada para o host (com machine, login e password) e depois execute o comando novamente)

Como corrigir: isso cabe ao operador e não ao autor da entidade — nada em um Aggregate, um Component ou uma Recipe o causa. O hub oficial, hub.aggrega.ai, serve a qualquer pessoa o que publica, então ler dele não requer credencial, enquanto publicar nele requer; outro registro pode exigir uma credencial também para leitura. Faça login no host que a mensagem nomeia — ou, para uma origem obtida por http ou https, adicione a entrada do netrc que a remediação nomeia — e execute a aquisição novamente. Se você já fez login, a credencial no armazenamento não é uma que esse host aceite para esse repositório: faça login novamente para renová-la, e verifique se a conta tem acesso de leitura ao repositório para o qual a referência se resolve, já que um repositório privado responde exatamente assim a uma conta que não pode vê-lo. Onde a referência se resolve para um host que você não esperava, o alias de registro ou o registro padrão em .aggrega-config.yaml está apontando para outro lugar.

The netrc file cannot be read (O arquivo netrc não pode ser lido)

Um repositório clássico de charts do Helm ou um pacote de chart, um fragmento de compose e um repositório Git baixados por http ou https obtêm sua credencial do arquivo netrc, que é lido quando uma fonte assim é baixada — por um pull, uma fixação ou uma build que preenche seu arquivo de bloqueio. Qual arquivo é lido, e qual entrada responde a uma requisição, está descrito em Autenticação. Esta condição informa um arquivo netrc que existe e não pôde ser usado: não pôde ser lido — é um diretório, por exemplo, ou você não tem permissão para lê-lo — ou não segue o formato netrc. O formato é lido de forma estrita, porque uma palavra lida no lugar errado desloca todas as palavras seguintes: uma palavra-chave escrita incorretamente transformaria de outra forma a senha seguinte na próxima palavra-chave, e a requisição sairia sem credencial, ou com a errada, enquanto o arquivo parecia correto.

Um arquivo que não existe não é esta condição: ele não contém credenciais, e uma requisição que precisa de uma é respondida pela recusa do servidor. Um arquivo que outros usuários da máquina podem ler também não é esta condição: no Linux e no macOS ele gera um aviso que nomeia o arquivo, e é lido mesmo assim.

A mensagem nomeia o arquivo e, para uma falha de formato, a linha, e diz o que está errado apenas em termos do formato — nunca uma palavra que o arquivo contém, já que uma palavra fora do lugar pode ser uma senha. O diagnóstico não carrega nenhuma categoria: o arquivo netrc é o seu próprio arquivo de credenciais, e não um documento que a build lê.

Mensagem emitida para uma falha de formato, que é uma destas: uma palavra onde se espera uma palavra-chave, uma palavra-chave não seguida do seu valor, um login, password ou account antes de qualquer entrada machine ou default, e uma palavra entre aspas não fechada na linha em que se abre:

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (não foi possível ler o arquivo netrc: no arquivo e na linha indicados há uma palavra onde se espera uma palavra-chave (machine, default, login, password, account ou macdef). Corrija o arquivo, ou defina NETRC com o caminho de outro arquivo netrc a ler em seu lugar)

e para um arquivo que não pôde ser lido, citando o motivo:

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (não foi possível ler o arquivo netrc: o arquivo indicado, com o motivo pelo qual não pôde ser lido. Corrija o arquivo, ou defina NETRC com o caminho de outro arquivo netrc a ler em seu lugar)

Como corrigir: abra o arquivo que a mensagem nomeia. Para uma falha de formato, vá até a linha que ela nomeia: cada entrada é machine <host> — ou default — seguida de login <user> e password <secret>, e uma palavra-chave escrita incorretamente ou deixada sem seu valor é a causa habitual. Para um arquivo que não pôde ser lido, torne-o um arquivo que você possa ler, legível somente por você (chmod 600). Onde o arquivo não for o que você pretendia que fosse lido, defina NETRC com o caminho daquele que você pretendia.

The registry could not be reached (Não foi possível acessar o registro)

A conversa com o registro nunca aconteceu: a resolução de nomes, a conexão ou o handshake seguro falhou. É a contrapartida de um registro que respondeu e recusou — aqui nada foi estabelecido em nenhum sentido, então o estado do artefato na outra ponta é desconhecido, em vez de se saber que está ausente.

Também é o que uma falha de transporte sem causa mais específica relata enquanto a fonte de uma Recipe está sendo adquirida, então nesse caminho é a resposta geral “não foi possível alcançar a outra ponta” e não uma afirmação sobre qual nível falhou.

Mensagem emitida, que nomeia a fonte em aquisição e cita a falha de transporte subjacente, com a correção que a condição traz:

sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported (sourceresolver: com o tipo, a URL e a versão indicados: oci: rede inacessível (causa: a falha de transporte); correção: verifique a conectividade de rede com o host indicado; proxies corporativos normalmente exigem que HTTPS_PROXY seja exportada)

Como corrigir: a correção cabe ao operador e está fora do seu catálogo. Verifique se o host da mensagem está acessível a partir de onde o comando está sendo executado. Onde o ambiente alcança a rede por meio de um proxy, o proxy precisa ser exportado para o ambiente, como indica a correção — um proxy configurado só para um navegador ou um gerenciador de pacotes não será reconhecido. Onde o host está acessível manualmente, mas não daqui, a diferença costuma estar em credenciais em um proxy ou em um certificado de interceptação que o handshake não aceitou. Depois que os artefatos estão em cache, as builds seguintes leem o cache e não precisam de rede alguma.

A server did not answer in time (Um servidor não respondeu a tempo)

Uma requisição ficou esperando o servidor ao qual se dirigia — um registro, ou qualquer outro servidor que um comando alcança, como o log de transparência em que uma assinatura é registrada — e foi retirada. Uma requisição espera no máximo 30 segundos para que o servidor comece sua resposta depois que a requisição foi enviada por completo, e no máximo 30 segundos pela próxima parte de uma resposta que já está chegando; passado qualquer um dos dois, ela é recusada sob esta condição, que nomeia o servidor e a espera. É o que produz um servidor que aceita uma conexão e nunca responde, e o que produz também um endereço que nunca aceita nenhuma, em vez de um comando que espera sem fim. Uma varredura de toda a listagem de repositórios de um registro, por sua vez, espera em cada página pelo tempo que a varredura puder durar, e é limitada por sua própria condição, E0377.

Só a espera é limitada. Um download ou upload que continua avançando leva o tempo que levar, porque a espera só é medida enquanto nada chega. Um chart do Helm que o source: de uma Recipe busca por HTTPS fica sujeito apenas à espera pelo início de sua resposta, e essa expiração é informada nas próprias palavras da biblioteca de rede em vez de sob esta condição. Uma requisição que um comando já repete quando expira — uma leitura durante aggrega registry update, uma escrita durante uma publicação — é repetida primeiro, de modo que a recusa é o que resta após sua última tentativa.

Mensagem emitida, para uma listagem de versões à qual o registro não respondeu:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: listar as versões de plugin/cli/mo: oci: listar as tags: Get: 127.0.0.1:18471 não respondeu em 30s: egress: o servidor não respondeu a tempo)

e para uma resposta que parou no meio do caminho:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (parou de responder: nada mais de sua resposta chegou por 30s: egress: o servidor não respondeu a tempo)

Como corrigir: a correção cabe ao operador e está fora do seu catálogo. Verifique se o servidor que a mensagem nomeia está no ar e acessível de onde o comando é executado; um registro sob carga ou em manutenção volta a responder mais tarde, e basta executar o comando de novo. Quando o ambiente acessa a rede por meio de um proxy, verifique se o proxy repassa a requisição em vez de retê-la. A espera é fixa; não há configuração que a aumente.

A registry’s repository listing did not end in time (A listagem de repositórios de um registro não terminou a tempo)

Uma varredura de toda a listagem de repositórios de um registro durou cinco minutos sem chegar ao fim da listagem e foi interrompida. Dois comandos varrem a listagem: aggrega plugin add, somente quando nenhum plugin tem exatamente o nome que recebeu e ele procura um cujo nome o contenha, e aggrega registry update, que lista os repositórios de um registro antes de ler cada um deles. Uma listagem que continua nomeando novos repositórios sem fim e uma que um registro serve devagar demais para terminar acabam ambas aqui em vez de prender o comando; a varredura não produz nenhum repositório, então nada é escolhido nem indexado de uma listagem que foi interrompida. A mensagem informa quantos repositórios a listagem tinha nomeado quando foi interrompida.

Mensagem emitida, para a adição de um plugin cuja consulta é parte de um nome:

aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: nenhum plugin cli se chama “mo”, e a busca em cada repositório por um nome que o contenha não terminou; nomeie o plugin exatamente, como aggrega plugin add cli seguido do nome: a varredura foi interrompida após 5m0s, antes do fim da listagem (repositórios nomeados até agora: 146): registry: a listagem de repositórios não terminou a tempo)

Como corrigir: para aggrega plugin add, nomeie o plugin exatamente — aggrega plugin add cli moo em vez de aggrega plugin add cli mo —, o que busca o plugin por esse nome com uma única requisição e nunca varre a listagem. Para aggrega registry update, a causa é a listagem do registro: confirme com quem administra o registro que a listagem termina e execute a atualização novamente quando isso acontecer. O limite de cinco minutos é fixo; não há configuração que o aumente.

A registry kept asking to slow down (Um registry continuou pedindo para desacelerar)

Um registry ocupado demais responde 429 Too Many Requests, ou 503 Service Unavailable com um cabeçalho Retry-After dizendo quanto tempo esperar. Toda requisição que um comando faz a um registry aguarda o tempo que o registry pede — dez segundos quando ele não diz — e é feita de novo; toda requisição a esse registry aguarda junto, e menos requisições são enviadas a ele ao mesmo tempo até que ele volte a responder. Um registry que por cinco minutos não responde nada além de “desacelere” é recusado com esta condição, indicando o registry, sua última resposta e há quanto tempo não respondia outra coisa, e o mesmo vale para uma requisição cujo próprio limite de tempo termina enquanto ela aguarda. aggrega registry update então informa esse registry como não indexado, e ele mantém o índice que tinha antes da execução.

Mensagem emitida, para um registry que pediu para desacelerar por cinco minutos:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (continuou pedindo para desacelerar: sua última resposta foi 429 Too Many Requests, e não tinha respondido outra coisa por 5m0s: oci: o registry continuou pedindo para desacelerar)

e para uma requisição cujo próprio limite de tempo encerrou a espera:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (continuou pedindo para desacelerar: sua última resposta foi 429 Too Many Requests, e não tinha respondido outra coisa quando o próprio tempo da requisição se esgotou: oci: o registry continuou pedindo para desacelerar)

Como corrigir: a causa é o limite de taxa do registry, não algo que você escreveu. Um registry que limita a frequência com que um cliente pode fazer pedidos geralmente limita tudo o que vem do mesmo endereço, então verifique se outros comandos ou máquinas por trás desse endereço estão fazendo pedidos a ele ao mesmo tempo, e execute o comando novamente quando eles terminarem. Se o registry for operado por você, verifique o limite de taxa dele. O limite de cinco minutos é fixo; não há configuração que o aumente.

Fetched or cached bytes do not match the digest committed for them (Os bytes baixados ou em cache não correspondem ao digest declarado para eles)

Todo artefato traz um manifesto que declara o digest do seu conteúdo, e o arquivo de bloqueio fixa de forma independente o digest desse manifesto. As duas declarações são verificadas recalculando o hash dos bytes disponíveis e comparando. É isso que uma comparação que falha relata, e ela dispara da mesma forma em bytes recém-baixados e em bytes lidos de volta do cache.

Duas condições, e qual delas dispara diz qual nível divergiu. Uma nomeia conteúdo que não corresponde ao digest que o seu próprio manifesto declara. A outra nomeia um manifesto em cache que não corresponde ao digest que o arquivo de bloqueio fixou para ele — a verificação que impede que um manifesto adulterado se torne a autoridade em que uma verificação de conteúdo posterior confia. A fixação é o que dá sentido a essa segunda verificação: ela vem do arquivo de bloqueio, em vez de derivar novamente o manifesto a partir dos bytes em cache, de modo que as duas são de fato independentes.

Uma entidade é então confrontada com a sua própria linha, acima do que os bytes trazem. Depois que os bytes de uma entidade em cache concordam com o seu manifesto, eles são comparados com o digest que o arquivo de bloqueio registra para a entidade, que cobre os arquivos que a sua publicação traz — cada um pelo seu caminho e pelos seus bytes — em vez dos bytes comprimidos. Assim, os mesmos arquivos publicados com outra compressão continuam concordando, enquanto arquivos diferentes sob a mesma versão não, e uma divergência é relatada sob a condição de conteúdo. Um pull que respeita uma fixação faz a mesma comparação sobre o que um registro serve sob a versão fixada.

Nenhuma dessas verificações precisa de rede. Cada uma é uma comparação de hashes sobre bytes já disponíveis, o que permite que uma build totalmente offline ainda assim estabeleça que o que está lendo é o que foi fixado.

Mensagens emitidas. O conteúdo em relação ao seu manifesto:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch (oci: o digest calculado do conteúdo difere do declarado pela camada do manifesto: oci: divergência do digest de conteúdo)

uma entidade de plugin, que um manifesto declara em outra posição:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch (oci: o digest calculado da configuração difere do da configuração do manifesto: oci: divergência do digest de conteúdo)

um manifesto em cache em relação ao digest fixado:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch (oci: o digest calculado do manifesto em cache difere do fixado: oci: divergência do digest do manifesto em cache)

uma entidade em cache em relação à sua linha, e um registro que serve outro conteúdo sob uma versão fixada:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch (catalog: o digest de conteúdo da entidade em cache indicada não corresponde à fixação do arquivo de bloqueio: oci: divergência do digest de conteúdo)

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin (oci: divergência do digest de conteúdo: entidade fixada indicada: o registro agora serve para a versão fixada um digest diferente do fixado; execute o pull de atualização para atualizar a fixação)

Ambos são enquadrados pelo que estava sendo lido. Uma entidade fixada que nenhuma fonte contém na sua fixação, com a condição do manifesto onde o manifesto da entrada de cache divergiu e a do conteúdo nos demais casos:

pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above> (entidade fixada indicada: nenhuma fonte contém os bytes fixados, com o que cada fonte lida continha; com um registro acessível, o pull baixa de novo a versão fixada: a mensagem acima)

Uma entrada de arquivo compactado que nomeia um caminho que escapa do arquivo compactado também é relatada sob a condição de conteúdo, já que um bundle que tenta isso não é o bundle que foi declarado:

path traversal entry "<name>": oci: content digest mismatch (entrada indicada com travessia de caminho: oci: divergência do digest de conteúdo)

Ambas trazem a mesma correção onde a etapa que as revela fornece uma:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache (correção: execute aggrega pull —upgrade —release para a Release indicada, para atualizar o arquivo de bloqueio e o cache)

Como corrigir: nada nos seus arquivos de entidade causa isso e nenhuma mudança de autoria o resolve. Atualize juntos o cache e o arquivo de bloqueio com aggrega pull --upgrade --release <release>, que baixa de novo da fonte e reescreve os dois. Se isso resolver, a cópia em cache tinha sido alterada ou truncada desde que foi gravada. Se a divergência persistir após uma atualização, os bytes que o publicador serve diferem de fato do que foi fixado — uma versão republicada, o que é uma pergunta para quem a publica, e que vale a pena fazer antes de adotar o novo digest, e não depois.

A manifest carries no layer of the expected kind, or more than one (Um manifesto não traz nenhuma camada do tipo esperado, ou traz mais de uma)

O manifesto de um artefato lista as suas camadas, e a que traz o conteúdo é selecionada pelo seu tipo de mídia, e não pela sua posição. É isso que permite que um artefato agrupe mais de uma camada — um chart com uma camada de proveniência separada ao lado, por exemplo — e ainda assim tenha o conteúdo identificado de forma confiável.

Duas estruturas não deixam nada a selecionar. Nenhuma camada do tipo esperado significa que o manifesto descreve algo diferente do que se supôs que a referência indicava. Mais de uma significa que a escolha não tem resposta, e pegar a primeira às vezes estaria certo e às vezes silenciosamente errado.

Mensagens emitidas, cada uma nomeando o tipo de mídia esperado. Nenhuma:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type (oci: o manifesto não tem nenhuma camada do tipo de mídia indicado: oci: o manifesto não tem nenhuma camada do tipo de mídia de conteúdo esperado)

e mais de uma, que também nomeia quantas:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type (oci: o manifesto tem várias camadas do tipo de mídia indicado; era esperada exatamente uma: oci: o manifesto tem várias camadas do tipo de mídia de conteúdo esperado)

Como corrigir: a correção cabe ao publicador, e não a você — o manifesto não é algo que um autor de catálogo escreve. Verifique primeiro se a referência aponta para onde você pretendia: uma referência que se resolve para outro tipo de artefato produz a primeira estrutura, porque o manifesto é um manifesto real de outra coisa. Se a referência estiver correta, o artefato foi publicado com um manifesto que não o descreve como o tipo que ele alega ser; então informe o tipo de mídia da mensagem a quem o publica. Publicar pelo caminho de publicação comum produz um manifesto com exatamente uma camada de conteúdo, então um artefato em qualquer uma das duas estruturas foi montado de outra maneira.

A published bundle holds no entity, or holds two (Um bundle publicado não contém nenhuma entidade, ou contém duas)

Uma entidade que declara arquivos ao lado do seu documento — o chart local de uma Recipe ou o seu lock, o esquema importado de um Component — é publicada como um .tar.gz que agrupa a entidade junto com esses arquivos. Ler um de volta significa encontrar de novo a entidade entre eles — e o arquivo em que ela foi escrita pode ter qualquer nome, então o que a identifica é o preâmbulo de entidade que ela traz, e não o seu nome. O documento na raiz do bundle cujo kind: é um tipo de entidade publicável é a entidade; um fragmento compose, um template de chart ou um manifesto do Kubernetes ao lado dele não é, nem um documento de entidade mais abaixo dentro de uma árvore source/, que é conteúdo que a entidade distribui, e não a própria entidade.

Duas estruturas não deixam nada a selecionar, e ambas são propriedades de como o artefato foi publicado.

Nenhum documento de entidade na raiz do bundle. O bundle foi empacotado sem a entidade na sua raiz — o seu documento omitido, ou colocado em um subdiretório em vez de ao lado dos arquivos que ele traz. A mensagem lista o que a raiz do bundle de fato traz, o que normalmente basta para ver o que aconteceu.

Dois documentos de entidade na raiz do bundle. O bundle foi empacotado a partir de um diretório inteiro em que duas entidades foram escritas — algo que aggrega push nunca faz, já que cada entidade traz apenas os arquivos que declara, mas que outro cliente pode fazer. Empacotadas assim, cada uma das suas coordenadas publicadas traz os mesmos bytes — então responder com qualquer uma delas devolveria a outra entidade sob o nome que foi pedido, sem que nada a jusante pudesse perceber. Não há escolha segura a fazer, então nenhuma é feita.

Mensagens emitidas, que listam o que foi encontrado. Nenhum, onde o bundle traz outros arquivos:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (a raiz do bundle não traz nenhum documento de entidade entre os arquivos indicados: oci: o bundle publicado não traz nenhum documento de entidade)

nenhum, onde não traz nada:

bundle root carries no files at all: oci: published bundle carries no entity document (a raiz do bundle não traz nenhum arquivo: oci: o bundle publicado não traz nenhum documento de entidade)

e mais de um, que nomeia tanto a contagem quanto os documentos em colisão:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (a raiz do bundle traz vários documentos de entidade, nos arquivos indicados: oci: o bundle publicado traz mais de um documento de entidade)

Como corrigir: resolver ambos cabe ao publicador, e não a você, e a correção está no diretório de versão a partir do qual a entidade foi publicada. Dê a cada entidade um diretório de versão próprio, de modo que esse diretório contenha uma entidade e os arquivos que pertencem a ela — a estrutura que toda entidade publicada já segue, em que o diretório recebe o nome do metadata.version da entidade e fica sob o próprio nome da entidade. Depois publique de novo com uma nova versão: os bytes publicados são congelados, então republicar sobre a versão existente é recusado, e não corrigido. Se você está consumindo em vez de publicar, informe a mensagem a quem publica o artefato; os nomes de arquivo nela identificam o diretório a dividir.

A published artifact cannot be read as an entity (Um artefato publicado não pode ser lido como uma entidade)

Ler uma entidade a partir da coordenada em que ela está publicada começa pelos bytes que o registro serve ali — aggrega inspect oci://… os lê para que você os examine, e um pull de dependências lê da mesma forma os de um arquivo compactado para encontrar a versão que fixa. Duas estruturas desses bytes não contêm nenhuma entidade a ler.

Um arquivo compactado que não se descompacta. Uma entidade publicada com os arquivos que declara é publicada como um .tar.gz, e os bytes começam como tal, mas o fluxo de compressão ou o arquivo compactado dentro dele não está bem formado — na maioria das vezes porque foi truncado. Os bytes ainda correspondem ao digest que o próprio manifesto do artefato registra para eles, então são exatamente o que foi publicado: o dano aconteceu antes ou durante a publicação, e não no caminho até você.

Um documento que não é uma entidade. A coordenada traz um único documento, e ele não é analisado, não declara nenhum kind: ou declara um tipo que nunca é publicado, como uma Release ou um Manifest. A referência então nomeia algo publicado ao lado do catálogo em vez de uma entidade — um artefato de dados publicado com aggrega push-artifact, por exemplo.

Mensagens emitidas. Um arquivo compactado cujo fluxo de compressão não está bem formado, com o erro que o interrompeu:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: descompactação gzip do bundle: o erro do arquivo compactado: oci: o bundle publicado não pode ser descompactado)

um que para no meio de um arquivo:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (leitura do arquivo indicado a partir do bundle publicado: o erro do arquivo compactado: oci: o bundle publicado não pode ser descompactado)

um documento que declara um tipo que nunca é publicado:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (o documento publicado declara um tipo que um registro não publica: oci: o artefato publicado não é um documento de entidade)

e bytes que não são um documento de forma alguma:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (os bytes publicados não são analisados como um documento, com o erro de análise: oci: o artefato publicado não é um documento de entidade)

Como corrigir: um arquivo compactado que não se descompacta cabe ao publicador substituir. Os bytes publicados são congelados, então a solução é publicar a entidade de novo com uma nova versão; se você a está consumindo, informe a mensagem a quem a publica. Um documento que não é uma entidade quase sempre significa que a referência não é a que você pretendia: verifique se ela nomeia a coordenada em que uma entidade está publicada, que é a referência que aggrega push imprime quando publica uma.

The registry could not answer what is attached to an artifact (O registro não conseguiu responder o que está vinculado a um artefato)

Assinaturas e outras vinculações ficam penduradas em um artefato em vez de estarem dentro dele, e encontrá-las é uma pergunta feita ao registro. Esta condição diz que a pergunta ficou sem resposta — o registro não atende a essa consulta, o artefato ao qual as vinculações estão penduradas não pôde ser localizado, ou a própria requisição falhou.

Isso não é o mesmo que uma resposta de “nada está vinculado”, e confundir as duas é exatamente o que isto existe para impedir. Um artefato que de fato não traz nenhuma assinatura se resolve normalmente e produz uma lista vazia. Isto diz que a lista nunca foi obtida, então nada se sabe sobre o que está vinculado.

Se a build é interrompida depende de uma assinatura ser exigida, e as duas direções são deliberadas:

  • Uma assinatura é exigida. A build para. Uma verificação exigida que não pôde ser executada não foi aprovada, e admitir o artefato se apoiaria em uma pergunta que ninguém conseguiu fazer.
  • Nenhuma assinatura é exigida. A build continua e diz isso em voz alta, em vez de em silêncio. A consulta não produziu nada a verificar em nenhum sentido, então recusar rejeitaria um artefato com base em uma pergunta sem resposta — mas o silêncio seria lido como um pull limpo sem assinatura, o que não é.

Mensagens emitidas. Um registro que não atende à consulta:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: o destino não oferece suporte à descoberta de referrers, com o tipo de destino indicado: oci: não foi possível concluir a descoberta de referrers)

o próprio artefato não localizável:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: resolução do sujeito indicado: a falha subjacente: oci: não foi possível concluir a descoberta de referrers)

e a consulta falhando:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: listagem dos referrers da referência indicada: a falha subjacente: oci: não foi possível concluir a descoberta de referrers)

Onde nenhuma assinatura é exigida, o mesmo texto aparece como aviso:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (não foi possível executar a verificação de assinatura para o artefato indicado (o registro não conseguiu responder à consulta de assinatura e nenhuma assinatura é exigida; continuando): a mensagem acima)

Como corrigir: a correção cabe ao operador e está no registro, e não no seu catálogo. Onde o registro não atende de forma alguma a consultas de vinculações, ele não pode trazer assinaturas, então espelhe o artefato para um que possa ou deixe de exigir assinaturas desse host em .aggrega-config.yaml — e anote qual das duas opções você está escolhendo, porque a segunda significa que as assinaturas desse host não são mais verificadas. Onde a consulta falhou em um registro que a atende, trata-se de um problema de transporte ou de permissão especificamente no endpoint de vinculações, e executar de novo quando o registro estiver acessível é toda a solução.

An artifact that must be signed carries no signature (Um artefato que precisa ser assinado não traz nenhuma assinatura)

Uma assinatura é exigida para um artefato quando a política de assinatura do próprio espaço de trabalho abrange o seu tipo ou quando o registro de onde ele vem está configurado para exigir uma. Esta condição relata que o registro respondeu à consulta de vinculações, que nada estava vinculado e que uma assinatura era exigida.

Os dois requisitos são uma única postura lida em dois escopos. A política de todo o espaço de trabalho impõe uma assinatura a um tipo dentro do seu escopo mesmo a partir de um host cuja própria entrada não exige nenhuma, então um host que não exige nada não isenta um artefato abrangido pela política de todo o espaço de trabalho.

Onde nenhuma assinatura é exigida, isto não é uma falha de forma alguma. O artefato é verificado se uma assinatura estiver presente e passa sem alarde se não houver nenhuma, e é isso que torna utilizável sem cerimônia um host sem uma postura configurada.

Um artefato cujo tipo não pôde ser determinado enquanto uma política de todo o espaço de trabalho está ativa é tratado como se exigisse uma assinatura, e não como isento, de modo que um artefato não classificável não pode escapar de uma política que está ativada.

Mensagem emitida, enquadrada pela referência que estava verificando:

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (verificação da assinatura do artefato indicado: signing: nenhuma assinatura encontrada para um artefato que exige uma)

Como corrigir: a correção cabe ao operador ou ao publicador, não ao autor da entidade. Onde você esperava que o artefato estivesse assinado, ele foi publicado sem assinatura — informe a referência a quem o publica, já que só quem o publica pode vincular uma. Onde o artefato não deve ser assinado, o que precisa mudar é o requisito: ele vem da entrada do registro em .aggrega-config.yaml ou da política de assinatura de todo o espaço de trabalho, e a referência da mensagem indica qual host examinar. Desativar um requisito significa que os artefatos desse host não são mais verificados, então prefira restringir o escopo da política a um tipo em vez de desativá-la por completo.

A signature does not verify (Uma assinatura não passa na verificação)

Uma assinatura foi encontrada e verificada, e a verificação falhou. É o resultado negativo geral dessa verificação, e abrange uma cadeia de certificados que não tem raiz no material de confiança, uma assinatura sem entrada no log de transparência onde uma é exigida, uma assinatura sobre um artefato diferente daquele que se tem em mãos, um bundle que foi alterado e um bundle verificado com uma chave fixada com a qual ele não passa na verificação.

Ela é deliberadamente distinta de uma assinatura cujo signatário não é confiável. Aquela é estruturalmente válida e feita pelo signatário errado; esta não passou na verificação de forma alguma. Mantê-las separadas é o que permite a você distinguir “o artefato não é o que foi assinado” de “o artefato foi assinado por alguém que você não aceitou”.

Para qual artefato uma assinatura foi feita é verificado duas vezes. Depois que a verificação criptográfica da assinatura se confirma, a cadeia de ferramentas lê na própria assinatura para qual artefato ela foi feita — a mesma leitura à qual toda build posterior submete a assinatura registrada, que é o que permite a uma build recusar uma assinatura copiada de um artefato para outro sem verificar nada — e recusa a assinatura onde essa leitura não nomeia o artefato em mãos, ou onde a assinatura está em uma forma da qual a leitura não consegue extrair o artefato. As duas formas que um pull aceita são lidas: uma assinatura feita sobre o próprio artefato e uma declaração assinada que o nomeia. A leitura segue as regras próprias da verificação criptográfica, então, sobre uma assinatura que essa verificação aceita, as duas concordam; uma recusa desse tipo significa que elas não concordaram, e vale a pena relatá-la com a referência e a mensagem em vez de contorná-la por configuração.

Onde a entrada de um registro marca a verificação como consultiva, o mesmo texto é relatado como aviso e a execução continua.

Mensagens emitidas. Da própria verificação, citando o que o verificador relatou:

signing: signature bundle does not verify: <what the verifier reported> (signing: o bundle de assinatura não passa na verificação: o que o verificador relatou)

e, onde a verificação criptográfica se confirma e a leitura de para qual artefato a assinatura foi feita não concorda:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (signing: o bundle de assinatura não passa na verificação: sua verificação criptográfica se confirma, mas ele não nomeia o digest do manifesto indicado como o artefato para o qual foi feito)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (signing: o bundle de assinatura não passa na verificação: sua verificação criptográfica se confirma, mas ele está em uma forma da qual não é possível ler o artefato para o qual foi feito)

cada uma enquadrada pela referência que está sendo verificada:

verifying the signature of <uri>: <the message above> (verificação da assinatura do artefato indicado: a mensagem acima)

e, onde a entrada do registro torna a verificação consultiva, como aviso em vez de interrupção:

signature verification failed for <uri> (advisory; continuing): <the message above> (a verificação de assinatura falhou para o artefato indicado (consultiva; continuando): a mensagem acima)

Como corrigir: nada nos seus arquivos de entidade causa isso e nenhuma alteração de autoria resolve. Trate isso como uma afirmação sobre o artefato, e não sobre a sua configuração: os bytes em mãos não são os bytes que foram assinados, ou a assinatura não é uma que o material de confiança configurado consiga verificar. Adquira o artefato de novo primeiro, já que uma cópia em cache truncada ou alterada falha exatamente assim e um novo download resolve. Onde o problema sobrevive a um novo download, informe a referência e as próprias palavras do verificador a quem publica o artefato. Não recorra à configuração consultiva para contorná-lo — essa configuração mantém a verificação em execução e a impede de interromper a build, o que é uma escolha deliberada de aceitar artefatos não verificados desse host, e não uma forma de corrigir um.

A signature verifies but its signer is not one the registry trusts (Uma assinatura passa na verificação, mas o seu signatário não é um em quem o registro confia)

A assinatura passou na verificação — a cadeia de certificados tem raiz no material de confiança e a entrada de transparência está presente — e a identidade nesse certificado não corresponde a nenhuma das identidades configuradas como aceitáveis para o registro. O artefato foi assinado por um signatário real que não foi aceito.

As duas metades de uma identidade são comparadas, o sujeito e o emissor que respondeu por ele, e qualquer uma das duas pode ser a que não correspondeu. A mensagem nomeia ambas onde elas podem ser lidas do certificado, porque um signatário que apresenta um sujeito esperado sob um emissor que ninguém aceitou parece idêntico a um sujeito errado, a menos que ambas sejam mostradas.

Mensagens emitidas. Com as duas metades legíveis:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (signing: a identidade da assinatura não é confiável para este registro: o que o verificador relatou; o signatário apresentou o emissor indicado com a identidade indicada, mas nenhuma identidade confiável permite esse emissor)

e onde elas não podem ser lidas, recorrendo ao próprio relato do verificador:

signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: a identidade da assinatura não é confiável para este registro: o que o verificador relatou)

Como corrigir: esta é uma decisão do operador, e é uma decisão real, não uma formalidade. Compare o emissor e a identidade da mensagem com as identidades confiáveis configuradas para esse registro em .aggrega-config.yaml. Onde o signatário é um que você pretende aceitar, adicione-o — uma entrada nomeia uma identidade, ou um padrão que corresponde a uma, junto com o emissor, e ambos precisam estar corretos. Onde não é, o artefato foi assinado por alguém que você não aceitou, e adicionar a identidade para fazer a build passar é a única resposta a evitar. Registros que anunciam a sua própria política de confiança podem tê-la fixada quando o registro é adicionado, que é a forma de incluir as identidades pretendidas sem transcrevê-las.

A keyless trust policy names no acceptable signer (Uma política de confiança sem chave não nomeia nenhum signatário aceitável)

A verificação sem chave decide se aceita um artefato comparando a identidade em seu certificado de assinatura com um conjunto de identidades configuradas como aceitáveis. Um conjunto vazio é recusado em vez de ser tratado como uma política: comparar com nada aceitaria todos os signatários ou rejeitaria todos, e nenhuma das duas coisas é o que pretendia um operador que configurou a verificação.

Mensagem emitida, que é a própria frase da condição:

signing: keyless verification requires at least one trusted identity (signing: a verificação sem chave exige pelo menos uma identidade confiável)

Como corrigir: configure pelo menos uma identidade confiável para o registro em .aggrega-config.yaml. Uma entrada nomeia a identidade — como sujeito exato ou como padrão que corresponde a um — junto com o emissor que responde por ela, e ambos são obrigatórios. Onde o registro anuncia a sua própria política de confiança, fixar essa política quando o registro é adicionado preenche o conjunto com o que o registro publica. Onde você não pretende verificar de forma alguma as assinaturas deste registro, trata-se de uma configuração diferente de um conjunto de identidades vazio, e defini-la explicitamente é o que deixa isso claro.

The pinned trust root cannot be read (A raiz de confiança fixada não pode ser lida)

Uma raiz de confiança fixada no espaço de trabalho é o que permite a uma verificação sem chave verificar sem acesso à rede onde quer que seja executada: um arquivo cujo conteúdo é o material com o qual cada assinatura é verificada. Esta condição relata que o arquivo no caminho configurado não pôde ser transformado em material de confiança utilizável — ele está ausente, não é legível, ou o seu conteúdo não é uma raiz de confiança.

Ela é interrompida em vez de recorrer a outra coisa. Uma raiz fixada é uma escolha deliberada de verificar as assinaturas com material que você controla, então baixar uma silenciosamente no lugar dela substituiria essa escolha por outra e produziria um resultado de verificação que ninguém pediu.

Mensagem emitida, que nomeia o caminho e cita o que a leitura relatou:

signing: cannot load pinned trust root: <path>: <what the read reported> (signing: não é possível carregar a raiz de confiança fixada: o caminho indicado: o que a leitura relatou)

Como corrigir: isto cabe ao operador. Verifique se o caminho configurado para a raiz de confiança existe e pode ser lido por quem executa o comando — um caminho relativo a um diretório de trabalho diferente e um arquivo presente mas ilegível são ambos relatados aqui. Onde o arquivo existe e pode ser lido, o seu conteúdo não é uma raiz de confiança, então substitua-o por um bundle atual da fonte de onde você o obteve, em vez de editá-lo. Onde uma raiz fixada não era pretendida, o que precisa mudar é a configuração: remova a fixação e a verificação usa o material que lhe seria fornecido de outra forma.

A pinned verification key is not the key profile the verifier accepts (Uma chave de verificação fixada não é do perfil de chave que o verificador aceita)

Assinar e verificar com uma chave em posse usam um único perfil de chave, e uma chave de qualquer outro tipo é recusada em vez de tentada. É uma afirmação sobre o tipo da chave, não sobre se ela verifica alguma coisa.

Os dois momentos em que ela é relatada são tarefas diferentes. Um é carregar uma chave com a qual assinar, o que acontece onde um artefato é publicado; o outro é verificar uma assinatura com uma chave fixada para um registro, o que acontece onde um artefato é verificado. A recusa é a mesma em ambos.

Mensagens emitidas, cada uma nomeando o algoritmo da chave efetivamente fornecida — an RSA key ou an Ed25519 key. Uma chave de verificação fixada:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (signing: tipo de chave em posse não suportado: a chave fixada usa o algoritmo indicado, é esperada ECDSA P-256)

e uma chave carregada para assinar:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: tipo de chave em posse não suportado: a chave em posse usa o algoritmo indicado, é esperada ECDSA P-256)

Como corrigir: forneça uma chave do perfil que a mensagem nomeia. Onde você está verificando, a chave é a fixada para o registro em .aggrega-config.yaml, e ela precisa ser a metade pública da chave com a qual o publicador assina — uma divergência aqui costuma significar que o arquivo errado foi fixado, já que uma chave do tipo certo, mas que não é a chave certa, é relatada em vez disso como uma assinatura que não passa na verificação. Onde você está assinando, gere uma chave do perfil indicado, ou use o caminho sem chave, que não precisa de nenhuma chave em posse.

The workspace is offline and the step needs the network (O espaço de trabalho está offline e a etapa precisa da rede)

Um espaço de trabalho pode ser marcado como offline, e essa configuração é uma recusa, não uma preferência: toda etapa que alcançaria a rede é recusada onde é construída, antes que qualquer conexão seja aberta. Recusar cedo é o que faz a falha dizer “este espaço de trabalho está offline” em vez de surgir mais tarde como um tempo limite esgotado sem explicação.

Uma única decisão, lida em um único lugar. Uma etapa que precisa saber de antemão se a rede poderia ser alcançada faz a mesma pergunta que o próprio download faz, de modo que uma verificação e a operação que ela protege não podem chegar a conclusões diferentes.

Ela alcança vários tipos de trabalho, todos com a mesma recusa: adquirir um artefato de um registro, adquirir a fonte de uma Recipe pela rede, baixar uma entrada externa, obter uma identidade com a qual assinar e baixar material de confiança. Uma build que lê um cache preenchido não alcança nenhum deles, e esse é o propósito da configuração.

Onde o comando inteiro é uma ida e volta pela rede, a recusa vem primeiro em vez de por último. push, push-artifact e registry update existem para alcançar um registro, então dizem isso antes de ler a sua entidade ou percorrer os seus repositórios, e nomeiam qual dos três lugares definiu o modo — a flag que você digitou, a variável de ambiente, ou o arquivo e a chave dentro dele. Um --dry-run é a exceção, e é uma exceção pelo que faz, não pelo nome que tem: ele relata o que publicaria e não chama nada, então é a forma de uma publicação segura offline e continua funcionando.

Mensagem emitida, que traz a sua própria correção e é a própria frase da condição:

egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache (egress: acesso à rede recusado porque o espaço de trabalho está offline; correção: passe a flag que permite a rede para esta única execução, ou remova a chave de nível superior do modo offline no arquivo de configuração (ou AGGREGA_OFFLINE) para permiti-la daqui em diante; onde o trabalho é uma build que precisa de conteúdo que a máquina não tem, execute primeiro o pull da Release indicada a partir de um ambiente conectado para preencher o cache)

Enquadrada pelo que precisava da rede — a aquisição da fonte de uma Recipe, por exemplo:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above> (sourceresolver: com o tipo, a URL e a versão indicados: a mensagem acima)

Adicionar o hub oficial em um espaço de trabalho offline não é recusado: o hub é adicionado com a sua base integrada, e o aviso diz que o hub não foi consultado sobre a sua política de confiança porque o espaço de trabalho está offline.

Como corrigir: a mensagem nomeia três caminhos, e qual se aplica cabe a você decidir. Onde o modo está definido e você quer contorná-lo para este único comando, passe --offline=false; é para isso que a flag existe, e é a única resposta disponível para quem não escreveu pessoalmente o arquivo de configuração. Onde o espaço de trabalho deve ficar offline, o que precisa ser corrigido é o conteúdo ausente: execute o pull a partir de algum lugar com acesso à rede para que o cache contenha tudo o que a Release alcança, e depois a build offline não precisa de mais nada. Onde ele não deve ficar offline de forma alguma, remova a configuração na sua origem — a chave de nível superior offline em .aggrega-config.yaml, ou a variável de ambiente que a mensagem nomeia, e a variável é a que pega as pessoas de surpresa porque não está em nenhum arquivo. Observe que um espaço de trabalho offline não pode assinar de forma alguma pelo caminho sem chave, já que emitir um certificado e registrá-lo são operações de rede sem forma offline.

Ao construir a topologia

Quando cada Component tem uma Recipe resolvida, o compilador une os Components no grafo IR lendo o bloco uses: de cada Component e cruzando os destinos e as vinculações de funcionalidades.

Dangling uses target (Destino de aresta pendente)

Uma aresta uses: nomeia um componente de destino que não existe na topologia resolvida. A interrupção é agnóstica em relação à origem — uma aresta do Aggregate escrita pelo desenvolvedor e uma aresta cabeada por uma Release são detectadas da mesma forma. Um destino pendente é uma interrupção fatal, não um descarte silencioso: uma aresta para um destino inexistente desapareceria de outro modo e deixaria silenciosamente vazios os valores injetados do consumidor no momento da implantação. É o irmão estrutural da interrupção por socket não declarado mais abaixo: seja qual for o socket em que uma conexão é cabeada, seu destino precisa se resolver em um componente existente antes que o tipo da aresta seja verificado.

Mensagem emitida. Primeiro vem a recusa, depois o destino que não corresponde a nada e o socket em que a conexão foi cabeada — depois o que fazer a respeito:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (o destino da aresta uses não existe: o destino indicado, cabeado no socket indicado. Aponte o destino para um componente que o Aggregate declara, ou declare um componente com esse nome.)

O achado é posicionado na entrada escrita a que se refere, no documento em que essa entrada foi escrita, de modo que uma conexão traçada pelo próprio bloco uses: de um componente, uma projetada por uma vinculação e uma cabeada por uma Release são relatadas, cada uma, em seu próprio bloco. Cada conexão infratora é relatada como um achado próprio, de modo que uma única build nomeia todas elas em vez de parar na primeira.

Como corrigir: declare o componente de destino ausente, ou corrija o nome do destino na entrada uses: para que corresponda a um componente existente.

Two connections of one component under one alias (Duas conexões de um componente sob um mesmo alias)

Um componente lê cada uma de suas conexões pelo seu alias — a chave sob a qual a conexão foi escrita ou, para uma conexão escrita como entrada de lista, o próprio nome do seu destino. Um template de Recipe lê as conexões de um componente indexadas apenas pelo alias, e uma asserção as lê indexadas pelo socket e depois pelo alias, de modo que duas conexões de um componente sob um mesmo alias compartilhariam um único slot em pelo menos uma dessas visões: a posterior o ocuparia, e a outra estaria ausente do que o template ou a asserção vê. Assim, um alias nomeia uma única conexão de um componente — seja qual for o socket em que cada uma é cabeada, o que quer que a tenha traçado (o próprio bloco uses: do componente, o bloco uses: de uma vinculação em qualquer escopo ou uma entrada por aresta de uma Release) e seja qual for o seu destino. Um par interrompe a build assim que o grafo é definitivo, antes que qualquer asserção seja executada e antes que qualquer coisa seja renderizada.

O par surge de uma autoria que é legal em cada superfície isoladamente: a entrada própria de um componente e a de uma vinculação em um mesmo socket e alias; uma lista que nomeia duas vezes o mesmo destino (models: [llama, llama]); um alias escrito em dois sockets (models: { local: … } ao lado de databases: { local: … }); duas vinculações que cabeiam um mesmo alias; ou uma entrada de Release que traça uma conexão em um socket que o Aggregate deixou sem associação, sob um alias que o Aggregate já usou em outro socket. Duas estruturas vizinhas nunca chegam a esta interrupção: uma chave escrita duas vezes em um mesmo bloco de entradas com chave faz o documento falhar ao carregar, e uma entrada de Release em um socket e um alias que outro bloco já traçou configura essa conexão — ou, se nomeia um destino diferente, é interrompida como uma mudança de destino — em vez de traçar uma segunda.

Mensagem emitida. Primeiro vem a recusa, depois o alias e o componente, depois o socket desta conexão, seu destino e onde sua entrada foi escrita, depois o mesmo para a conexão que já detém o alias — depois o que fazer a respeito:

connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (o alias de conexão já é usado por outra conexão do mesmo componente: o alias e o componente indicados, o socket, o destino, o arquivo e o caminho de chaves desta conexão, depois os mesmos dados da conexão que já detém o alias. Dê a uma das duas conexões um alias próprio: um componente lê cada conexão pelo seu alias, seja qual for o socket em que está cabeada. Uma entrada de lista usa o nome do seu destino como alias, então um destino listado duas vezes é listado uma só vez, ou escrito como duas entradas com chave sob dois aliases.)

Onde as duas conexões foram escritas em um mesmo caminho de chaves — uma lista que nomeia duas vezes o mesmo destino —, cada uma também é nomeada pela sua posição nessa lista, list entry "2" ao lado de list entry "1", que é a única coisa que distingue as duas entradas.

O achado é posicionado na entrada própria da conexão posterior — a traçada em segundo lugar, que é a que de outro modo teria ocupado o slot do alias — no documento em que essa entrada foi escrita. Assim, uma entrada de Release, ou uma vinculação que a Release escreve, conta como uma falha de operações, e uma entrada no Aggregate como uma falha do desenvolvedor. Cada conexão infratora é relatada como um achado próprio, de modo que uma única build nomeia todas elas.

Algumas estruturas são nomeadas com menos exatidão. Um nome de vinculação declarado em mais de um escopo — em um componente e no subsistema que o contém, por exemplo — traça uma conexão a partir de cada bloco que o declara, e a build registra ambas apenas sob o nome da vinculação. As duas conexões são então nomeadas em um dos blocos declarantes — o próprio bloco de vinculações do componente, onde quer que o nome esteja declarado ali — e nenhuma delas traz uma posição de lista. O mesmo vale dentro de um Aggregate importado, onde os blocos declarantes — o de um componente e o de um dos próprios subsistemas do módulo — são nomeados no próprio documento do módulo. Em cada uma dessas estruturas o par continua sendo recusado.

Como corrigir: dê a uma das duas conexões um alias próprio. Para uma lista que nomeia duas vezes o mesmo destino, liste o destino uma só vez, ou escreva as duas conexões como entradas com chave sob dois aliases. Para um alias em dois sockets, renomeie uma das duas chaves. Uma vinculação que cabeia um socket sob um alias que o componente já usa recebe uma chave diferente em seu próprio bloco uses:.

uses: socket not declared in the owning entity’s usesSchema (Socket não declarado no esquema de sockets da entidade proprietária)

Um bloco uses: nomeia um socket que a entidade proprietária da superfície não declara em seu usesSchema, em uma das duas superfícies onde só um socket declarado pode ser nomeado: o uses: de uma vinculação de Feature, onde o socket precisa ser declarado na Feature vinculada, e o uses: por aresta de uma Release, onde precisa ser declarado no Component consumidor. Uma Release só pode cabear ou configurar arestas dentro dos sockets que o usesSchema do Component já declara.

A superfície das vinculações é verificada em cada escopo em que uma vinculação é escrita: em um componente, em um subsistema — do Aggregate ou de um módulo que ele importa —, em uma fronteira de Release e em uma entrada de componente da Release, incluindo a entrada de um componente que um módulo fornece. As declarações próprias de um módulo são verificadas assim que a composição que o importa é construída, e o achado nomeia o Aggregate do módulo e a chave dentro do seu documento.

O bloco uses: próprio de um componente deliberadamente não é uma dessas superfícies, então esta interrupção não dispara para ele. Um desenvolvedor é dono da topologia que o Aggregate declara e pode nomear um socket que o catálogo não declarou; o silêncio do catálogo sobre um socket significa que a conexão não foi prevista, não que seja proibida. Esse socket é legal e sua aresta é construída — o que ele perde é o seletor e o contrato por aresta que um socket declarado traz. Um nome de socket escrito errado ali, portanto, não é uma interrupção, mas uma conexão ad hoc própria, e é relatado como um aviso que nomeia as duas grafias — veja warnings.md “Uses-socket near-miss lint (Lint de quase correspondência de sockets uses)”.

Mensagem emitida:

unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (socket uses desconhecido: nomeie um socket que a entidade declara em seu usesSchema — só o próprio bloco uses de um componente pode nomear um que o catálogo não declarou; com a Release, a entrada do componente, o tipo de componente, o nome do socket e os sockets declarados)

O ramo das vinculações nomeia o tipo de funcionalidade no lugar do tipo de componente; uma Feature vinculada que não declara nenhum usesSchema relata, em vez disso, que declarações uses: não são permitidas para ela.

Como corrigir: em uma vinculação, corrija o nome do socket para um que a Feature vinculada declara, ou declare esse socket no usesSchema da Feature. Em uma entrada por aresta de uma Release, corrija o nome do socket para um que o Component consumidor declara — uma Release não pode introduzir um socket que o Component não declara, e mover a declaração para a entidade do catálogo é o caminho suportado. Se a entidade do catálogo não declara nenhum usesSchema, ela não aceita declarações uses: nessa superfície — remova o bloco.

A connection carries an attachment under a name its socket declares no slot for (Uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot)

O bloco features: de uma entrada de conexão nomeia uma vinculação que nenhum slot do socket da conexão declara. As vinculações que uma conexão traz são um conjunto fechado: o socket pelo qual a conexão é cabeada declara, em um featuresSchema na entrada do usesSchema do Component consumidor, cada slot que uma conexão nele pode preencher, e uma vinculação sob qualquer outro nome é recusada quando a build é carregada. Um socket que não declara nenhum featuresSchema não admite vinculações em suas conexões, e o mesmo vale para um socket que o Aggregate nomeia sem que o Component o declare — esse socket não declara nenhum slot.

A regra vale nos dois documentos que escrevem as vinculações de uma conexão: a entrada de conexão do Aggregate sob o uses: de um componente e a entrada uses: por aresta da Release. Para um componente que um subagregado fornece, os nomes do desenvolvedor são verificados assim que o próprio documento do subagregado é lido, e o achado nomeia o arquivo desse documento e a entrada do componente nele. Os nomes da Release são verificados assim que a composição é achatada, para cada componente sobre o qual a Release escreve, e o achado nomeia a própria entrada da Release — dentro da fronteira em que ela está, ou sob a entrada de roteamento que alcança o componente de um subagregado. Uma entrada de Release em um socket que o Component não declara é relatada pela interrupção por socket não declarado mais acima, que lista os sockets que de fato existem, e não por esta.

Mensagem emitida. Primeiro vem a recusa, depois o documento e a entrada, o nome da vinculação, a conexão, o socket, o componente e os slots que o socket declara — depois o que fazer a respeito:

a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot: o Aggregate, a entrada, a vinculação, a conexão, o socket e o componente indicados, com os slots que o socket declara. Escreva a vinculação sob um dos slots que o socket declara, ou declare este slot no featuresSchema do socket no Component.)

Onde o nome está a uma edição de distância de um slot que o socket declara — um caractere transposto, omitido, duplicado ou errado, a estrutura que um erro de digitação assume —, esse slot é nomeado logo depois dele, de modo que a grafia provavelmente pretendida está na mesma frase:

a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …) (uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot: a Release e a entrada indicadas, o nome da vinculação próximo do slot declarado, a conexão indicada, …)

Nenhum aviso separado é gerado para um nome assim. No próprio bloco features: de um componente, um nome a uma edição de distância de um slot declarado é legal e gera apenas o aviso descrito em “An attachment name is one edit from a declared slot (Um nome de vinculação está a uma edição de distância de um slot declarado)” mais abaixo; em uma conexão o nome é recusado, e a recusa traz o próprio emparelhamento.

Onde o socket não declara nenhum slot, a lista não aparece e a recomendação diz “The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component. (O socket não declara nenhum slot, então nenhuma conexão cabeada por ele traz uma vinculação: remova a vinculação, ou declare o slot no featuresSchema do socket no Component.)” Onde o Component não declara o socket de forma alguma, ela diz “The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema. (O tipo do componente não declara este socket, então o socket não declara nenhum slot e nenhuma conexão cabeada por ele traz uma vinculação: remova a vinculação, ou declare o socket e seu slot no usesSchema do Component.)”

Cada vinculação infratora é relatada como um achado próprio, de modo que uma única build nomeia todas elas.

Como corrigir: escreva a vinculação sob um slot que o socket declara; ou, se a conexão precisar de um slot que o socket não tem, declare-o no featuresSchema do socket no Component. Em um socket que o Component não declara, declare o socket e seu slot no usesSchema do Component, ou remova a vinculação.

Release retargets a developer-declared edge (A Release muda o destino de uma aresta declarada pelo desenvolvedor)

Uma entrada uses: por aresta de uma Release nomeia um destino diferente daquele que o desenvolvedor já cabeou para o mesmo socket e alias. Uma Release pode configurar uma aresta que o desenvolvedor declarou (definir infra por aresta, nomeando o mesmo destino ou omitindo-o) e pode cabear uma aresta em um socket declarado mas sem associação, mas não pode mudar o destino de uma aresta que o desenvolvedor declarou — o desenvolvedor é dono da arquitetura que escreveu.

Os dois destinos são comparados como foram escritos, não como se resolvem. Um target: pode nomear o alias publicado de um subagregado em vez de um id de componente, e esse alias se resolve no componente para o qual o módulo o publica — então uma entrada de Release que repete exatamente o alias que o desenvolvedor escreveu é uma configuração e é aceita, exatamente como a repetição de um simples id de componente.

A aresta mantém o destino que o desenvolvedor lhe deu, quer esta interrupção dispare, quer não, e o bloco infra: da entrada de Release não é aplicado a ela. Uma mudança de destino recusada nunca é aplicada pela metade.

Mensagem emitida. Primeiro vem a recusa, depois o destino que o desenvolvedor declarou, o destino que a Release nomeou e o socket — depois o que fazer a respeito:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (a aresta da Release muda o destino de uma aresta declarada pelo desenvolvedor: o destino declarado, o destino que a Release nomeia e o socket em que ela está cabeada, indicados. Remova o destino da entrada da Release para configurar a conexão como ela foi declarada, ou mude o destino onde a conexão é declarada.)

O achado é posicionado na entrada escrita em que a conexão foi declarada, no documento que a declarou. Cada entrada infratora é relatada como um achado próprio, de modo que uma única build nomeia todas elas em vez de uma por execução.

Como corrigir: remova o target divergente da entrada uses: da Release para configurar a aresta existente (apenas infra por aresta), ou, se a conexão de fato pertence a outro socket, cabeie-a por um socket que o desenvolvedor deixou sem associação. Para mudar o próprio destino, mude-o no Aggregate, onde a topologia é escrita.

Release per-edge configuration has no edge to apply to (A configuração por aresta da Release não tem nenhuma aresta à qual se aplicar)

Uma entrada uses: por aresta de uma Release define infra:, vinculações sob features:, ou ambos, mas não existe nenhuma aresta no consumidor, no socket e no alias que ela nomeia, depois que todas as arestas da build foram traçadas.

As duas coisas que uma entrada de Release pode fazer são cabear uma aresta e configurar uma, e qual delas ela faz é decidido por ela nomear ou não um target:. Uma entrada com um destino cria a aresta que configura. Uma entrada sem destino configura uma aresta que já precisa existir — declarada pelo desenvolvedor no Aggregate, ou fornecida por uma Feature vinculada. Então uma entrada que não nomeia nenhum destino e não corresponde a nenhuma aresta existente não se aplica a nada: o bloco infra: e as vinculações abaixo dele nunca chegam a nenhuma saída. A build para em vez de aceitar uma autoria que não faz nada, porque, de outro modo, uma build bem-sucedida seria lida como confirmação de que a infraestrutura foi aplicada e de que a conexão traz o que a entrada colocou nela.

O alias faz parte do que uma entrada nomeia, então uma entrada que configura um alias que o desenvolvedor nunca declarou não alcança nenhuma aresta, mesmo quando o socket está associado sob outro alias. O mesmo vale para uma entrada que nomeia um componente que o Aggregate não declara.

Duas condições vizinhas são relatadas por suas próprias interrupções, e não por esta, porque cada uma tem mais a dizer a você. Um socket que o usesSchema do Component consumidor não declara é relatado como socket não declarado, o que permite listar os sockets que de fato existem. Um target: que não nomeia nenhum componente é relatado como destino pendente. Um componente desligado por um interruptor active: leva suas arestas consigo, por design, então uma entrada que ficou sobre ele é aceita em vez de interrompida.

Cada entrada infratora é relatada. Uma Release com várias entradas que não alcançam nenhuma aresta é interrompida com uma destas mensagens por entrada em uma única build, na ordem em que o documento as declara, em vez de relatar a primeira e deixar o resto para a próxima build.

Mensagem emitida, onde a entrada nomeia um componente que existe. Ela traz o caminho da própria entrada, de modo que é nomeada a linha a editar, e não o componente que a contém:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (a configuração por aresta da Release não tem nenhuma aresta à qual se aplicar: a Release, a entrada, o consumidor, o socket e o alias indicados. Dê um destino à entrada para cabear a aresta, ou remova-a: uma entrada sem destino configura uma aresta que já precisa existir.)

Uma Release que nomeia seus componentes no nível superior em vez de sob fronteiras traz a estrutura que seu autor escreveu — .spec.components.<consumer>.uses.<socket>.<alias> — e um componente nomeado dentro de uma entrada de roteamento aggregates: é nomeado por meio dessa entrada, sob o nome local que ele traz ali.

Onde a entrada nomeia um componente que o Aggregate não declara, a interrupção vem de uma fase anterior da build e diz o seguinte, nomeando o que a entrada define — infra, features ou infra and features:

release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (a configuração por aresta da Release não tem nenhuma aresta à qual se aplicar: a aresta da Release indicada define os blocos indicados no consumidor indicado, que não é um componente na topologia)

Como corrigir: adicione um target: à entrada, o que cabeia a aresta e aplica a configuração a ela; corrija o alias para aquele que o Aggregate declarou para essa conexão, de modo que a entrada configure a aresta existente; corrija o nome do componente para um que o Aggregate declara; ou remova a entrada se a configuração não for mais desejada.

A Release attachment takes the name of a connection’s attachment (Uma vinculação da Release usa o nome da vinculação de uma conexão)

Uma Release escreve uma vinculação sob o nome que uma vinculação em uma das conexões de um componente recebe: o alias da conexão, um ponto e o slot que a vinculação preenche — gpt.credential para a vinculação que preenche o slot credential na conexão gpt. A vinculação de uma conexão é escrita na sua entrada de conexão — a conexão do Aggregate sob o uses: do componente, ou a entrada uses: por aresta da Release para a mesma conexão — e se torna uma vinculação do componente consumidor sob esse nome composto. A Release escreve vinculações em dois outros escopos cujas chaves podem conter um ponto, então o nome composto também pode ser escrito ali:

  • O próprio bloco features: de uma entrada de componente, que se vincula a esse componente.
  • O próprio bloco features: de uma fronteira, que se vincula a cada componente colocado nessa fronteira ou em uma fronteira aninhada dentro dela — incluindo os componentes de um subagregado que a fronteira roteia para dentro sem nomeá-los. Uma chave ali é interrompida quando é igual ao nome composto em qualquer componente que ela alcança, nomeie ela ou não um type:.

A build para em vez de incorporar qualquer uma das duas à vinculação da conexão, porque então nenhum dos dois documentos mostraria por inteiro o que a build faz com ela. O slot de um socket é preenchido por conexão, pela própria entrada da conexão, e nunca por uma vinculação que caia em cascata sobre ele a partir de um escopo mais amplo. Uma chave com ponto que nenhuma vinculação de conexão dos componentes que ela alcança recebe é um nome de vinculação comum, e não é recusada.

A verificação abrange uma vinculação que qualquer um dos dois documentos colocou na conexão, e tanto um componente que um subagregado fornece quanto um que o Aggregate declara.

Mensagem emitida, para uma chave em uma entrada de componente. Primeiro vem a recusa, depois a Release e a entrada de componente, a chave que a Release escreveu, o componente, a conexão, o socket e o slot — depois a entrada de conexão em que escrevê-la:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (uma vinculação da Release usa o nome de uma vinculação que uma das conexões de um componente traz: a Release, a entrada do componente, a chave, o componente, a conexão, o socket e o slot indicados. Escreva-a na entrada de conexão, sob o caminho indicado, e remova a chave das features desta entrada: uma vinculação que uma conexão traz é escrita nessa conexão e em nenhum outro lugar.)

Mensagem emitida, para uma chave em uma fronteira. Ela nomeia o bloco de vinculações da fronteira e o componente cuja conexão traz a vinculação:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (uma vinculação da Release usa o nome de uma vinculação que uma das conexões de um componente traz: a Release, o bloco de vinculações da fronteira, a chave, o componente, a conexão, o socket e o slot indicados. Escreva-a na entrada de conexão do componente indicado, sob o caminho indicado, e remova a chave das features desta fronteira: uma vinculação que uma conexão traz é escrita nessa conexão e em nenhum outro lugar.)

Uma chave em uma fronteira que alcança vários componentes cujas conexões trazem o nome composto é relatada uma vez para cada um deles, porque cada conexão é uma edição separada.

O achado é posicionado no bloco em que a chave foi escrita — a entrada de componente, ou o features: da fronteira — porque a própria chave contém um ponto e uma posição não consegue endereçar uma chave assim; em vez disso, a chave é nomeada na mensagem. Em uma Release que nomeia fronteiras, uma entrada de componente é lida como .spec.boundaries.<boundary>.components.<component>, um componente nomeado dentro de uma entrada de roteamento aggregates: é nomeado por meio dessa entrada, sob o nome local que ele traz ali, e o bloco de uma fronteira aninhada é lido como .spec.boundaries.<outer>.boundaries.<inner>.features.

Como corrigir: mova a vinculação para a entrada da Release para essa conexão — uses.<socket>.<alias>.features.<slot> sob o componente — escrevendo ali apenas infra: para dimensionar uma vinculação que o Aggregate declara, ou type: e infra: para uma que só a Release cria; depois remova a chave com ponto do features: do componente ou da fronteira. Uma chave válida para toda a fronteira e destinada às conexões de vários componentes é escrita uma vez em cada uma dessas conexões.

A Release connection attachment names no Feature type (Uma vinculação de conexão da Release não nomeia nenhum tipo de Feature)

Uma entrada uses: por aresta de uma Release coloca uma vinculação em uma conexão, sob um slot para o qual o Aggregate não declara nenhuma vinculação nessa conexão, e não nomeia nenhum type:. Uma vinculação que uma Release escreve em uma conexão é uma de duas coisas. Ou ela dimensiona uma vinculação que o Aggregate já declara na mesma conexão, e não nomeia nenhum tipo porque a declaração do Aggregate o nomeia; ou é uma vinculação que só a Release cria, e então a entrada da Release é o único lugar de onde pode vir o seu tipo de Feature. Sem um tipo, nada consegue escolher uma FeatureRecipe para a vinculação.

A verificação abrange tanto um componente que um subagregado fornece quanto um que o Aggregate declara. Um componente que um interruptor active: desligou leva suas conexões consigo, então uma entrada que ficou sobre ele não é verificada.

Mensagem emitida. Primeiro vem a recusa, depois a Release e a entrada de conexão, o slot, a conexão, o socket e o componente — depois o que fazer a respeito:

a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (uma vinculação de conexão da Release não nomeia nenhum tipo de Feature, e o tipo é obrigatório para uma vinculação que só a Release cria: a Release, a entrada de conexão, o slot, a conexão, o socket e o componente indicados. Nomeie, pelo seu tipo, a Feature que esta vinculação vincula, ou declare a vinculação na entrada de conexão do Aggregate e dimensione-a aqui.)

Cada vinculação infratora é relatada como um achado próprio, de modo que uma única build nomeia todas elas.

Como corrigir: adicione um type: que nomeie a Feature que a vinculação vincula; ou, onde declarar a vinculação cabe ao desenvolvedor, declare-a na entrada de conexão do Aggregate com seus values: e mantenha apenas infra: na entrada da Release.

Component identity cannot be stamped on what it emits (A identidade do Component não pode ser carimbada no que ele emite)

A identidade de um componente não é só uma chave no seu Aggregate — ela é um nome dentro do cluster. Cada recurso que um componente emite é carimbado com ela, sob aggrega.ai/component-id e app.kubernetes.io/name, e os sintetizadores de cargas de trabalho nomeiam o que emitem a partir dela. Então a identidade precisa ser um nome que o destino aceite, e precisa ser um nome que significa o que diz.

Um nome que você escreveu chega à saída exatamente como você o escreveu, e é isso que faz do nome no seu Aggregate o nome que você pode procurar no seu cluster. Vale a pena ter isso, e é por isso que uma identidade que o destino recusaria é relatada aqui em vez de ser reparada silenciosamente em algo que você nunca escreveu.

Um caractere é a exceção, e é um que você não pode escrever: o ponto que une o nome de um módulo ao nome de um componente dentro dele. Ele é excluído de todo nome que você escreve justamente para que essa união seja inequívoca, e é retirado da identidade antes que ela seja carimbada — data-layer.main-db é carimbado como data-layer-zdmain-db. Isso não custa nenhum nome que alguém tenha digitado, e é o que permite carimbar um componente que um Aggregate importado fornece: um ponto não é um caractere que um nome de Service aceite, e dentro de um endereço do cluster ele separa um serviço do seu namespace, então um nome com ponto entregue a um consumidor como host se resolveria em outro serviço em vez de falhar.

Duas estruturas são recusadas.

Uma identidade que o alfabeto de carimbo não consegue levar. A identidade é escrita no valor do rótulo que cada recurso emitido traz, e esse alfabeto admite letras, dígitos, -, _ e ., e exige que o valor comece e termine com uma letra ou um dígito. As regras dos nomes escritos são próximas disso, mas não iguais — permitem que um nome comece ou termine com - ou _ —, então _api e api- são ambos nomes que você pode escrever e nenhum dos dois pode ser carimbado.

Qual pode ser o comprimento de um nome não é perguntado aqui. Isso cabe ao destino em que um componente é implantado, e destinos diferentes respondem de formas diferentes: esta condição abrange as estruturas que nenhum destino conseguiria levar. Um nome recusado pelo seu comprimento é relatado, em vez disso, pela própria recusa do destino, que traz o motivo desse destino e o comprimento que ele aceitaria.

Uma identidade que começa como começa uma identidade composta. Os recursos que uma Feature emite não podem ser carimbados com um nome de componente que você escreveu, então o Aggrega compõe para eles uma identidade a partir das partes que você escreveu, atrás de um prefixo fixo que diz onde a Feature foi vinculada. Onde a Feature está vinculada a um único componente, a identidade é composta a partir desse componente e da chave sob a qual a Feature está vinculada, e começa com cfr--. Onde ela está vinculada a uma fronteira inteira, não se aplica o nome de nenhum componente, então a identidade é composta a partir do caminho da fronteira e do nome sob o qual a Feature está vinculada, e começa com bfr--. É o prefixo que diz ao leitor de qual das duas um recurso veio, em vez de ter vindo de um componente. Então bfr-- e cfr-- são ambos reservados no início de uma identidade de componente. Um componente chamado bfr--api ou cfr--api seria carimbado de forma idêntica a um composto, e nada na saída emitida conseguiria distinguir os dois. Só o prefixo completo é reservado: um componente chamado bfr, cfr, bfr-api ou bfrontend tem um nome comum e a build é concluída.

A verificação lê a identidade que um componente de fato traz, que, para um componente fornecido por um Aggregate importado, é a qualificada — o nome do módulo, um ponto e o nome próprio do componente. Então dois nomes que são aceitáveis cada um por si ainda podem se unir em uma identidade que não é: um módulo chamado bfr--x e um componente chamado y dentro dele se unem em bfr--x.y, que começa como começa uma identidade composta. A interrupção nomeia a identidade unida enquanto aponta para a chave que você escreveu.

Mensagem emitida, para uma identidade que o destino recusaria:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (a identidade do componente não pode ser o nome carimbado nos recursos que ele emite: renomeie o componente; com o Aggregate, o caminho do campo e a identidade indicados, e a regra que a identidade precisa cumprir)

e para uma que começa como começa uma identidade composta, onde <opening> é aquele dos prefixos reservados ao qual o nome correspondeu:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (a identidade do componente não pode ser o nome carimbado nos recursos que ele emite: renomeie o componente; com o Aggregate, o caminho do campo e a identidade indicados, que não pode começar com o prefixo reservado indicado)

Como corrigir: renomeie o componente, em cada superfície que o nomeia — o Aggregate que o declara e a Release que o coloca e o configura. Dê a ele um nome que comece e termine com uma letra ou um dígito e que não comece nem com bfr-- nem com cfr--. Renomear um componente muda o nome que seus recursos trazem no cluster, então, em uma aplicação já implantada, trate isso como qualquer outra renomeação de recurso.

The target will not accept a name derived from an authored identity (O destino não aceita um nome derivado de uma identidade escrita)

Cada destino deriva seus próprios nomes da identidade de um componente: um instalador de charts deriva um nome de release, um orquestrador de contêineres deriva nomes de serviço. Esta interrupção é esse destino dizendo que não pode usar um deles.

A Aggrega não mantém as regras de nomenclatura de nenhum destino. Ela não sabe qual comprimento um nome pode ter, quais caracteres um destino admite nem o que a gramática de um destino exige no início de um nome — e deliberadamente não sabe, porque isso varia conforme o destino, conforme o tipo de recurso em que um nome vai parar e, às vezes, conforme um serviço dentro de um mesmo provedor. Por isso, antes que um nome seja definido, o compilador pergunta ao provedor que vai renderizar o componente, e esta interrupção relata a resposta do provedor. É por isso que a mensagem traz a palavra do próprio destino para o que recusou (release name, Service name) e o motivo do próprio destino, em vez de uma regra escrita no compilador.

Por que o nome é recusado em vez de encurtado. Um nome que você escreveu é o nome com que sua carga de trabalho é implantada: encurtá-lo renomearia cada recurso em cada saída existente, e o faria em seu nome sem que você tivesse pedido. A pessoa que pode escolher um nome diferente é a pessoa que escreveu este, então a interrupção aponta para a chave spec.components que você escreveu e deixa o nome como está. Os nomes que a própria Aggrega compõe — a identidade de uma Feature vinculada a uma fronteira inteira, por exemplo — são encurtados em vez disso, porque são montados a partir de partes escritas em vários documentos e nenhum autor sozinho consegue ver o comprimento que eles atingem.

Duas respostas que um destino pode dar, e elas levam a lugares diferentes. Onde um nome mais curto seria aceito, a interrupção informa o comprimento que funcionaria, de modo que um novo nome é escolhido uma vez em vez de duas. Onde nenhum comprimento ajudaria — um caractere que a gramática do destino recusa na posição em que foi parar —, nenhum comprimento é informado, porque encurtar não pode resolvê-lo. O caso mais comum do segundo tipo: um destino cujos nomes admitem apenas minúsculas faz o escape de cada caractere que não admite, e todo escape começa com um hífen, de modo que um nome cujo primeiro caractere sofre escape produz um nome que começa com um hífen. Um destino que exige ali uma letra minúscula ou um dígito o recusa, por mais curto que seja o resto. Um destino também pode sujeitar o início de um nome à regra mais estrita dos recursos nomeados a partir dele: o destino helm recusa um nome que começa com um dígito, relatado como Service name, porque o Helm aceita um nome de release assim, enquanto o cluster recusa um Service do Kubernetes nomeado a partir dele.

Uma terceira forma aparece apenas para um nome composto: um destino pode informar um comprimento menor que a identidade mais curta que o compilador consegue compor a partir das partes que recebeu, já que uma identidade composta reserva espaço para um discriminador. A interrupção diz isso e nomeia a solução — encurtar as partes escritas — em vez de relatar o provedor como defeituoso.

Alguns nomes existem apenas para a carga de trabalho que um componente renderiza. O provedor é consultado assim que o Workload desse componente é resolvido, e a consulta inclui o form do Workload e suas chaves de Service, para que um destino possa avaliar também os nomes que constrói a partir deles. Com o destino helm, isso acrescenta dois: um CronJob name, de no máximo 52 caracteres e avaliado apenas para um Workload scheduled, porque o cluster nomeia o Job de cada execução a partir do CronJob, com um sufixo acrescentado; e cada Service name, <release name>-<service key>, de no máximo 63 caracteres. Um nome de Service é construído a partir de partes de dois autores — o nome do seu componente e a chave que a carga de trabalho declara, na Recipe ou em uma FeatureRecipe —, então seu motivo nomeia a chave e o lugar em que a carga de trabalho a declara, spec.workload.services.<key>, ao lado do campo que você escreveu. Uma chave longa o suficiente para não deixar espaço para nenhum nome de componente não informa nenhum comprimento dentro do qual escolher, e o motivo diz que é a chave que precisa ser mais curta. Esses nomes não são avaliados para uma Feature associada a uma fronteira inteira: sua identidade é definida antes de seu Workload ser resolvido, porque o lugar em que sua saída é montada pode depender dela.

Mensagem emitida, para uma identidade escrita:

the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (o destino não aceita um nome derivado da identidade escrita deste componente: renomeie o componente (o componente indicado, escrito no caminho indicado, que o destino não pode usar como o tipo de nome indicado, com o motivo do destino). escolha um nome que o destino aceite, com no máximo o número de caracteres indicado)

Como corrigir: renomeie o componente para um nome que o destino aceite, em cada superfície que o nomeia — o Aggregate que o declara e a Release que o posiciona e o configura. Onde a mensagem informa um comprimento, fique dentro dele. Onde não informa, leia o motivo do destino: geralmente é um caractere que o destino não admite, e na maioria das vezes uma letra maiúscula no início do nome — ou, com o destino helm, um dígito nessa posição. Prefira letras minúsculas e dígitos com hifens entre as palavras; o capítulo sobre nomenclatura explica o que um nome custa em cada tipo de destino. Onde o motivo nomeia uma chave de Service, o comprimento também pode ser recuperado encurtando essa chave onde a carga de trabalho a declara — e, onde o motivo diz que a chave não deixa espaço, só isso resolverá. Renomear um componente muda o nome que seus recursos carregam, então, em uma aplicação já implantada, trate isso como qualquer outra renomeação de recursos.

Onde a identidade é uma que o compilador compôs em vez de uma que você escreveu, a mesma interrupção relata o valor composto e pede que você encurte as partes a partir das quais ele foi construído — o nome sob o qual você vinculou uma Feature e o caminho da fronteira à qual você a vinculou.

A provider never accepted a name the compiler composed (Um provedor nunca aceitou um nome composto pelo compilador)

Esta relata um defeito em um plugin, não em algo que você escreveu.

Definir um nome composto é uma troca: o compilador propõe uma identidade, o provedor a aceita ou diz quão curta ela teria de ser, o compilador compõe uma mais curta e o provedor é consultado novamente. Uma segunda recusa é normal e esperada — encurtar para um comprimento pode colocar um caractere onde a gramática desse destino não o admite, e o provedor dizer isso é a forma como um compilador que não conhece a gramática de nenhum destino e um provedor que a conhece chegam a um acordo.

O que não é normal é um provedor que nunca aceita nada: um que informa um comprimento, recebe um nome desse comprimento e o recusa novamente. A troca é limitada e, ao atingir o limite, a build para e nomeia o provedor em vez de usar um nome com o qual o provedor nunca concordou. Um nome definido por desistência seria carimbado em recursos reais sem que nada na saída registrasse que nenhum acordo foi alcançado, e a consequência apareceria no momento da aplicação em vez de na build que o produziu.

Mensagem emitida:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (o guest do provedor nunca aceitou uma identidade de componente que o compilador compôs para ele (o guest do provedor indicado recusou o número de propostas indicado, sendo a última delas a identidade indicada). relate o defeito a quem mantém esse plugin de provedor)

Como corrigir: relate-o a quem mantém o plugin de provedor nomeado, citando a última proposta da mensagem. Não há nenhuma alteração de autoria que contorne isso: o compilador já ofereceu cada comprimento que o provedor pediu. Se o provedor for um que você mantém, a verificação a fazer é que um nome cortado para um limite que ele informa seja um nome que ele então aceita.

Required uses: socket not populated (Socket obrigatório não preenchido)

Um Component declara em seu usesSchema um socket marcado com required: true, e nada na build cabeia uma conexão nesse socket para uma das instâncias desse Component.

Três superfícies podem cabeá-lo, e a interrupção só dispara quando as três estão vazias. O próprio bloco uses: da instância no Aggregate; uma entrada uses: por aresta de uma Release que nomeia um target:, a qual cria a conexão em um socket declarado, mas sem associação; e o conjunto de conexões que a composição produziu, que é o que responde por um componente fornecido por um Aggregate importado — o bloco uses: de um componente assim fica no próprio documento desse Aggregate, lido apenas quando a composição está montada. Como a terceira superfície é a última a ficar completa, a verificação é executada assim que a composição inteira existe, e não enquanto os dois documentos escritos são lidos, e ela faz a mesma pergunta a cada componente, seja qual for o documento que o declarou.

Duas estruturas que parecem que deveriam preencher o socket não o fazem. Uma entrada de Release que não nomeia nenhum target: configura uma conexão que já precisa existir em vez de criar uma, então não cabeia nada (e, onde traz infra:, é relatada pela sua própria interrupção mais acima). E o uses: de uma vinculação de Feature nomeia sockets declarados na Feature vinculada, um conjunto de sockets separado em uma entidade separada, então uma vinculação nunca pode preencher um socket próprio de um Component.

Mensagem emitida:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (socket uses obrigatório não preenchido (Component, no caminho do socket, com o nome do socket, declarado obrigatório pelo tipo de componente indicado))

O achado é posicionado na entrada de socket que o autor precisa escrever, .spec.components.<instance>.uses.<socket>. O nome de instância nela é o nome que o componente carrega no documento que o declara, então, para um componente que um Aggregate importado forneceu, o localizador nomeia uma chave que o próprio arquivo desse Aggregate contém, e não o nome com prefixo que a composição lhe deu.

Cada socket obrigatório não preenchido é relatado, em cada componente: uma única build informa você sobre todos eles em vez de apenas sobre o primeiro.

Como corrigir: adicione uma entrada uses: para o socket obrigatório, cabeando-a a um destino que o selector: do socket aceita; ou cabeie-o a partir da Release com uma entrada que nomeia um target:. Se o socket não deve mais ser obrigatório, atualize o usesSchema do Component para definir required: false ou remova a declaração required.

Sub-aggregate nesting depth exceeded (Profundidade de aninhamento de subagregados excedida)

Uma cadeia de importações de subagregados excede a profundidade máxima de aninhamento do compilador. O limite impede um achatamento descontrolado de topologias profundamente aninhadas e força uma decomposição arquitetural acima de um limiar.

Mensagem emitida:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (profundidade máxima de aninhamento de subagregados excedida: a profundidade indicada no prefixo achatado indicado.)

Como corrigir: reestruture a topologia do agregado para reduzir o aninhamento. Um aninhamento tão profundo geralmente indica que a forma do Aggregate espelha a hierarquia organizacional em vez da topologia de implantação — considere achatar grupos de subagregados em subsistemas de mesmo nível dentro de um único Aggregate pai.

Feature type mismatch between Aggregate and Release (Divergência de tipo de Feature entre Aggregate e Release)

O Aggregate e a Release vinculam ambos uma funcionalidade com o mesmo nome de instância, mas cada um declara um type: diferente, e a vinculação da Release alcança o componente a partir dos features: de uma fronteira. Onde a Release a escreve, em vez disso, em sua própria entrada para o componente, o mesmo conflito é recusado antes e relatado como E0153, em “A feature attached by both the Aggregate and the Release cannot be merged (Uma funcionalidade vinculada tanto pelo Aggregate quanto pela Release não pode ser mesclada)” mais acima.

Mensagem emitida:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (divergência de tipo de funcionalidade entre Aggregate e Release (o nó e a vinculação indicados, o tipo existente no Aggregate entra em conflito com o tipo na Release))

Como corrigir: remova o type: da Release (ela o herdará do Aggregate), ou altere um dos lados para que ambos declarem o mesmo tipo. A Release pode omitir type: ou repetir o tipo do Aggregate, mas não pode substituí-lo por outro diferente.

Cyclic extends on Components or Features (Extends cíclico em Components ou Features)

A cadeia extends: de um Component ou a cadeia extends: de uma Feature volta sobre si mesma.

Mensagem emitida, com Feature no lugar de Component quando a cadeia que forma o laço é a de uma Feature:

cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (cadeia extends cíclica (Component indicado, regra extends). A entidade estende a referência, que já está na cadeia; remova o extends da entidade ou aponte-o para uma entidade fora da cadeia)

Como corrigir: abra a entidade que a aresta nomeia — que, ao longo de uma cadeia de três ou mais, não é a entidade nomeada no início da mensagem — e remova seu extends: ou aponte-o para outro lugar.

A component the composition holds is placed in no boundary (Um componente que a composição contém não está posicionado em nenhuma fronteira)

Uma Release posiciona um componente em uma fronteira de duas maneiras, e qualquer uma delas conta. Ela nomeia o componente sob os components de uma fronteira, endereçado pelo id que o componente carrega assim que a composição inteira é achatada. Ou roteia o módulo que fornece o componente para uma fronteira sob aggregates, o que posiciona de uma vez cada componente que esse módulo contém.

Um componente que não alcança nenhuma das duas é renderizado fora de toda fronteira que a Release declarou. Seu diretório de saída, sua sync wave, suas anotações e seu infra por componente então não vêm de lugar nenhum — e a build, de outro modo, seria bem-sucedida, emitiria os artefatos e não diria nada sobre a configuração do operador nunca ter sido aplicada a ele. Dois componentes separados por essa linha também são renderizados em saídas diferentes e perdem a ordenação que têm quando posicionados juntos.

Duas estruturas deliberadamente não se enquadram nela. Uma Release que declara components de nível superior em vez de fronteiras nomeadas posiciona tudo o que nomeia: normalizar uma Release assim lhe dá uma fronteira própria que contém exatamente esses componentes. E um componente cujo módulo inteiro a Release não posicionou em lugar nenhum é relatado, em vez disso, uma única vez em relação ao módulo, na entrada abaixo — uma falha, uma solução, uma chave a editar — em vez de uma vez por componente cuja própria declaração está correta.

Mensagem emitida. O valor no final é o id que o componente carrega assim que a composição é achatada, que, para um componente que um módulo forneceu, é o nome desse módulo, um ponto e o nome próprio do componente:

component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (componente não posicionado em nenhuma fronteira: nomeie-o entre os componentes de uma fronteira, ou posicione o submódulo que o fornece entre os agregados (com a Release, a chave escrita e o id do componente indicados))

Como corrigir: nomeie o componente sob os components de uma fronteira, usando exatamente o id que a mensagem cita — para um componente que um módulo forneceu, esse é o id com prefixo, e não o nome escrito dentro do próprio arquivo do módulo. Ou, onde o módulo inteiro pertence a uma única fronteira, roteie-o para lá sob aggregates e deixe que cada componente que ele contém seja posicionado de uma vez.

A sub-module’s components are placed in no boundary (Os componentes de um submódulo não estão posicionados em nenhuma fronteira)

A forma em escala de módulo da regra acima: um módulo que a composição incluiu forneceu componentes, e nenhuma fronteira contém nenhum deles. Ela é relatada uma única vez para o módulo em vez de uma vez por componente, porque um módulo não posicionado em lugar nenhum é uma única falha de autoria com uma única solução em uma única chave — e relatá-la por componente nomearia componentes cujas próprias declarações estão perfeitamente corretas.

A regra lê o posicionamento, e não a grafia, então um módulo cujos componentes são nomeados cada um individualmente sob os components de uma fronteira está posicionado e passa: recusá-lo por falta de uma entrada de roteamento rejeitaria uma forma de autoria que a linguagem admite. Um módulo posicionado apenas em parte também passa — quais de seus componentes trazem entradas próprias é questão da regra de componentes, e os que ele deixou de fora são relatados lá, cada um na sua própria chave.

Um módulo que não forneceu nenhum componente não se enquadra nela: não há nada a posicionar. Nem um que um interruptor active: em false removeu, que nunca chegou a ser composto.

Mensagem emitida, posicionada na entrada aggregates que declarou o módulo, sob o nome local que o documento importador escreveu:

sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (submódulo não posicionado em nenhuma fronteira: roteie-o para uma fronteira entre os agregados, ou nomeie ali seus componentes entre os componentes (com a Release, a chave escrita e o caminho do módulo indicados))

Como corrigir: adicione uma entrada aggregates para o módulo sob a fronteira à qual ele pertence, o que posiciona cada componente que ele fornece. Ou, onde seus componentes pertencem a fronteiras diferentes, nomeie cada um deles sob a fronteira à qual pertence, usando os ids com prefixo que eles carregam depois de achatados.

A boundary names a component the composition does not hold (Uma fronteira nomeia um componente que a composição não contém)

A contrapartida por excesso de nomes das duas regras acima, e uma questão separada em vez de um ramo de qualquer uma delas: aquelas perguntam de um componente se algo o posicionou, esta pergunta de uma entrada que a Release escreveu se algo lhe corresponde. Nenhuma implica a outra. Uma Release pode nomear um componente que não existe enquanto cada componente que existe está devidamente posicionado, e pode deixar um componente real sem posicionamento enquanto cada entrada que escreveu se resolve.

A entrada que não nomeia nada não configura nada: seu directory, seu subDirectory, seu syncWave, suas anotações e seu infra por componente são escritos para um componente que não está lá, então nada é renderizado sob eles e a build, de outro modo, seria bem-sucedida com a configuração do operador silenciosamente inerte.

Uma fronteira nomeia um componente de duas maneiras, e ambas são verificadas. Sob components, uma entrada endereça o componente pelo id que ele carrega assim que a composição é achatada — então um componente fornecido por um módulo é escrito com o prefixo desse módulo antes do seu próprio nome. Dentro de uma entrada de roteamento aggregates, uma entrada endereça o componente pelo nome local que ele carrega dentro desse módulo, que se resolve no mesmo id. A mensagem cita o id que a entrada endereçou, que no eixo roteado não é o nome que o arquivo escreve: o arquivo traz a metade local e o módulo fornece o resto.

Um subsistema não contribui com nada para o id de um componente, então um componente declarado dentro de um subsistema é endereçado pelo seu nome simples. Uma entrada escrita como se o subsistema fizesse parte do id não endereça nada e se enquadra nesta regra.

Um componente desligado por um interruptor active: em false não se enquadra nela. Desligar um componente é um ato de autoria, e não se espera que a Release que o configura seja reescrita na mesma edição — recusar a entrada tornaria o interruptor inutilizável enquanto qualquer Release nomeasse o componente.

Mensagem emitida:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (a fronteira nomeia um componente que a composição não contém: corrija o nome, ou remova a entrada (com a Release, a chave escrita e o id endereçado indicados))

Como corrigir: compare o id que a mensagem cita com os componentes que a composição realmente contém. Um prefixo de módulo ausente e um nome de subsistema escrito no id são as duas causas comuns; retire o subsistema, adicione o prefixo do módulo ou corrija a grafia. Onde a entrada sobrou de um componente que desde então foi removido ou renomeado, exclua-a.

A uses edge targets a component an active: toggle removed (Uma aresta tem como destino um componente que um interruptor removeu)

O irmão da interrupção por destino pendente mais acima, relatado separadamente para que o autor saiba por que o destino está ausente. O destino não está ausente porque nunca foi declarado — ele está declarado, e foi deliberadamente removido desta build porque seu interruptor active: se resolveu em false, levando consigo suas arestas. Um componente que sobreviveu ainda depende dele, e deixar a aresta desaparecer deixaria silenciosamente vazios os valores injetados desse consumidor no momento da implantação.

Mensagem emitida. Primeiro vem a recusa, depois o destino que o interruptor removeu e o socket em que a conexão foi cabeada — depois o que fazer a respeito:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (o destino da aresta uses foi removido porque seu interruptor active se resolveu em false: o destino indicado, cabeado no socket indicado. Mantenha em true o interruptor do destino, ou remova a dependência dele.)

O achado é posicionado na entrada escrita a que se refere, nos mesmos caminhos que a interrupção por destino pendente mais acima nomeia, e cada conexão infratora é relatada, e não apenas a primeira.

Como corrigir: decida qual dos dois pertence a este ambiente. Religue o destino — onde seu interruptor lê um parâmetro, isso significa fornecer o parâmetro para esta Release. Ou condicione o consumidor ao mesmo interruptor, para que os dois saiam juntos e nenhuma aresta fique apontando para o nada. Ou, onde o consumidor realmente não precisa mais dele, remova a aresta do bloco uses: do consumidor.

A uses target names a module’s component the module does not export (Um destino de aresta nomeia um componente de um módulo que o módulo não exporta)

Um módulo publica sua interface sob exportedComponents:, e um documento que importa o módulo alcança os componentes do módulo apenas por meio desses nomes: o nome do módulo, um ponto e um dos seus alias. Um destino de uses: que alcança um componente dentro de um módulo de qualquer outra forma — pelo nome do componente dentro do módulo, ou por um caminho que atravessa o módulo até um módulo aninhado nele — interrompe a build, porque a conexão se associaria a algo que o autor do módulo não publicou e que ele é livre para renomear ou remover. O próprio bloco uses: de um componente, o de uma vinculação e uma conexão cabeada por uma Release estão sujeitos a isso da mesma forma. Em quais módulos uma conexão entra é lido a partir de onde seu consumidor está, então uma conexão entre dois componentes de um mesmo módulo — incluindo uma Release que os cabeia um ao outro — não cruza nenhuma interface e não é recusada. Um destino que não corresponde a nenhum componente é relatado, em vez disso, pela interrupção por destino pendente, para que um nome digitado errado seja relatado uma única vez.

Mensagem emitida. Primeiro vem a recusa, depois o destino como foi escrito, o módulo em que ele entra e os alias que esse módulo exporta, e o socket — depois o que fazer a respeito:

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (o destino da aresta uses nomeia um componente que seu módulo não exporta: o destino, o módulo, os alias que ele exporta e o socket em que está cabeado, indicados. Nomeie o componente por meio de um dos alias exportados do módulo, ou liste-o entre os componentes exportados do módulo.)

Um módulo que não exporta nada é nomeado como exportando "nothing". O achado é posicionado na entrada escrita no documento que traçou a conexão.

Como corrigir: nomeie o componente por meio de um alias que o módulo exporta — finance-db-subsystem.primary_db em vez de finance-db-subsystem.internal-pg-primary — ou, onde você é o autor do módulo e pretende publicar o componente, liste-o sob os exportedComponents do módulo, com o seu próprio nome se esse for o nome que os importadores devem usar.

An active: toggle does not resolve to true or false (Um interruptor não se resolve em true nem em false)

Um interruptor active: chega ao construtor do grafo já resolvido em um literal — um booleano escrito diretamente, ou uma referência a parâmetro na qual os valores da Release foram substituídos antes de o documento ser lido. Ele é então lido de forma estrita: um literal que não é um booleano interrompe a build em vez de assumir um valor padrão qualquer. A regra é a mesma para o interruptor de um componente e para o de um módulo.

Um literal vazio é o caso que vale a pena nomear, porque é o que um parâmetro não satisfeito produz. Um interruptor que lê {{ .parameters.<key> }} se resolve em nada enquanto esse parâmetro não tem valor, e ler esse nada como “presente” implantaria justamente a entidade que o autor condicionou ao parâmetro. Só um interruptor que ninguém escreveu vale, por padrão, como presente, e isso é lido a partir da ausência do interruptor e não do seu valor — e é por isso que escrever active: sem nada depois não é o mesmo que omitir a chave.

Mensagem emitida:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (o interruptor active não se resolveu em um booleano (o nó indicado, com active resolvido no valor indicado))

e, onde ele não se resolveu em absolutamente nada, com a recomendação que nomeia a causa habitual:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (o interruptor active não se resolveu em um booleano (o nó indicado, com active resolvido em uma string vazia). um interruptor que lê um parâmetro se resolve em nada até que esse parâmetro seja satisfeito)

Como corrigir: escreva true ou false. Onde o interruptor lê um parâmetro, forneça esse parâmetro na Release, ou dê a ele um default: onde ele é declarado no Aggregate, para que cada ambiente tenha uma resposta. Para tornar uma entidade presente incondicionalmente, remova a chave active: em vez de deixá-la vazia.

A module a composition imports cannot be loaded, or imports itself (Um módulo que uma composição importa não pode ser carregado, ou importa a si mesmo)

Um Aggregate compõe outros Aggregates nomeando-os sob aggregates:, e cada um é carregado e percorrido por sua vez para que seus componentes entrem no grafo. Duas coisas interrompem esse percurso aqui.

O módulo não pode ser carregado de forma alguma — a referência não se resolve em nada que o catálogo possa devolver, ou o documento por trás dela não pode ser lido. O motivo que o carregador deu é trazido abaixo da interrupção em vez de incorporado a ela, para que o que falhou seja relatado nas próprias palavras do carregador.

Ou o módulo nomeia um tipo que já está na cadeia sendo percorrida. Expandi-lo reproduziria a cadeia que o contém, sem fim. Isso é relatado no ponto em que a referência fecha o laço, nomeando tanto o tipo quanto o lugar que ele ocupa na composição.

Mensagem emitida, para uma referência circular:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (falha ao carregar o subagregado (referência circular de subagregado, com o tipo de módulo e o caminho na composição indicados))

e para uma falha de carregamento, em que a interrupção se lê como a frase sozinha, posicionada no caminho do módulo, com o próprio motivo do carregador abaixo dela:

sub-aggregate load failed (falha ao carregar o subagregado)

Como corrigir: para uma falha de carregamento, leia o motivo abaixo da interrupção — um nome ou uma versão a que o catálogo não sabe responder é o caso comum, e a correção vai na entrada aggregates: que o nomeia. Para uma referência circular, quebre o laço: o caminho na mensagem é onde a cadeia se fecha, e um dos módulos ao longo dela precisa deixar de importar aquele que o importa. Onde dois módulos realmente precisam dos componentes um do outro, a parte compartilhada pertence a um terceiro módulo que ambos importem.

Two instances flatten to one identifier (Duas instâncias são achatadas em um único identificador)

Compor um Aggregate achata cada componente em um único conjunto, e um componente fornecido por um módulo carrega o nome desse módulo, um ponto e seu próprio nome. O conjunto se recusa a conter duas entradas sob um mesmo identificador: a segunda substituiria a primeira, e um dos dois componentes desapareceria da saída sem que nada fosse dito a respeito.

Esta interrupção é a que é levantada quando os componentes de um módulo são mesclados, e a superfície de autoria não oferece os nomes que a produziriam. Cada componente que um módulo fornece carrega o nome desse módulo antes do seu; um nome de instância é escrito com letras, dígitos, - e _, então não pode conter o ponto com que os dois são unidos, e dois identificadores construídos a partir de nomes de módulo diferentes não podem coincidir. Dois módulos importados sob um mesmo nome são uma única chave duplicada, e o documento é recusado ao ser carregado. Portanto, isso serve de rede de segurança para uma composição montada por algo diferente do caminho de autoria comum, e deparar com uma merece ser relatado em vez de contornado.

Dois componentes de um mesmo Aggregate que chegam a um mesmo identificador são uma interrupção diferente, e a autoria comum a produz — veja Two subsystems declare a component under one name (Dois subsistemas declaram um componente com um mesmo nome) mais abaixo.

Mensagem emitida:

flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (colisão de ID de nós achatados: renomeie uma das instâncias em colisão para que seus IDs achatados sejam diferentes (o identificador e o caminho na composição indicados, em colisão com a entrada existente vinda do outro contribuidor indicado))

Como corrigir: renomeie uma das duas instâncias que a mensagem nomeia, no documento que a declara e em cada entrada de Release que a endereça.

Two subsystems declare a component under one name (Dois subsistemas declaram um componente com um mesmo nome)

Os subsistemas agrupam os componentes de um Aggregate para o leitor e para o que se propaga em cascata para eles; eles não qualificam o nome a que um componente responde. Um componente declarado sob subsystems.frontend é endereçado como api, não como frontend.api, e um fornecido por um módulo carrega o nome desse módulo em vez do nome do subsistema. Então dois subsistemas de um mesmo Aggregate podem declarar cada um um componente chamado api, e os dois passam então a responder ao mesmo identificador.

O documento está bem formado — os dois são chaves separadas em blocos separados, que é exatamente o motivo pelo qual nada o recusa antes — mas apenas um componente pode carregar um identificador. A build para em vez de manter o que foi lido por último e renderizar como se um único componente tivesse sido declarado.

O mesmo nome duas vezes dentro de um mesmo subsistema é uma falha diferente: são duas entradas sob uma mesma chave, e o documento é recusado ao ser lido.

Mensagem emitida:

components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (componentes em subsistemas diferentes assumem a mesma identidade: renomeie um deles, já que um subsistema não contribui com nada para a identidade de um componente (com o Aggregate, o caminho e o identificador indicados, declarado sob os subsistemas indicados))

Como corrigir: renomeie um dos dois componentes, no documento que o declara e em cada entrada de Release que o endereça. Onde os dois são realmente o mesmo componente desejado em dois lugares, declare-o uma única vez e faça o outro subsistema depender dele. Renomear o subsistema não ajuda: o subsistema não faz parte do nome.

A re-published component alias points back at itself (Um alias de componente republicado aponta para si mesmo)

Um módulo publica parte de si mesmo exportando componentes sob alias, e um Aggregate que o importa pode republicar um desses alias sob um nome próprio. Resolver um alias assim segue a cadeia de republicações até o componente que ele nomeia em última instância, para que uma aresta que aponta para o nome público alcance um componente real.

Uma cadeia que revisita um alias antes de alcançar um componente nunca chega ao fim. O percurso para em vez de segui-la indefinidamente, e nomeia a cadeia que percorreu para que o elo que fecha o laço fique visível.

Nada do que você pode escrever produz uma cadeia assim. A árvore de importações é acíclica, e cada elo nomeia algo aninhado mais profundamente do que o elo anterior, então uma cadeia montada a partir de importações desce e termina. Portanto, isso serve de rede de segurança para uma tabela de alias montada por algo diferente do caminho de autoria comum, e não para uma estrutura que um Aggregate possa declarar.

Mensagem emitida:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (o alias de componente reexportado forma um ciclo (com a cadeia de alias indicada))

Como corrigir: nada nos seus arquivos o produz, e não há nenhuma alteração de autoria que o elimine. Relate-o com o comando que você executou e a cadeia de alias que a mensagem nomeia, que é o detalhe que indica onde o laço se fechou.

An Aggregate reached graph building without being normalised (Um Aggregate chegou à construção do grafo sem ter sido normalizado)

Um Aggregate escrito com componentes em seu nível superior e um escrito com subsistemas nomeados assumem a mesma forma ao serem lidos: os componentes de nível superior são incorporados a um subsistema que o compilador fornece, e o nível superior é esvaziado. Essa incorporação é o que permite que tudo o que vem depois faça uma única pergunta a uma única forma.

Um Aggregate que chega à construção do grafo com ambos preenchidos não foi produzido por essa leitura. As duas formas são mutuamente exclusivas onde são escritas — um documento que declara ambas é recusado ao ser carregado — e a incorporação é o que as torna uma única forma depois, então nada que um autor possa escrever chega até aqui. Ela serve de rede de segurança para um Aggregate montado por algo diferente do caminho de carregamento comum, e deparar com uma merece ser relatado em vez de contornado.

Sua mensagem começa assim:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (o agregado chegou à topologia sem estar normalizado (componentes raiz não vazios ao lado de um subsistema padrão sintetizado))

e continua com o caminho de construção que o compilador espera, que é uma nota para quem estiver depurando a build, e não uma instrução de autoria.

Como corrigir: nada nos seus arquivos o produz, e não há nenhuma alteração de autoria que o elimine. Relate-o com o comando que você executou.

A label-transform plugin’s patch reaches outside node labels (O patch de um plugin label-transform vai além dos rótulos dos nós)

Um plugin de governança vinculado em um papel label-transform recebe uma projeção do grafo — uma entrada por nó, trazendo os rótulos desse nó e os valores que sua instância declara, com qualquer valor que seu Component declare sensível retido — e retorna patches sobre os rótulos dos nós. O host os aplica apenas aos rótulos e depois verifica se o que voltou ainda é essa visão dos rótulos: os mesmos nós, cada um trazendo apenas rótulos, cada valor de rótulo uma string.

Qualquer outra coisa é recusada e a build para. Adicionar ou remover um nó, ou alterar um campo de um nó que não sejam seus rótulos, é exatamente o aparecimento silencioso de infraestrutura que ninguém declarou — então, em vez de absorver uma alteração que o papel não cobre, a build diz qual regra de confinamento o patch violou. Os rótulos são toda a superfície do papel, e um operador que vinculou o plugin declarou isso e nada mais.

Mensagens emitidas. O patch foi recusado antes de ser aplicado:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (patch do mutador recusado: o patch indicado não é decodificado como um documento JSON Patch: o que o leitor não conseguiu fazer) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (patch do mutador recusado: o patch indicado não se aplica à superfície de rótulos dos nós: o que o mecanismo de patch recusou)

ou o resultado de aplicá-lo não era a visão que o host havia entregado:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (patch do mutador recusado: o conjunto de nós mutado mudou de tamanho (um mutador não pode adicionar nem remover nós)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (patch do mutador recusado: o conjunto de nós mutado introduziu o nó indicado (um mutador não pode adicionar nós)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (patch do mutador recusado: o nó indicado ganhou um campo fora dos rótulos (um mutador só pode mexer nos rótulos)) mutator patch rejected: node "<node>" lost its "labels" field (patch do mutador recusado: o nó indicado perdeu seu campo de rótulos) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (patch do mutador recusado: o nó indicado traz um valor de rótulo que não é string após a aplicação do patch: o que o leitor encontrou)

Como corrigir: a falha é do plugin, e não dos seus documentos. Corrija-o para que cada operação que ele retorna se dirija a uma entrada sob os labels de algum nó e defina apenas valores string — um valor de rótulo numérico ou booleano é o caso comum, já que a superfície aceita apenas strings. Remover a vinculação de plugins.governance é a forma imediata de desbloquear uma build enquanto o plugin é corrigido.

Omissão intencional: não se exige que a topologia seja acíclica

A Aggrega permite ciclos na topologia: ela não exige que o grafo de dependências seja um grafo acíclico dirigido. Arquiteturas agente a agente, padrões de callback e pares de autenticação mútua produzem todos arestas cíclicas, e o compilador as aceita. A ordenação no momento da implantação cabe ao renderizador (por meio de um syncWave por fronteira ou equivalente), e não ao grafo IR.

Ao verificar os contratos de inject

O compilador percorre cada bloco inject: — tanto self-inject (um Component injetando em si mesmo) quanto uses-inject (cabeamento de um Component para outro) — e valida o contrato de entrega em relação ao esquema provides: do Component de destino, à partição de rótulos da Feature e ao conjunto de chaves de entrega declaradas. Uma chave from: em um bloco que o próprio componente do Aggregate escreveu é verificada assim que o catálogo é resolvido, então ela falha na linha que você escreveu; uma no bloco de um componente que um módulo fornece é verificada assim que a composição que importa o módulo é construída, e falha na linha do próprio documento do módulo; uma chave from: em uma conexão que uma Feature vinculada fornece é verificada assim que cada superfície que pode traçar uma conexão tiver contribuído, que é o primeiro ponto em que uma conexão assim existe para ser verificada.

Inject from key is not in the target’s provides (A chave de inject não está entre o que o destino fornece)

Uma entrada inject: referencia uma chave from: que a fonte da qual ela lê não publica: o esquema provides: do Component de destino para o próprio bloco de um componente ou para uma conexão, e a FeatureRecipe da Feature anexada para o próprio bloco inject: de uma Feature anexada.

A verificação se aplica onde quer que a conexão tenha sido escrita. Uma conexão uses: chega à topologia construída a partir de mais de uma superfície de autoria — o próprio bloco uses: de um Component e o bloco uses: de uma Feature vinculada a ele, seja essa vinculação escrita no componente, em um subsistema, em uma fronteira da Release ou na entrada de componente de uma fronteira da Release — e a mesma chave escrita errado é recusada em cada uma delas. O diagnóstico aponta para o bloco cujo autor a escreveu: a própria entrada uses: de uma vinculação, no local em que a própria vinculação foi declarada, e não o bloco uses: do componente consumidor, que, para uma conexão fornecida, não contém nada.

Em relação a que a referência é resolvida depende de onde ela está. Um from: de self-inject no nível do Component é resolvido em relação ao próprio provides: desse mesmo Component. Um from: em uma conexão uses: é resolvido em relação ao provides: do componente para o qual essa conexão aponta — e, onde duas superfícies escrevem um mesmo socket e um mesmo alias, cada conexão é resolvida em relação ao destino que ela mesma nomeia, na mesma build que recusa o par por compartilhar um alias. Um Component que não declara nenhum provides: recusa toda referência from: dirigida a ele.

O próprio bloco inject: de uma Feature anexada. Ali, um from: é resolvido em relação às chaves que a FeatureRecipe da Feature publica em seu provides:, conforme avaliadas para o componente ao qual a Feature está anexada, e é verificado quando esse componente é renderizado. Uma chave que a FeatureRecipe não publica não colocaria nada no ambiente, no arquivo ou no argumento do componente, então o build é interrompido — a menos que a FeatureRecipe leia ela mesma as entradas da Feature anexada, em .inject, em um template que ela avalia em relação ao próprio contexto de renderização da Feature anexada — aquele que carrega .inject: seu mapeamento de valores, sua carga de trabalho, seus artefatos, suas omissões ou o with: ou o when: de uma etapa do pipeline, escritos inline ou importados. Seus locals:, provides:, source: e assertions: não carregam .inject, e seu injectMapping: é avaliado em relação ao contexto do componente, então uma leitura em qualquer um deles não conta. Essa FeatureRecipe recebe cada entrada como foi escrita e a entrega à sua maneira, então suas entradas não são recusadas, e uma chave que ela não publica não entrega nada pela entrega própria do componente e fica à disposição da FeatureRecipe. Se uma FeatureRecipe lê .inject é decidido a partir dos caminhos que seus templates nomeiam: um template que repassa todo o seu contexto (toJson .) ou que alcança as entradas por meio de uma função como index . "inject" não conta como leitura das entradas, e suas entradas que nomeiam uma chave não publicada são recusadas. Uma Feature anexada em uma fronteira cuja FeatureRecipe é renderizada uma vez para essa fronteira é verificada em relação a essa única avaliação; onde nenhuma fronteira que contém o componente produziu uma, não há nada contra o que verificar suas chaves e elas não são recusadas. Um from: que nomeia uma chave publicada entrega como antes. A constatação é posicionada na própria entrada da Feature anexada, no documento que a escreveu — .spec.components.<component>.features.<attachment> no Aggregate, por exemplo — e uma entrada cuja chave de entrega outra fonte de inject também já detém é relatada também em “An attachment delivers a key another inject source already claimed (Um anexo entrega uma chave que outra fonte de inject já reivindicou)”, já que cada uma precisa de sua própria correção.

No próprio bloco inject: de um componente, uma entrada value: traz um literal e não é resolvida em relação a nada, então um literal que por acaso se parece com uma chave provides não é recusado ali; em uma conexão, uma entrada value: é recusada, como descreve “An inject: entry on a connection carries a literal (Uma entrada de inject em uma conexão traz um literal)” mais abaixo. Apenas from: nomeia uma chave.

A própria superfície uses: por aresta da Release traz target e infra e nenhum inject:, então uma conexão cabeada ali não dita nenhuma entrega e não tem nenhuma chave from: a verificar.

Mensagem emitida, para um from: lido no próprio bloco inject: de um Component. Primeiro vem a recusa, depois a chave errada, o tipo de componente em relação ao qual ela foi resolvida e as chaves declaradas desse tipo, em ordem — as alternativas entre as quais escolher:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (chave inject inválida: a from-key deve nomear uma chave provides que sua fonte publica (com o Aggregate, o caminho, a from-key, o tipo de componente e as chaves declaradas indicados))

Para um from: lido em uma conexão uses:, a mesma recusa vem primeiro, e o mecanismo e a chave de entrega sob os quais a entrada foi escrita vêm antes da chave errada:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (chave inject inválida: a from-key deve nomear uma chave provides que sua fonte publica (com o Aggregate e a conexão indicados, o mecanismo, a chave de entrega, a from-key, o tipo de componente e a chave declarada))

Para um from: lido no próprio bloco inject: de uma Feature anexada, a chave com erro vem primeiro, depois o in: e o mecanismo da entrada, a FeatureRecipe em relação à qual ela foi resolvida e, ordenadas, todas as chaves que essa FeatureRecipe publica:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (chave inject inválida: a from-key deve nomear uma chave provides que sua fonte publica (com o Aggregate, o caminho, a from-key, o in, o mecanismo, a FeatureRecipe e as chaves publicadas indicados))

Quando o destino não declara nenhuma chave provides:, não há alternativas a listar, então a mensagem termina após o tipo de componente — ou, no bloco de uma Feature anexada, após a FeatureRecipe.

Como corrigir: altere a chave from: para que corresponda a uma das chaves declaradas listadas na mensagem, ou estenda o esquema provides: do Component de destino para declarar a chave de que você precisa. No bloco de uma Feature anexada, altere a chave from: para uma que a FeatureRecipe publica, ou — quando a FeatureRecipe for sua — publique a chave em seu provides:, ou faça com que ela mesma leia a entrada em .inject se entregar o valor à sua maneira.

Required feature not attached (Funcionalidade obrigatória não vinculada)

O Component declara um mandato de presença — uma anotação features.aggrega.ai/requiredType.<label> — que nomeia um tipo de Feature que não está presente entre as vinculações com que esta instância de componente acaba ficando, contando cada escopo: os blocos de nível de componente e de nível de subsistema do Aggregate, os blocos de nível de fronteira e de nível de componente da Release, e a expansão orientada por anotações.

Mensagem emitida:

missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (funcionalidade obrigatória ausente: vincule ao componente uma Feature do tipo exigido (o tipo exigido indicado, exigido pelo tipo de componente indicado, sob o rótulo de requisito indicado))

Os três valores são o tipo de Feature que o mandato exige — que a frase anterior já nomeia, então ele aparece sem legenda —, depois o tipo de componente que declara o mandato e o rótulo que o mandato traz, cada um com legenda para que um leitor possa distinguir duas referências a entidades. Um componente que exige dois tipos diferentes relata duas mensagens que diferem, e dois componentes que declaram o mandato a partir de tipos diferentes ficam sabendo qual tipo fez cada exigência. O achado é posicionado na própria chave do componente sob components:, e um componente escrito dentro de um subsistema é posicionado primeiro sob a chave desse subsistema.

O nome sob o qual uma vinculação é escrita não importa aqui: o mandato pergunta se há alguma vinculação do tipo nomeado presente. Associar um slot o satisfaz, e uma vinculação sob qualquer outro nome também.

Como corrigir: vincule uma Feature do tipo exigido ao componente no Aggregate ou na Release, ou em um escopo mais amplo do qual o componente herda. Se o Component não deve mais exigi-la, remova a anotação do mandato da declaração dele no catálogo.

Malformed attachment requirement (Requisito de vinculação malformado)

A declaração de um mandato de presença não pode ser avaliada. O valor de uma anotação é uma string opaca, então nada valida sua forma antes que o compilador a leia: um valor que não é um URI de tipo de Feature, ou uma chave que nomeia a família de mandatos sem um rótulo após o prefixo, é relatado como uma declaração defeituosa, e não como um requisito não satisfeito — um erro de digitação nunca deve ser lido como um requisito satisfeito.

Mensagens emitidas:

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (requisito de vinculação malformado (a chave indicada, declarada pelo tipo de componente indicado, que não pode ser avaliada porque o valor deve ser um URI de tipo de Feature na forma publicador/nome em segmentos kebab em minúsculas, como no exemplo indicado). Corrija essa anotação na entidade de catálogo do tipo de componente.)

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (requisito de vinculação malformado (a chave indicada, declarada pelo tipo de componente indicado, que não pode ser avaliada porque a chave precisa de um rótulo que nomeie o requisito, como no exemplo indicado). Corrija essa anotação na entidade de catálogo do tipo de componente.)

A mensagem começa pela chave da anotação — a declaração de que trata a interrupção — e depois nomeia o tipo de componente cuja declaração está defeituosa, de modo que nomeia a entidade a corrigir, mesmo que o achado seja posicionado na instância de componente que usa esse tipo: a instância é onde você o vê, e a entidade de catálogo é onde está a solução.

Esta interrupção é gerada assim que a composição é montada, o que acontece antes de qualquer verificação que leia o grafo finalizado. Uma build com um mandato defeituoso, portanto, relata apenas ele: as verificações que seriam executadas depois não são alcançadas, porque raciocinam sobre o que a declaração diz, e a declaração não pode ser lida. Corrija-o e refaça a build para ver o restante.

Como corrigir: corrija a entidade de catálogo do Component. A solução está no catálogo, e não no Aggregate — e é por isso que esta interrupção é distinta de “Required feature not attached (Funcionalidade obrigatória não vinculada)”, em que são os seus próprios documentos que precisam ser alterados.

Required attachment slot not bound (Slot de vinculação obrigatório sem associação)

Uma entidade de catálogo declara um slot de vinculação com required: true em seu featuresSchema, e nada associa o nome desse slot em uma instância da entidade. A verificação é executada sobre as vinculações com que a instância acaba ficando depois que todos os escopos são combinados — os blocos features: de nível de componente e de nível de subsistema do Aggregate, os blocos de nível de fronteira e de nível de componente da Release, e as vinculações produzidas pela expansão orientada por anotações —, então uma credencial vinculada uma vez em um escopo do qual a instância herda associa o slot exatamente como um preenchimento escrito na instância.

Mensagem emitida:

required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (slot de vinculação obrigatório não preenchido (o slot indicado, declarado obrigatório pelo tipo de componente indicado). Vincule uma Feature com esse nome, no Aggregate ou na Release, no componente ou em um escopo acima dele.)

Os dois valores são o próprio nome do slot e o tipo de componente que o declara, então uma instância que deixa dois slots sem associação relata duas mensagens que diferem. O achado é posicionado na chave do slot sob o bloco features: do componente no Aggregate; como essa chave é exatamente o que falta, um editor o coloca na chave existente mais próxima — o bloco features:, onde o componente escreve um, e o próprio componente, onde não escreve. Nada escreveu a vinculação ausente, então nenhum autor de documento é apontado por ela: o achado permanece no componente e é classificado como falha do desenvolvedor, e a solução nomeia ambos os documentos, porque qualquer um deles pode preencher o slot — o Aggregate no componente ou em um subsistema que o contém, a Release em sua entrada para o componente ou em uma fronteira que o contém.

Um slot que um socket declara — no featuresSchema de uma entrada de usesSchema — é exigido de cada conexão cabeada pelo socket, e não do componente: cada conexão o preenche por si mesma, em sua própria entrada no Aggregate ou na Release, e nenhum escopo acima o alcança. Assim, um socket com duas conexões, uma das quais preenche o slot, relata apenas a outra, nomeando-a:

required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (slot de vinculação obrigatório não preenchido (o slot indicado, declarado obrigatório pelo socket indicado, do tipo de componente indicado, deixado sem preenchimento pela conexão indicada). Vincule uma Feature sob esse slot nas funcionalidades desta conexão, em sua entrada no Aggregate ou na Release.)

Esse achado é posicionado na entrada da conexão no documento que traçou a conexão — a entrada uses: do Aggregate, ou a entrada por aresta da Release para uma conexão que a Release cabeou. Uma conexão que uma Feature vinculada traça é cabeada em um socket que a Feature declara, e não em um do componente, então não cabe a ela preencher os slots dos sockets do componente.

Como corrigir: vincule uma Feature sob o nome do slot, no Aggregate ou na Release — no componente, ou em um escopo mais amplo que todo consumidor do slot compartilhe; para o slot de um socket, na conexão que o achado nomeia. Uma vinculação sob um nome diferente não associa o slot: um slot é um ponto de associação nomeado, então o nome é a associação. Se o slot não deve mais ser obrigatório, atualize o featuresSchema da entidade de catálogo — o do próprio componente ou o do socket — para remover a declaração required.

Two Features declared to conflict reach one component (Duas Features declaradas em conflito alcançam um mesmo componente)

O campo interoperability.conflictsWith de uma Feature nomeia as Features ao lado das quais ela não pode ser vinculada, e um componente acaba trazendo a Feature e uma das que ela nomeia. A verificação é executada sobre as vinculações com que o componente acaba ficando depois que todos os escopos são combinados — os blocos features: de nível de componente e de nível de subsistema do Aggregate, os blocos de nível de fronteira da Release (toda fronteira dentro da qual o componente está, incluindo as aninhadas) e suas entradas de nível de componente, e as vinculações produzidas pela expansão orientada por anotações. Assim, um par causa a interrupção quando ambas estão escritas no componente, quando uma está em uma fronteira ou subsistema que o contém, ou quando uma está em uma fronteira externa e a outra em uma fronteira aninhada dentro dela. Duas Features vinculadas a fronteiras irmãs que não compartilham nenhum componente nunca se encontram, e uma fronteira que não contém nenhum componente não alcança nada, então nenhum desses casos causa a interrupção.

Uma declaração basta: a interrupção dispara quando a lista de uma ou outra Feature nomeia a outra. Os nomes são comparados sem qualquer versão, dos dois lados, de modo que uma entrada corresponde a toda versão da Feature que nomeia. O compilador compara os nomes que o autor da Feature declarou com as Features que o componente traz e não lê nada além disso em nenhum dos dois.

Mensagem emitida:

a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (uma Feature alcança um componente ao lado de uma Feature com a qual declara um conflito (a Feature indicada, vinculada na Release na fronteira indicada, entra em conflito com a outra Feature indicada, vinculada no Aggregate no componente indicado, no componente indicado). Vincule apenas uma das duas onde elas se encontram: remova uma vinculação, ou mova-a para um escopo que não contenha este componente.)

O primeiro valor é a Feature cuja lista nomeia a outra — a que a frase anterior nomeia — seguida de cada local em que ela foi vinculada; depois a Feature com a qual ela entra em conflito, e cada local em que essa foi vinculada; e por último o componente em que elas se encontram. Cada local é expresso nas palavras do documento que você abriria para alterá-lo: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (o caminho de uma fronteira aninhada une seus níveis com /), attached in the Release on the entry for component seguido de in boundary, ou attached by annotation-driven expansion of seguido da anotação, e de declared at com o local em que ela foi escrita. Uma vinculação escrita em uma conexão é expressa como a entrada dessa conexão, já que é essa entrada, e não o próprio bloco do componente, o lugar em que ela é editada: attached in the Aggregate on the connection seguido de through socket e of component, ou attached in the Release on the connection seguido de through socket, of the entry for component e in boundary. Uma Feature vinculada em dois locais lista ambos. O achado é posicionado na própria chave do componente sob components:, e um par que se encontra em vários componentes é relatado uma vez para cada um deles, na ordem em que o Aggregate declara os componentes.

Como corrigir: vincule apenas uma das duas onde elas se encontram — remova uma das vinculações, ou mova uma para um escopo que não contenha este componente, como uma fronteira irmã. Onde a vinculação veio da expansão orientada por anotações, o que deve ser alterado é a anotação, e não o bloco sobre o qual ela foi expandida. Se as duas Features puderem de fato ser combinadas, o que está errado é a declaração: remova a outra Feature da lista conflictsWith na entidade de catálogo da Feature que a declara.

Attachment does not conform to its declared slot shape (A vinculação não está em conformidade com a forma declarada de seu slot)

Uma vinculação associa um slot declarado, mas não corresponde à forma que esse slot declara. O caso comum é a entrega: a lista de permissões inject de um slot nomeia os mecanismos pelos quais um preenchimento pode entregar seu material, e uma lista de permissões vazia é blackbox — a Recipe entrega o material internamente e um preenchimento não pode ditar nenhuma entrega. Um bloco inject: {} vazio não dita nenhuma entrega, portanto está na forma correta para qualquer slot, inclusive um com lista de permissões vazia, e recebe o mesmo veredito onde quer que a vinculação seja escrita: em um componente que o Aggregate declara, em um componente que um módulo importado fornece ou em um escopo mais amplo. Uma vinculação sob um nome que nenhum slot declara é uma vinculação livre e não traz nenhuma restrição de slot.

Mensagem emitida, quando a vinculação dita uma entrega que seu slot não aceita — o slot, depois o mecanismo, depois cada mecanismo que a lista de permissões inject do slot aceita, na ordem em que o slot os declara (nenhum vem depois para uma lista de permissões vazia):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (a vinculação não está em conformidade com a forma declarada de seu slot (com o Aggregate, o caminho, o slot, o mecanismo e o mecanismo permitido indicados))

Um componente que um módulo importado fornece é verificado assim que a composição que o importa é construída, e é relatado em uma segunda forma. Ela nomeia o Aggregate do módulo e a chave, dentro do documento do módulo, que o slot não declara — um mecanismo sob o bloco inject: da vinculação, ou o próprio bloco inject:, quando ele nomeia algum mecanismo, em um slot cuja lista de permissões está vazia:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (a vinculação não está em conformidade com a forma declarada de seu slot (com o Aggregate e o caminho indicados, a vinculação não está em conformidade com a forma de slot declarada: esta chave não faz parte da declaração do slot — a solução indicada))

em que <remedy> depende da chave:

  • remove it, para um bloco inject: que nomeia um mecanismo em um slot cuja lista de permissões está vazia;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, para um mecanismo que a lista de permissões de um slot pode nomear — env, file ou arg;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, para qualquer outro mecanismo, que nenhum slot pode declarar.

Uma vinculação declarada em um escopo mais amplo — em todo o subsistema, em cascata sobre cada componente abaixo dele — é submetida à mesma forma, e é verificada em relação ao slot em cada componente que alcança. A mesma vinculação pode, portanto, estar em conformidade para um componente e fora de conformidade para outro, então esta forma nomeia o componente e o slot em relação ao qual ela falhou, e localiza a vinculação no escopo em que foi declarada, e não em uma chave dentro de seu bloco de entrega:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (a vinculação não está em conformidade com a forma declarada de seu slot (com o Aggregate e o caminho indicados, esta vinculação está declarada em um escopo que alcança o componente indicado, cujo slot de vinculação indicado não aceita a entrega que ela traz: mova a vinculação para baixo, para os componentes que podem recebê-la))

Uma vinculação que uma conexão traz nunca chega a esta interrupção. Sua forma é fechada onde é escrita: na entrada de conexão do Aggregate ela aceita type, description e values, e na da Release type, description e infra, então não pode ditar nenhuma entrega — um inject: escrito ali é recusado quando o documento é carregado, com o nome da chave — e a entrada do Workload que a entrega é submetida, em vez disso, à lista de permissões inject do slot do socket. Nenhum escopo alcança tampouco o slot de um socket, então a forma de escopo inteiro descrita acima não tem equivalente em uma conexão.

Como corrigir: as formas pedem duas alterações diferentes, e o caminho do campo diz qual delas você tem. Onde ele nomeia uma vinculação em um componente, ou uma chave dentro dela, a falha está na entrega: remova-a, ou mova suas entradas para sob um mecanismo que a lista de permissões inject do slot nomeia. Onde o material realmente deve chegar à carga de trabalho por um mecanismo que o slot não lista, a lista de permissões no featuresSchema da entidade de catálogo pode ser ampliada — mas apenas com env, file ou arg, os mecanismos que um slot pode declarar; um Component que nomeie ali qualquer outro mecanismo falha na validação quando é carregado, então, para qualquer outro mecanismo, removê-lo é a única correção. Onde ele nomeia uma vinculação em um escopo, a vinculação está bem formada e a falha está em seu posicionamento: mova-a para baixo, para os componentes cujo slot aceita a entrega, deixando fora de seu alcance os componentes que reservam a entrega à sua Recipe.

Duplicate delivery key across inject sources (Chave de entrega duplicada entre as fontes de inject)

A mesma chave de entrega (por exemplo, o mesmo nome de variável de ambiente) é reivindicada duas vezes entre as fontes de inject escritas pelo desenvolvedor para um componente — no nível do Component e sob uma entrada uses[], por duas entradas uses[] no mesmo componente, ou sob dois mecanismos de entrega do próprio bloco inject: do Component. A entrega não pode vir de dois lugares ao mesmo tempo, então uma chave reivindicada duas vezes é uma contradição, e não uma questão de qual delas vence.

A build lê isso em quatro lugares, porque eles veem conjuntos diferentes de fontes escritas e de conexões de dependência e lhes fazem perguntas diferentes, e cada um relata em sua própria forma.

O primeiro lê as conexões que você escreveu no Aggregate, e relata enquanto seus arquivos são resolvidos. Ele nomeia o mecanismo de entrega, a chave e, depois, o socket e o alias da primeira conexão, na ordem de escrita, que também a reivindica:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (chave de entrega duplicada entre as fontes de inject (com o Aggregate, o caminho, o mecanismo, a chave, o socket e o alias indicados))

O segundo lê esse mesmo bloco escrito e lhe faz uma pergunta diferente: se o componente reivindica uma chave sob dois de seus próprios mecanismos de entrega, sem nenhuma conexão envolvida. Ele relata uma vez por mecanismo que reivindica a chave, posicionado na própria entrada desse mecanismo, e nomeia o mecanismo de que trata o achado, a chave e, depois, cada outro mecanismo que a reivindica, na ordem de escrita:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (chave de entrega duplicada entre as fontes de inject (com o Aggregate, o caminho, o mecanismo, a chave e o outro mecanismo indicados))

Nenhum dos dois mecanismos é o infrator, e cabe a você agir sobre ambos os achados: renomeie a chave sob um deles, ou descarte uma das duas entregas. Quais mecanismos um componente pode usar é uma questão separada, respondida pela lista de permissões spec.inject dele — veja “Self-inject mechanism not in the component’s allowlist (Mecanismo de self-inject fora da lista de permissões do componente)” mais abaixo.

Um componente que um módulo fornece também encontra essas duas primeiras formas, lidas do próprio documento do módulo assim que a composição que o importa é construída; elas então nomeiam o Aggregate do módulo e a chave dentro do documento dele.

O terceiro lê as conexões que a topologia finalizada traz, incluindo as que uma vinculação de Feature forneceu em seu nome. Ele é executado antes que qualquer coisa seja renderizada, e nomeia a chave de entrega que você escreveu junto com o socket de dependência que também a entrega:

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (chave de entrega duplicada entre self-inject e uses-inject (a chave indicada, o socket indicado))

Uma chave escrita entregue por dois sockets de dependência é relatada uma vez por socket, de modo que uma única build informa você sobre todos eles, e não apenas sobre o que foi alcançado primeiro.

O quarto lê a mesma topologia finalizada e lhe faz uma pergunta diferente: se duas das próprias conexões de dependência de um componente entregam uma mesma chave entre si, sem que o próprio componente reivindique nada. Ele relata uma vez em cada conexão, posicionado na própria entrada de entrega dessa conexão, e nomeia o caminho da entrada seguido de cada socket que entrega a chave:

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (chave de entrega duplicada entre as fontes de inject (com o caminho da entrada e os sockets indicados))

Um socket nomeado duas vezes é o que indica que as duas conexões estão em um mesmo socket sob aliases diferentes — ali a posição é a única coisa que as separa, então leia o caminho do campo de cada um dos dois achados, e não os nomes dos sockets.

Nenhuma das duas conexões é a infratora, e cabe a você agir sobre ambas: renomeie uma das chaves, ou descarte uma das duas entregas.

Onde a chave é um caminho, o caminho do campo nomeia, em vez disso, o bloco do mecanismo. O que uma chave de entrega expressa é assunto do próprio mecanismo, e um mecanismo file entrega em um caminho de montagem — então uma chave assim contém pontos, enquanto um caminho do campo separa suas próprias etapas com eles. Um caminho do campo para na última etapa que consegue nomear sem ambiguidade, em vez de escrever uma que seria lida como um percurso por chaves que seu documento não contém, então, para uma chave como /etc/app/config.yaml, ele é lido como .spec.components.<component>.inject.<mechanism> e para ali. A mensagem nomeia a chave em qualquer caso, e é isso que mantém o achado igualmente acionável — mas onde lê-la na mensagem difere entre as quatro formas acima, então leia o caminho do campo para o bloco e depois tire a chave daquela das quatro que você tiver: onde o detalhe começa pelo mecanismo de entrega, a chave é o valor entre aspas logo depois dele; onde o detalhe começa pela chave sozinha, ela é o primeiro valor entre aspas; e onde o detalhe começa pelo próprio caminho da entrada de entrega, a chave é a última etapa desse caminho.

Como corrigir: renomeie uma das chaves em conflito, ou descarte a declaração duplicada. Observe que o injectMapping de uma FeatureRecipe que reescreve uma chave entregue pelo próprio bloco inject: do componente ou por um dos blocos inject: de suas conexões é uma interceptação intencional e não é sinalizado aqui nem em nenhum outro lugar.

Uma chave reivindicada por uma Feature vinculada ao componente encontra o mesmo espaço compartilhado a partir da terceira de suas três superfícies de autoria, e é relatada sob “An attachment delivers a key another inject source already claimed (Uma vinculação entrega uma chave que outra fonte de inject já reivindicou)” mais abaixo; uma chave que duas Features vinculadas entregam, em que a posterior das duas a entrega por meio do injectMapping de sua FeatureRecipe, é relatada sob “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Duas Features vinculadas entregam uma mesma chave, a posterior por meio do injectMapping de sua FeatureRecipe)”.

Self-inject on a component without an allowlist (Self-inject em um componente sem lista de permissões)

O desenvolvedor escreveu um bloco inject: no nível do componente, mas a entidade de catálogo do Component não declara spec.inject. Components sem uma lista de permissões spec.inject são tipos Black-Box — eles não recebem nenhuma injeção escrita pelo desenvolvedor.

Mensagem emitida:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject em um componente sem lista de permissões spec.inject (com o Aggregate, o caminho, a chave inject e o tipo de componente indicados))

O achado é posicionado no próprio bloco inject:, que é o elemento a remover.

Como corrigir: remova o bloco inject: desta instância de Component, ou mude para um tipo de Component White-Box cuja declaração de catálogo inclua spec.inject.

Self-inject mechanism not in the component’s allowlist (Mecanismo de self-inject fora da lista de permissões do componente)

O desenvolvedor escreveu um bloco inject: no nível do componente usando um mecanismo (por exemplo, env ou uma forma específica de montagem de arquivo) que não está listado na lista de permissões spec.inject do Component.

Mensagem emitida:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (self-inject em um componente sem lista de permissões spec.inject (com o Aggregate, o caminho, o tipo de componente, o mecanismo e os mecanismos permitidos indicados))

Os mecanismos que o tipo de fato permite vêm depois do que foi ditado, de modo que a mensagem traz tanto o que foi escrito quanto o que o tipo permite. Um tipo que não declara nenhuma lista de permissões relata o mecanismo ditado sem nada depois dele.

Tanto esta regra quanto a anterior valem para um componente que um módulo fornece, assim que a composição que importa o módulo é construída; o achado então nomeia o Aggregate do módulo e a chave dentro do documento dele.

Como corrigir: mude para um mecanismo da lista de permissões, ou, se o Component deve suportar o mecanismo de que você precisa, estenda a lista de permissões spec.inject dele no catálogo.

uses edge dictates delivery on a socket that allowlists none (Uma aresta dita a entrega em um socket que não permite nenhum mecanismo)

Um bloco inject: em uma aresta uses: é cabeado em um socket cuja entrada de usesSchema não declara nenhuma lista de permissões inject:, ou declara uma vazia. Um socket assim é uma conexão Black-Box: a entidade que o declarou trata internamente os valores da dependência, então o consumidor recebe o que quer que a Recipe do produtor emita e não escolhe a forma de entrega. Uma chave inject: ausente e inject: [] são a mesma declaração.

O socket é lido na entidade que o declarou, seja ela qual for: uma aresta escrita em uma vinculação de Feature é resolvida em relação ao usesSchema da Feature vinculada, e toda outra aresta em relação ao do Component consumidor.

Mensagem emitida. Primeiro vem a recusa, depois os mecanismos que a aresta ditou, o socket e a entidade cuja declaração foi lida — e depois o que fazer a respeito:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (o inject da aresta uses dita um mecanismo de entrega que o socket não permite (o mecanismo indicado, no socket indicado, declarado no tipo de componente indicado). O socket não declara nenhuma lista de permissões de entrega, então não permite ditar nada — a entidade que o declarou entrega ela mesma os valores da dependência. Remova o bloco inject desta conexão e leia os valores dos provides da conexão na Recipe consumidora, ou declare os mecanismos que o socket permite em sua entrada de usesSchema.)

O achado é posicionado na entrada escrita a que se refere, no documento em que essa entrada foi escrita: .spec.components.<consumer>.uses.<socket>.<alias> para uma aresta que o próprio bloco uses: de um componente traçou, e .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> para uma que uma vinculação traçou — com raiz no bloco que declarou a vinculação, que pode ser o de um subsistema ou o de uma fronteira, e não o do próprio componente. Onde o socket foi declarado na Feature vinculada, a mensagem nomeia o tipo de funcionalidade no lugar do tipo de componente. Cada aresta com erro é relatada como um achado próprio, então uma única build nomeia todas elas.

Como corrigir: remova o bloco inject: da aresta e leia, em vez disso, os valores da dependência a partir de .context.uses.<alias>.provides.<name> na Recipe consumidora; ou, se a conexão deve ser transparente, declare os mecanismos de entrega que o socket permite na lista de permissões inject: de sua entrada de usesSchema.

Um socket que a entidade declarante nunca declarou é um caso diferente e não é recusado aqui: um socket ad hoc não traz nenhuma lista de permissões, então não há nada fora do qual a aresta possa estar.

uses edge dictates a delivery mechanism outside the socket’s allowlist (Uma aresta dita um mecanismo de entrega fora da lista de permissões do socket)

Um bloco inject: em uma aresta uses: nomeia um mecanismo de entrega que a lista de permissões inject: do socket não inclui. A lista de permissões é a declaração da entidade declarante sobre as formas de entrega a partir das quais seu ponto de entrada consegue de fato ler os valores da dependência, então um mecanismo fora dela entregaria valores que nada consome.

Todo mecanismo que o bloco nomeia é verificado, e cada um fora da lista de permissões é relatado, então uma única build nomeia todos eles em vez de um por execução.

Mensagem emitida. Primeiro vem a recusa, depois o mecanismo recusado, o socket, o que esse socket permite e a entidade cuja declaração foi lida:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (o inject da aresta uses dita um mecanismo de entrega que o socket não permite (o mecanismo indicado, no socket indicado, que permite os mecanismos indicados, declarado no tipo de componente indicado). Dite um dos mecanismos que o socket permite, ou amplie a lista de permissões de inject desse socket na entrada de usesSchema da entidade declarante.)

O achado é posicionado na entrada escrita a que se refere, nos mesmos caminhos que a recusa acima nomeia. Onde o socket foi declarado na Feature vinculada, a mensagem nomeia o tipo de funcionalidade no lugar do tipo de componente.

Como corrigir: passe a usar um dos mecanismos permitidos, ou, se a entidade deve suportar o mecanismo de que você precisa, amplie a lista de permissões inject: desse socket em sua entrada usesSchema do catálogo.

An inject: entry carries both a literal and a source key (Uma entrada de inject traz ao mesmo tempo um literal e uma chave de origem)

Uma entrada inject: entrega uma de duas coisas: um literal, escrito sob value: — no próprio bloco de um componente, o único lugar em que um literal é entregue — ou uma chave lida do componente para o qual a conexão aponta, escrita sob from:. Uma entrada que traz as duas diz duas coisas ao mesmo tempo e não oferece nenhuma regra para escolher entre elas, então é recusada em vez de deixar que uma das duas prevaleça silenciosamente.

Os esquemas de autoria admitem exatamente uma das duas, então um documento lido de um arquivo é recusado ao ser carregado. Esta é a verificação que está por trás daquela: ela lê cada bloco inject: que o Aggregate e a Release trazem enquanto os dois documentos são resolvidos, então um documento construído por algum caminho que não seja um arquivo ainda é recusado antes que qualquer coisa seja construída a partir dele, em vez de ter um campo escolhido silenciosamente. Ela cobre os mesmos blocos que a verificação de forma mais abaixo.

Cada mecanismo de entrega que contém uma entrada com erro é relatado como um achado próprio, posicionado nesse mecanismo no documento que o escreveu — .spec.components.<component>.inject.env para o próprio bloco de um componente — e todos os da build são relatados de uma vez. O achado nomeia o mecanismo e depois o campo in: de cada entrada com erro na lista desse mecanismo.

Mensagem emitida:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (a entrada de inject traz os dois campos; o esquema exige exatamente um (com o mecanismo e as entradas indicados))

Como corrigir: abra cada entrada que a mensagem nomeia e apague aquele dos dois de que ela não precisa. Mantenha from: onde o valor deve vir do componente para o qual a conexão aponta — ele nomeia uma chave que o provides: desse componente declara. Mantenha value: onde o valor é um literal que este lado fornece, no próprio bloco de um componente; em uma conexão e no próprio bloco de uma Feature anexada um literal é recusado, então mantenha from: ali.

An inject: entry on a connection carries a literal (Uma entrada de inject em uma conexão traz um literal)

Uma conexão entrega ao componente consumidor o que o componente para o qual ela aponta publica: cada entrada no bloco inject: da conexão nomeia sob from: uma das chaves provides: desse componente. Um literal escrito sob value: não nomeia nada que o destino publique, então não tem lugar em uma conexão, e a entrada é recusada em vez de descartada. Um literal que um componente entrega a si mesmo pertence ao próprio bloco inject: do componente, onde value: é admitido.

Toda conexão é verificada, qualquer que seja o documento que a traçou: uma no próprio bloco uses: de um componente, uma que uma Feature vinculada traça no Aggregate e uma que uma vinculação escrita na Release traça. Ela é recusada antes que qualquer coisa seja renderizada, então aggrega validate --release a relata tanto quanto aggrega build.

Cada entrada com erro é relatada como um achado próprio, posicionado na entrada da conexão no documento que a traçou — .spec.components.<component>.uses.<socket>.<alias> para a própria conexão de um componente, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> para uma que uma vinculação traça e, na Release, o mesmo caminho sob a entrada da vinculação, como .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias> — e todas as da build são relatadas de uma vez. Um achado no Aggregate é classificado sob DEVELOPER_ERROR, um na Release sob OPS_ERROR. O achado nomeia o mecanismo e o campo in: da entrada.

Mensagem emitida:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (a entrada de inject em uma conexão traz um literal; uma conexão entrega as chaves publicadas do destino, cada uma nomeada como origem (com o mecanismo e a entrada indicados))

Como corrigir: onde o valor for um que o destino publica, substitua value: por from: nomeando essa chave provides:. Onde for um literal de que o componente consumidor precisa, mova a entrada para o próprio bloco inject: desse componente, cujos mecanismos a lista de permissões spec.inject do seu tipo de Component rege.

An inject: entry on an attached Feature carries a literal (Uma entrada de injeção em uma Feature anexada carrega um literal)

O bloco inject: escrito em uma Feature anexada entrega ao componente o que a FeatureRecipe desse anexo publica: cada entrada nomeia uma das chaves que o provides: da FeatureRecipe publica, sob from:. Um literal escrito sob value: não nomeia nada que o anexo publique, então nada chegaria ao componente sob o in: dessa entrada; a entrada é recusada em vez de construída e descartada. Um literal de que o componente precisa pertence ao próprio bloco inject: do componente, onde value: é admitido e entregue.

Todo anexo em que um Aggregate escreve um bloco inject: é verificado: um no próprio bloco features: de um componente e um no bloco features: de um subsistema, que alcança cada componente que o subsistema contém — no Aggregate que a Release nomeia e em cada módulo que esse Aggregate importa sob aggregates:, em qualquer profundidade. Uma conexão que um anexo traça carrega seu próprio bloco inject:, e um literal ali cai na recusa de conexão descrita acima. Um anexo da Release não escreve nenhum bloco inject: próprio. A entrada é recusada antes que qualquer coisa seja renderizada, então aggrega validate --release a relata assim como aggrega build.

Cada entrada com problema é relatada como sua própria constatação, registrada como DEVELOPER_ERROR contra o Aggregate cujo documento escreveu o bloco — o próprio documento de um módulo, para um anexo escrito em um módulo — e posicionada no mecanismo de entrega dentro do bloco do anexo nesse documento: .spec.components.<component>.features.<attachment>.inject.<mechanism>, ou .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> para o anexo de um subsistema. Todas as de um documento são relatadas de uma vez; as de um módulo importado são relatadas assim que o Aggregate importador passa na verificação. A constatação nomeia o mecanismo e o in: da entrada. Uma entrada que carrega tanto value: quanto from: é relatada uma única vez, em “An inject: entry carries both a literal and a source key (Uma entrada de injeção carrega tanto um literal quanto uma chave de origem)” acima.

Mensagem emitida:

inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>") (uma entrada inject em um anexo carrega um literal; um anexo entrega as chaves que sua FeatureRecipe publica, cada uma nomeada como chave de origem, e um literal pertence ao próprio bloco inject do componente)

Como corrigir: onde o valor for um que a FeatureRecipe do anexo publica, substitua value: por from: nomeando essa chave provides:. Onde for um literal de que o componente precisa, mova a entrada para o próprio bloco inject: do componente, cujos mecanismos são regidos pela allowlist spec.inject do seu tipo de Component:

components:
api:
type: core/api
inject:
env:
- in: LITERAL_NAME
value: a-literal # the literal, delivered by the component's own block
features:
token:
type: core/token
inject:
env:
- in: TOKEN_NAME
from: name # a key the attachment's FeatureRecipe publishes

An inject: delivery is not a list of entries (Uma entrega de inject não é uma lista de entradas)

Cada mecanismo de entrega em um bloco inject: — env, file, arg ou um mecanismo nomeado ao lado deles — é uma lista de entradas, cada uma trazendo in: e exatamente um entre from: e value:. Um mecanismo que contém qualquer outra coisa, como um mapeamento de nomes para chaves, não entrega nada que o compilador consiga ler, então é recusado em vez de descartado. Um mecanismo escrito sem nenhum valor não entrega nada e não é recusado.

Os esquemas de autoria admitem apenas a lista, então um documento lido de um arquivo é recusado ao ser carregado, como um documento que não corresponde ao esquema do seu tipo. Esta é a verificação que está por trás daquela: ela lê cada bloco inject: que o Aggregate e a Release trazem enquanto os dois documentos são resolvidos, então um documento construído por algum caminho que não seja um arquivo ainda é recusado antes que qualquer coisa seja construída a partir dele, em vez de a entrega desaparecer. Ela cobre todo bloco que qualquer um dos documentos traz: no Aggregate, o próprio de um componente, o de uma vinculação e os das conexões que qualquer um dos dois traça; na Release, os das conexões que suas vinculações traçam.

Cada mecanismo com erro é relatado como um achado próprio, posicionado nesse mecanismo no documento que o escreveu e nomeando o mecanismo, e todos os da build são relatados de uma vez. Os achados do Aggregate são relatados antes dos da Release.

Mensagem emitida:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (entrega de inject: a forma deve ser uma lista de entradas, cada uma com um destino e exatamente uma origem ou um literal (com o mecanismo indicado))

A posição é o caminho de chaves que o autor escreveu. No Aggregate, .spec.components.<component>.inject.<mechanism> para o próprio bloco de um componente, .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> para um bloco em uma de suas conexões e .spec.components.<component>.features.<attachment>… para o de uma vinculação, com .subsystems.<name> para cada subsistema em que um componente ou uma vinculação é declarado. Na Release, o bloco em uma conexão que uma vinculação traça, através dessa vinculação — .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> para uma vinculada a toda a fronteira, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… para uma em um componente, com .boundaries.<name> para cada fronteira aninhada e .aggregates.<module> para cada entrada de roteamento através da qual um componente é nomeado.

Como corrigir: escreva como lista cada mecanismo que a mensagem nomeia. Uma entrada DB_URL: host sob env: se torna - in: DB_URL com from: host quando host nomeia uma chave provides: — a do componente conectado em uma conexão, a do próprio componente em seu próprio bloco — ou, no próprio bloco do componente, com value: host quando é um literal que este lado fornece.

The Feature filling an attachment slot does not satisfy the slot’s selector (A Feature que preenche um slot de vinculação não satisfaz o seletor do slot)

Um Component declara pontos de associação nomeados para as Features que espera, e um slot pode declarar um selector: que restringe os rótulos do que quer que o preencha. Uma vinculação associa um slot trazendo o nome do slot; quando isso acontece, os rótulos da Feature que ela nomeia são comparados com essa restrição, e um preenchimento que não a satisfaz interrompe a build. Um slot que não declara nenhuma restrição aceita qualquer preenchimento.

Se um slot pode ficar sem associação é uma questão diferente, com uma solução diferente, relatada pela sua própria interrupção acima: esta pressupõe um preenchimento e pergunta se o preenchimento é admissível, então um slot sem associação não é assunto dela.

Dois resultados são relatados sob esta única condição, e a mensagem os distingue pelo que diz o seu último valor. Um preenchimento que não satisfez a restrição nomeia a Feature cujos rótulos não corresponderam. Uma restrição que não pôde ser lida de forma alguma nomeia, em vez disso, o motivo — uma expressão que o comparador de rótulos não conseguiu avaliar —, o que é uma falha na própria declaração do slot, e não no que foi vinculado a ele.

Mensagem emitida, quando os rótulos do preenchimento não satisfizeram a restrição:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (seletor do slot de vinculação não satisfeito (o seletor indicado, declarado no slot indicado, não satisfeito pelos rótulos da Feature que o preenche, o tipo de Feature indicado). Adicione aos rótulos da Feature os rótulos que o seletor do slot exige, ou preencha o slot com uma Feature que já os traga.)

e quando a própria restrição não pôde ser avaliada:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (seletor do slot de vinculação não satisfeito (o seletor indicado, declarado no slot indicado, que não pôde ser avaliado: com o motivo indicado). Corrija o seletor na declaração do slot na entidade de catálogo do componente.)

Ele é posicionado na chave do preenchimento no documento que escreveu o preenchimento, e classificado sob o autor desse documento: o bloco features: do componente no Aggregate é uma falha do desenvolvedor, e um preenchimento que apenas a Release faz — em sua entrada para o componente, ou em uma fronteira que o contém — é uma falha do operador, relatada no próprio caminho da Release:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

O mesmo preenchimento escrito no componente no Aggregate relata [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity.

Um slot que um socket declara — no featuresSchema de uma entrada de usesSchema — submete da mesma forma o preenchimento de cada conexão ao seu selector:. A vinculação que uma conexão traz no slot é comparada com a restrição, e um preenchimento que ela não admite interrompe a build, nomeando o socket e a conexão além do slot:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (seletor do slot de vinculação não satisfeito (o seletor indicado, declarado no slot indicado, do socket indicado, preenchido na conexão indicada, não satisfeito pelos rótulos da Feature que o preenche, o tipo de Feature indicado). Adicione aos rótulos da Feature os rótulos que o seletor do slot exige, ou preencha o slot com uma Feature que já os traga.)

Ele é posicionado na chave da vinculação sob o features: dessa conexão, no documento que escreveu o preenchimento: a entrada da conexão do Aggregate, ou a entrada por aresta da Release para um preenchimento que apenas a Release faz.

Um seletor de slot que a gramática não consegue ler também é recusado antes que qualquer coisa preencha o slot. aggrega validate, sobre todo o catálogo ou sobre um único Component ou Feature, lê todos os seletores de slot que o próprio documento da entidade declara — os slots do próprio Component, os slots que seus sockets declaram e os slots de uma Feature — e recusa, sob esta mesma condição, aquele que a gramática não consegue ler, quer algo preencha o slot, quer não. A mensagem é a forma “não pôde ser avaliado” mostrada acima; um slot que um socket declara acrescenta o socket:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (seletor de slot de vinculação não satisfeito, declarado em um slot de um socket, que não pôde ser avaliado. Corrija o seletor na declaração do slot no featuresSchema do socket, na entidade de catálogo do componente.)

Em um slot de uma Feature, a correção nomeia, em vez disso, a entidade de catálogo da Feature. Nada preencheu o slot, então a falha é da entidade de catálogo: ela é registrada como CATALOG_ERROR e nomeia o arquivo da entidade.

Como corrigir: para um preenchimento que não satisfez a restrição, vincule uma Feature cujos rótulos a satisfaçam — o seletor na mensagem diz quais rótulos estão sendo pedidos — ou amplie o selector: do slot no Component que o declara. Onde a mensagem diz que a restrição não pôde ser avaliada, a falha está na expressão do seletor: corrija-a na declaração do slot do Component, ou na do socket.

An attachment written under another name fits a slot its component leaves empty (Uma vinculação escrita sob outro nome se encaixa em um slot que seu componente deixa vazio)

A superfície de vinculação própria de um Component é aberta: uma vinculação sob um nome que nenhum slot declara é uma vinculação livre, e é legal. Uma única forma nessa superfície causa uma interrupção, porque é a forma que um preenchimento destinado a um slot assume quando é escrito sob o nome errado. A build é interrompida quando todas estas condições valem para uma mesma vinculação:

  • ela está escrita no próprio componente — no próprio bloco features: do componente no Aggregate, ou na entrada da Release para esse único componente;
  • seu nome não é um slot que o tipo do componente declara;
  • os rótulos da sua Feature satisfazem o selector: de um slot que o tipo declara;
  • nada associa esse slot no componente depois que todos os escopos são combinados.

Deixada assim, essa vinculação é uma vinculação livre enquanto o slot ao qual se destinava fica vazio — e um slot opcional deixado vazio gera uma build verde e não entrega nada. A regra vale para toda Feature, não apenas para credenciais.

Todo o resto na superfície continua livre. Uma vinculação cuja Feature não se encaixa em nenhum slot declarado não interrompe a build; o mesmo vale para uma vinculação extra ao lado de um slot que algo já associa, desde que nenhum outro slot em que ela se encaixe fique vazio. Uma vinculação que o componente herda de um subsistema ou de uma fronteira de Release nunca é julgada, então a forma compartilhada — uma credencial vinculada uma única vez em um escopo em que estão vários componentes, sem que nenhum componente preencha o slot — não interrompe a build. Um slot que não declara nenhum selector: não diz nada sobre a qual Feature se destina, então nenhuma vinculação é submetida a ele dessa forma. Uma vinculação que uma conexão traz também não é julgada aqui: os slots de um socket são um conjunto fechado, e qualquer outro nome em uma conexão causa uma interrupção sob “A connection carries an attachment under a name its socket declares no slot for (Uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot)”.

Mensagem emitida. Primeiro vem a frase da condição, depois o nome sob o qual a vinculação foi escrita, o componente, a Feature que ela vincula e o slot vazio em que ela se encaixa — depois o que fazer a respeito:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (uma vinculação escrita sob um nome que nenhum slot declara se encaixa em um slot que seu componente deixa vazio (a vinculação indicada, no componente indicado, vinculando a Feature indicada, que se encaixa no slot vazio indicado). Vincule-a com o nome do slot indicado para preencher o slot.)

Onde a Feature se encaixa em mais de um slot vazio, a mensagem nomeia cada um, na ordem em que o tipo do componente os declara, e deixa a escolha para você:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (uma vinculação escrita sob um nome que nenhum slot declara se encaixa em um slot que seu componente deixa vazio (a vinculação indicada, no componente indicado, vinculando a Feature indicada, que se encaixa no slot vazio indicado e no outro slot vazio indicado). Vincule-a sob o nome do slot que ela deve preencher.)

Ele é posicionado na chave da vinculação no documento que a escreveu, e classificado sob o autor desse documento. Uma vinculação no próprio bloco features: do componente no Aggregate é relatada em .spec.components.<component>.features.<attachment> como uma falha do desenvolvedor; uma que apenas a Release escreveu, em sua entrada para o componente, é relatada ali — sob a fronteira que nomeia o componente, .spec.boundaries.<boundary>.components.<component>.features.<attachment> — como uma falha do operador:

[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.

O próprio slot vazio é um achado separado onde é obrigatório, relatado no componente no Aggregate sob “Required attachment slot not bound (Slot de vinculação obrigatório sem associação)”.

Como isso difere do aviso de quase correspondência. O aviso descrito em “An attachment name is one edit from a declared slot (Um nome de vinculação está a uma edição de distância de um slot declarado)” trata de como um nome é escrito: um nome a uma edição de distância de um slot cujo selector: a Feature da vinculação não satisfaz, o que não interrompe a build e relata uma advertência. Esta interrupção trata daquilo em que a Feature se encaixa, qualquer que seja o nome: o nome pode ser qualquer um, e o slot em que ela se encaixa precisa ter sido deixado vazio. Onde um nome está a uma edição de distância de um slot e sua Feature de fato se encaixa nesse slot, nenhum aviso é gerado, e se o slot for deixado vazio esta interrupção é o único achado relatado.

Como corrigir: vincule-a sob o nome do slot, para que ela preencha o slot — a mensagem nomeia o slot, ou cada candidato quando há vários. Se ela realmente for uma vinculação separada, preencha também o slot, já que uma vinculação extra é livre assim que cada slot em que ela se encaixa está associado; ou, onde ela deve alcançar vários componentes, vincule-a no subsistema ou na fronteira de Release em que eles estão. Se a Feature nunca deve preencher esse slot, restrinja o selector: do slot no Component que o declara.

An attachment delivers a key another inject source already claimed (Uma vinculação entrega uma chave que outra fonte de inject já reivindicou)

Três superfícies de autoria entregam no canal de injeção de um componente por meio de um bloco inject:: o próprio bloco inject: do componente, os blocos inject: nas entradas do seu bloco de dependências e o bloco em cada Feature vinculada a ele. Elas compartilham um único espaço de chaves por mecanismo de entrega, então uma chave que duas delas reivindicam é ambígua quanto a qual valor chega, e a build é interrompida em vez de deixar que uma superfície desloque silenciosamente outra. Uma Feature vinculada também pode entregar de uma segunda forma, por meio do injectMapping da sua FeatureRecipe; essa via encontra o mesmo espaço depois que todos os blocos entregaram, e é relatada mais abaixo sob “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Duas Features vinculadas entregam uma mesma chave, a posterior por meio do injectMapping de sua FeatureRecipe)”.

Esta condição é o lado desse espaço que cabe ao bloco da vinculação. Ela é relatada quando o próprio bloco inject: de uma vinculação reivindica uma chave que alguma entrega anterior já detém — a entrada mais acima, “Duplicate delivery key across inject sources (Chave de entrega duplicada entre as fontes de inject)”, é a mesma regra lida a partir do lado escrito pelo desenvolvedor, e juntas elas cobrem a reivindicação de todo bloco.

A ordem é o que decide quem colidiu. A primeira reivindicação sob uma chave é a que a detém, e as reivindicações posteriores são as relatadas — então uma vinculação cuja chave já está ocupada é informada disso, enquanto uma vinculação que reivindicou primeiro não é informada sobre uma posterior que não deslocou nada. Uma reivindicação que não entregou nada deixa a chave livre e não participa de nada disso.

O achado é posicionado na própria entrada da vinculação dentro do bloco do componente, que é a posição a editar; a mensagem nomeia a chave e o mecanismo em cujo espaço de chaves ela está. Cada chave em colisão é relatada separadamente, então uma vinculação que duplica duas chaves informa você sobre ambas.

Mensagem emitida:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (chave de entrega duplicada entre o inject da vinculação e outra fonte de inject (a chave indicada, o mecanismo indicado))

Como corrigir: nenhum dos lados é o infrator, e cabe a você agir sobre ambos. Renomeie a chave no lado que você controla — na maioria das vezes a própria entrada inject: do componente, já que o mapeamento da Feature está escrito em um documento de catálogo — ou descarte uma das duas entregas. Onde a vinculação realmente deve fornecer o valor, remova a reivindicação escrita pelo desenvolvedor, e não a da vinculação. Observe que o injectMapping da FeatureRecipe de uma Feature que escreve uma chave é uma via diferente e não é relatado aqui: reescrever uma chave que o próprio bloco inject: do componente ou uma de suas conexões entregou é interceptação e não é relatado de forma alguma, e escrever uma chave que outra Feature vinculada entregou é relatado sob a entrada seguinte.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Duas Features vinculadas entregam uma mesma chave, a posterior por meio do injectMapping de sua FeatureRecipe)

Uma Feature vinculada entrega no canal de injeção do seu componente por duas vias: o bloco inject: escrito na vinculação e o injectMapping da sua FeatureRecipe, cuja saída nomeia a chave de entrega — muitas vezes a partir de um valor que a vinculação traz, como a variável de ambiente escolhida para uma credencial. Quando duas Features vinculadas chegam a uma mesma chave sob um mesmo mecanismo de entrega, e a posterior das duas chega lá por meio do seu mapeamento, a build é interrompida. Se ela continuasse, o componente leria o valor que por acaso fosse escrito por último, então uma credencial poderia ser apresentada no lugar de outra sem que nada na saída o indicasse.

Ela cobre toda Feature vinculada, onde quer que tenha sido vinculada: o próprio bloco features: do componente, um subsistema, uma fronteira de Release ou uma entrada de componente da Release, a expansão de uma anotação e a entrada features: de uma conexão. A anterior das duas entregas pode ser o mapeamento da outra Feature ou o próprio bloco inject: dela — a build relata ambos os emparelhamentos sob esta única condição.

A ordem é o que decide quem colidiu. Todo bloco inject: entrega antes que qualquer mapeamento seja renderizado, e os mapeamentos são renderizados em uma única ordem fixa — a ordem em que o mapeamento de inject percorre as Features vinculadas de um componente, descrita no pipeline de compilação — então a primeira entrega sob uma chave é a que a detém, e a Feature posterior é a relatada. Só a presença decide: os valores não são comparados, então duas Features que entregam o mesmo valor sob uma mesma chave ainda são relatadas. Uma chave que a saída de um mapeamento não traz de forma alguma não é uma entrega; uma chave que ela traz com um valor vazio é, porque o valor vazio substitui o que estava ali. Uma mesma chave sob dois mecanismos de entrega diferentes são duas chaves, não uma colisão.

O que não é relatado. O injectMapping de uma FeatureRecipe que reescreve uma chave que o próprio bloco inject: do componente ou um dos blocos inject: de suas conexões entregou é interceptação — uma Feature de roteamento qualificando um host, uma proteção redirecionando um upstream — e o valor do mapeamento substitui essa única entrada. O mapeamento de uma Feature que reescreve uma chave que o seu próprio bloco inject: entregou é essa Feature transformando a sua própria entrega, e também não é relatado.

O achado é posicionado na própria entrada da Feature posterior — dentro do bloco features: do componente ou, para uma Feature que uma conexão traz, na sua entrada sob essa conexão no documento que a escreveu, como .spec.components.<component>.uses.<socket>.<alias>.features.<slot> no Aggregate. A mensagem nomeia a chave, o mecanismo de entrega e ambas as Features pelos nomes que elas trazem no componente; uma Feature que uma conexão traz é nomeada pelo alias da conexão e pelo slot que ela preenche, unidos por um ponto. Cada chave em colisão é relatada separadamente.

Mensagem emitida:

duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (chave de entrega duplicada entre duas vinculações: a FeatureRecipe de uma vinculação escreve uma chave de entrega que outra vinculação já entregou. Dê a uma das duas vinculações uma chave própria, ou vincule uma a menos: a chave sob a qual essa vinculação entrega é escolhida pela sua FeatureRecipe, que pode ler os values e a infra da própria vinculação, e a da outra é escolhida da mesma forma ou pelo seu próprio bloco inject, quando ela entregou por meio de um. Uma Release define a infra de uma vinculação e nunca os seus values; então, quando uma chave é escolhida por um valor, faça essa vinculação no Aggregate com o valor e continue fornecendo o restante a partir da Release.)

Como corrigir: dê a uma das duas Features uma chave própria — para uma Feature de credencial, essa costuma ser a chave que os seus valores nomeiam — ou remova uma das duas vinculações. Onde ambas devem fornecer uma mesma variável, decida qual o componente deve ler e vincule apenas essa. Duas credenciais que uma Release vincula por conta própria chegam ambas sob a chave que a sua Feature nomeia por padrão, porque uma Release não pode escrever os values de uma vinculação: vincule uma delas no Aggregate com o valor que nomeia a sua chave e forneça a sua origem a partir da Release na mesma entrada.

A component declares an inject mechanism the attached Feature maps nothing to (Um componente declara um mecanismo de inject para o qual a Feature vinculada não mapeia nada)

A lista de permissões spec.inject de um Component pode nomear mecanismos de entrega além dos padrão — um mecanismo que a própria lógica interna do componente entende, e para o qual tudo o que entrega nele precisa produzir um valor. Quando uma Feature é vinculada a um componente assim, o injectMapping da FeatureRecipe é o que diz sob qual mecanismo cada valor que ela produz é entregue. Um mecanismo que o componente declarou e para o qual o mapeamento não produz nenhuma chave é uma entrega que silenciosamente nunca aconteceria, então a build é interrompida em vez disso.

Um mapeamento que não diz nada sobre mecanismos não é um mapeamento que exclui todos eles. Uma FeatureRecipe cujo mapeamento é renderizado como um dicionário plano de entregas não afirma nada sobre mecanismos — essa é a forma comum de escrever uma Feature que produz entregas como variáveis de ambiente —, e o mesmo vale para uma vinculação que associa uma FeatureRecipe sem nenhum mapeamento a avaliar. Nenhum dos dois é relatado aqui; esta condição trata apenas de um mapeamento que nomeia mecanismos e omite um que o componente declarou.

Cada mecanismo não mapeado é um achado próprio, então um componente que declara dois, sem que uma vinculação mapeie nenhum deles, informa você sobre ambos. O achado é posicionado na entrada da vinculação no seu próprio arquivo, e nomeia também a FeatureRecipe — porque esse é o documento em que o mapeamento está escrito, e ele fica em um lugar completamente diferente.

Mensagem emitida:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (o mecanismo de inject personalizado não tem nenhuma chave correspondente na saída do injectMapping; adicione a chave do mecanismo ao injectMapping da Recipe (o mecanismo indicado, a FeatureRecipe indicada))

Como corrigir: a mensagem nomeia as duas metades. Adicione a chave do mecanismo ao injectMapping da FeatureRecipe para que a Feature produza um valor para ele, ou descarte o mecanismo da lista de permissões spec.inject do Component onde não se espera que nada entregue sob ele. Onde a FeatureRecipe pertence ao catálogo de outra pessoa, vincular uma Feature cujo mapeamento cubra o mecanismo é a terceira resposta.

An attached Feature’s injectMapping output cannot be read (A saída de injectMapping de uma Feature anexada não pode ser lida)

O injectMapping de uma FeatureRecipe é um template, e o que ele produz é lido como YAML: um dicionário com chaves por mecanismo de entrega — env, file, arg ou um mecanismo próprio do componente — ou um dicionário plano de entregas de ambiente. Quando a saída não pode ser lida como nenhum dos dois, nenhuma das suas chaves pode ser entregue, então a build é interrompida em vez de renderizar o componente como se a Feature vinculada não tivesse entregado nada. Uma credencial é o caso que mais importa: um componente que espera uma senha que nunca recebeu poderia, de outra forma, executar sem ela, e nada na saída o indicaria.

A causa habitual é um valor que o template escreveu entre aspas tal como está. Uma aspa dupla dentro dele encerra antes da hora o escalar entre aspas, e uma barra invertida inicia um escape que o YAML pode não conhecer, então um mapeamento que é renderizado corretamente para a maioria dos valores quebra para aquele que contém um caractere assim — muitas vezes uma senha. Uma saída vazia, ou que é interpretada como um dicionário que não entrega nada, não é esta condição: ela não entrega nada, e é isso que ela diz.

O quadro acima da mensagem nomeia o componente que está sendo renderizado, depois a vinculação pelo nome que ela traz no componente e a FeatureRecipe em que o mapeamento está escrito, como feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Abaixo da mensagem está o motivo pelo qual a saída não pôde ser lida — a linha e o que o YAML encontrou ali, como yaml: line 2: found unknown escape character. Onde o template lê um valor que um autor declarou sensível e o motivo depende do que esse valor contém, o motivo é omitido e uma frase dizendo isso aparece no seu lugar, de modo que a interrupção nunca cita o valor que quebrou a saída. A build relata a interrupção sob uma tag CATALOG_ERROR, porque o mapeamento é escrito pelo autor da FeatureRecipe.

Mensagem emitida:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (a saída de injectMapping da FeatureRecipe não pôde ser lida como um dicionário de entregas)

Como corrigir: no injectMapping da FeatureRecipe, escreva cada valor por meio de toJson — {{ .values.key }}: {{ .values.origin | toJson }} —, que o escreve como uma string JSON que o YAML lê de volta exatamente, quaisquer que sejam os caracteres que ela contenha. Onde a FeatureRecipe pertence ao catálogo de outra pessoa, o valor também pode ser alterado para não conter aspas duplas nem barras invertidas até que o mapeamento seja corrigido.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (A saída de injectMapping de uma Feature anexada grava entregas sob uma chave que nada entrega)

A saída do injectMapping de uma FeatureRecipe é mesclada no canal de injeção do componente pelas suas chaves de nível superior. env, file e arg são entregues como esses mecanismos, e qualquer outra chave é entregue como um mecanismo próprio com esse nome, que a Recipe do componente lê em .context.inject.<name>. A visão all é diferente: ela é construída a partir dos mecanismos depois da mesclagem, nunca mesclada a partir de uma saída, então os valores que um mapeamento escreve sob all: não chegam a nada. A saída ainda é lida sem erros, então, sem esta interrupção, uma build que lê esses valores de forma opcional é bem-sucedida sem eles — uma credencial escrita ali nunca chega ao componente, e nada na build nomeia o mapeamento que a perdeu.

Ela se aplica onde quer que all: traga pelo menos uma entrada, sozinho ou ao lado de outros mecanismos; os outros mecanismos na mesma saída não são o problema, e um all: escrito vazio não perde nada e não é relatado. Um dicionário plano que por acaso traz uma chave chamada all com um único valor é uma entrega de ambiente chamada all, não esta condição.

O achado é posicionado na entrada da vinculação no seu próprio arquivo, e nomeia a chave e a FeatureRecipe em que o mapeamento está escrito — porque esse é o documento a alterar, e ele fica em um lugar completamente diferente — junto com as chaves que uma saída pode trazer. Cada uma dessas chaves é um achado próprio. A build o relata sob uma tag CATALOG_ERROR.

Mensagem emitida:

FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (a saída de injectMapping da FeatureRecipe escreve uma chave que nenhum mecanismo de entrega do hospedeiro lê (a chave all, a FeatureRecipe indicada e as chaves que uma saída pode trazer))

Como corrigir: no injectMapping da FeatureRecipe, mova as entradas que estão sob all: para o mecanismo do qual o componente as lê — normalmente env:, ou o nome do mecanismo que a Recipe do componente lê. Onde a FeatureRecipe pertence ao catálogo de outra pessoa, vincule em vez disso uma Feature cujo mapeamento entregue o valor.

Ao renderizar a saída

Depois que cada contrato é validado, o compilador avalia templates Go nos valores de Component, nos blocos injectMapping de FeatureRecipe e nas fontes de Recipe e FeatureRecipe, e então entrega o resultado ao renderizador.

provides: template references a non-self-contained root (O template de provides referencia uma raiz não autocontida)

O template provides: de uma Recipe referencia uma raiz fora do conjunto autocontido. O bloco provides é avaliado na avaliação de provides, antes que o canal de inject seja hidratado e antes que as arestas entre nós sejam percorridas, então ele pode referenciar apenas dados que pertencem ao seu próprio nó: .context.instance_id, .context.rendered_name onde o provedor do nó informa um, .values, .infra, os .locals resolvidos do nó e strings estáticas. A verificação é uma lista de permissões positiva, então qualquer outra raiz causa uma interrupção — .context.inject e .context.uses (entre nós), .context.annotations.*, .context.labels, .context.metadata e .metadata.* (dados acoplados ao posicionamento ou à implantação que a superfície de provides não expõe), e .attachment_name (a passagem de provides de uma Recipe base não resolve nenhuma vinculação). Referenciar uma delas interrompe a build de forma explícita em vez de renderizar silenciosamente um valor vazio.

.locals faz parte da superfície: os locals de um nó são resolvidos no preâmbulo da mesma etapa, antes de seus provides, então um template provides os lê e recebe valores resolvidos.

Mensagem emitida:

provides block references a root outside the self-contained set ("<expression>") (o bloco provides referencia uma raiz fora do conjunto autocontido (com a expressão indicada))

A interrupção é posicionada na Recipe que declara a entrada e na chave escrita dentro dela — .spec.provides.<name> —, então ela nomeia o bloco a editar em vez do componente que associou a Recipe. Toda entrada que sai da superfície é relatada na mesma build; onde há mais de uma, os achados são agrupados sob provides entries that reach outside the data they are evaluated against.

Como corrigir: reestruture o template para que ele obtenha dados apenas dos pilares próprios da Recipe. Se o valor depende da saída de outro nó, essa dependência pertence ao bloco uses[].inject de um chamador, não aos provides do destino. Se o valor é calculado, coloque a expressão em uma entrada locals: e leia-a a partir de provides — assim a expressão fica em um único lugar. Se você estava tentando alcançar o namespace de implantação (ou outros dados de posicionamento) para montar um host entre namespaces, publique aqui o host simples e qualifique-o no lado do consumidor com uma funcionalidade de roteamento — os provides do produtor não devem depender de onde ele foi implantado.

O provides: de uma FeatureRecipe segue a mesma regra de locals: seus próprios locals: são resolvidos antes do seu provides:, então uma entrada provides de uma FeatureRecipe também lê .locals.

locals: entry references a sibling defined later in the same block (Uma entrada de locals referencia uma entrada irmã definida mais adiante no mesmo bloco)

Um bloco locals: é resolvido na ordem em que suas entradas são escritas, e uma entrada lê apenas uma entrada irmã definida acima dela. Uma referência direta .locals.<key> a uma entrada que o bloco define mais adiante causa uma interrupção: o compilador nunca ordena nem reordena o bloco para fazer a referência se resolver, porque a saída emitida passaria então a seguir uma inferência em vez do que foi escrito. Sem a interrupção, a referência seria resolvida, pela política de chaves ausentes, como uma string vazia, então um hostname ou nome de secret derivado perderia silenciosamente o segmento a partir do qual foi construído.

As duas resoluções de um bloco locals: decidem essa falha, e uma delas é a fixação. Um bloco é resolvido para dois propósitos diferentes: para que os próprios templates da Recipe possam lê-lo enquanto um artefato é renderizado, e para que uma coordenada source: estruturada possa ser resolvida e o artefato que ela nomeia possa ser fixado. A falha é decidida a partir da ordem de chaves declarada e do texto escrito, que é tudo de que ela precisa, então as duas resoluções a alcançam e relatam a mesma condição — aggrega pull, e uma build que preenche o lockfile, recusam o bloco exatamente como uma renderização faz. Vale a pena conhecer duas consequências ao escrever. O bloco inteiro é lido enquanto uma coordenada é resolvida, então uma entrada fora de ordem causa uma interrupção mesmo onde todo campo source: é literal e não lê nenhum local. E uma Recipe cujo source: é uma string simples, ou que não declara nenhum source:, não resolve nenhuma coordenada, então nessa Recipe a falha é relatada quando a saída é renderizada.

Mensagem emitida, para uma entrada no próprio bloco locals: da Recipe de um componente. Ela é posicionada na chave escrita dentro da Recipe, e toda entrada com erro é relatada em uma única build; onde há mais de uma, os achados são agrupados sob locals entries that read a sibling they cannot:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (a entrada de locals referencia uma entrada irmã definida mais adiante no mesmo bloco (com a expressão, a chave que ela nomeia, os locals resolvidos neste ponto e o componente pelo qual foi alcançada indicados). defina a chave nomeada acima da entrada indicada no bloco locals)

Uma autorreferência é a mesma condição — a chave está declarada e não resolvida — e nenhuma reordenação a corrige, então a mensagem diz isso no lugar da instrução de mover:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (a entrada de locals referencia uma entrada irmã definida mais adiante no mesmo bloco (com a expressão, a chave que ela nomeia, os locals resolvidos neste ponto e o componente pelo qual foi alcançada indicados). uma entrada de locals não pode ler a si mesma; calcule o valor diretamente a partir de .values e .infra)

Uma Recipe é associada por muitos componentes, então um erro em um bloco compartilhado é relatado uma vez para cada componente que o associa — e reached through the component é o que distingue esses achados. Eles compartilham uma posição, porque todos tratam da mesma entrada escrita no mesmo documento; a posição é onde editar, e o nome do componente é qual dos seus componentes cada achado representa. Os achados não são mesclados em um só, porque mesclá-los diria que algo está errado sem dizer quais componentes isso alcança, e essa é a parte sobre a qual você precisa agir.

A mesma falha em um bloco locals: que a receita de uma Feature declara é relatada da mesma forma: posicionada na chave escrita dentro dessa receita, nomeada pelo componente em que a vinculação está e agrupada com quaisquer entradas irmãs que tenham a mesma falha. Onde a receita é vinculada em mais de um lugar, a falha é relatada uma vez para cada um — cada vinculação associa esse bloco de forma independente, então cada uma é uma ocorrência própria e não a repetição de uma só.

Onde essa forma relata uma autorreferência, sua cláusula de posição nomeia a própria entrada que faz a referência em vez de uma posterior, porque é ali que a chave está.

Como corrigir: mova a entrada referenciada para acima de quem a lê. Reordenar um bloco locals: é uma mudança de comportamento onde quer que uma entrada leia outra, então a correção é exatamente a reordenação que a mensagem nomeia. Uma autorreferência — uma entrada que nomeia sua própria chave — não pode ser corrigida reordenando; em vez disso, calcule o valor diretamente a partir de .values e .infra, o que a mensagem diz no lugar da instrução de mover.

locals: key does not exist (A chave de locals não existe)

Um template lê .locals.<key> para uma chave que o bloco locals: não declara de forma alguma — um erro de digitação, ou uma chave que foi renomeada ou removida. Toda superfície que lê o pilar gera essa interrupção: uma entrada locals:, um template provides:, um template source: de Recipe e a resolução de uma coordenada source: estruturada, que lê o bloco inteiro para fixar o artefato que a coordenada nomeia. O pilar de locals é um mapa aberto com chaves, então uma chave desconhecida sob ele passa pela verificação de raiz e, caso contrário, seria resolvida como uma string vazia; a interrupção é o que impede que esse valor vazio chegue a um artefato emitido.

Mensagem emitida, onde a referência com erro está em um template provides::

template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (o template referencia uma chave que o bloco locals não declara (a entrada de provides indicada da Recipe indicada referencia a expressão indicada, o bloco locals não declara a chave indicada, declara as chaves indicadas). corrija o nome da chave)

Mensagem emitida, onde ela está em uma entrada locals: propriamente dita. Ela traz o componente pelo qual o bloco foi associado, pelo motivo que a interrupção por ordenação acima expõe — um bloco compartilhado é relatado uma vez por componente que o associa, e é isso que separa esses achados:

template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (o template referencia uma chave que o bloco locals não declara (com a expressão, a chave ausente, as chaves que o bloco declara e o componente pelo qual foi alcançada indicados). corrija o nome da chave)

Como corrigir: corrija o nome da chave para um que o bloco declara; a mensagem os lista. A interrupção é distinta da interrupção por ordenação acima porque os remédios diferem — nenhuma reordenação faz uma chave que não existe se resolver.

A verificação lê o caminho para o qual uma referência se resolve em vez do que foi digitado, então um alias do bloco é seguido: uma chave alcançada pelo ponto que um corpo with .locals revincula, ou por uma variável vinculada a .locals, é verificada exatamente nos mesmos termos que a grafia direta e causa uma interrupção da mesma forma, assim como uma chave lida do bloco entre parênteses — {{ (.locals).nope }} ou {{ ($.locals).nope }} — porque os parênteses produzem o próprio bloco e nada mais. Uma única grafia escapa da verificação: uma chave alcançada por uma chamada cujo resultado o texto do template não consegue nomear — {{ index .locals "nope" }}, ou {{ (default dict .locals).nope }} — porque o que uma chamada assim produz é decidido quando o template é executado, e não pelo que está escrito. Uma chave ausente lida como campo do resultado de uma chamada assim — a forma (default dict .locals).nope — não causa uma interrupção e renderiza o texto de espaço reservado do mecanismo de templates <no value>. Uma chave ausente alcançada por index causa uma interrupção, mas como “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)” mais abaixo, e não como esta verificação: index causa uma interrupção em qualquer chave de mapa que o mapa não contenha. index continua sendo, portanto, a forma de alcançar uma chave cujo nome é ele próprio calculado, e um nome calculado que o bloco não declara ainda é relatado pela sua chave.

Template references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define)

Um template referencia uma raiz de nível superior — o primeiro segmento do caminho após o ponto inicial — que seu contexto de renderização não define: um erro de digitação como {{ .valeus.port }}, ou uma raiz que não existe na superfície que está sendo escrita. A verificação é uma lista de permissões positiva sobre nomes de raiz, e o conjunto admitido é derivado da própria forma do contexto de renderização em vez de mantido como uma lista separada ao lado dele, então o conjunto que a build recusa e o conjunto que o contexto de fato entrega não podem divergir. O diagnóstico nomeia a referência com erro e lista as raízes que esse contexto define.

A interrupção ocorre de forma idêntica, esteja a referência sozinha ou envolvida em um fallback default, if, with ou range, e a forma envolvida é a que mais importa: um wrapper pode fornecer um fallback para uma chave ausente sob uma raiz definida, mas nunca para uma raiz ausente, então sem essa interrupção a forma envolvida seria resolvida silenciosamente como um valor vazio e deixaria a build terminar com sucesso. Uma chave ausente sob uma raiz definida não é afetada e continua seguindo a política missingkey=zero para templates de valores descrita em “Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)” mais abaixo, então idiomas de chave opcional como {{ .values.optional_field | default "fallback" }} continuam funcionando.

A mesma interrupção cobre uma chave digitada errado um nível abaixo, sob um pilar cuja forma é declarada. Alguns pilares têm um conjunto de chaves que o compilador define: .context, .metadata, .inject, .workload e .boundary no contexto de renderização de Recipe e FeatureRecipe, e .manifest em um template de caminho. Uma referência a uma chave que um desses pilares não define — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — causa uma interrupção exatamente como uma raiz errada, e o diagnóstico lista as chaves que esse pilar define. Nos templates próprios da vinculação de uma Feature, .inject define uma chave a mais para cada mecanismo de entrega que o bloco inject: da própria vinculação nomeia, além de env, file, arg e all: uma vinculação que escreve um mecanismo vault_ref: é lida em {{ .inject.vault_ref.VAULT_PATH }}, e o diagnóstico lista .inject.vault_ref entre as chaves que .inject define. Um mecanismo que a vinculação não nomeia causa uma interrupção mesmo dentro de um if ou de um with, porque a referência é verificada antes de o template ser executado. Para ler um mecanismo que a vinculação pode não nomear, proteja-o: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Com o par protegido, o build é concluído quer a vinculação nomeie o mecanismo ou não, quer ela escreva um bloco inject: ou não escreva nenhum — .inject não contém nada nesse caso, então o with pula o seu corpo, enquanto hasKey aplicado diretamente sobre .inject causaria uma interrupção em um valor que não é um mapa. Dentro da proteção, index ainda causa uma interrupção em uma chave que o mecanismo nomeado não contém. Outros pilares são abertos, porque o que contêm são dados com chaves, e não um conjunto que o compilador declara — entre eles .values, .infra, .locals, .provides, .features e .steps no contexto de renderização, e .parameters e .parent_boundary em um template de caminho. Um pilar aberto aceita qualquer chave. Uma chave ausente sob um pilar aberto não é essa interrupção — ela segue a política de chaves ausentes da superfície descrita em “Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)” mais abaixo, então {{ .values.optional_field | default "fallback" }} e todo outro idioma de chave opcional continuam funcionando.

Quais pilares são declarados e quais são abertos é uma propriedade da superfície, não algo que um template possa influenciar: o compilador lê isso a partir da forma do contexto de renderização que está prestes a entregar. É isso que permite que a interrupção por erro de digitação e a renderização da chave opcional convivam no mesmo template.

Uma superfície também pode restringir uma chave que seu pilar define em outros casos, e um relato assim não é um erro de digitação. Onde uma chave traz uma resposta sem sentido — ou que pertence a um nó diferente — em uma superfície específica, essa superfície recusa a referência em vez de resolvê-la para a coisa errada, e o diagnóstico lista as chaves que ela define. Dois casos a conhecer, ambos {{ .context.rendered_name }}. Nos templates próprios de uma vinculação de Feature, a chave traz o nome do componente hospedeiro tal como o próprio provedor do hospedeiro o informa, então ela é recusada na vinculação de um hospedeiro cujo provedor não informa nenhum nome — um hospedeiro que posiciona sozinho um conjunto de artefatos, ou um que renderiza por meio de um provedor que não deriva tal nome — e admitida em qualquer outro hospedeiro. {{ .context.instance_id }} é admitida nessa superfície e nomeia o componente hospedeiro para o qual a vinculação está sendo resolvida, que é o nome que os recursos próprios do hospedeiro recebem em um hospedeiro assim. Nas entradas locals: de uma Recipe, a chave é recusada independentemente do que o provedor do nó informe: um local compartilha seu contexto com o template source: da Recipe, e se o nó fornece uma fonte é uma das coisas de que o nome depende, então o nome não é oferecido ali. O diagnóstico lista .context.instance_id como a única chave que .context define ali; leia o nome renderizado em uma entrada provides: ou em um template inline. Consulte ../templates/rendered-resource-names.md para saber o que cada uma das duas chaves nomeia e onde cada uma pode ser lida.

Mensagem emitida quando a própria raiz não está definida:

template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (o template referencia uma raiz que o contexto de renderização não define (o template indicado referencia o caminho indicado, o contexto de renderização define as raízes indicadas))

E quando a raiz está certa, mas uma chave sob um pilar declarado não está:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (o template referencia uma raiz que o contexto de renderização não define (o template indicado referencia o caminho indicado, o pilar indicado define as chaves indicadas))

Como corrigir: corrija a referência para uma que o diagnóstico lista — a maioria dos relatos é um erro de digitação de .values, .infra ou .context, ou de uma chave sob .context ou .metadata. Remover o wrapper de fallback não elimina a interrupção, e adicionar um nunca a suprimiu; o wrapper apenas escondia qual referência estava errada. Se os dados realmente pertencem a outro nó, eles chegam a este template pelo canal de inject — cabeie-os com uma entrada uses[].inject no consumidor e leia-os a partir de .context.inject — e não por uma raiz própria.

A verificação cobre toda superfície de template que o renderizador avalia, cada uma em relação ao conjunto de referências que sua própria superfície define: valuesMapping, injectMapping e workload de Recipe e FeatureRecipe, corpos de artifacts:, entradas provides: e locals:, source:, corpos when: e with: de etapas de pipeline, assertions:, os templates value: de self-inject no nível do componente em um Aggregate e os templates de caminho das fronteiras da Release (directory: / subDirectory:). Duas dessas superfícies nomeiam algumas recusas com um diagnóstico próprio, porque o erro que descrevem é mais específico do que “esta referência não existe”: um template de caminho que tenta alcançar uma variável que não lhe é fornecida é coberto por “Path-template references a variable outside the allowlist (O template de caminho referencia uma variável fora da lista de permissões)” mais abaixo, e uma FeatureRecipe de escopo de fronteira que tenta alcançar um pilar por componente, por “FeatureRecipe template references a field outside its scope’s allowlist (O template de FeatureRecipe referencia um campo fora da lista de permissões do seu escopo)”. Todo o resto que essas duas superfícies recusam — incluindo uma chave digitada errado sob um pilar que elas admitem — relata essa interrupção, então nenhum diagnóstico diz a você que sua referência é algo que ela não é.

An artifacts: template reads a pillar the Recipe does not declare (Um template de artifacts lê um pilar que a Recipe não declara)

O template de uma entrada artifacts: lê .workload, ou uma chave abaixo dele, em uma Recipe que não declara nenhum workload:; ou lê .source, ou uma chave abaixo dele, em uma Recipe que não declara nenhum source:. Os dois pilares estão sempre presentes no contexto de renderização dos artefatos — são raízes que a superfície define —, então a referência está bem formada e a interrupção diz respeito à ausência da declaração, e não a uma referência errada. Uma Recipe que renderiza um Deployment a partir da sua carga de trabalho sintetizada e uma Recipe que renderiza um chart a partir de uma fonte são formas diferentes, e um corpo artifacts: escrito para uma delas tenta alcançar um pilar que a outra nunca preenche.

A verificação é executada antes de a entrada ser avaliada, e essa ordem é o que torna o relato útil. Um pilar ausente chega ao template como um valor vazio, então, deixada à avaliação, a build ou não inseriria nada no arquivo emitido, ou falharia com o que quer que o mecanismo de templates diga sobre ler uma chave de nada — e nenhuma das duas coisas nomeia o pilar ou a declaração que falta. Recusar primeiro permite que a interrupção nomeie a expressão exata que tentou alcançar o pilar, citada como você a escreveu.

Um source: que está declarado mas cuja renderização resulta em uma string vazia é lido como nenhuma fonte, porque o que a verificação lê é a fonte depois que seu próprio template foi avaliado. Esse é o mesmo valor a partir do qual o provedor renderiza em seguida, então uma Recipe cujo source: foi resolvido como nada também não tem fonte a oferecer a um corpo artifacts:.

Mensagem emitida, em uma única forma onde quer que a entrada artifacts: tenha sido escrita. O que varia não é a frase, mas as legendas depois dela, que dizem qual documento contém a entrada.

Toda referência com erro no template é nomeada, então um corpo que tenta alcançar dois pilares ausentes informa você sobre os dois, e não apenas sobre o que veio primeiro. Cada referência é relatada no documento que declara a entrada, citada como você a escreveu e com a legenda da saída à qual pertence:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (o template de artefato referencia um pilar que a Recipe não declara (com a expressão e o artefato indicados))

A expressão nomeia o pilar em seu primeiro segmento, e é isso que diz a você qual declaração falta: .source.chart tenta alcançar source:, e .workload.containers, workload:.

Uma entrada que a Recipe própria de um componente declara é relatada no bloco artifacts: dessa Recipe.

Uma entrada que uma FeatureRecipe declara — vinculada a um componente como funcionalidade, ou declarada em uma fronteira — é verificada em relação aos pilares que essa FeatureRecipe declara, e não aos do componente hospedeiro, é relatada no bloco artifacts: da FeatureRecipe e traz uma legenda adicional que nomeia a vinculação que a associa:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (o template de artefato referencia um pilar que a Recipe não declara (com a expressão, o artefato e a vinculação indicados))

A legenda da vinculação é o que a posição não consegue dizer sozinha: um componente pode ter várias vinculações, e uma vinculação declarada em uma fronteira alcança cada componente que a fronteira contém. A frase em si nomeia uma Recipe em ambos os caminhos; são a posição e a legenda da vinculação juntas que dizem qual documento abrir.

Onde um template nomeia várias referências, cada uma recebe um relato próprio sob uma linha que nomeia a entrada que compartilham, e essa linha também nomeia o documento:

artifact <output-name> references pillars its Recipe does not declare (o artefato indicado referencia pilares que sua Recipe não declara)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (o artefato indicado referencia pilares que a FeatureRecipe associada pela vinculação indicada não declara)

Cada um desses relatos traz a mesma condição de interrupção, seja qual for o documento de que trata, então qualquer coisa que faça correspondência com a condição, e não com o texto, não vê diferença entre eles.

Como corrigir: declare o pilar que o template lê, ou pare de lê-lo. Declará-lo é a correção quando o corpo artifacts: pertence àquela forma de Recipe — adicione o workload: que as referências do template a contêineres, portas ou volumes esperam, ou o source: cujo caminho de chart ou de módulo ele interpola. Remover a referência é a correção quando o corpo foi escrito para uma Recipe diferente e reutiliza um fragmento que não se aplica aqui; onde o valor realmente vem de outro lugar, publique-o pelo provides: do nó produtor e leia-o a partir do canal de inject em vez de tentar alcançar um pilar que esta Recipe não preenche. Proteger a referência com um wrapper de fallback não elimina a interrupção — o que falta é o pilar, não a chave abaixo dele —, e mover a referência para outra entrada da mesma Recipe também não, porque toda entrada de um mesmo bloco artifacts: é avaliada em relação aos mesmos pilares.

Esta interrupção é distinta de “Template references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define)” acima, e vale a pena distinguir as duas porque os remédios diferem. Aquela ocorre em uma raiz que a superfície não define de forma alguma, ou em uma chave digitada errado sob um pilar cuja forma é fixa — {{ .workload.containres }} em uma Recipe que de fato declara uma carga de trabalho. Esta ocorre em uma referência escrita corretamente a um pilar que simplesmente não está lá.

A template reads a rendered name the node’s provider does not report (Um template lê um nome renderizado que o provedor do nó não informa)

Um template lê {{ .context.rendered_name }} — o nome que o provedor associado dá à saída que renderiza para o nó, a partir de uma fonte fornecida pelo autor ou de uma carga de trabalho que ele sintetiza — em um nó cujo provedor não informa nenhum nome desse tipo. A referência está bem formada e a chave é uma das que o contexto de renderização define; o que falta é uma resposta para este nó.

A recusa existe porque a alternativa é pior do que uma interrupção. O nome chega a um template como uma string simples, então um nó sem nome faria a referência desaparecer na renderização e emitiria um endereço com um segmento a menos — .svc.cluster.local onde se pretendia um hostname — com código de saída zero, sem nada para ler na build. Esse artefato é implantado, e o que ele nomeia não existe. Recusar antes que qualquer coisa seja avaliada relata, em vez disso, a falha no template que o autor escreveu.

Se o provedor de um nó informa um nome desse tipo é definido pela associação da Recipe, antes de toda avaliação, então nada aqui é adivinhado.

Dois relatos, e qual você recebe depende do nó, e não de onde você escreveu a referência. Um nó que não fornece nenhuma fonte própria, sob um provedor que não informa nenhum nome para ele, tem seus recursos nomeados segundo sua identidade, então existe um valor correto e o relato o nomeia. Um nó que de fato fornece uma fonte, sob um provedor que não deriva nenhum nome para ele, não tem substituto — e oferecer a identidade ali mandaria você para um valor que não nomeia nenhum dos recursos desse nó, então o relato diz isso em vez disso.

Mensagem emitida, onde o nó não fornece nenhuma fonte própria:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (o template lê o nome que o destino dá aos recursos que renderiza para o nó, e o provedor deste nó não informa nenhum nome desse tipo; um template conforme lê um valor que o próprio provedor do nó fornece (com a chave e o provedor indicados). leia em vez disso a chave indicada: este nó não fornece nenhuma fonte própria, então seus recursos são nomeados segundo a identidade do nó)

E onde ele de fato fornece uma fonte, sob um provedor que não deriva nenhum nome desse tipo:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (o template lê o nome que o destino dá aos recursos que renderiza para o nó, e o provedor deste nó não informa nenhum nome desse tipo; um template conforme lê um valor que o próprio provedor do nó fornece (com a chave e o provedor indicados). escreva um valor que não dependa de um nome que este destino deriva: ele não informa nenhum para a saída que renderiza a partir de uma fonte fornecida, então não há nada desse tipo para ler aqui)

Onde a referência está em um template que não é uma entrada provides:, o relato nomeia também o campo em que ela foi escrita — field "valuesMapping", field "artifacts[probe.tf.json]" —, porque a chave de uma entrada artifacts: é um nome de arquivo de saída e contém o caractere com que a posição separa seus próprios segmentos, então a posição para no bloco que contém a entrada.

Quais templates ela cobre: todo template que uma Recipe escreve inline — suas entradas provides:, seu valuesMapping:, seu corpo workload:, cada entrada artifacts: e o with: e o when: de cada etapa de pipeline. Uma superfície de template fica de fora: uma entrada valuesMapping:, workload: ou artifacts: fornecida por $import: — quer o import nomeie um arquivo local, quer uma entrada de biblioteca — não traz nenhum texto na Recipe até que a renderização a resolva, então uma referência dentro de um corpo assim é renderizada como um valor vazio em vez de causar uma interrupção.

Como corrigir: leia a chave que o relato nomeia. Onde a saída do seu nó é algo construído para ele sob um provedor que não informa nenhum nome — uma carga de trabalho sintetizada, um conjunto de artefatos posicionado —, {{ .context.instance_id }} é o nome que esses recursos de fato recebem, e é o valor certo, não um fallback. Onde o seu nó fornece um chart ou módulo próprio e o relato não oferece nenhum substituto, o nome que você tentava alcançar não é um que esse provedor deriva: publique algo que não dependa dele, ou nomeie o recurso na fonte que você forneceu e leia esse nome de volta a partir de um valor que você define. ../templates/rendered-resource-names.md expõe quais provedores informam um nome e, para cada um dos outros, por que não existe nenhum a informar.

A template reads its callers’ render facts without declaring it (Um template lê os fatos de renderização de seus chamadores sem declarar isso)

Um template em uma FeatureRecipe vinculada a um componente lê render_facts sob .context.used_by — o que os componentes que se conectam ao hospedeiro da vinculação relataram sobre suas próprias renderizações — e a FeatureRecipe não define readsCallerRenderFacts: true.

A chave é o que decide quando a vinculação é renderizada. Sem ela, a vinculação é renderizada logo depois do componente ao qual está vinculada, e um componente que se conecta e que vem mais tarde na ordem da build ainda não foi renderizado nesse ponto, então o que ele emitiu não pode estar lá para ser lido. Recusar o template antes que qualquer coisa seja renderizada relata a declaração ausente no campo que você escreveu, em vez de uma build cujo template lê o que alguns dos seus chamadores emitiram e não os outros.

Mensagem emitida:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (o template lê os fatos de renderização de seus chamadores, mas a FeatureRecipe não define readsCallerRenderFacts (com a referência e o campo em que está escrita indicados))

A referência é citada em relação à conexão de que foi lida — .render_facts, ou .render_facts.<name> —, porque um template lê os chamadores uma conexão por vez, dentro de {{ range .context.used_by }} ou a partir de uma conexão que escolhe. O campo nomeia o bloco em que o template foi escrito: valuesMapping, workload ou artifacts[<output-name>]. Um with: ou when: de uma etapa de pipeline que lê os mesmos fatos é relatado, em vez disso, pela entrada seguinte, seja o que for que a FeatureRecipe defina, porque definir a chave não permitiria que uma etapa os lesse. Onde vários campos leem os fatos, cada um recebe um relato próprio sob uma linha que nomeia o que eles compartilham:

attachment templates reading their callers’ render facts without declaring it (templates de vinculação que leem os fatos de renderização de seus chamadores sem declarar isso)

Como corrigir: defina readsCallerRenderFacts: true no spec da FeatureRecipe. Isso renderiza suas vinculações depois que cada componente foi renderizado e não muda mais nada no que elas renderizam — consulte a página da entidade FeatureRecipe. A chave é o contrato, e esta interrupção apenas ajuda você a encontrar um template que visivelmente precisa dela: a verificação lê o template como está escrito, então uma referência construída enquanto o template é executado, ou uma escrita em conteúdo importado de um arquivo ou de uma biblioteca, não causa interrupção — defina mesmo assim a chave em uma FeatureRecipe desse tipo. Um template que lê um campo chamado render_facts de alguma outra lista ao lado de .context.used_by também causa uma interrupção, assim como um que lê os fatos próprios do seu hospedeiro como .render_facts dentro de {{ with .context }} ao lado dela — escreva os do hospedeiro por extenso como .context.render_facts, que nunca é confundido com os dos chamadores; definir a chave elimina ambos os casos sem outro custo além da renderização posterior.

Uma FeatureRecipe que renderiza uma única vez por fronteira (executionScope: boundary) não é verificada aqui: os templates que produzem seus recursos não têm nenhum .context para ler, e uma referência a ele é recusada, em vez disso, como um campo fora da lista de permissões do seu escopo.

A pipeline step reads its callers’ render facts (Uma etapa de pipeline lê os fatos de renderização de seus chamadores)

O with: ou o when: de uma etapa de pipeline, em uma FeatureRecipe vinculada a um componente, lê render_facts sob .context.used_by — o que os componentes que se conectam ao hospedeiro da vinculação relataram sobre suas próprias renderizações.

Uma etapa de pipeline nunca vê essas conexões. Uma etapa pode reescrever os documentos próprios do componente hospedeiro, e a saída própria de um componente continua a mesma independentemente de quem se conecta a ele, então os templates de uma etapa são avaliados sem .context.used_by — para toda FeatureRecipe, defina ela ou não readsCallerRenderFacts: true. Essa chave decide quando a vinculação é renderizada, nunca o que uma etapa vê. Uma etapa que lesse os fatos de seus chamadores não leria, portanto, nada, e a build é interrompida antes que qualquer coisa seja renderizada, em vez de renderizar essa leitura como um valor vazio.

Mensagem emitida:

pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>) (a etapa de pipeline lê os fatos de renderização de seus chamadores, mas uma etapa de pipeline não lê os componentes que se conectam ao seu hospedeiro; ela lê apenas os fatos de renderização próprios do hospedeiro (com a referência e o campo em que ela está escrita indicados))

A referência é citada em relação à conexão da qual foi lida — .render_facts, ou .render_facts.<name> — como na entrada acima, e o campo nomeia a etapa pelo seu id: pipeline[<step>].with ou pipeline[<step>].when. Onde várias etapas leem os fatos, cada uma recebe um relato próprio sob uma linha que nomeia o que elas têm em comum:

pipeline steps reading their callers’ render facts (etapas de pipeline que leem os fatos de renderização de seus chamadores)

Como corrigir: em uma etapa, leia os fatos de renderização próprios do hospedeiro em .context.render_facts, escrito por extenso — eles vêm da renderização própria do hospedeiro, então lê-los não faz nada depender de quem se conecta a ele. Leia os fatos dos chamadores, em vez disso, nos templates que produzem os recursos próprios da vinculação — seu valuesMapping:, workload: ou artifacts: — com readsCallerRenderFacts: true definido, como descreve a página da entidade FeatureRecipe. Definir apenas a chave não elimina essa interrupção. A verificação lê o template tal como está escrito, com os limites que a entrada acima descreve: uma referência construída enquanto o template é executado, ou uma escrita em conteúdo importado de um arquivo ou de uma biblioteca, não interrompe a build, e uma etapa que lê um campo chamado render_facts de alguma outra lista ao lado de .context.used_by, ou os fatos próprios do seu hospedeiro como .render_facts dentro de {{ with .context }} ao lado dela, também a interrompe.

Uma FeatureRecipe que é renderizada uma única vez para uma fronteira (executionScope: boundary) não é verificada aqui, pelo motivo que a entrada acima apresenta.

A template reads its targets’ render facts without declaring it (Um template lê os fatos de renderização de seus destinos sem declarar isso)

Um template em uma FeatureRecipe vinculada a um componente lê render_facts sob .context.uses — o que os componentes aos quais o hospedeiro da vinculação está cabeado relataram sobre suas próprias renderizações — e a FeatureRecipe não define readsTargetRenderFacts: true.

A chave decide duas coisas. Ela faz a vinculação ser renderizada depois que todos os componentes foram renderizados: sem ela, a vinculação é renderizada logo após o componente ao qual está vinculada, e um destino que vem depois na ordem da build ainda não foi renderizado nesse momento. E é ela que coloca os fatos de cada destino nas conexões que a vinculação lê: sem ela, nenhuma entrada de .context.uses traz .render_facts. Recusar o template antes que qualquer coisa seja renderizada relata a declaração ausente no campo que você escreveu, em vez de uma build cujo template não lê nada onde esperava os fatos de um destino.

Mensagem emitida:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (o template lê os fatos de renderização de um componente ao qual seu hospedeiro está cabeado, mas a FeatureRecipe não define readsTargetRenderFacts (com a referência e o campo em que ela está escrita indicados))

A referência é aquela que o template escreveu: por extenso sob o alias de uma conexão — .context.uses.<alias>.render_facts, ou .context.uses.<alias>.render_facts.<name> — ou, onde o template lê as conexões uma de cada vez, dentro de {{ range .context.uses }}, {{ with .context.uses.<alias> }} ou a partir de uma conexão que ele escolhe, em relação a essa conexão: .render_facts, ou .render_facts.<name>. O campo nomeia o bloco em que o template foi escrito: valuesMapping, workload ou artifacts[<output-name>]. Um with: ou when: de uma etapa de pipeline que lê os mesmos fatos é relatado, em vez disso, pela próxima entrada, seja o que for que a FeatureRecipe defina. Onde vários campos leem os fatos, cada um recebe um relato próprio sob uma linha que nomeia o que eles têm em comum:

attachment templates reading the render facts of the components their host is wired to, without declaring it (templates de vinculação que leem os fatos de renderização dos componentes aos quais seu hospedeiro está cabeado, sem declarar isso)

Como corrigir: defina readsTargetRenderFacts: true no spec da FeatureRecipe — readsCallerRenderFacts: true não elimina essa interrupção, já que coloca fatos nos componentes que se conectam ao hospedeiro e não naqueles aos quais ele está cabeado. Isso renderiza as vinculações dela depois que todos os componentes foram renderizados, coloca os fatos de cada destino na conexão dele e não muda mais nada no que elas renderizam — consulte a página da entidade FeatureRecipe. A chave é o contrato, e essa interrupção apenas ajuda você a encontrar um template que visivelmente precisa dela: a verificação lê o template tal como está escrito, então uma referência construída enquanto o template é executado, ou uma escrita em conteúdo importado de um arquivo ou de uma biblioteca, não interrompe a build — defina a chave em uma FeatureRecipe desse tipo mesmo assim. Um template que lê .context.uses de qualquer forma e também lê um campo chamado render_facts de algum outro valor — entre eles os fatos de um chamador dentro de {{ range .context.used_by }} — também interrompe a build; defina a chave, e também readsCallerRenderFacts onde o template lê os fatos de seus chamadores.

Uma FeatureRecipe que é renderizada uma única vez para uma fronteira (executionScope: boundary) não é verificada aqui, pelo motivo que a entrada sobre os chamadores acima apresenta.

A pipeline step reads its targets’ render facts (Uma etapa de pipeline lê os fatos de renderização de seus destinos)

O with: ou o when: de uma etapa de pipeline, em uma FeatureRecipe vinculada a um componente, lê render_facts sob .context.uses — o que os componentes aos quais o hospedeiro da vinculação está cabeado relataram sobre suas próprias renderizações.

Uma etapa lê as conexões que seu hospedeiro faz, tal como a Recipe própria do hospedeiro as lê, e nunca os fatos de renderização dos destinos delas — para toda FeatureRecipe, defina ela ou não readsTargetRenderFacts: true. Uma etapa pode reescrever os documentos próprios do componente hospedeiro, e a renderização própria do hospedeiro lê o que seus destinos publicam, nunca o que eles emitiram, então os templates de uma etapa são avaliados sem esses fatos. Uma etapa que os lesse não leria, portanto, nada, e a build é interrompida antes que qualquer coisa seja renderizada, em vez de renderizar essa leitura como um valor vazio.

Mensagem emitida:

pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>) (a etapa de pipeline lê os fatos de renderização de um componente ao qual seu hospedeiro está cabeado, mas uma etapa de pipeline lê apenas os fatos de renderização próprios do hospedeiro (com a referência e o campo em que ela está escrita indicados))

A referência é citada como na entrada acima, e o campo nomeia a etapa pelo seu id: pipeline[<step>].with ou pipeline[<step>].when. Onde várias etapas leem os fatos, cada uma recebe um relato próprio sob uma linha que nomeia o que elas têm em comum:

pipeline steps reading the render facts of the components their host is wired to (etapas de pipeline que leem os fatos de renderização dos componentes aos quais seu hospedeiro está cabeado)

Como corrigir: em uma etapa, leia os fatos de renderização próprios do hospedeiro em .context.render_facts, escrito por extenso. Leia os fatos dos destinos, em vez disso, nos templates que produzem os recursos próprios da vinculação — seu valuesMapping:, workload: ou artifacts: — com readsTargetRenderFacts: true definido, como descreve a página da entidade FeatureRecipe. Definir apenas a chave não elimina essa interrupção. A verificação lê o template tal como está escrito, com os limites que a entrada acima descreve.

Uma FeatureRecipe que é renderizada uma única vez para uma fronteira (executionScope: boundary) não é verificada aqui, pelo motivo que a entrada sobre os chamadores acima apresenta.

Cross-node type safety violation via selector: (Violação da segurança de tipos entre nós via selector)

Uma única interrupção cobre as duas expressões de rótulos que um autor de catálogo escreve para restringir o que pode ser cabeado ou vinculado, porque ambas falham da mesma forma: um conjunto de rótulos que não satisfaz uma expressão que uma entidade do catálogo declarou.

Uma aresta uses: cujo destino não satisfaz o selector: de seu socket. Um socket usesSchema declara um campo selector: que exclui o Component de destino conectado na outra ponta da aresta. O seletor é a forma de o autor do catálogo dizer “este socket só aceita destinos cujos rótulos correspondam a esta expressão”; uma aresta que satisfaz a busca pelo nome do socket, mas não a expressão do seletor, é uma violação da segurança de tipos.

Mensagem emitida:

selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (violação de seletor (a expressão indicada, declarada no socket indicado, não é satisfeita pelos rótulos do destino indicado). Adicione ao tipo de componente do destino os rótulos que o seletor exige, ou cabeie o socket a um componente que já os tenha.)

Uma vinculação cujo componente não satisfaz o campo appliesTo: da Feature. Uma Feature declara a quais componentes pode ser vinculada, em appliesTo: e em appliesToAnyOf:. Os requisitos da expressão única valem em conjunto e as alternativas valem alternativamente, bastando qualquer uma delas; ambas as superfícies precisam ser satisfeitas, e uma superfície que a Feature omite é satisfeita por qualquer coisa. Uma vinculação cujo componente traz rótulos que a declaração da Feature não admite é a mesma classe de violação que o caso da aresta acima.

Mensagem emitida:

selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (violação de seletor (a expressão appliesTo indicada, declarada pela Feature indicada, não é satisfeita pelos rótulos do componente indicado). Adicione ao tipo deste componente os rótulos que o appliesTo da Feature exige, ou vincule uma Feature cuja aplicabilidade o componente já satisfaça.)

Qualquer uma das expressões também pode ser escrita em uma forma que a gramática de rótulos não consegue ler de modo algum. Isso é relatado como a mesma interrupção, cujo último valor é o motivo pelo qual ela não pôde ser lida, e não o conjunto de rótulos que não a satisfez — que é o que distingue uma expressão que não pôde ser avaliada de uma que foi avaliada e resultou falsa:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (violação de seletor (a expressão appliesTo indicada, declarada pela Feature indicada, que não pôde ser avaliada, pelo motivo indicado). Corrija o seletor appliesTo na entidade de catálogo da Feature.)

Um seletor de socket que a gramática não consegue ler também é recusado antes que qualquer coisa conecte o socket. aggrega validate, sobre todo o catálogo ou sobre um único Component ou Feature, lê todos os seletores de socket que o próprio documento da entidade declara e recusa, sob esta mesma condição, aquele que a gramática não consegue ler, haja ou não alguma aresta conectada através do socket:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (violação de seletor, declarado em um socket, que não pôde ser avaliado. Corrija o seletor na declaração do socket no usesSchema do tipo de componente.)

Em um socket de uma Feature, a correção nomeia, em vez disso, o usesSchema da Feature. Nada conectou o socket, então a falha é da entidade de catálogo: ela é registrada como CATALOG_ERROR e nomeia o arquivo da entidade.

A interrupção traz a chave escrita a que se refere — a entrada de socket uses:, ou a entrada features: que nomeia a vinculação — junto com o arquivo que a declara, então a posição que ela relata é a entrada que você edita, e não o início do documento. Um Component escrito dentro de um subsistema é posicionado no subsistema sob o qual foi escrito, nível por nível. Uma vinculação é posicionada na entrada features: que a escreveu, no documento que a escreveu, e atribuída ao autor desse documento: o bloco próprio do componente ou o bloco de um subsistema no Aggregate, uma falha do desenvolvedor; e, para uma vinculação que só a Release faz, sua entrada para o componente ou o bloco features: de uma fronteira que contém o componente, uma falha do operador. Onde ambos os documentos escrevem a vinculação, ela é posicionada onde seu type é nomeado, o que o Aggregate sempre faz. Uma vinculação escrita em uma conexão é posicionada na sua chave sob o features: dessa conexão, no documento que a escreveu — a entrada de conexão do Aggregate, ou a entrada por aresta da Release para uma vinculação que só a Release faz. Uma Feature que somente a Release vincula a um componente que sua declaração não admite resulta em:

[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.

e a mesma vinculação escrita no componente no Aggregate resulta em [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics. Uma vinculação produzida pela expansão orientada por anotações não foi escrita por nenhuma entrada features:, então ela é posicionada na chave features: própria do componente no documento que declara o componente, como uma falha do desenvolvedor.

Como corrigir uma violação de aresta: ou direcione a aresta uses: para um Component cujos rótulos satisfaçam o seletor, ou ajuste a expressão do seletor na entidade do catálogo para aceitar a classe de destino pretendida. Revise os metadata.labels do Component de destino com aggrega inspect para confirmar quais rótulos ele traz.

Como corrigir uma violação de vinculação: ou vincule a Feature a um componente cujos rótulos a declaração dela admite, ou amplie o appliesTo: da Feature — adicionando uma alternativa sob appliesToAnyOf: onde a Feature realmente atende mais de uma classe de componente. Onde o componente deveria se qualificar e não se qualifica, a peça que falta geralmente é um rótulo: revise-o com aggrega inspect e adicione o que a expressão pede nos metadata.labels do Component.

Unknown provider (Provedor desconhecido)

Uma Recipe declara capability: <name> onde <name> não nomeia nenhum provedor que o compilador sirva. O compilador não pode despachar a renderização para um provedor do qual nunca ouviu falar.

Mensagem emitida:

unknown provider: <provider-name> (provedor desconhecido: o nome indicado)

Como corrigir: confirme que o nome do provedor está escrito corretamente — cloudformation, compose, helm, helm-chart e terraform são os nomes que os plugins provedores embutidos servem. Se você pretendia um provedor corporativo personalizado, garanta que um Plugin de renderização de provedor que sirva esse nome (pluginType: provider com o nome em suas spec.provider.capabilities) esteja presente no espaço de trabalho de catálogo para o qual a build aponta.

A capability is served by more than one provider plugin (Uma capacidade é servida por mais de um plugin provedor)

Uma build alcança uma capacidade — ou um pull resolve uma — servida por mais de um Plugin de renderização de provedor (pluginType: provider, cada um listando essa capacidade em suas spec.provider.capabilities), e o espaço de trabalho não selecionou qual deles a renderiza. Em vez de escolher um provedor arbitrariamente, a build é interrompida e nomeia ambos os candidatos. Um catálogo que traz dois plugins para a mesma capacidade é válido — dois publicadores podem cada um distribuir um plugin para helm ou compose, e o catálogo aceita ambos. A ambiguidade só aparece no ponto de uso: a interrupção ocorre quando uma build ou um pull de fato alcança a capacidade disputada, não no momento do carregamento.

Mensagem emitida. A regra que interrompeu a build vem primeiro, e os detalhes — qual capacidade, quais candidatos e a associação a escrever — vêm em seguida:

capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (a capacidade é servida por mais de um plugin provedor; adicione uma entrada plugins.providers para selecionar um: a capacidade indicada é servida por mais de um plugin provedor (os indicados); adicione uma entrada plugins.providers para a capacidade indicada que selecione um)

Como corrigir: adicione uma entrada plugins.providers na configuração do espaço de trabalho, com a capacidade como chave e cujo valor seleciona a identidade do plugin que a renderiza. Mantenha ambos os plugins no catálogo federado; a associação diz a este espaço de trabalho para qual deles despachar a capacidade disputada.

The plugin serving a provider cannot assemble what that provider combines (O plugin que serve um provedor não consegue montar o que esse provedor combina)

Um provedor declara o que acontece com a saída por nó de um grupo de despacho: a saída de cada nó gravada diretamente no caminho de despacho, os fragmentos combinados em um único documento, ou cada nó colocado em sua própria posição dentro de uma única estrutura que os envolve. Onde um provedor declara que a saída é combinada — um arquivo compose mesclado, um chart guarda-chuva — o plugin que o serve precisa oferecer o export que faz a combinação. Essa interrupção ocorre onde ele não o faz: o plugin anuncia a renderização por nó (render_node) e nenhum assemble_boundary correspondente, então os nós do grupo podem ser renderizados, mas a saída deles não pode ser mesclada.

As duas metades dessa divergência pertencem ao plugin. O que acontece com a saída de um grupo de despacho faz parte do que o plugin relata sobre si mesmo quando é carregado, e o export que faria a combinação é uma das entradas sob spec.exports de uma entidade Plugin, conferida com esse mesmo relato — então a interrupção nomeia um plugin que declara uma montagem que sua superfície de export não fornece.

A build é interrompida em vez de pular a montagem. Pulá-la gravaria o fragmento de cada nó no caminho em que se esperava um único artefato e relataria sucesso, e nada mais adiante consegue distinguir esses fragmentos da saída plana por nó que um provedor que não declara nenhuma montagem emite por design — então um artefato ausente apareceria onde quer que a saída fosse aplicada, e não no momento da build.

Um grupo de despacho sem caminho de despacho é ignorado. A saída gravada em nenhum caminho é saída por nó, então nada é montado ali sobre o que uma declaração de combinação possa valer.

Mensagem emitida — um achado por grupo de despacho infrator, que nomeia o provedor e o caminho em que esse grupo se monta:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (o provedor que deveria montar seu grupo de despacho não fornece nenhum montador de fronteira (com o provedor e o caminho de despacho indicados))

Onde mais de um grupo de despacho é infrator, os achados chegam juntos sob o relato dispatch groups whose provider offers no boundary assembler.

Como corrigir: sirva a capacidade com um plugin que anuncie tanto render_node quanto assemble_boundary — consulte ../entities/plugin.md para a superfície de autoria spec.exports, e ../schema/plugins/wasm-provider.md para o que o export de montagem recebe. Se você escreve o plugin, cabe a você alinhar os dois lados: adicione o export de montagem, ou não relate nenhuma declaração de montagem e deixe a saída de cada nó chegar ao caminho de despacho sem mesclagem. Se você consome um plugin publicado, selecione uma versão que ofereça os dois exports, ou selecione um plugin cujo provedor não declare nenhuma montagem para essa capacidade.

A boundary-level Feature’s output reaches no assembled file (A saída de uma Feature de escopo de fronteira não chega a nenhum arquivo montado)

Uma Feature vinculada sob o features: de uma fronteira, cuja FeatureRecipe declara executionScope: boundary, é renderizada uma única vez para a fronteira inteira, e sua saída vai para o diretório ao qual o directory: e o subDirectory: próprios da fronteira são avaliados para ela. Um provedor que combina sua saída em um único documento — compose, em um único docker-compose.yaml; cloudformation, em uma única stack — grava a contribuição de uma Feature assim apenas como parte do arquivo que monta ali a partir dos componentes da fronteira. Esse arquivo só existe onde a saída de pelo menos um componente chega ao mesmo diretório sob o mesmo provedor.

Ele não existe onde os componentes da fronteira chegam a outro lugar: quando estão em fronteiras aninhadas cujo subDirectory: os envia para outro lugar — "{{ .component_id }}", por exemplo, para que cada componente tenha um arquivo próprio — ou sob um diretório que a saída da Feature não compartilha. Nada é montado no diretório da Feature, então sua saída não seria gravada em lugar nenhum — para a ponte compose, um serviço de gateway que nenhum arquivo contém — e a build relataria sucesso. Em vez disso, a build é interrompida.

Uma Feature cujo provedor grava cada contribuição como arquivos próprios — helm, helm-chart e terraform — não é afetada: esses arquivos são gravados quer algo seja montado ao lado deles, quer não.

Mensagem emitida — um achado por Feature infratora, posicionado em sua entrada sob o features: da fronteira, que nomeia a fronteira, a Feature, o caminho de despacho para o qual sua saída foi encaminhada e o provedor:

boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (a saída da Feature de escopo de fronteira é encaminhada para um caminho de despacho em que nada é montado (com a fronteira, a instância de Feature, o caminho de despacho e o provedor indicados). vincule a Feature a uma fronteira cujo caminho de saída também receba seus componentes, ou dê aos componentes da fronteira o diretório para o qual a saída da Feature é encaminhada)

Uma ponte compose vinculada a uma fronteira pai bridge, cuja única fronteira filha coloca cada componente sob subDirectory: "{{ .component_id }}", imprime:

[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to

Onde mais de uma Feature é infratora, os achados chegam juntos sob o relato boundary-level Features whose output is routed to a dispatch path nothing assembles.

Como corrigir: faça com que o diretório da Feature seja um em que os componentes da sua fronteira também cheguem. Vincule a Feature a uma fronteira cujo próprio caminho de saída receba esses componentes, ou dê aos componentes o diretório para o qual a saída da Feature é encaminhada — para fronteiras filhas, directory: "{{ .parent_boundary.directory }}" sem um subDirectory: próprio, para que compartilhem o arquivo da fronteira pai. A mensagem nomeia o diretório para o qual a saída da Feature foi encaminhada, que é o que deve ser compartilhado.

Path-template references a variable outside the allowlist (O template de caminho referencia uma variável fora da lista de permissões)

Um template directory: ou subDirectory: referencia um nome de variável que a lista de permissões de variáveis de templates de caminho não inclui — por exemplo, um erro de digitação como {{ .parmaeters.region }}, ou um campo que existe no contexto de renderização da Recipe, mas não é exposto aos templates de caminho (como .context.inject ou .values). A mesma interrupção cobre {{ .component_id }} em um template directory:: a variável existe, e templates subDirectory: podem lê-la, mas o directory: de uma fronteira é avaliado uma única vez para a fronteira inteira, e não uma vez por componente, então ali uma variável por componente faria o caminho emitido depender de qual componente por acaso foi avaliado primeiro.

Os templates de caminho são validados no momento da análise, antes de qualquer trabalho de renderização começar, em relação às variáveis que o contexto de templates de caminho define, menos as que a superfície em questão recusa. O compilador também avalia os templates de caminho com a semântica missingkey=error, então uma referência que está na lista de permissões, mas não está definida no momento da avaliação, produz um erro explícito em vez de renderizar silenciosamente uma string vazia em um caminho de diretório.

Essa interrupção diz respeito à variável. Uma chave digitada errado sob uma variável permitida — {{ .manifest.recipe_nmae }} — relata em vez disso “Template references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define)” mais acima, nomeando as chaves que .manifest define, porque a própria variável foi admitida e só a chave estava errada.

Mensagem emitida:

path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (o template de caminho referencia um campo que não está na lista de permissões documentada (com o caminho indicado, escrito no campo indicado; o contexto de renderização define as variáveis indicadas))

Como corrigir: corrija o nome do campo para um que esteja na lista de permissões dos templates de caminho, ou remova a referência. A lista de permissões para directory: é {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }} e {{ .parent_boundary.* }}; subDirectory: acrescenta {{ .component_id }}. Outras superfícies (valuesMapping da Recipe, injectMapping da FeatureRecipe etc.) usam uma forma de contexto diferente; referências a .context.*, .values, .infra ou .locals deliberadamente não são expostas aos templates de caminho porque a emissão de caminhos é uma questão estrutural, não uma questão de renderização de valores.

Path collision: two contributors emit at incompatible paths (Colisão de caminhos: dois contribuidores emitem em caminhos incompatíveis)

Duas fronteiras cujas declarações de caminho são avaliadas para o mesmo caminho de montagem passam por provedores diferentes. Ambos montam ali, e cada um grava arquivos dos quais o outro não sabe nada, então um substitui silenciosamente o outro no disco — e a build que produziu a saída substituída parece ter sido bem-sucedida.

O subDirectory: padrão dá a cada provedor um subcaminho próprio, então dois provedores chegam a um mesmo caminho apenas onde as declarações foram escritas para serem avaliadas da mesma forma: duas fronteiras que compartilham um directory: e que fixam ambas subDirectory: no mesmo literal, por exemplo.

Mensagens emitidas. Um achado é relatado por fronteira contribuidora, então cada fronteira cuja saída chegou ao caminho é nomeada separadamente, em vez de agrupada em uma lista dentro de uma única mensagem. A falha é dois provedores se encontrarem em um mesmo caminho, então há sempre pelo menos dois achados, e eles chegam juntos sob um relato que informa o que têm em comum:

assembly paths reached by more than one provider (caminhos de montagem alcançados por mais de um provedor)

Cada achado nomeia o caminho, a fronteira cuja saída chegou a ele e o provedor pelo qual essa fronteira passa:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (o caminho de despacho produziu várias saídas de provedor (com o caminho, a fronteira e o provedor indicados))

Uma build cujas fronteiras api-net e db-net declaram ambas directory: ./dist/shared e subDirectory: merged, uma encaminhada por helm e a outra por compose, imprime:

[OPS_ERROR E0048]
assembly paths reached by more than one provider
caused by (2):
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "db-net", provider "compose")
---
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "api-net", provider "helm")

O relato traz o código curto e cada achado abaixo dele traz apenas sua categoria, que é a forma que todo relato de falhas coletadas usa — consulte error-translation.md para essa gramática.

Como corrigir: dê a cada fronteira um directory: distinto (para que se montem em caminhos separados), ou deixe subDirectory: no seu valor padrão para que a saída de cada provedor chegue a um subcaminho próprio. O padrão da ponte compose reúne intencionalmente duas subfronteiras em um único caminho de montagem; esse padrão exige que ambas as fronteiras tenham como alvo o mesmo provedor e tragam anotações resolvidas em cascata compatíveis.

A boundary’s output directory is not a directory beneath the output root (O diretório de saída de uma fronteira não é um diretório sob a raiz de saída)

O directory: e o subDirectory: de uma fronteira são avaliados e unidos no diretório sob o qual sua saída é gravada, e esse caminho é normalizado uma vez: out/a, out//a, ./out/a e out/a/ são um único diretório. Onde o caminho normalizado não é um diretório sob a raiz de saída, a build para antes que qualquer coisa seja gravada. Trata-se de um caminho que sobe para fora da raiz de saída (.., ../escape, a/../..), de um caminho absoluto (/srv/out), ou de um que não nomeia diretório nenhum: um valor vazio, ou um que se normaliza na própria raiz de saída, como directory: "." com o subdiretório desativado.

O caminho é verificado tal como foi avaliado, então é o resultado de um template que é julgado, não o texto escrito. A mensagem nomeia o campo de onde vem a falha — directory: onde o diretório sozinho já sai da raiz de saída ou onde nenhum subdiretório é unido a ele, e subDirectory: nos demais casos — junto com o valor para o qual esse campo foi avaliado e o caminho que ele produziu.

Mensagem emitida:

boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (o diretório de saída da fronteira não nomeia um diretório sob a raiz de saída (com a Release, a fronteira, o valor de directory e o caminho de saída indicados). escreva um diretório sob a raiz de saída, como “deploy/prod” — sem “/” inicial, sem “..” subindo acima dela, e não a própria raiz de saída)

Onde a falha está no subdiretório, o terceiro valor traz subDirectory: "<value>" em vez disso.

Como corrigir: escreva o campo que a mensagem nomeia como um diretório sob a raiz de saída. Um diretório que deveria ficar ao lado da raiz de saída deve, em vez disso, ficar dentro dela. Para gravar a saída de uma fronteira diretamente no seu directory:, defina subDirectory: "." — o próprio diretório ainda precisa nomear um diretório próprio.

A boundary-level Feature is named . or .. (Uma Feature de escopo de fronteira se chama . ou ..)

Um provedor que dá a cada contribuidor um diretório próprio — terraform, sob modules/, e helm-chart, sob charts/ — coloca uma Feature vinculada a uma fronteira em um diretório nomeado apenas pela instância, ao lado dos componentes da fronteira. A chave features: de uma fronteira admite . e .., e nenhum dos dois é um nome de diretório: . colocaria os arquivos da Feature no diretório que contém todos os contribuidores, e .. no diretório acima dele, então os arquivos iriam parar fora da posição que o provedor deu à Feature. Em vez disso, a build para. Qualquer outro nome não é alterado, incluindo um com pontos como audit.v2.

Mensagem emitida:

boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (o nome de instância da Feature de escopo de fronteira não é um nome de diretório (com a Release, a fronteira e a instância de Feature indicadas). renomeie a instância de Feature sob os features da fronteira para um nome comum, como “audit”)

Como corrigir: renomeie a instância sob o features: da fronteira para um nome comum.

Instance-ID collision across boundaries assembling to the same path (Colisão de ID de instância entre fronteiras que se montam no mesmo caminho)

Duas fronteiras que se montam na mesma tupla (caminho, provedor) contribuem com componentes com IDs de instância idênticos. A montagem mesclada não consegue distinguir os dois fragmentos de componente — um único chart Helm não pode conter dois Deployments chamados web-server, e um único arquivo docker-compose não pode conter dois serviços chamados api.

Mensagem emitida:

multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (vários contribuidores compartilham um ID de instância no mesmo caminho de despacho: o caminho de despacho e o provedor indicados já contêm o nó indicado (com as fronteiras contribuidoras indicadas); os IDs de instância dos componentes precisam ser únicos dentro de um grupo de montagem)

Como corrigir: renomeie um dos componentes em colisão no Aggregate, ou separe as duas fronteiras em caminhos directory: distintos para que cada instância de componente chegue à sua própria montagem.

Two contributors write the same output path (Dois contribuidores escrevem o mesmo caminho de saída)

Dois contribuidores de uma mesma montagem produzem um arquivo no mesmo caminho de saída. Isso é diferente da colisão de ID de instância acima: os componentes têm nomes diferentes e a montagem consegue distingui-los — são os arquivos que eles emitem que vão parar em um mesmo caminho. Isso acontece com mais frequência quando um provedor escreve a saída de cada contribuidor lado a lado em vez de sob uma posição por componente, de modo que dois componentes cujas Recipes emitem o mesmo nome de arquivo (duas entradas artifacts: ambas chamadas main.tf, por exemplo) se encontram em um mesmo caminho. A saída própria do montador pode colidir com o arquivo de um contribuidor da mesma forma.

Se dois contribuidores que emitem um mesmo nome de arquivo colidem depende de onde o provedor deles os posiciona. Um provedor que aninha cada contribuidor sob sua própria posição na montagem mantém separados dois arquivos de mesmo nome; um provedor que escreve os contribuidores lado a lado, não. A comparação é feita sobre o caminho final em que um arquivo seria escrito, não sobre o nome que o contribuidor emitiu, então o caso aninhado não é relatado.

A build é interrompida em vez de escrever um dos dois arquivos e descartar o outro. Não existe uma resolução silenciosa correta: renomear um arquivo ou acrescentar-lhe um sufixo inventaria um nome que ninguém escreveu, e mesclar seus conteúdos inventaria um documento que ninguém redigiu. Todo caminho em colisão é relatado, e todo contribuidor que o escreve é nomeado, de modo que uma única build mostra o quadro completo em vez de uma colisão de cada vez.

Mensagens emitidas. Um achado é relatado por caminho em colisão — uma única vez, não importa quantas fronteiras tenham alimentado a montagem em que ela ocorreu —, de modo que uma build cujos contribuidores se encontraram em dois caminhos informa você sobre ambos e nenhuma colisão é relatada duas vezes:

assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (colisão na saída montada: dois contribuidores escrevem o mesmo caminho de saída (com o caminho de saída, os contribuidores que o escrevem e as fronteiras dentro das quais ele foi montado indicados))

Cada contribuidor é nomeado pelo que ele é, o que indica onde seu nome está escrito: component <name> para uma instância de componente, feature <name> para uma funcionalidade vinculada a uma fronteira, e the <provider> assembly para a saída mesclada própria da montagem. Os contribuidores são listados em ordem de nome, então a frase é a mesma em toda build da mesma entrada.

Um arquivo com que uma Recipe contribui para a saída compartilhada da fronteira também está sujeito a essa regra. O bloco boundary: de uma Recipe escreve seus arquivos ao lado da saída montada própria do provedor, uma vez por nome de arquivo. Vários componentes que declaram um nome com bytes idênticos são um único arquivo e nunca colidem; declará-lo com bytes diferentes colide aqui, nomeando o arquivo e cada componente que o declarou, e o mesmo vale para um nome que a própria montagem do provedor escreve — aggrega.modules.tf para terraform, por exemplo, que nomeia the terraform assembly entre os contribuidores. Um arquivo que vários componentes declararam de forma idêntica e que encontra o arquivo próprio da montagem é nomeado com todos eles, como component <name-1> and component <name-2>.

As fronteiras que alimentaram a montagem também são nomeadas, e são listadas em vez de destacadas individualmente. Fronteiras cujas declarações directory: são avaliadas da mesma forma são montadas como uma só, e nada em uma colisão diz em qual delas os contribuidores que se encontraram foram declarados — então o achado mostra cada fronteira cuja declaração poderia separá-los e não afirma de nenhuma delas que seja aquela em que está a falha. O achado é relatado sobre o documento da Release como um todo pelo mesmo motivo: nomear uma fronteira dentro dele levaria você a um documento que talvez não tenha contribuído com nada para o caminho.

Onde mais de um caminho colide, os achados chegam juntos sob um relato que indica o que eles têm em comum:

assembled output paths written by more than one contributor (caminhos da saída montada escritos por mais de um contribuidor)

Como corrigir: renomeie o arquivo emitido na Recipe que você controla — uma chave de artifacts:, a chave de um bloco boundary:, ou o nome de arquivo que uma tradução de Workload deriva — para que os dois não se encontrem mais. Onde duas Recipes declaram um mesmo arquivo compartilhado e querem dizer a mesma configuração, torne as declarações delas idênticas byte a byte. Onde os dois contribuidores realmente pertencem a saídas separadas, dê às fronteiras deles caminhos directory: distintos para que cada uma seja montada separadamente.

The same name is derived more than once inside the output (O mesmo nome é derivado mais de uma vez dentro da saída)

Uma montagem acaba usando o mesmo nome duas vezes para algo dentro dos arquivos que emite, em um ponto onde só há espaço para um. Isso acontece de duas formas: dois contribuidores derivam o mesmo nome, ou a saída própria de um único contribuidor traz esse nome duas vezes. Isso é diferente das duas colisões acima: onde dois contribuidores estão envolvidos, os componentes têm nomes diferentes e seus arquivos vão parar em caminhos diferentes, então nada na estrutura da montagem está errado — é um nome no conteúdo, como o identificador que um destino usa para endereçar um recurso, ou o nome sob o qual uma saída é publicada para que outra a referencie.

Quais nomes são comparados decorre do que o provedor faz com a saída de uma montagem. Onde o provedor mescla essa saída em um único documento — um template de stack, um arquivo compose —, os nomes dentro desse documento são comparados entre si, e um contribuidor cuja saída é escrita como arquivos separados próprios fica fora dele. Seus nomes não encontram os de mais ninguém, então nada é interrompido entre eles, e nada que você pudesse renomear mudaria isso. Onde, em vez disso, o provedor escreve a saída de cada contribuidor como arquivos próprios — uma renderização de chart, um conjunto de manifestos —, cada contribuidor da montagem é comparado com todos os outros, porque um nome em uma saída desse tipo é único em tudo o que lê esses arquivos como um conjunto, e não dentro de um único arquivo.

Os recursos próprios de uma FeatureRecipe seguem o mesmo caminho que os do seu componente hospedeiro, porque uma vinculação contribui para a montagem à qual seu hospedeiro pertence. Assim, onde o provedor mescla, os nomes de uma vinculação são comparados com os do seu componente hospedeiro e com os de todas as outras vinculações, exatamente como os nomes de dois componentes: todos acabam dentro do único documento, e de dois nomes iguais um substitui o outro ali. Onde o provedor não mescla, os recursos da vinculação são escritos sob um diretório que nomeia o componente ao qual ela está vinculada, e seus nomes ainda são comparados com cada contribuidor da montagem — que é onde uma identidade de recurso que precisa ser única em todo um cluster é detectada. A comparação é, portanto, a mesma nos dois casos, e o que difere é apenas onde o nome que seria substituído acaba ficando.

Uma metade da interrupção não é afetada por nada disso: a saída própria de um único contribuidor trazendo um nome duas vezes. Trata-se de um nome usado duas vezes dentro de uma saída que um único contribuidor escreveu, então ela interrompe a build onde quer que essa saída tenha sido escrita, e as duas coisas a separar estão sempre dentro dela.

A maioria desses nomes pertence a um provedor, derivados da instância de componente e do recurso, então dois componentes podem chegar a um mesmo nome sempre que as partes das quais ele é derivado coincidirem — e um componente pode chegar duas vezes a um mesmo nome da mesma forma, quando dois de seus próprios recursos são construídos a partir de partes que coincidem. Como o nome vive nos próprios bytes do arquivo, a montagem não consegue vê-lo: o provedor relata os nomes que derivou, e a build os compara.

Um tipo de nome pertence à build e não a um provedor, e é relatado da mesma forma: a identidade com que é rotulado cada recurso que uma FeatureRecipe emite, que chega à sua saída como o rótulo aggrega.ai/component-id. Ela é relatada sob o tipo de nome component-id, para que você possa encontrar a mesma string na sua própria saída emitida. Onde uma FeatureRecipe sintetiza seus recursos, essa identidade é também aquilo a partir do qual eles são nomeados; onde ela renderiza um chart ou um fragmento fornecido pelo autor, os nomes dentro dessa renderização continuam sendo os do componente hospedeiro e apenas os rótulos trazem a identidade.

Para uma funcionalidade vinculada a um componente, ela é composta a partir do componente ao qual a funcionalidade está vinculada e da chave que você escreveu sob features:, após um prefixo fixo. O componente hospedeiro faz parte do valor porque um mesmo nome de funcionalidade vinculado a vários componentes emite um conjunto separado de recursos em cada um, e cada conjunto precisa de uma identidade própria.

Para uma funcionalidade vinculada a uma fronteira, ela é composta a partir do nome da funcionalidade e de cada segmento do caminho da fronteira, após um prefixo próprio. Os dois casos compõem em vez de substituir: um caractere que o alfabeto de rótulos recusa é transcrito em vez de substituído, e as partes são unidas por uma sequência que nenhuma parte escrita pode conter, então duas vinculações que você consegue distinguir sempre chegam a duas identidades. O único resíduo é o comprimento: uma identidade composta longa demais para o valor de um rótulo é encurtada em torno de um digest da sua totalidade, e duas identidades encurtadas podem, em princípio, se encontrar. Esta interrupção relata um encontro desse tipo entre dois contribuidores cujos nomes são comparados, e duas vinculações em um componente são dois contribuidores desse tipo onde quer que o provedor do seu hospedeiro as monte juntas. Veja ../providers/well-known-annotations.md para saber como cada uma é construída.

Uma renderização do Kubernetes relata um tipo de nome próprio: o nome que cada recurso produzido pela sua própria renderização traz em seu metadata.name. Um nome desse tipo precisa ser único dentro do seu kind — e, para um tipo que o cluster mantém em namespaces, dentro do seu namespace — e não em toda a saída, então o tipo de nome diz a qual desses escopos ele se restringe. Ele começa com resource-names e depois traz o kind do recurso e o namespace em que o recurso fica, que é aquele que o recurso nomeia para si mesmo ou, onde ele não nomeia nenhum, aquele com que a fronteira está anotada. Assim, resource-names:Service--default são os nomes dos Services que ficam em default. Um tipo que a API do Kubernetes mantém fora de todo namespace — um ClusterRole, uma StorageClass, uma CustomResourceDefinition — e um tipo personalizado que uma CustomResourceDefinition na mesma renderização declara com o escopo Cluster trazem apenas o seu kind, qualquer que seja o namespace que o documento deles escreva: resource-names:ClusterRole são os nomes de todo ClusterRole que a saída traz. Tudo o que está fora das letras e dos dígitos é transcrito em vez de substituído e as duas partes são unidas por uma sequência que nenhuma parte escrita pode conter, então dois pares diferentes nunca chegam a um mesmo tipo de nome, e um tipo sozinho nunca chega ao tipo de nome de um tipo e um namespace. Um Service e um Deployment podem compartilhar um nome, e dois namespaces contêm um mesmo nome de um tipo com namespace de forma independente, então nenhum desses casos interrompe a build. O próprio nome é relatado exatamente como o seu chart o escreveu, o que o torna a string a procurar nos seus templates.

Assim, dois contribuidores de uma mesma saída que escrevem cada um um mesmo objeto de escopo de cluster sob um mesmo nome interrompem a build mesmo onde a Release os coloca em dois namespaces, porque aplicar ambos escreve esse único objeto duas vezes; e um chart que escreve um objeto desse tipo sob dois namespaces diferentes, que a renderização emite como dois arquivos, interrompe a build como um único contribuidor que traz o nome duas vezes. Um tipo que nada na renderização classifica — um tipo personalizado cuja CustomResourceDefinition a renderização não emite, ou um documento que não nomeia nenhum apiVersion — é comparado dentro do seu namespace, como um tipo com namespace, porque nada na renderização diz que o cluster o mantém fora de um; dois contribuidores que escrevem um objeto desse tipo em dois namespaces, portanto, não se encontram.

Os nomes são comparados entre os contribuidores de uma mesma saída, e nunca entre duas saídas. Duas fronteiras são duas saídas quando cada uma tem um diretório próprio — um que ela nomeia, ou aquele que cada fronteira que não nomeia nenhum directory: recebe — e nada em uma build diz se duas saídas são aplicadas a um mesmo cluster ou a dois: a CustomResourceDefinition de um mesmo operador enviada a cada um de dois clusters é o mesmo nome em duas saídas, e isso está correto. Assim, duas fronteiras que escrevem cada uma um mesmo objeto de escopo de cluster sob um mesmo nome não interrompem a build mesmo onde ambas são aplicadas a um mesmo cluster; onde forem, emita o objeto a partir de apenas uma delas.

A disposição que chega a esta interrupção com mais frequência é a de duas Features vinculadas a um mesmo componente, cada uma entregando um chart fornecido pelo seu autor. Os dois charts são renderizados com o mesmo nome de release — o do componente hospedeiro, para que vincular um chart não renomeie recursos que o autor dele já declarou e implantou — e nomear um recurso com base no nome de release está entre as coisas mais comuns que um chart faz. Nada na estrutura da saída está errado: os dois recursos simplesmente trazem um mesmo nome. Onde o provedor do componente escreve documentos separados, cada vinculação escreve sob um diretório próprio e aplicar ambas deixa a que foi aplicada por último; onde ele reúne seu grupo em um único documento, as duas vinculações contribuem para esse documento e um dos dois nomes substitui o outro dentro dele. Renomeie o recurso no chart que você controla, ou dê a ele um nome que traga algo que distinga as duas vinculações — e é a vinculação que precisa chegar ao template, porque os dois charts são renderizados com o nome de release do hospedeiro, então renomear apenas a vinculação não muda nada. Passe .attachment_name para o chart por meio do valuesMapping: da FeatureRecipe, e defina-o naquele dos valores próprios do chart a partir do qual os nomes dos seus recursos são construídos.

Uma segunda disposição chega à mesma interrupção com uma única Feature em vez de duas: um chart cujo template escreve um nome de recurso como literal, vinculado a dois componentes. Cada hospedeiro o renderiza com um nome de release próprio, então o literal é a única razão pela qual as duas cópias trazem um mesmo nome — nomeie o recurso com base em .Release.Name e o hospedeiro volta a fazer parte dele, que é o que um chart que constrói os nomes dos seus recursos a partir da sua identidade de release já faz.

Uma terceira disposição tem a mesma estrutura, uma superfície de autoria mais para dentro: uma FeatureRecipe que entrega seus recursos por meio de artifacts: em vez de por meio de um chart, vinculada sob um mesmo nome a dois componentes, cujo corpo escreve um nome de recurso como literal. A saída de cada vinculação fica sob um diretório que nomeia seu hospedeiro, então os caminhos emitidos diferem e nada na estrutura da saída está errado — mas os dois corpos trazem o mesmo nome, e aplicar ambos deixa o que foi aplicado por último. Um nome em um corpo de artifacts é comparado exatamente como um nome que um chart renderizou: os dois descrevem o mesmo recurso no mesmo cluster, então de onde o nome veio não faz diferença para o que acontece quando ambos são aplicados. Essa leitura depende de os dois nomes serem lidos juntos, o que acontece onde um provedor escreve a saída de cada contribuidor como arquivos que um destino lê como um único conjunto. Onde, em vez disso, o provedor mescla a saída de uma montagem em um único documento, os arquivos de cada vinculação ficam fora desse documento e um nome dentro de um deles se restringe a ele, então duas vinculações desse tipo nunca se encontram e a build prossegue.

Nem todo nome é relatado, então uma build que não é interrompida não estabeleceu que todo nome que sua saída acabará trazendo foi comparado. Um recurso cuja nomeação fica a cargo do cluster — um que declara generateName em vez de name — ainda não traz nenhum nome, então não há nenhum a relatar. E um nome escrito em algum outro campo para que um controlador o leia depois não é um nome de recurso, então nada o compara. Os dois limites são propriedades da leitura do documento emitido, então ambos se aplicam a um corpo de artifacts exatamente como se aplicam a um template de chart renderizado.

Um corpo de artifacts: é um template, então um nome dentro dele que precisa ser distinto em cada hospedeiro é composto em vez de escrito como literal. .context.rendered_name é o nome que o próprio provedor do componente hospedeiro lhe dá — sob helm, o nome de release dele, escrito nos caracteres que um nome do Kubernetes permite — e .attachment_name é a chave sob a qual você o vinculou, então {{ .context.rendered_name }}-{{ .attachment_name }} dá a um recurso um nome próprio em cada hospedeiro e sob cada vinculação. Em um hospedeiro cujo provedor não relata nenhum nome desse tipo, componha-o a partir de .context.instance_id, a identidade do hospedeiro, em vez disso. Um único corpo escrito chega a cada hospedeiro ao qual está vinculado trazendo os nomes que contiver, e um literal é o mesmo em todos eles — então dê essa estrutura a um nome que precise ser único no cluster.

Nada do significado de um nome é interpretado — dois nomes relatados são o mesmo texto ou não são —, e é por isso que o mesmo relato abrange todo tipo de nome, seja quem for que o tenha derivado.

Um nome pode aparecer em mais de um relato para um mesmo componente, porque cada parte de um componente é relatada à medida que é renderizada. Trata-se de um único recurso nomeado em cada relato ao qual pertence, não de um nome usado duas vezes, e isso não interrompe a build. O que interrompe a build é um único relato que traz um nome duas vezes, porque esse relato descreve uma saída em que o nome é realmente usado duas vezes.

Essa leitura depende do que conta como um único contribuidor, e para o tipo component-id a resposta é a vinculação, e não o componente ou a fronteira em que ela está. Uma vinculação é identificada pelas duas coordenadas que você escreveu para ela — o componente ao qual está vinculada junto com a chave sob features:, ou o caminho da fronteira junto com o nome nessa fronteira —, então duas vinculações em um componente são dois contribuidores, exatamente como duas em componentes diferentes, e um nome de funcionalidade escrito em duas fronteiras são dois contribuidores, mesmo que o nome seja o mesmo em cada uma. Ser dois contribuidores é o que torna as identidades deles comparáveis em cada uma dessas disposições; se dois deles chegam a ser comparados segue a mesma regra que qualquer outro nome aqui, então, onde o provedor mescla, uma vinculação cuja saída é escrita como arquivos separados próprios fica fora do documento mesclado e é comparada apenas consigo mesma. Duas vinculações que chegam a uma mesma identidade, portanto, interrompem a build onde quer que a saída de uma possa alcançar a da outra, e cada achado nomeia as suas duas coordenadas para que você saiba quais duas coisas separar. Como as duas coordenadas fazem parte do valor composto, duas vinculações que você consegue distinguir chegam a duas identidades em qualquer comprimento que caiba — então a disposição que chega a esta interrupção é aquela em que um valor longo demais para o seu destino foi encurtado e dois valores encurtados se encontraram. Onde duas identidades encurtadas se encontram e a saída de uma não pode alcançar a da outra — duas vinculações em um componente, sob um provedor que mescla, cada uma escrita como arquivos separados próprios —, nada as compara, e os dois conjuntos de recursos trazem entre si um mesmo aggrega.ai/component-id.

Uma disposição merece ser declarada explicitamente porque parece que deveria interromper a build e não interrompe: vincular uma funcionalidade sob o mesmo nome em dois componentes é totalmente suportado e não exige nenhuma renomeação. O componente faz parte do valor composto, então metrics em api e metrics em web chegam a duas identidades e os recursos de cada componente recebem uma identidade própria — o que importa porque uma cascata que, intencionalmente, cunha um mesmo nome de vinculação em muitos componentes não deixa ao autor nenhum outro nome para escrever. Toda forma pela qual uma FeatureRecipe entrega recursos coloca a identidade dela no que ela emite, inclusive aquela que apenas incorpora uma fonte e a renderiza como está, então todas elas são comparadas; uma funcionalidade cuja FeatureRecipe não emite nada não tem nada a comparar.

A build é interrompida em vez de manter um e descartar o outro. Não existe uma resolução silenciosa correta: manter o primeiro removeria por completo da saída um recurso que você declarou e deixaria a build relatando sucesso, e tudo o que referenciasse o removido passaria silenciosamente a se resolver para o que restou. Todo nome em colisão é relatado, cada um com o tipo de nome que é e com cada contribuidor que o derivou nomeado — de modo que uma única build mostra o quadro completo em vez de uma colisão de cada vez. Um contribuidor cuja saída própria traz o nome duas vezes é nomeado como tendo derivado o nome mais de uma vez, e é isso que indica que as duas coisas a separar estão dentro desse único componente, e não entre dois deles.

Mensagens emitidas. Um achado é relatado por contribuidor e por nome em colisão, de modo que cada contribuidor que derivou o nome é nomeado por si só, em vez de agrupado em uma lista dentro de uma única mensagem. Onde dois contribuidores derivaram o nome há pelo menos dois achados, e eles chegam juntos sob um relato que indica o que eles têm em comum:

dispatch groups whose contributors derive one name more than once in one key space (grupos de despacho cujos contribuidores derivam um mesmo nome mais de uma vez em um mesmo espaço de chaves)

Cada achado nomeia o nome, o tipo de nome que ele é, o contribuidor que o derivou, e o provedor e o caminho da montagem na qual a saída deles é mesclada:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (colisão de nomes derivados: um mesmo nome é derivado mais de uma vez em um mesmo espaço de chaves (com o nome, o espaço de chaves, o componente que o derivou, o provedor e o caminho de despacho indicados))

O contribuidor é nomeado pelo que ele é, o que indica onde seu nome está escrito: derived by component para uma instância de componente, e derived by feature para uma funcionalidade vinculada a uma fronteira.

Onde o próprio nome do contribuidor não o identifica por si só, segue-se uma segunda coordenada, e qual ela é depende do tipo. Uma funcionalidade vinculada a uma fronteira traz o caminho da fronteira, porque um mesmo nome de funcionalidade pode ser escrito em mais de uma fronteira:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (colisão de nomes derivados: um mesmo nome é derivado mais de uma vez em um mesmo espaço de chaves (com o nome, o espaço de chaves, a funcionalidade que o derivou, a fronteira à qual está vinculada, o provedor e o caminho de despacho indicados))

Um componente traz a chave da vinculação cuja renderização derivou o nome, porque um componente traz uma vinculação por chave que você escreveu:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (colisão de nomes derivados: um mesmo nome é derivado mais de uma vez em um mesmo espaço de chaves (com o nome, o espaço de chaves, o componente que o derivou, a vinculação que ele traz, o provedor e o caminho de despacho indicados))

A renderização própria de um componente — um nome que o provedor dele derivou para o próprio componente, e não para uma de suas vinculações — não traz nenhuma segunda coordenada, então o achado termina no nome do componente.

Onde a saída própria de um único contribuidor traz o nome duas vezes, esse contribuidor é o único achado, então ele chega sozinho, sem nenhum relato acima dele — e é nomeado como tendo derivado o nome mais de uma vez, em vez de como tendo encontrado outro contribuidor:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (colisão de nomes derivados: um mesmo nome é derivado mais de uma vez em um mesmo espaço de chaves (com o nome, o espaço de chaves, o componente que o derivou mais de uma vez, o provedor e o caminho de despacho indicados))

A segunda coordenada segue o contribuidor aqui nos mesmos termos de acima, então uma repetição dentro da saída própria de uma vinculação nomeia essa vinculação, e não apenas o componente que a traz.

Como corrigir: onde dois contribuidores são nomeados, renomeie um deles no Aggregate, para que os nomes derivados dele não coincidam mais com os do outro. Onde o tipo de nome é component-id, cada achado já nomeia o que renomear: carrying attachment "…" é a chave sob o bloco features: desse componente, e um feature "…" attached at boundary "…" é o nome sob o bloco features: dessa fronteira. Onde os dois achados diferem apenas na fronteira que nomeiam, as duas vinculações trazem um mesmo nome em duas fronteiras — renomeie uma delas, ou dê às duas fronteiras caminhos directory: distintos para que a saída delas não seja mais mesclada. Onde os dois nomes são nomes que a build compôs, eles só podem ter se encontrado depois de serem encurtados para caber no destino, então encurte você mesmo as partes das quais eles são compostos, em vez de deixar isso para a build. Onde os dois nomes são derivados de algo que você definiu explicitamente — um valor que a Recipe passa ao provedor, ou uma anotação que o provedor lê —, altere isso, em vez disso, naquele dos dois que você controla. Onde os dois contribuidores realmente pertencem a saídas separadas, dê às fronteiras deles caminhos directory: distintos para que cada uma seja montada separadamente e os dois nomes nunca se encontrem. Onde um único contribuidor é nomeado como tendo derivado o nome mais de uma vez, as duas coisas em colisão estão ambas dentro desse único componente: encontre os dois recursos que a Recipe dele produz cujos nomes coincidem, e mude aquilo com base no qual um deles é nomeado — a chave sob a qual ele é declarado, ou um valor a partir do qual ele é construído — para que o provedor derive um nome distinto para cada um. Onde o tipo de nome é apenas um tipo de escopo de cluster, como resource-names:ClusterRole, os documentos nomeados descrevem um único objeto no cluster, quaisquer que sejam os namespaces em que foram colocados: emita-o a partir de um único contribuidor — por meio de um valor que o chart dele oferece, como uma opção para instalar as definições dele — ou, onde os dois devem ser dois objetos, dê a um deles um nome próprio no chart ou no corpo que você controla; um único contribuidor nomeado duas vezes por ele o escreve sob dois namespaces, e um dos dois documentos é o que deve ser removido.

An authored export name is one the build derives for a cross-stack reference (Um nome de exportação escrito é um que a build deriva para uma referência entre stacks)

O bloco Outputs: de uma Recipe cloudformation é CloudFormation escrito pelo autor, e uma entrada nele pode trazer o seu próprio Export: com um Name:; esse nome chega à stack montada exatamente como foi escrito. Separadamente, quando uma aresta uses passa de uma fronteira para outra, o provedor publica o valor consumido como um Output da stack com um Export sob um nome que ele deriva da release, da fronteira, do componente e da chave fornecida. Esta interrupção ocorre onde os dois se encontram: o nome que você escreveu é o nome que a derivação produziu para a mesma build, então a stack declararia um mesmo nome de exportação duas vezes a partir de dois lugares, e um nome de exportação precisa ser único.

Somente a coincidência interrompe a build. Declarar um nome de exportação em uma entrada Outputs é suportado, e um que não coincide com nenhum nome derivado é publicado ao lado dos derivados sem comentários — em toda entrada exceto a saída da stack na qual uma referência entre stacks publica a sua própria exportação, para uma chave que ela consome. Um Export: ali interrompe a build, a menos que traga exatamente o nome derivado; esse caso é The output a cross-stack reference publishes on already carries an Export (A saída na qual uma referência entre stacks publica já traz um Export).

A interrupção informa o nome de exportação derivado junto com as quatro partes a partir das quais ele foi construído, para que você veja qual referência entre fronteiras o produziu, e nomeia a saída da stack sob a qual a sua declaração está — marcada como um nome que o provedor monta, e não como um que uma Recipe escreveu, porque o provedor constrói esse nome codificando o componente e a entrada nas letras e nos dígitos que um ID lógico admite, então esse nome não é a string com que qualquer um dos dois foi escrito. O nome de exportação é a parte a procurar. A sua entrada o escreve exatamente como a interrupção, o que faz dos dois uma colisão, então ele é a única string que aparece tanto na mensagem quanto nos seus próprios arquivos.

A comparação se restringe a uma única stack: os nomes de exportação que essa stack declara, comparados com os nomes derivados para as referências entre fronteiras que publicam nela. Duas stacks não são comparadas entre si, e um nome de exportação escrito como uma função intrínseca do CloudFormation é resolvido no momento da implantação, então não há nenhum nome a comparar. O que um nome encontra entre as exportações já implantadas em uma conta e uma região é uma propriedade da implantação, que uma build não observa.

Mensagem emitida. A condição nomeia o tipo de falha e a frase própria do provedor diz o que aconteceu; o relato ao redor também nomeia a aresta uses que está sendo cabeada:

two things a plugin produced occupy one name in its output (duas coisas que um plugin produziu ocupam um mesmo nome na saída dele) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (um nome de exportação que um link entre fronteiras deriva já está declarado por outra entrada Outputs na mesma stack: o link deriva o nome de exportação indicado para a chave provides indicada do componente indicado na fronteira indicada da Release indicada, e outra entrada Outputs da mesma stack já declara esse mesmo nome de exportação — essa declaração está sob a saída da stack indicada, um nome que este provedor monta, e não um que uma Recipe escreveu; cada entrada Outputs que o sombreia escreve seu nome de exportação exatamente como a interrupção, então procurar esse nome nas suas Recipes leva à entrada — renomeie o nome de exportação que a entrada declara, ou remova o bloco Export dessa entrada e deixe o link publicar a exportação)

Como corrigir: procure nas suas Recipes o nome de exportação que a interrupção nomeia — a entrada Outputs que o declara o escreve de forma idêntica — e então renomeie esse nome de exportação para que ele não coincida mais, ou remova o bloco Export: dessa entrada e deixe o cabeamento entre stacks publicar a exportação por conta própria. Removê-lo costuma ser a decisão certa onde a entrada existia para exportar o mesmo valor que a aresta consome: o provedor publica um Export para esse valor de qualquer forma, então o escrito pelo autor não acrescenta nada. Mantenha, em vez disso, o Export: escrito e renomeie-o onde a entrada exporta o valor para um consumidor diferente que o importa sob um nome que você escolheu.

The output a cross-stack reference publishes on already carries an Export (A saída na qual uma referência entre stacks publica já traz um Export)

Quando uma aresta uses passa de uma fronteira para outra, o provedor publica o Export do valor consumido na saída da stack que ele monta para o componente produtor e a chave fornecida — a mesma saída que uma Recipe de cloudformation alcança quando seu bloco Outputs: escreve uma entrada sob essa chave. Um Export: já presente nessa saída só é mantido quando seu Name: é exatamente o nome que o provedor deriva: essa é a exportação que uma referência entre stacks anterior ao mesmo valor já publicou, então todo consumidor importa esse único nome. Qualquer outro Export: ali causa uma interrupção, porque escrever a exportação do provedor sobrescreveria o que você escreveu, e manter o seu deixaria todo consumidor importando um nome que a referência nunca publicou.

A interrupção ocorre em quatro formas de Export: nessa saída:

  • um Name: que é uma string diferente;
  • um Name: escrito como função intrínseca do CloudFormation, que é resolvida no momento da implantação, então o provedor não consegue ler o que ela expressa;
  • um bloco Export: que não nomeia nada;
  • um Export: escrito como valor simples em vez de como bloco.

Um nome de exportação que você declara em qualquer outra entrada Outputs é comparado separadamente, em An authored export name is one the build derives for a cross-stack reference (Um nome de exportação escrito é um que a build deriva para uma referência entre stacks).

Mensagem emitida. A condição nomeia o tipo de falha e a frase própria do provedor diz o que aconteceu; o relato ao redor também nomeia a aresta uses que está sendo cabeada:

two things a plugin produced occupy one name in its output (duas coisas que um plugin produziu ocupam um mesmo nome na saída dele) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (a saída da stack na qual um link entre fronteiras publica sua exportação já traz um Export que o link não escreveu: o link deriva o nome de exportação indicado para a chave provides indicada do componente indicado na fronteira indicada da Release indicada, e a saída da stack que este provedor monta para essa chave e esse componente apresenta o que é indicado; remova o bloco Export dessa entrada e deixe o link publicar a exportação que todo consumidor importa)

<what-it-found> é um dos seguintes, na ordem das formas acima:

already declares the export name <name> (já declara o nome de exportação indicado) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (já declara um nome de exportação que não é uma string — um dado como função intrínseca, que é resolvida no momento da implantação, então este provedor não consegue ler o que ela expressa) already carries an Export block declaring no export name (já traz um bloco Export que não declara nenhum nome de exportação) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (já traz um Export que não é um bloco, onde o CloudFormation espera um que traga um Name)

Como corrigir: na Recipe do componente que a interrupção nomeia, encontre a entrada Outputs escrita sob a chave fornecida que ela nomeia, e remova o bloco Export: dessa entrada — o cabeamento entre stacks passa então a publicar a exportação que todo consumidor importa. Se você também precisar que o valor seja exportado com um nome próprio, para um consumidor fora desta build, escreva esse Export: em uma entrada Outputs sob uma chave diferente: ali um nome de exportação é suportado, desde que não seja um que a build deriva.

Chart-name mismatch on a merged helm-chart umbrella (Nome de chart divergente em um chart guarda-chuva helm-chart mesclado)

Duas ou mais fronteiras contribuem para o mesmo caminho de montagem do provedor helm-chart, mas suas anotações aggrega.ai/chart-name efetivas (resolvidas pela cascata de anotações das fronteiras) não coincidem. Um chart guarda-chuva do Helm tem exatamente um nome de chart; o renderizador não consegue escolher um dos candidatos em conflito.

Mensagens emitidas. É relatado um achado por fronteira contribuidora, cada um trazendo o valor para o qual essa fronteira foi resolvida, então os nomes divergentes chegam um por achado em vez de como uma única coleção impressa. O relato sob o qual chegam informa o que eles têm em comum:

merged dispatch groups whose boundaries disagree on the assembly name (grupos de despacho mesclados cujas fronteiras divergem quanto ao nome de montagem)

Cada achado nomeia o valor para o qual essa fronteira foi resolvida, a anotação da qual ele foi lido, a fronteira, o provedor e o caminho para o qual elas se mesclam:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (a montagem de caminho mesclado tem valores conflitantes para a anotação do nome de montagem (com o valor, a anotação, a fronteira, o provedor e o caminho de despacho indicados))

Como corrigir: declare uma anotação aggrega.ai/chart-name correspondente em cada fronteira contribuidora (o mecanismo de cascata torna isso DRY quando os contribuidores compartilham uma fronteira pai — declare uma vez na fronteira pai), ou separe as fronteiras em caminhos directory: distintos para que cada uma tenha seu próprio chart guarda-chuva.

FeatureRecipe template references a field outside its scope’s allowlist (O template de FeatureRecipe referencia um campo fora da lista de permissões do seu escopo)

Uma FeatureRecipe com executionScope: boundary referencia um campo exclusivo de cada componente, como .context.instance_id, .context.inject ou .context.uses — campos que não têm valor significativo no escopo de fronteira — em um template que é executado uma única vez para a fronteira: seus locals:, provides:, valuesMapping:, artifacts: ou o with: ou o when: de uma etapa de pipeline. A condição espelhada também vale: uma FeatureRecipe de escopo de componente (o padrão) que referencia campos .boundary.* falha no mesmo validador. A validação é executada no momento da análise em relação à lista de permissões de campos do escopo correspondente, antes que qualquer trabalho de renderização comece. O injectMapping de uma FeatureRecipe de escopo de fronteira não é verificado aqui: ele é executado uma vez para cada componente que a vinculação alcança, no contexto desse componente, então lê .context.*, e uma referência a .boundary nele é relatada por “Template references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define)” mais acima.

Mensagem emitida:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (o template de FeatureRecipe referencia um campo exclusivo de cada componente com executionScope: boundary (com o caminho indicado, escrito no campo indicado; o contexto de renderização define as raízes indicadas))

Uma FeatureRecipe de escopo de fronteira cujo valuesMapping lê .context.instance_id imprime:

[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")

Como corrigir: reescreva o template com base nos campos disponíveis no escopo, ou altere o executionScope da FeatureRecipe. FeatureRecipes de escopo de fronteira referenciam .boundary.path, .boundary.boundary_name, .boundary.components, as coleções .boundary.*_uses_edges, .boundary.labels, .boundary.annotations e .boundary.feature_attachments. FeatureRecipes de escopo de Component referenciam .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Ambos os escopos compartilham .values, .infra, .locals, .provides, .steps e .metadata. Um parâmetro da Release não é um pilar próprio nesta superfície — ele chega a um template de FeatureRecipe por meio de uma entrada values ou infra que o referencia.

Self-inject value template references cross-node data (O template do valor de self-inject referencia dados entre nós)

Um template inject: value: no nível do componente busca dados em .context.inject ou .context.uses. O canal de inject é justamente o que esta passagem está construindo — um template dentro do próprio valor de self-inject de um componente não consegue ler dele.

É o .context da superfície que determina isso: ele traz instance_id, labels e annotations, e nada mais. .context.inject e .context.uses são, portanto, chaves que o contexto desta superfície não define, e a referência causa uma interrupção como “Template references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define)” mais acima, no momento da análise, antes que qualquer coisa seja renderizada. O diagnóstico nomeia o mecanismo e a chave de entrega aos quais o template pertence, e lista as chaves que .context define aqui — então o mesmo relato cobre tanto uma tentativa real de alcançar dados entre nós quanto um simples erro de digitação como {{ .context.nmae }}, que é o erro mais comum e que, de outra forma, teria sido renderizado como nada.

Mensagem emitida — o detalhe no nível da referência; o relato ao redor também nomeia o nó, o mecanismo e a chave de entrega:

template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (o template referencia uma raiz que o contexto de renderização não define (o template de self-inject indicado referencia o caminho indicado, o contexto define as chaves indicadas))

Cada quadro do relato está no domínio do desenvolvedor, porque um bloco inject: no nível do componente é escrito no Aggregate.

Como corrigir: mova o cabeamento entre componentes para uma entrada uses[].inject — é ali que o contexto entre nós está disponível. Mantenha os templates value: de self-inject no nível do componente fechados sobre os values e a infra próprios do componente, seus .context.instance_id / .context.labels / .context.annotations, e .metadata.

Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)

O tratamento de chaves ausentes depende da superfície do template. Onde uma renderização vazia acaba em um lugar delimitado — um campo de manifesto que o autor pode reler — a ausência é tolerada e a leitura não renderiza nada. Onde, em vez disso, uma renderização vazia produziria uma estrutura errada ou um veredito errado, a superfície recusa a referência em vez de resolvê-la como nada.

  • A interpolação de parâmetros em um Aggregate — as referências {{ .parameters.<key> }} que o próprio texto do Aggregate traz — é a mais precoce dessas superfícies: ela é executada sobre o documento bruto antes que o catálogo seja resolvido, então sua política se aplica a texto que nenhuma outra superfície viu ainda. Uma referência a um parâmetro que a Release nunca preencheu é renderizada como nada, e um pipe default ou uma guarda if sobre uma leitura assim se comporta exatamente como faria sobre o parâmetro não preenchido. Uma referência que o template itera continua iterando como nada, que é o que se quer de um range sobre uma lista opcional — a menos que o texto também a imprima, caso em que causa uma interrupção como descreve “A template reads and iterates a path that holds nothing (Um template lê e itera um caminho que não contém nada)” mais abaixo. Uma referência cujo pai está ausente — .parameters.db.host onde nenhum parâmetro db foi preenchido — ainda causa uma interrupção, porque não há nada em que descer e fornecer um pai trocaria a interrupção por um artefato silenciosamente errado. Um limite vale ser declarado como limite em vez de como política: uma referência ancorada em uma raiz que a superfície não define é deixada como está em vez de renderizada como nada, então ela sobrevive no documento interpolado como o próprio texto de espaço reservado do mecanismo de templates, <no value>. Nada nesta superfície causa uma interrupção por isso, então ancore toda referência a parâmetro em .parameters, e leia um <no value> perdido como uma raiz escrita errado.
  • Os templates de caminho (directory: / subDirectory: das fronteiras da Release) são avaliados com missingkey=error. Uma referência a uma variável que a superfície não lhes fornece causa uma interrupção no momento da análise — veja “Path-template references a variable outside the allowlist (O template de caminho referencia uma variável fora da lista de permissões)” mais acima — e o mesmo vale para uma chave digitada errado sob .manifest, cujas chaves são declaradas. Uma referência permitida, mas não definida no momento da avaliação, como uma chave de .parameters que a Release não fornece, produz um erro explícito em vez de renderizar silenciosamente uma string vazia em um caminho de diretório.
  • As assertions (em um Component, uma Feature, uma Recipe ou uma FeatureRecipe) são avaliadas com missingkey=error. Uma referência a uma chave não definida causa uma interrupção com um diagnóstico de chave inexistente que nomeia a entidade, a instância e a asserção. O rigor é o que torna uma asserção confiável: um predicado cuja referência fosse renderizada como valor vazio compararia com nada e passaria, então um único erro de digitação aposentaria silenciosamente a regra que a asserção foi escrita para impor. Como a referência isolada causa uma interrupção antes que qualquer fallback possa ser executado, um default simples não fornece um fallback para um campo opcional nesta superfície — proteja a referência com hasKey, ou use o helper optional, que faz a verificação de presença diretamente. 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.
  • Os templates de valores (valuesMapping da Recipe, entradas locals: e provides:, corpos de artifacts:, corpos de Workload, injectMapping e pipeline.with da FeatureRecipe, e templates value: de self-inject no nível do componente) são avaliados com missingkey=zero, então uma referência a uma chave não definida não interrompe a build — a leitura não renderiza nada, e nada é o que chega ao artefato. O que ainda causa uma interrupção nesta superfície é uma referência que desce através de um contêiner que o autor nunca forneceu — .values.tls.ca onde nenhum tls foi escrito — porque não há nada em que descer. Só a chave final de uma referência cujos contêineres estão todos presentes é renderizada como nada. Um campo de nível superior que o contexto define, mas para o qual não contém nada — .workload em uma Recipe que não sintetiza nenhum, .features em um componente sem vinculações — é renderizado como nada da mesma forma quando lido por inteiro. Uma referência é uma só referência, seja qual for a grafia: .values.list, $.values.list e (.values).list nomeiam a mesma chave, então percorrê-la com range em uma grafia é percorrê-la em todas, e uma chave lida de um pilar entre parênteses é renderizada, ou causa uma interrupção, exatamente como a grafia direta. Uma chave que o template percorre com range continua iterando como nada quando não está definida, e uma chave que ele tanto imprime quanto percorre causa uma interrupção quando não está definida — veja “A template reads and iterates a path that holds nothing (Um template lê e itera um caminho que não contém nada)” mais abaixo. As proteções funcionam como esperado: {{ .values.optional_field | default "fallback" }} fornece de fato o fallback, porque um valor não definido conta como vazio para default e como falso para if. Quem precisa do discriminador entre ausente e zero — distinguir “chave ausente” de “chave presente e vazia” — usa o helper optional documentado em templates/sprig-functions.md, e lê uma dada chave de uma só maneira por template: uma chave que o mesmo template também lê como .values.<key> conta como presente, então optional informa seu valor vazio em vez do fallback. O que esta política não cobre é uma leitura por meio de index: indexar um mapa com uma chave que ele não contém causa uma interrupção nomeando a chave, aqui como em toda superfície — veja “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)” mais abaixo.
  • Uma coordenada source: — os campos com template de um bloco source: estruturado em uma Recipe ou FeatureRecipe (version, ref, chart, module_subdir) — é avaliada com missingkey=error. Uma referência a uma chave que nada fornece causa uma interrupção nomeando o campo da fonte, em vez de ser resolvida como nada: uma versão ou um ref vazios fixariam um artefato diferente daquele que o autor nomeou, e a fixação é o que toda build posterior reproduz. Esta superfície é também aquela em que o conjunto de funções disponível difere, e em que uma referência de locals: que a própria ordem de escrita do bloco recusa causa uma interrupção antes que qualquer coisa seja avaliada — veja abaixo.
  • Os contratos de parâmetros tipados capturam os casos de parâmetro obrigatório ausente e de violação de contrato na camada de contrato de parâmetros, antes que a interpolação seja executada — veja “Parameter type mismatch / contract violation (Tipo de parâmetro incompatível / violação de contrato)” mais acima.

O conjunto de helpers é o mesmo em templates de valores, templates de caminho e asserções: as funções do Sprig mais as próprias do Aggrega (optional e capitalizedWords). O fail do Sprig está entre elas, então um template de valores pode parar a build com uma mensagem própria, como descreve “A value template failed while it ran (Um template de valores falhou durante a execução)” mais abaixo; uma asserção é a superfície escrita para isso, já que interromper a build é todo o seu propósito. Entre essas três, o que difere é a política de chaves ausentes — optional também está disponível em um template de caminho, onde lê uma chave de .parameters sem que a política estrita dispare antes. A resolução de uma coordenada source: difere no próprio conjunto de funções, e tem sua própria subseção mais abaixo. A interpolação de parâmetros em um Aggregate oferece apenas as funções do Sprig, então nenhum dos dois helpers do Aggrega está disponível ali. Uma função lê da mesma forma em cada uma dessas superfícies, incluídas a coordenada e a interpolação: index, que causa uma interrupção nomeando a chave quando o mapa que lê não a contém.

A mensagem que uma ausência em template de caminho imprime é citada sob a entrada que documenta essa condição, “Path-template references a variable outside the allowlist (O template de caminho referencia uma variável fora da lista de permissões)” mais acima, então é escrita uma única vez em vez de repetida aqui.

Como corrigir: para ausências em templates de caminho, corrija o nome do campo para um que esteja na lista de permissões documentada em path-template-variables.md. Para uma ausência em uma asserção, corrija a referência — a maioria dos relatos é uma chave escrita errado — ou, onde o campo for de fato opcional, proteja-o com hasKey ou use o helper optional; envolver a referência isolada em um default não eliminará a interrupção, porque a referência é resolvida antes que o fallback seja executado, e lê-la por meio de index também não, porque index causa uma interrupção em uma chave que o mapa não contém. Para ausências em templates de valores onde a renderização vazia não é desejada, use o helper optional ou forneça a chave ausente como uma declaração parameters.* tipada no Aggregate com um valor da Release, como uma entrada provides: de um Component de origem cabeada por meio de uses[].inject, ou como uma entrada locals: na mesma entidade.

Resolving a source: coordinate registers a narrower function set (A resolução de uma coordenada source registra um conjunto de funções mais restrito)

Um bloco source: estruturado é resolvido para que o artefato que ele nomeia possa ser fixado, e essa resolução registra os helpers próprios do Aggrega e nada mais — optional e capitalizedWords estão disponíveis, e index causa uma interrupção em uma chave de mapa que o mapa não contém exatamente como faz quando a Recipe renderiza; as funções do Sprig não. Das superfícies em que uma Recipe ou FeatureRecipe escreve templates, esta é a única cujo conjunto de funções difere, então uma expressão que renderiza corretamente em outro ponto da mesma Recipe pode ser recusada aqui. O conjunto mais restrito é deliberado: o que é fixado é decidido pelos values e pelo infra que o autor fornece, e as funções do Sprig incluem algumas que leem o relógio, o ambiente, uma fonte aleatória ou a rede.

Chamar uma função do Sprig em um campo source:, ou em uma entrada locals: que esse campo lê, causa uma interrupção no momento da análise. O diagnóstico tem como cabeçalho E0111 e nomeia a entrada, o campo source: que a lê, a função que não conseguiu resolver e os helpers que esta superfície registra:

resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads (resolução: análise do template na entrada de locals indicada, lida pelo campo source indicado: resolução: erro de análise do template da fonte (causa: a função indicada não está definida); um campo source, e cada entrada de locals que ele lê, é avaliado quando a fonte é resolvida apenas com os helpers próprios do Aggrega (optional, capitalizedWords e index), não com as funções do Sprig que uma renderização adiciona; escreva o valor sem essa função, ou mova o valor para uma entrada de locals que nenhum campo source lê)

Um campo source: que chama diretamente a função é relatado da mesma forma, nomeando apenas o campo.

O alcance são as entradas que a coordenada lê. Resolver uma coordenada avalia cada entrada locals: que um campo source: lê, e cada entrada que uma entrada dessas lê por sua vez — e nenhuma outra. Uma entrada que nenhum campo source: alcança não é avaliada, analisada nem verificada enquanto a fonte é resolvida, então uma entrada de locals de que a renderização precisa — uma que faz aritmética com as funções do Sprig, ou que nomeia um recurso a partir de .context.instance_id — não tem efeito na fixação do artefato; ela é avaliada, e qualquer falha nela é relatada, quando a Recipe renderiza. Quais entradas um campo lê é decidido a partir do seu texto, então um campo que lê .locals de um jeito que não nomeia nenhuma entrada específica — {{ index .locals "version" }}, o bloco inteiro passado a optional ou vinculado a uma variável — faz com que, em vez disso, todas as entradas sejam avaliadas, e o diagnóstico de uma entrada que ele alcança dessa forma diz isso: no lugar de read by <field> ele diz evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated.

Duas formas ficam fora desta superfície, e saber em qual delas uma Recipe está explica por que a mesma expressão é aceita em uma Recipe e recusada em outra:

  • Um source: escrito como string simples — um URI ou um caminho local em vez de um mapa — é tomado literalmente, então não tem campos a avaliar e o bloco locals: não é resolvido aqui de forma alguma.
  • Uma entidade que não declara nenhum source: não resolve nenhuma coordenada, então seu bloco locals: é resolvido apenas para a renderização própria dessa entidade, onde vale o conjunto completo de funções.

O contrato de ordem das referências é o mesmo aqui para cada entrada que a coordenada lê. Resolver uma coordenada recusa as mesmas referências que uma renderização recusa em cada entrada que avalia: uma entrada que lê uma entrada irmã que o bloco declara mais abaixo, e qualquer template que lê uma chave que o bloco não declara. Ambas relatam as condições documentadas mais acima em “locals: entry references a sibling defined later in the same block (Uma entrada de locals referencia uma entrada irmã definida mais adiante no mesmo bloco)” e “locals: key does not exist (A chave de locals não existe)” — a mesma condição, com o mesmo remédio, qualquer que seja a resolução que a alcançou primeiro — e o relato nomeia o campo source: para o qual a entrada foi avaliada. Uma falha em uma entrada que nenhum campo source: lê é recusada quando a Recipe renderiza, sob a mesma condição.

O que esta superfície deixa passar é uma entrada que uma coordenada realmente não consegue resolver: uma que lê dados que só existem enquanto um artefato é renderizado, sendo .context.instance_id o caso para o qual isso existe. Uma entrada assim é ignorada, então uma Recipe cuja coordenada alcança uma dessas em um ramo que não percorre ainda é fixada. Onde a própria coordenada precisava dessa entrada, a resolução causa uma interrupção nomeando o campo source: — o relato de chave ausente descrito mais acima para esta superfície, com o cabeçalho E0110 — e cita, ao lado da chave que não conseguiu ler, por que essa entrada não contém nenhum valor aqui:

resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context") (resolução: avaliação do template no campo source indicado: resolução: falha de avaliação do template da fonte no momento do lock (causa: o mapa não tem nenhuma entrada para a chave indicada); ele lê a entrada de locals indicada, que não pôde ser avaliada aqui (causa: o mapa não tem nenhuma entrada para a chave context))

Nem um campo source: nem uma entrada locals: que ele lê podem ler .provides. Um bloco locals: alimenta um bloco provides: e nunca o contrário, então um template nesta superfície que lê .provides é recusado como a referência inversa que é, em vez de ser resolvido como nada. A recusa não é uma ausência no momento do lock que uma fase posterior satisfaria — nenhuma ordem torna a referência válida — então ela é relatada da mesma forma onde quer que a coordenada seja resolvida. O diagnóstico tem como cabeçalho E0112; ele nomeia o campo, ou a entrada e o campo que a lê, diz o que há de errado com a referência e indica a superfície que a expressão pode ler em vez disso:

source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference) (o template de versão da fonte no campo source indicado referencia .provides, que é uma referência inversa inválida (locals alimenta provides, nunca o contrário) — refatore para ler apenas .values e .infra (e .locals sobre eles): resolução: o template da fonte referencia .provides (referência inversa inválida))

Onde a interrupção aparece: enquanto o lockfile é preenchido ou atualizado — aggrega pull, ou uma build que o preenche (--auto-pull, --upgrade ou a configuração auto_pull do workspace). Cada falha é relatada como um único diagnóstico, com o código do que deu errado como cabeçalho — E0111 para um template que não passa na análise, E0112 para uma referência a .provides, E0110 para um template que foi analisado e não pôde ser avaliado — tanto no terminal quanto em um editor conectado ao aggrega serve. Uma chave ausente em um campo source:, ao contrário de uma função indisponível, é relatada no momento da execução e não da análise, nomeando o campo e a chave que não pôde ser lida.

Como corrigir: optional está registrado nesta superfície e em todo template de valores, template de caminho e asserção, o que o torna a escolha portável — {{ optional .values "chart_version" "25.0.8" }} no lugar de {{ default "25.0.8" .values.chart_version }}. Leia a diferença semântica antes de substituir: optional dispara quando a chave está ausente, enquanto default dispara quando o valor está vazio, então uma chave escrita como string vazia ou como zero mantém o valor escrito com optional e é substituída com default. Onde a expressão realmente precisa de uma função do Sprig — remodelar uma string em vez de fornecer um fallback — mantenha-a fora do que a coordenada lê: em uma entrada locals: que nenhum campo source: lê, ou na superfície que a consome (valuesMapping, um corpo de Workload, uma entrada artifacts:).

A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)

Um template lê um mapa por meio de index — {{ index .values "replicas" }}, ou {{ index .context.inject.env $apiKeyVar }} com um nome de chave que o template calculou — e o mapa não contém a chave pedida. index causa ali uma interrupção e nomeia a chave, em toda superfície que avalia um template: templates de valores, entradas locals: e provides:, templates de caminho, asserções, uma coordenada source: estruturada, a interpolação de parâmetros em um Aggregate e os predicados validate: de seus parâmetros, e os predicados x-aggrega-when: e x-aggrega-validate: de um esquema.

Esta é uma propriedade apenas de index, e a política de chaves ausentes de nenhuma superfície a altera. Uma leitura com ponto de uma chave não definida sob um pilar aberto continua não renderizando nada em um template de valores, como descreve “Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)” mais acima, e um template que testa se o autor forneceu uma chave assim não é afetado. O que causa a interrupção é pedir a index uma chave que o mapa não contém. index é a forma como um template alcança uma chave cujo nome ele calcula — uma credencial lida sob o nome de variável que a Recipe consumidora escolheu, por exemplo — e, sem a interrupção, essa leitura colocaria no artefato o texto de espaço reservado do mecanismo de templates <no value> enquanto a build é bem-sucedida: um servidor iniciado com esse texto como chave. Qualquer outra resposta que index dá é a do próprio mecanismo de templates: uma posição em uma lista ou em uma string, uma posição fora do intervalo, uma chave que o mapa contém — incluindo uma cujo valor é null, que imprime <no value>.

Mensagem emitida, como última linha do relato — os quadros acima dela nomeiam o nó e o campo em que o template está, e em um template de valores de uma Recipe ou FeatureRecipe o cabeçalho traz o código desta condição:

template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (template: execução do template indicado, na linha e na coluna indicadas, na expressão index indicada: erro ao chamar index: o template indexa um mapa com uma chave que o mapa não contém (com a chave indicada). leia uma chave que pode estar ausente por meio de uma função que primeiro testa sua presença, como optional, get ou hasKey)

Em uma superfície que relata uma falha de template sob uma condição própria — uma entrada provides: (“A provides: template could not be evaluated (Não é possível avaliar um template de provides)”), a interpolação de parâmetros (“A {{ .parameters.* }} reference cannot be interpolated (Uma referência a parâmetros não pode ser interpolada)”), um predicado de esquema (“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Não é possível avaliar um predicado)”), uma coordenada source: (“Resolving a source: coordinate registers a narrower function set (A resolução de uma coordenada source registra um conjunto de funções mais restrito)”) — o cabeçalho traz o código dessa condição e a linha acima é o motivo que ele traz, incluindo a chave.

Como corrigir: decida se a chave pode legitimamente estar ausente.

  • Pode. Leia-a por meio de uma função que primeiro testa sua presença: {{ optional .values "replicas" 1 }} retorna o fallback quando a chave está ausente e o valor, seja ele qual for, quando está presente; o get do Sprig retorna uma string vazia para uma chave ausente; hasKey testa sem ler. optional está registrado em toda superfície, exceto na interpolação de parâmetros e nos predicados de um parâmetro ou de um esquema, que oferecem get e hasKey do Sprig; uma coordenada source: registra optional e não o Sprig.
  • Não pode. Forneça-a. A chave que a mensagem nomeia é a que o template pediu, então as causas habituais são uma chave publicada sob outro nome — uma credencial cuja key não é o nome de variável que a Recipe lê — uma chave escrita errado no template ou nos valores escritos, e uma conexão que entregaria a chave e não está cabeada.

A template reads and iterates a path that holds nothing (Um template lê e itera um caminho que não contém nada)

Um template imprime um caminho como está e também percorre o mesmo caminho — "user": "{{ .values.user }}" e "users": "{{ range .values.user }}…{{ end }}" em um mesmo valuesMapping, por exemplo — e os dados não contêm nada ali: a chave não está definida, contém null, ou é um campo de nível superior que o contexto define e para o qual não contém nada, como .workload em uma Recipe que não sintetiza nenhum. A build é interrompida antes que o template seja executado e nomeia o caminho, em toda superfície que renderiza um valor não definido como nada: os templates de valores que “Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)” lista mais acima, e a interpolação de parâmetros em um Aggregate.

Cada leitura isolada tem uma resposta. Um valor não definido que é impresso não renderiza nada, e um que é percorrido com range não itera nada. Um caminho lido das duas formas não pode ter nenhuma das duas: renderizá-lo como nada faria o range falhar sobre texto, e deixá-lo não definido imprimiria no artefato o texto de espaço reservado do mecanismo de templates <no value> enquanto a build é bem-sucedida. Então nenhuma das duas respostas é dada e, em vez disso, a build para.

O que conta como imprimir o caminho é restrito, e a linha é traçada onde o template certamente o imprime:

  • Ele é impresso quando uma ação consiste no caminho e em nada mais — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }}, ou uma variável vinculada ao caminho, {{ $u }} depois de {{ $u := .values.user }} — em um ponto que o template alcança toda vez que é executado.
  • Ele não é impresso quando a leitura fica dentro de um corpo if, with ou range ou de um ramo else, porque se essa leitura é executada depende de uma condição, e a condição pode ser justamente o teste que a impede de encontrar nada — então {{ if .values.user }}{{ .values.user }}{{ end }} ao lado de um range .values.user renderiza como sempre. Também não é impresso quando é o próprio teste de uma guarda, a atribuição de uma variável ou um argumento de uma função — {{ .values.user | quote }}, {{ toYaml .values.user }} — cuja saída é a resposta da função em vez do espaço reservado.

Uma impressão dentro de um corpo que de fato é executado sobre um caminho que não contém nada ainda escreve <no value>, o que esta verificação não alcança. Uma grafia de um caminho é o mesmo caminho que qualquer outra, então uma impressão em uma grafia e um range em outra são julgados juntos, e a mensagem cita a grafia que o template escreveu primeiro. Um caminho que contém um valor é impresso e iterado como sempre, e um caminho cujo pai não contém nada fica a cargo da interrupção que descer através de nada já causa.

Mensagem emitida, como última linha do relato — os quadros acima dela nomeiam o nó e o template, e o cabeçalho traz o código desta condição:

template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (o template lê um caminho como valor e o itera, e os dados não contêm nada nesse caminho (com o caminho indicado). forneça um valor no caminho, proteja a leitura impressa com um if ou um with sobre o caminho, ou leia-o de uma só forma)

A interpolação de parâmetros em um Aggregate também relata a mesma linha sob o código desta condição. Uma entrada provides: relata uma falha de template sob “A provides: template could not be evaluated (Não é possível avaliar um template de provides)”, então ali o cabeçalho traz o código dessa condição e a linha acima é o motivo que ele traz, incluindo o caminho.

Como corrigir: decida qual das duas leituras o template pretende.

  • O caminho precisa estar lá. Forneça-o — nos values: do Aggregate, no infra: da Release ou no parâmetro que a Release preenche — ou declare-o obrigatório no esquema que o rege, para que sua ausência seja relatada onde ele é escrito.
  • O caminho pode estar ausente. Proteja a leitura impressa: {{ with .values.user }}{{ . }}{{ end }} ou {{ if .values.user }}{{ .values.user }}{{ end }} não imprime nada quando ele não está definido, e o range ao lado continua iterando como nada.
  • Uma leitura basta. Leia o caminho de uma só forma — um range que também escreve o que precisa, ou uma impressão por meio de uma função como toYaml ou join que responde por si mesma por um valor não definido.

A value template failed while it ran (Um template de valores falhou durante a execução)

O template de valores de uma Recipe ou de uma FeatureRecipe — um dos templates que “Missing template key — asymmetric policy (Chave de template ausente — política assimétrica)” mais acima lista, entre eles um corpo de Workload, um corpo de artifacts: ou uma entrada locals: — foi analisado, começou a ser executado e parou antes de produzir seu texto. O que o parou é o motivo próprio do mecanismo de templates, que a interrupção traz abaixo dela: uma referência que desce através de um contêiner que nada forneceu, como {{ .values.tls.ca }} onde nenhum tls foi escrito; uma comparação entre valores de dois tipos, como {{ if eq .context.instance_id 1 }}, que compara texto com um número e causa uma interrupção com cannot compare text with a number; ou uma chamada ao fail do Sprig, que um template de valores pode fazer para recusar uma entrada com uma mensagem própria.

Quatro falhas nesses templates são relatadas, em vez disso, sob condições próprias. Uma entrada provides: é relatada sob “A provides: template could not be evaluated (Não é possível avaliar um template de provides)” mais abaixo, com esta frase e o motivo do mecanismo dentro de sua mensagem. Uma leitura por meio de index de uma chave que o mapa não contém é relatada sob “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)” mais acima. Um template que imprime e percorre com range um mesmo caminho que não contém nada é recusado antes de ser executado, sob “A template reads and iterates a path that holds nothing (Um template lê e itera um caminho que não contém nada)” mais acima. E um template que não pode ser analisado para antes de ser executado, então não é esta condição.

Mensagem emitida — os quadros acima dela nomeiam a instância do componente e o template, como recipe "<recipe>" workload template ou Recipe "<recipe>" locals["<key>"], e a linha própria do mecanismo de templates vem logo abaixo:

a value template failed while it ran (um template de valores falhou durante a execução)

A linha do mecanismo diz template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> — para uma chamada a fail, error calling fail: <the message the template wrote>. A build relata a interrupção sob uma tag CATALOG_ERROR, porque o template é escrito pelo autor da Recipe ou da FeatureRecipe. aggrega pull encontra a mesma falha quando renderiza a Release para descobrir as entradas externas que ela lê: relata a falha, ainda assim grava as fixações de dependências do lockfile e avisa que as fixações das entradas externas podem estar incompletas; a build, por sua vez, é interrompida por ela.

Como corrigir: leia o motivo do mecanismo no final do relato — ele nomeia o template, a linha e a coluna, e a expressão em que parou. Para um contêiner que nada forneceu, forneça-o, ou proteja a leitura para que ela nunca desça em algo ausente: {{ with .values.tls }}{{ .ca }}{{ end }}, ou o helper optional. Para dois tipos comparados, compare iguais com iguais — um número com um número escrito sem aspas, texto com texto escrito entre aspas — ou transforme um dos lados em texto com toString. Para uma chamada a fail, a mensagem é do autor do template e diz o que a Recipe precisa: forneça isso, ou mapeie o componente para uma Recipe que aceite o que você escreveu.

A governance plugin rejected the build (Um plugin de governança rejeitou a build)

Um operador pode vincular um plugin de governança em um papel de veredito, sobre o grafo que o compilador construiu ou sobre os artefatos que ele renderizou. Um plugin assim lê e devolve um veredito. O hospedeiro não tem nenhum caminho que aplicaria uma alteração vinda dele, então um papel de veredito pode rejeitar uma build e não pode reescrevê-la para torná-la conforme — a rejeição é tudo o que ele pode fazer, e o que mudar fica a cargo de quem a lê.

Só um veredito de interrupção para a build. Vereditos de aviso e informativos são relatados e a build continua. Cada veredito de interrupção que um plugin devolveu é relatado, na ordem em que o plugin os emitiu, então uma única execução informa você sobre todos eles.

A mensagem que uma build imprime é a do próprio plugin, apresentada exatamente como foi devolvida e enquadrada apenas pelo plugin que a devolveu — então quão específica ela é, e quão útil para agir, cabe ao plugin decidir, e não ao compilador. Qualquer detalhe opcional que o veredito trouxe vem a seguir entre colchetes, com cada parte nomeada: um código, um identificador de regra, uma classificação, uma referência de origem, uma localização, uma sugestão. A condição sob a qual ele é registrado é policy violation, que é aquilo a que um código curto no cabeçalho do diagnóstico se resolve.

A recusa é atribuída à vinculação de governança, e não a um dos seus documentos, então ela não traz nenhuma posição de arquivo: não há nenhuma chave que a tenha produzido, e a resposta é satisfazer a política ou reconsiderar a vinculação.

Mensagem emitida:

policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (o plugin de política indicado rejeitou a build: com a mensagem própria do plugin e, entre colchetes, o código, o identificador de regra, a classificação, a referência de origem, a localização e a sugestão indicados)

A parte entre colchetes só está presente onde o veredito trazia detalhes, e cada parte dentro dela só onde o plugin a definiu.

Como corrigir: leia a mensagem do plugin e a sugestão, onde ele tiver fornecido uma. Onde a constatação estiver correta, altere aquilo a que ela se opõe. Onde a política não deveria se aplicar a esta Release, essa é uma questão sobre a vinculação: as vinculações de governança são configuradas sob plugins.governance na configuração do workspace, e qual plugin é executado em qual papel é uma decisão do operador, e não algo que um documento possa sobrescrever.

A governance attachment’s settings do not match the plugin’s declared schema (As configurações de uma vinculação de governança não correspondem ao esquema declarado do plugin)

Um plugin de governança pode declarar um esquema para as configurações que sua vinculação lhe passa. As configurações escritas sob with.settings da vinculação são verificadas em relação a esse esquema antes que o plugin seja invocado, então uma vinculação mal configurada é relatada como a falha de configuração que ela é, em vez de chegar ao plugin como uma entrada malformada e voltar como o que quer que o plugin faça dela.

Essa ordem é o propósito da verificação. Ela também torna esta condição claramente distinta de uma rejeição: o plugin não foi executado, nenhum veredito foi alcançado e nada da build foi julgado. Um plugin que não declara nenhum esquema de configurações aceita quaisquer configurações, então uma vinculação a um desses plugins nunca encontra esta condição.

A verificação cobre todos os papéis de governança. Uma vinculação escrita em ir-verdict, render-verdict, label-transform ou annotation-transform tem suas configurações verificadas em relação ao esquema antes que o plugin seja invocado — with.settings é a mesma chave escrita em todos os papéis, e todos os papéis a leem primeiro em relação ao esquema. Um papel de transformação é executado onde a build o aplica, o que, em uma build que faz um pull primeiro, acontece durante esse pull, então ali a mensagem começa com a etapa que o invocou, como em auto-pull: label-transform:.

Mensagem emitida — o papel em que a vinculação foi escrita e o plugin que ela nomeia, depois a frase fixa, depois o que a verificação do esquema encontrou:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (ir-verdict: o plugin indicado: with.settings não satisfaz o esquema de configurações declarado do plugin: com o resultado indicado da verificação do esquema: as configurações da vinculação de política não satisfazem o esquema de configurações declarado do plugin)

A cláusula inicial diz render-verdict para uma vinculação escrita nesse papel. O que a verificação do esquema encontrou é o relato próprio do validador do esquema e ocupa mais de uma linha.

Como corrigir: corrija as configurações sob with.settings dessa vinculação em plugins.governance. O detalhe no meio da mensagem nomeia a chave com falha e o que o esquema esperava ali; a referência própria do plugin documenta as configurações que ele declara.

A pipeline step failed (Uma etapa de pipeline falhou)

Uma FeatureRecipe pode declarar um pipeline: uma sequência de etapas, cada uma das quais invoca um export de plugin sobre os documentos que o nó emitiu, para que uma Feature possa moldar a saída que a Recipe própria do componente produziu. Esta é a condição sob a qual uma etapa relata quando falha por qualquer motivo que não seja um patch que endereça algo que o conjunto de documentos não contém, que tem um relato próprio mais abaixo.

O que falhou é nomeado pelo id da etapa e seu índice, e a cláusula que vem a seguir diz qual parte cedeu: a renderização da entrada with da etapa, a própria chamada, uma saída que o hospedeiro não conseguiu ler, um erro que o plugin devolveu, um diagnóstico com severidade de erro que o plugin emitiu, um patch que o mecanismo de patch rejeitou, ou um patch que nomeia um escopo que o percurso não tem.

Uma etapa que falhou é revertida por inteiro. Os documentos são restaurados para como estavam antes de a etapa ser executada, e as saídas próprias da etapa são descartadas com eles, então o when ou o with de uma etapa posterior não pode ler um resultado parcial. Uma etapa declarada optional: true é então relatada como um aviso e o percurso continua; uma etapa que não é opcional para a build. O que optional: não tolera é um contrato declarado violado — veja a entrada mais abaixo.

Mensagens emitidas:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> (a etapa de pipeline falhou: na entrada da etapa indicada, com o índice indicado, a renderização não conseguiu fazer o que é indicado) pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> (a etapa de pipeline falhou: na invocação da etapa indicada, com o índice indicado, a chamada não conseguiu fazer o que é indicado) pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> (a etapa de pipeline falhou: a etapa indicada, com o índice indicado, emitiu um diagnóstico de erro com a mensagem do plugin indicada) pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> (a etapa de pipeline falhou: no escopo e na chave indicados, o mecanismo de patch recusou o que é indicado) pipeline step failed: unknown patch scope "<scope>" (a etapa de pipeline falhou: escopo de patch desconhecido, o indicado)

Como corrigir: leia o id da etapa e depois a cláusula após o índice — ela diz qual metade da etapa examinar. Uma falha de with é um template no bloco with: próprio da etapa, e cabe a você corrigi-la. Um diagnóstico de erro são as próprias palavras do plugin sobre a sua entrada. Um patch recusado e um escopo desconhecido são a saída do plugin em relação ao que o nó emitiu, e cabem ao autor do plugin. Onde uma etapa realmente tem permissão para falhar — um enriquecimento opcional, e não uma transformação obrigatória — declare-a optional: true, lembrando que isso tolera uma falha, e não um contrato quebrado.

A pipeline step’s typed input or output does not satisfy its declared contract (A entrada ou a saída tipada de uma etapa de pipeline não satisfaz seu contrato declarado)

Um export de plugin pode declarar um esquema para a entrada que recebe e para as saídas que devolve. Ambos são verificados: o valor with renderizado antes da chamada, e as saídas devolvidas depois dela. Um diagnóstico cuja severidade o contrato compartilhado não declara é recusado da mesma forma.

Isto causa uma interrupção mesmo para uma etapa declarada optional: true, e essa distinção é todo o motivo pelo qual a condição é separada de uma falha da etapa. Opcional tolera uma etapa que não conseguiu fazer o seu trabalho — uma chamada que falhou, um plugin que levantou uma objeção. Não tolera uma saída que o hospedeiro não consegue encaminhar, nem uma entrada que nunca teve a estrutura que o export dizia receber: um contrato declarado é um compromisso, e uma build que pulasse silenciosamente uma etapa cujo contrato foi quebrado estaria relatando sucesso sobre uma Feature que não fez nada.

Mensagens emitidas:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (a entrada da etapa de pipeline indicada não satisfaz o contrato de entrada declarado: com o resultado indicado da verificação do esquema: violação do contrato de E/S tipada da etapa de pipeline) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (a etapa de pipeline indicada devolveu saídas que não satisfazem o contrato de saída declarado: com o resultado indicado da verificação do esquema: violação do contrato de E/S tipada da etapa de pipeline)

e, para uma severidade de diagnóstico que o contrato não declara, que chega dentro do quadro da falha da etapa:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (a etapa de pipeline falhou: a etapa indicada, com o índice indicado: com a severidade indicada que o hospedeiro não conseguiu encaminhar: violação do contrato de E/S tipada da etapa de pipeline)

Onde o template with da etapa lê um valor declarado sensível, uma violação da entrada não nomeia nenhum valor. O que a verificação do esquema encontrou é substituído por cada posição com falha e pela palavra-chave que a recusou, fechadas por um aviso que nomeia o motivo — at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive) — então o campo a corrigir continua sendo nomeado. Veja vocabulary/compact-form-authoring.md “O que uma recusa diz sobre um valor declarado”.

Como corrigir: para uma violação da entrada, corrija o bloco with: da etapa de acordo com o esquema que seu export declara — o detalhe nomeia o campo e o que era esperado. Uma violação da saída e uma severidade não declarada cabem ao plugin corrigir; a declaração da etapa não é o que está errado, então marcá-la como opcional não eliminará nenhuma das duas.

A pipeline patch addresses a document the set does not hold, or one with no tree to address (Um patch de pipeline endereça um documento que o conjunto não contém, ou um sem árvore para endereçar)

Uma etapa de pipeline endereça um documento por um escopo e uma chave, e duas formas de endereço são recusadas.

O conjunto não o contém. A etapa aplicou um patch a um par de escopo e chave que não está entre os documentos que ela recebeu. Nada seria editado, então, em vez de aplicar um patch a nada e relatar sucesso, o percurso para:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (o patch de pipeline aponta para um documento que não está presente no conjunto: com o escopo e a chave indicados)

Ele não traz nenhuma árvore para endereçar. Algumas unidades não têm nenhuma estrutura para a qual um patch possa apontar — um corpo binário, texto livre, uma região que o provedor não consegue percorrer com segurança. Uma unidade assim ainda é entregue à etapa, marcada com seu tipo de mídia e seus bytes, para que possa ser selecionada e emitida por inteiro; o que ela não pode é receber um patch, porque não há nada em relação ao qual um caminho possa ser resolvido. Um patch contra uma delas para, em vez de ser ignorado silenciosamente:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (o patch de pipeline aponta para uma unidade opaca, não estruturada: com o escopo e a chave indicados)

O que conta como estruturado é a leitura própria que o provedor faz da unidade, e não um teste fixo, então o mesmo conteúdo pode ser endereçável sob um provedor e opaco sob outro.

Ambas são recusas próprias do percurso, e uma build as relata no nó cujo pipeline aplicou o patch, então a mensagem acima chega abaixo de uma interrupção que nomeia esse nó. Essa interrupção é a forma que para a build das mesmas duas falhas de endereçamento, documentada sob “A pipeline step addresses documents the node does not have (Uma etapa de pipeline endereça documentos que o nó não tem)” mais abaixo — que também cobre o terceiro endereço com o qual uma etapa pode não alcançar nada, uma solicitação dos documentos de um componente hospedeiro em um ponto em que não há nenhum.

Como corrigir: ambas cabem ao autor do plugin, e não a você. Uma etapa recebe o conjunto de documentos sobre o qual está sendo executada e pode ler quais chaves estão nele, então um alvo ausente é uma etapa endereçando um documento que este nó não emitiu — aplique o patch a um documento que esteja lá, ou emita primeiro aquele que você pretendia e aplique o patch nele em uma etapa posterior. Para uma unidade opaca, substitua o patch por uma emissão da unidade inteira: um corpo opaco é substituído, e não editado.

A patch’s test operation did not match the document (A operação de teste de um patch não correspondeu ao documento)

Um patch pode carregar uma operação test, que afirma o que está em um caminho antes que as operações seguintes sejam aplicadas. O mecanismo recusa o patch inteiro quando a afirmação não se sustenta, e é isso que torna um patch condicional realmente condicional, e não otimista: um plugin que testa antes de editar está dizendo que não tocará em um documento que não reconhece.

Duas formas são relatadas sob esta condição. Não há absolutamente nada no caminho, o que a mensagem diz. Ou há um valor e ele não é o afirmado, o que é relatado como a recusa pura e simples — nem o valor afirmado nem o encontrado é citado.

Mensagens emitidas:

jsonpatch: test operation failed: no value at path (jsonpatch: a operação de teste falhou: nenhum valor no caminho) jsonpatch: test operation failed (jsonpatch: a operação de teste falhou)

Onde a saída de uma etapa de pipeline carregava o patch, a recusa chega abaixo da falha dessa etapa, nomeando a etapa. Onde o patch de um plugin label-transform o carregava, ela chega abaixo da recusa do patch de labels.

Como corrigir: a falha é do plugin, e não dos seus documentos. Um teste que esperava um valor que o documento não tem geralmente significa que o plugin está sendo executado sobre uma estrutura para a qual não foi escrito — a saída de outro provedor, ou um documento que uma etapa anterior do mesmo pipeline já alterou. Onde cabe a você corrigir o patch, flexibilize o teste para o que o documento realmente contém, ou faça a condição when da etapa pular o caso em vez de testá-lo dentro do patch.

A workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)

Um workload: declara uma form: — a estrutura daquilo que é executado, expressa em termos que todo destino entende, e não no vocabulário de um único destino. Alguns campos só fazem sentido em uma forma, e uma forma declarada sem o campo de que precisa não tem nada coerente para renderizar. Ambas as direções são verificadas, antes que qualquer destino traduza a carga de trabalho, então o desacordo é relatado uma única vez em relação ao que você escreveu, e não uma vez por destino com as palavras que cada destino tem para isso.

Cinco pareamentos são aplicados, e cada um relata uma frase própria que nomeia as duas metades e o que escrever:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (a carga de trabalho declara um volume persistentTemplate, mas não é form: stateful; declare form: stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (a carga de trabalho é form: reference, mas não declara nenhum endpoint; defina endpoint como o host externo ou a URL para onde a referência aponta) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (a carga de trabalho declara um endpoint, mas não é form: reference; declare form: reference ou remova o endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (a carga de trabalho é form: scheduled, mas não declara nenhum agendamento; defina schedule como uma expressão cron de 5 campos ou uma macro @, por ex. @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (a carga de trabalho declara um agendamento, mas não é form: scheduled; declare form: scheduled ou remova o agendamento)

Cada uma é posicionada na instância do componente cuja carga de trabalho estava sendo lida, e relatada como uma falha de tradução, porque o desacordo é entre dois campos de um único bloco escrito pelo autor.

As condições sob as quais elas são registradas, que é aquilo para o qual seus códigos curtos são resolvidos, são persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule e schedule requires form: scheduled.

Um pareamento vale em um único sentido. Uma carga de trabalho form: stateful sem template de claim por réplica é comum e não provoca nada — a regra é que um template de claim precisa da identidade estável por réplica que só essa forma fornece, e não que a forma precise de um template de claim. Os outros dois pareamentos valem nos dois sentidos, porque um endpoint e um agendamento têm cada um exatamente uma forma em que significam alguma coisa.

Os dois pareamentos de endpoint também estão no esquema de Workload, então uma carga de trabalho que viola qualquer um deles é recusada no estágio de esquema, sob E0214, antes que sua frase acima seja alcançada. Um endpoint: em qualquer forma diferente de reference — incluindo uma form: omitida, já que ela é lida como stateless — é recusado como

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (a validação da carga de trabalho falhou, no Workload da Recipe e no caminho indicados, estágio de esquema: .endpoint: o valor corresponde a uma forma que não é permitida aqui)

e form: reference sem endpoint: termina, em vez disso, com .endpoint: missing required property: endpoint. A solução é a que a frase do pareamento indica.

Como corrigir: cada frase nomeia os dois campos e dá as duas respostas. Adicione o campo de que a forma precisa, ou mude a forma para aquela à qual o campo pertence, ou remova o campo onde ele ficou para trás após uma edição — apagar um valor de schedule: e deixar a chave é a forma que esse erro mais assume.

A workload schedule: is not an expression the check accepts (O agendamento de uma carga de trabalho não é uma expressão que a verificação aceita)

Uma carga de trabalho form: scheduled carrega um schedule: que diz quando ela é executada, e a estrutura do valor é verificada antes que qualquer destino o leia. Duas grafias são aceitas: uma das cinco macros @hourly, @daily, @weekly, @monthly e @yearly, ou uma expressão crontab de cinco campos cujos campos usam apenas dígitos e os caracteres *, ,, - e /.

O que a verificação lê e o que não lê. Ela conta os campos e examina os caracteres neles. Não avalia intervalos, aritmética de passos nem nomes de dias da semana, então uma expressão de cinco campos cujos números estão fora do intervalo passa aqui e cabe ao destino rejeitá-la. Uma expressão de seis campos que carrega um campo inicial de segundos é recusada: cinco campos é o que esta superfície aceita, e um destino que quer segundos os recebe de outra forma.

Mensagem emitida:

workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly (o agendamento da carga de trabalho não é uma expressão cron válida; use uma expressão crontab de 5 campos, como a do exemplo, ou uma de @hourly, @daily, @weekly, @monthly, @yearly)

A condição sob a qual ela é registrada é schedule is not a valid cron expression, que é aquilo para o qual seu código curto é resolvido.

Como corrigir: conte primeiro os campos — um agendamento com quatro ou seis deles é a causa mais comum, e um espaço a mais dentro de um campo o divide em dois. Substitua um dia ou mês nomeado pelo seu número, e recorra a uma macro onde alguma diga o que você queria.

A workload suspend: is set on a form other than scheduled (A suspensão de uma carga de trabalho está definida em uma forma diferente da agendada)

suspend: true retém o agendamento recorrente de uma carga de trabalho form: scheduled: o recurso agendado é renderizado, e nenhuma execução começa a partir do seu agendamento até que ele seja retomado. Nenhuma outra forma carrega um agendamento, então em qualquer outra forma não há nada para o campo reter, e a build é interrompida em vez de renderizar uma carga de trabalho que o descarta silenciosamente. A verificação é executada junto com os outros pareamentos de forma, antes que qualquer destino traduza a carga de trabalho, e uma form: omitida também é lida aqui como stateless.

Mensagem emitida:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (a carga de trabalho declara suspend, mas não é form: scheduled; declare form: scheduled com um agendamento ou remova suspend)

Ela é posicionada na instância do componente cuja carga de trabalho estava sendo lida, e relatada como uma falha de tradução. A condição sob a qual ela é registrada é suspend requires form: scheduled, que é aquilo para o qual seu código curto é resolvido.

A regra vale em um único sentido, e só com true. Uma carga de trabalho form: scheduled sem suspend: é comum e é executada no seu agendamento, e suspend: false, o padrão, não provoca nada em nenhuma forma.

Como corrigir: onde a carga de trabalho deveria ser executada apenas quando alguém a inicia, torne-a uma carga de trabalho form: scheduled com um schedule: e mantenha suspend: true; caso contrário, mantenha a forma como foi escrita e remova suspend:, que nenhuma outra forma lê.

A library $import: is not written in the bare-name form (Uma importação de biblioteca não está escrita na forma de nome simples)

Três campos de uma Recipe e de uma FeatureRecipe podem tomar seu corpo de uma biblioteca em vez de escrevê-lo no próprio lugar: uma entrada artifacts.<name>:, um valuesMapping: e um workload:. Cada um escreve $import: com o nome simples da biblioteca, depois #, depois o caminho da entrada na superfície que esse campo lê — #/artifacts/, #/mappings/ e #/workloads/, respectivamente. Um valor que não está nessa forma não nomeia nada que a build consiga resolver, e é recusado quando o campo é resolvido.

Os três campos são espelhos deliberados uns dos outros, então a falha é lida da mesma forma nos três e só a superfície muda:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (a importação de artifacts não é uma referência de nome simples a uma biblioteca de artefatos: com o valor indicado, como foi escrito) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (a importação de valuesMapping não é uma referência de nome simples a uma biblioteca de mappings: com o valor indicado, como foi escrito) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (a importação de workload não é uma referência de nome simples a uma biblioteca de cargas de trabalho: com o valor indicado, como foi escrito)

Uma versão escrita com @ é relatada com a grafia a ser usada no lugar, em vez de cair em uma reclamação de que a biblioteca não foi encontrada, porque é o erro que essa forma mais atrai:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (a importação de artifacts não é uma referência de nome simples a uma biblioteca de artefatos: o separador de versão é ’:’, não ’@’ — use o valor corrigido indicado)

Mais uma forma é relatada aqui, e não é um erro de grafia. O corpo próprio de um arquivo de um bundle de uma ArtifactLibrary não pode ser ele mesmo um $import: de outro bundle: uma posição de arquivo não pode se expandir em muitos arquivos, então uma importação aninhada é recusada em vez de resolvida em algo que o autor não escreveu. Em vez disso, componha os bundles no ponto em que são consumidos.

Uma entrada artifacts: que a Recipe própria de um componente escreve é decidida antes que qualquer coisa seja renderizada, então o relato é posicionado no bloco artifacts: dessa Recipe e nomeia a referência, o bundle, o arquivo cujo corpo carrega a importação aninhada e a entrada em que a importação foi escrita. Cada arquivo do bundle nessa forma é relatado em uma única build; onde há mais de um, as constatações são agrupadas sob artifacts entries whose library import the compiler cannot resolve:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them (a importação de artifacts não é uma referência de nome simples a uma biblioteca de artefatos, com o valor como foi escrito, o bundle, o arquivo do bundle e a entrada de artifacts indicados. O corpo de um arquivo de bundle não pode importar outro bundle — componha os dois na entrada de artifacts que os consome)

Uma entrada artifacts: que uma FeatureRecipe escreve relata a mesma condição quando o bundle é resolvido, nomeando o primeiro arquivo nessa forma:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site) (a importação de artifacts não é uma referência de nome simples a uma biblioteca de artefatos: o corpo do arquivo indicado do bundle indicado é uma importação na raiz do campo; uma importação de biblioteca aninhada dentro de um arquivo de bundle não é suportada; componha no ponto de consumo)

Um valuesMapping: que a Recipe própria de um componente escreve é decidido antes que qualquer coisa seja renderizada, então o relato é posicionado na chave valuesMapping: dessa Recipe e traz a grafia a ser usada:

valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/ (a importação de valuesMapping não é uma referência de nome simples a uma biblioteca de mappings, com o valor indicado, como foi escrito. Nomeie a biblioteca e a entrada de cada lado do fragmento — escreva a forma indicada)

Um valuesMapping: que uma FeatureRecipe escreve é relatado quando a referência é resolvida, na forma que a lista acima traz.

Um workload: que a Recipe própria de um componente escreve é decidido antes que qualquer coisa seja renderizada, então o relato é posicionado na chave workload: dessa Recipe e traz a grafia a ser usada:

workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/ (a importação de workload não é uma referência de nome simples a uma biblioteca de cargas de trabalho, com o valor indicado, como foi escrito. Nomeie a biblioteca e a entrada de cada lado do fragmento — escreva a forma indicada)

Um workload: que uma FeatureRecipe escreve é relatado quando a referência é resolvida, na forma que a lista acima traz.

Como corrigir: reescreva o valor como <Library>#<entry-path>, adicionando :<version> após o nome da biblioteca apenas onde você precisa de um piso para a versão que pode ser selecionada. Verifique se o fragmento corresponde ao campo — um caminho de entrada #/mappings/… em um workload: nomeia uma superfície que esse campo não lê, e é relatado aqui, e não como uma entrada ausente. A mesma forma de identidade rege o $ref: de um esquema, cujas recusas estão documentadas em “A $ref: is not written in a form the compiler can resolve (Uma referência não está escrita em uma forma que o compilador consiga resolver)” acima.

A library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)

Um $import: está escrito corretamente e aquilo para o qual ele aponta não está lá. Seis condições cobrem as duas metades de uma referência nos três tipos de biblioteca, e qual delas você recebe diz qual metade examinar: a própria biblioteca está ausente do que a build consegue ver, ou a biblioteca está lá e não publica a entrada.

O conjunto em relação ao qual uma referência é resolvida é o catálogo próprio do workspace mais as bibliotecas que o lockfile fixou e trouxe enquanto a build era carregada. Assim, uma biblioteca da qual nada no fechamento de dependências da Release declara depender não está nesse conjunto, por mais correta que pareça a referência a ela.

A biblioteca não está lá:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (uma importação de biblioteca de artefatos referencia uma ArtifactLibrary que não está presente no catálogo: com a ArtifactLibrary e o bundle indicados) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (uma importação de biblioteca de mappings referencia uma MappingLibrary que não está presente no catálogo: com a MappingLibrary e a entrada indicadas) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (uma importação de biblioteca de cargas de trabalho referencia uma WorkloadLibrary que não está presente no catálogo: com a WorkloadLibrary e a entrada indicadas)

A entrada não está lá:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (uma importação de biblioteca de artefatos referencia um bundle que não está presente na ArtifactLibrary: com o bundle e a ArtifactLibrary indicados) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (uma importação de biblioteca de mappings referencia uma entrada que não está presente na MappingLibrary: com a entrada e a MappingLibrary indicadas) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (uma importação de biblioteca de cargas de trabalho referencia uma entrada que não está presente na WorkloadLibrary: com a entrada e a WorkloadLibrary indicadas)

Uma entrada artifacts: que a Recipe própria de um componente escreve relata um bundle ausente em uma forma própria. Essa entrada é decidida antes que qualquer coisa seja renderizada, então o relato é posicionado no bloco artifacts: dessa Recipe e nomeia a entrada em que a importação foi escrita junto com as duas metades da referência:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (uma importação de biblioteca de artefatos referencia um bundle que não está presente na ArtifactLibrary: com o bundle, a ArtifactLibrary e a entrada de artifacts indicados)

Um valuesMapping: que a Recipe própria de um componente escreve relata uma entrada ausente em uma forma própria, pelo mesmo motivo: ele também é decidido antes que qualquer coisa seja renderizada, então o relato é posicionado na chave valuesMapping: dessa Recipe e nomeia as duas metades da referência:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (uma importação de biblioteca de mappings referencia uma entrada que não está presente na MappingLibrary: com a entrada e a MappingLibrary indicadas)

Um workload: que a Recipe própria de um componente escreve relata uma entrada ausente em uma forma própria, pelo mesmo motivo: ele também é decidido antes que qualquer coisa seja renderizada, então o relato é posicionado na chave workload: dessa Recipe e nomeia as duas metades da referência:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (uma importação de biblioteca de cargas de trabalho referencia uma entrada que não está presente na WorkloadLibrary: com a entrada e a WorkloadLibrary indicadas)

Uma entrada artifacts: que uma FeatureRecipe escreve, um valuesMapping: ou um workload: que uma FeatureRecipe escreve, e toda referência a uma biblioteca que a build não consegue ver são relatados à medida que a referência é resolvida, nas formas que as duas listas acima trazem.

Cada uma nomeia tanto a biblioteca quanto a entrada, qualquer que seja a metade que falhou, então um único relato basta para distinguir uma biblioteca ausente de uma entrada ausente sem abrir nada.

Como corrigir: para uma entrada ausente, confira o nome com o que a biblioteca publica — o nome de uma entrada é uma chave no mapa próprio dessa biblioteca, e diferencia maiúsculas de minúsculas. Para uma biblioteca ausente, a referência geralmente está certa e o que fica faltando é o fechamento: declare a dependência dessa biblioteca para que ela seja carregada, e atualize o lockfile para que ela seja fixada. Uma biblioteca alcançável em um workspace e não em outro é a mesma falha vista do outro lado.

A library $import: addresses its library by registry location (Uma importação de biblioteca endereça sua biblioteca pela localização no registro)

Um $import: de biblioteca nomeia sua biblioteca pela identidade, nunca pelo registro em que ela por acaso está publicada. Por qual registro um nome é resolvido é configuração do workspace, e qual versão é usada é a resposta do lockfile, então uma referência que carrega um host fixa em um documento de catálogo duas coisas que cabe à build decidir — e o documento então deixa de funcionar em qualquer workspace configurado de outra forma.

Os casos em que tal referência ainda pode chegar a esta interrupção são mais restritos do que parece. Os campos $import: próprios de uma Recipe e de uma FeatureRecipe são recusados antes, pelo seu esquema, que não admite nenhum prefixo de registro em nenhuma das três posições. O que resta é a referência que nenhum esquema descreve: uma lida do próprio corpo de uma entrada de biblioteca, que a entidade que a consome não escreveu e não consegue ver até que o corpo seja resolvido.

Mensagem emitida, a partir das superfícies valuesMapping: e workload:, onde o resolvedor relata apenas o valor:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (a importação de biblioteca carrega um host de registro; referencie a biblioteca pela identidade de nome simples: com o valor indicado, como foi escrito)

Uma entrada artifacts: não chega a esta interrupção, e vale a pena saber o motivo se você a estiver procurando ali. A própria referência dela é recusada com o resto do documento, como qualquer outra posição; e, ao contrário das outras duas superfícies, um arquivo de bundle cujo corpo é ele mesmo uma importação é rejeitado em vez de seguido — então não existe nenhum corpo de onde uma referência com host possa vir.

Como corrigir: remova o host e tudo antes do nome da biblioteca, deixando <Library>#<entry-path>. Onde o valor problemático está dentro de uma biblioteca que você consome, e não em uma que você publica, a correção cabe ao autor dessa biblioteca; até que ela chegue, importar uma entrada diferente ou escrever o corpo no próprio lugar libera a build.

Two artifact outputs of one Recipe carry the same filename (Duas saídas de artefatos de uma mesma Recipe têm o mesmo nome de arquivo)

O bloco artifacts: de uma Recipe nomeia uma saída por chave, e um bundle importado em uma chave contribui com seus arquivos abaixo dela. Duas saídas chegando a um mesmo nome de arquivo significariam uma sobrescrevendo a outra, então a build é interrompida em vez de escolher qual sobrevive.

Esta é uma proteção residual, e dizer isso faz parte do que ela é. Uma saída é nomeada pela chave sob a qual foi escrita, chaves de mapa são únicas dentro de um documento, e a superfície de autoria limita uma chave a um único nome de arquivo — então duas entradas escritas pelo autor não podem colidir, e uma chave também não pode escrever o nome aninhado que o bundle de outra chave produz. O que a proteção ainda cobre é conteúdo que chegou à projeção sem passar pela recusa de chaves duplicadas própria de um documento escrito pelo autor: estado montado enquanto a build é executada, em vez de lido de um arquivo. Uma colisão relatada aqui, portanto, aponta para como a build foi montada, e não para uma linha que você consiga ver.

Ela é levantada por Recipe, sobre as saídas próprias dessa Recipe, e é isso que a separa de dois contribuidores diferentes que vão parar em um mesmo caminho em uma montagem — isso é “Two contributors write the same output path (Dois contribuidores escrevem o mesmo caminho de saída)” acima, com um remédio diferente.

Mensagem emitida:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (colisão de nome de arquivo de uma saída de artifacts: duas saídas de artefatos têm o mesmo nome de arquivo, com a Recipe e a saída de artefato indicadas, emitida mais de uma vez)

Como corrigir: abra a Recipe que a mensagem nomeia e confira suas chaves artifacts: com os arquivos com que contribui qualquer bundle que ela importa. Onde as chaves são de fato distintas e a colisão ainda se mantém, nada no documento está errado, e vale a pena levar o relato a quem mantém a build.

An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Um arquivo de bundle de uma ArtifactLibrary não nomeia nenhum arquivo próprio sob a chave em que foi importado)

Uma entrada artifacts: que importa um bundle se expande em uma saída por arquivo desse bundle, cada uma aninhada sob a chave em que a importação foi escrita. Assim, a chave nomeia um diretório e todo arquivo com que o bundle contribui fica abaixo dele, sob um nome próprio. Um nome de arquivo que sobe para fora desse diretório, nomeia uma localização absoluta ou não nomeia absolutamente nada não fica, e a build é interrompida em vez de colocar o arquivo em algum lugar que a Recipe consumidora nunca escolheu.

Não nomear nada abrange todo nome que não seja a única grafia de um único arquivo abaixo da chave. . e ./, e um nome que volta a cair sobre a chave, como x/.., nomeiam a própria chave, então o arquivo seria escrito onde fica o diretório da chave. Um nome com uma / final ou duplicada, ou com uma parte . ou .. — x/, a//b, ./a, a/./b, a/../b — é uma segunda grafia de um arquivo que outro nome pode ter: a//b ao lado de a/b são dois nomes para um mesmo arquivo, e um seria escrito por cima do outro sem que nenhuma colisão fosse relatada. O nome vazio também é recusado.

O que ela impede é um rearranjo silencioso, e não uma escrita fora do diretório de saída. O lugar onde os arquivos são escritos é protegido de novo, então um nome que sobe o suficiente é recusado ali de qualquer forma. O nome que passa por essa proteção é o que sobe exatamente um nível: ele volta a cair dentro do diretório de saída, em uma posição que ninguém escolheu. Isso é pior do que uma escrita recusada, porque toda proteção contra colisões neste caminho lê um nome como ele foi composto, e não como ele se resolve — então dois arquivos assim podem se resolver em uma mesma saída sem que nada relate uma colisão, e qual deles sobrevive é decidido por nada que alguém tenha escrito.

Um layout aninhado escrito de forma simples dentro da chave não é afetado. Um bundle é livre para trazer seus próprios subdiretórios, como rbac/role.yaml, e aninhá-los sob a chave de consumo é justamente para o que a chave serve. Um nome que apenas contém pontos dentro de uma parte, como ..config ou role.v1.yaml, é um nome comum.

A Recipe consumidora e o bundle publicado geralmente são escritos por autores diferentes, então a mensagem nomeia as duas metades junto com o remédio.

Uma entrada artifacts: que a Recipe própria de um componente escreve é decidida antes que qualquer coisa seja renderizada, então o relato é posicionado no bloco artifacts: dessa Recipe e nomeia primeiro o arquivo, depois a biblioteca de onde ele veio e a entrada em que é consumido. Todo arquivo do bundle cujo nome é recusado é relatado em uma única build; onde há mais de um, as constatações são agrupadas sob artifacts entries whose library import the compiler cannot resolve:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (o nome de um arquivo do bundle de uma biblioteca de artefatos não nomeia um arquivo próprio abaixo da chave de artifacts sob a qual sua saída está aninhada, com o arquivo, a ArtifactLibrary e a entrada de artifacts indicados. renomeie o arquivo dentro do bundle da ArtifactLibrary para um nome de arquivo comum abaixo da chave de artifacts em que ele é consumido, como “config.yaml” ou “rbac/role.yaml” — nenhuma parte “.” ou “..”, e nenhuma “/” inicial, final ou duplicada)

Uma entrada artifacts: que uma FeatureRecipe escreve relata a mesma condição à medida que o bundle é resolvido, nomeando a receita em que foi escrita e o primeiro desses arquivos:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (o nome de um arquivo do bundle de uma biblioteca de artefatos não nomeia um arquivo próprio abaixo da chave de artifacts sob a qual sua saída está aninhada, com a Recipe, o artefato e o arquivo de bundle indicados. renomeie o arquivo dentro do bundle da ArtifactLibrary para um nome de arquivo comum abaixo da chave de artifacts em que ele é consumido, como “config.yaml” ou “rbac/role.yaml” — nenhuma parte “.” ou “..”, e nenhuma “/” inicial, final ou duplicada)

Como corrigir: renomeie o arquivo dentro da ArtifactLibrary para um nome de arquivo comum abaixo da chave. Onde a biblioteca não é sua, importar um bundle diferente ou escrever a entrada no próprio lugar libera a build enquanto a correção é feita na origem. Um arquivo que deveria ir parar em um lugar totalmente diferente é uma segunda entrada artifacts: na chave a que pertence, e não um nome que sobe até lá.

An imported artifact no longer matches the digest recorded beside its Recipe (Um artefato importado não corresponde mais ao digest registrado ao lado de sua Recipe)

Uma entrada artifacts: que importa um arquivo local tem seu conteúdo fixado quando a Recipe é fixada — por aggrega pin, ou por um pull ou um push solicitado a executar a mesma etapa: o digest dos bytes do arquivo é registrado em entity.lock, ao lado da Recipe. Uma entrada do boundary.artifacts: de uma Recipe é fixada e comparada da mesma forma, e registrada sob boundary/<key>, que é o nome que a mensagem lhe dá. Toda build lê o arquivo de novo, calcula seu digest de novo e recusa a divergência — assim, um arquivo editado depois de ter sido fixado nunca é renderizado como se tivesse sido verificado. aggrega pull --verify faz a mesma comparação e relata uma divergência com a mesma mensagem.

O que é comparado é o conteúdo da entrada, e não o que sua renderização produziu. O corpo de um artefato é um template, e avaliá-lo substitui valores que diferem por instância de componente, então um digest sobre a saída divergiria para toda instância cujos valores diferem. O conteúdo registrado é o mesmo texto para toda instância que se liga à Recipe, e é isso que torna um único digest registrado a coisa certa com que comparar.

Uma Recipe que ninguém fixou não tem nenhuma fixação ao seu lado, e uma build não a compara. A ausência de uma fixação não é uma divergência para uma build; significa que não há nada a comparar. Um pull sobre uma Recipe assim, por outro lado, é interrompido, como descreve An entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação). Um lockfile escrito antes de o arquivo ser editado relata primeiro, porque a linha da entidade cobre também o arquivo importado, como expõe A local source no longer matches the pins recorded beside its Recipe (Uma origem local não corresponde mais às fixações registradas ao lado de sua Recipe), onde a mesma seção diz quando esta comparação é a que uma build encontra.

Três superfícies trazem a mesma verificação sobre documentos diferentes — a Recipe própria de um componente, uma Feature vinculada a um componente e uma Feature vinculada a uma fronteira —, então o conteúdo da FeatureRecipe é medido em relação ao digest registrado ao lado da FeatureRecipe, e não ao lado da Recipe do componente hospedeiro. Nas duas superfícies de vinculação, a mensagem nomeia também a vinculação, e é isso que diz qual documento abrir.

Mensagens emitidas:

imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (o conteúdo do artefato importado não corresponde ao digest registrado para ele em entity.lock, com o artefato, o arquivo importado, o digest do seu conteúdo e a fixação registrada indicados. Se o arquivo foi alterado de propósito, execute aggrega pin na entidade que o importa para registrar seu novo digest; caso contrário, restaure o arquivo) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (o conteúdo do artefato importado não corresponde ao digest registrado para ele em entity.lock, com o artefato, o arquivo importado, o digest do seu conteúdo, a fixação registrada e a vinculação indicados. Se o arquivo foi alterado de propósito, execute aggrega pin na entidade que o importa para registrar seu novo digest; caso contrário, restaure o arquivo)

Como corrigir: duas respostas, e qual é a certa depende de a edição ter sido intencional. Se foi, execute aggrega pin na Recipe para que a fixação seja tomada de novo a partir dos bytes atuais do arquivo, e faça commit do entity.lock que ele reescreve. Se não foi, restaure o arquivo — o digest registrado é o registro dos bytes que foram fixados, e uma build que renderizasse o arquivo alterado estaria entregando conteúdo que nada verificou.

A local source no longer matches the pins recorded beside its Recipe (Uma origem local não corresponde mais às fixações registradas ao lado de sua Recipe)

Uma Recipe ou FeatureRecipe cujo source: nomeia um diretório ou um arquivo ao lado dela tem essa origem fixada quando a entidade é fixada — por aggrega pin, ou por um pull ou um push solicitado a executar a mesma etapa. O entity.lock ao lado da entidade registra um digest por arquivo com que a origem contribui para o que uma publicação da entidade carrega, indexado pelo caminho do arquivo. Depois que o lock os registra, toda build compara a origem como está com essas fixações antes que o provedor a leia, e recusa uma divergência — assim, um chart ou um módulo editado depois de ter sido fixado nunca é renderizado como se tivesse sido verificado. aggrega pull --verify faz a mesma comparação e relata uma divergência com a mesma mensagem. Uma build nomeia a instância de componente cuja origem estava resolvendo e, abaixo dela, o documento da Recipe.

A origem é comparada como um único conjunto de arquivos. Um arquivo cujo conteúdo mudou, um arquivo adicionado à origem e um arquivo removido dela mudam, cada um, aquilo a partir de que a entidade é renderizada, então cada um é relatado, com o digest que o arquivo tem agora e o digest registrado para ele. Um arquivo ao lado da entidade com que a origem não contribui — uma nota ou um README junto à Recipe — não é comparado. Uma origem escrita como template, como ./charts/{{ .values.flavour }}, contribui com todo arquivo do diretório da entidade, porque qual diretório ela nomeia é decidido por cada Release; para essa forma, uma edição em qualquer arquivo do diretório é relatada.

Uma Recipe cujo lock não registra nenhuma fixação para sua origem não tem nada que uma build possa comparar. Uma build não a recusa; um pull ou um push que não fixa a recusa, como descreve An entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação). Fixações que um lock ainda registra para uma origem local que a Recipe não declara mais não fixam nada que ela leia, então não são comparadas com nada. Uma Recipe que um pull resolveu a partir de um registro é coberta, em vez disso, pelo digest que o lockfile registra para o que sua publicação carrega.

Um lockfile escrito antes da mudança relata primeiro. O lockfile registra a entidade pelo que ela carrega, e os arquivos da origem fazem parte disso, então uma build ou aggrega pull --verify com um lockfile escrito antes de um arquivo mudar se interrompe antes que esta comparação seja executada, com The lockfile no longer matches what the release resolves to (O arquivo de bloqueio não corresponde mais àquilo em que a Release se resolve) nomeando a entidade e os dois digests. Um aggrega pull simples nomeia o arquivo que mudou, com An entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação). O mesmo vale para um arquivo importado. Onde o lockfile não tem nenhuma entrada própria da entidade, esta comparação é a que uma build e um pull de verificação encontram: uma Recipe ou FeatureRecipe que o Manifest nomeia por uma referência que também é o nome de um Component ou de uma Feature que a Release alcança é registrada sob essa referência como o Component ou a Feature, então nada no lockfile muda quando os arquivos da Recipe mudam.

Mensagens emitidas:

the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (os arquivos da origem local da entidade não correspondem às fixações registradas para eles em entity.lock, com o arquivo, seu digest e sua fixação registrada indicados. Se a origem foi alterada de propósito, execute aggrega pin na entidade para registrar seus arquivos de novo; caso contrário, restaure os arquivos) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (os arquivos da origem local da entidade não correspondem às fixações registradas para eles em entity.lock, com o arquivo e seu digest indicados, para o qual nenhuma fixação está registrada. Se a origem foi alterada de propósito, execute aggrega pin na entidade para registrar seus arquivos de novo; caso contrário, restaure os arquivos) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (os arquivos da origem local da entidade não correspondem às fixações registradas para eles em entity.lock, com o arquivo indicado, que não está mais na origem, e sua fixação registrada. Se a origem foi alterada de propósito, execute aggrega pin na entidade para registrar seus arquivos de novo; caso contrário, restaure os arquivos)

Como corrigir: como para um arquivo importado, duas respostas, e qual é a certa depende de a mudança ter sido intencional. Se foi, execute aggrega pin na Recipe para que os arquivos de sua origem sejam fixados de novo, e faça commit do entity.lock que ele reescreve. Se não foi, restaure os arquivos que a mensagem nomeia.

Todo arquivo que uma publicação de uma entidade carrega é lido do diretório próprio da entidade, e um link simbólico ali é recusado em vez de seguido. Segui-lo publicaria os bytes para os quais ele aponta sob o nome do próprio link — de onde quer que ele aponte, inclusive fora do diretório da entidade — em um artefato cujo digest é então calculado e que, onde a assinatura se aplica, é assinado. Ignorá-lo, em vez disso, publicaria um artefato cujo conteúdo difere silenciosamente do seu diretório. Então toda forma de link é recusada da mesma maneira: um link para um arquivo, um link para um diretório, um link que não aponta para lugar nenhum, um link que aponta para si mesmo e dois links que apontam um para o outro.

A recusa é feita onde quer que os arquivos da entidade sejam lidos: por aggrega pin, por uma publicação antes que ela empacote qualquer coisa (incluindo uma execução de teste), por um pull e um pull de verificação que confrontam o entity.lock com os arquivos da entidade, por uma build que compara uma origem local com suas fixações e por uma renderização que lê um diretório de origem local antes que qualquer parte dele seja entregue a um provedor. A mensagem nomeia o link pelo seu caminho ao lado do documento da entidade, e o diagnóstico é posicionado no próprio link.

Um link que suas regras de exclusão deixam de fora não é um arquivo que a entidade carrega, então ele é ignorado como qualquer outro arquivo que essas regras deixam de fora, e nunca é seguido. Essas regras são as registradas no entity.lock quando a entidade foi fixada, então uma linha que você adiciona ao .aggregaignore entra em vigor quando você fixa a entidade de novo.

Mensagem emitida:

a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (um link simbólico está entre os arquivos que uma entidade carrega, com o caminho indicado. solução: substitua o link por uma cópia daquilo para o qual ele aponta, colocada dentro do diretório próprio da entidade. Um link encontrado dentro de um diretório de origem pode, em vez disso, ser deixado de fora com uma linha no .aggregaignore ao lado da entidade, que entra em vigor quando a entidade é fixada de novo. Um link é recusado em vez de seguido porque os bytes para os quais ele aponta viajariam sob o nome do link, de onde quer que ele aponte)

Como corrigir: onde a entidade precisa daquilo para o qual o link aponta, substitua o link por uma cópia do seu destino dentro do diretório da entidade e fixe a entidade de novo. Onde o link está ali para a sua própria conveniência e a entidade não o lê, adicione o caminho dele ao .aggregaignore ao lado do documento da entidade e fixe de novo. Quais arquivos são distribuídos com uma entidade descreve as regras que decidem o que uma entidade carrega.

An entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação)

Uma Recipe ou FeatureRecipe pode depender de bytes fora do seu próprio documento: um source: remoto cujas coordenadas estão escritas por completo, um arquivo que uma entrada artifacts importa com $import, e os arquivos de um source: que nomeia um diretório ou um arquivo ao lado dela. A fixação de cada um é registrada no entity.lock ao lado da entidade, e registrá-la é a etapa do autor da entidade, aggrega pin. Então um pull não registra essas fixações por conta própria: sobre uma entidade em um dos seus diretórios de catálogo que a Release compila, ele compara o que a etapa registraria com o que o lock contém, e é interrompido quando falta uma fixação no lock — ou quando ele contém uma à qual a entrada não corresponde mais — em vez de escrever no diretório do autor sem que isso seja pedido. Uma build que preenche seu próprio lockfile é um pull e é interrompida da mesma forma.

Um push é interrompido na mesma comparação, sobre a única entidade que ele está prestes a publicar. Antes que o bundle seja construído, e antes que qualquer registro seja contatado, ele compara o que a etapa registraria para a entidade com o lock ao lado dela, e recusa da mesma forma — incluindo uma execução de teste — a menos que o push tenha sido solicitado a executar a etapa ele mesmo. O que a mensagem sugere no final difere entre os dois, porque cada comando tem suas próprias formas de fazer registrar as fixações; o que ela relata, não.

Uma origem local é confrontada com suas fixações como um único conjunto de arquivos. Onde o lock não registra nenhuma delas, cada arquivo com que a origem contribui é relatado aqui como ausente. Onde as registra, um arquivo adicionado desde a fixação é relatado como ausente e um arquivo alterado ou removido como uma fixação à qual a entrada não corresponde mais, e uma build relata a mesma mudança como A local source no longer matches the pins recorded beside its Recipe (Uma origem local não corresponde mais às fixações registradas ao lado de sua Recipe). Fixações que um lock ainda registra para uma origem local que a Recipe não declara mais — seu source: removido, ou agora nomeando um artefato remoto — não fixam nada que a Recipe leia, então não interrompem nem um pull, nem um push, nem um pull de verificação, nem uma build; o próximo aggrega pin as descarta.

A mensagem nomeia toda entrada que lhe falta, por classe. Cada uma é uma remote source, nomeada por sua url e pela versão em que se resolveu, um imported file, nomeado pela chave artifacts que o consome, ou um local source file, nomeado pelo seu caminho ao lado da entidade — assim você sabe se é uma origem ou um arquivo que precisa ser fixado. Toda entidade desse tipo na Release é relatada em uma única execução.

Uma entidade resolvida a partir de um registro nunca é confrontada com isso por um pull, porque sua publicação já foi. Ela fica no cache de conteúdo, e não em um diretório de que você é autor, então um pull não lê nem escreve nenhum lock ao lado dela, e suas origens são confrontadas com o lockfile da Release. Uma entidade publicada com aggrega push foi recusada na publicação, a menos que seu lock registrasse toda fixação que a etapa registraria para ela naquele momento, e esse lock viaja dentro do bundle publicado.

Mensagens emitidas, por um pull e por um push:

an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (uma entrada que a entidade lê não tem nenhuma fixação registrada para ela no entity.lock ao lado dela, com a Recipe indicada, uma origem remota indicada com sua versão para a qual nenhuma fixação está registrada, e um arquivo importado indicado ao qual a fixação registrada não corresponde mais. solução: execute aggrega pin no caminho da entidade indicado e faça commit do entity.lock que ele escreve ao lado da entidade; para que, em vez disso, todo pull neste workspace registre as fixações por conta própria, defina pin_sources_at_pull: true na configuração do workspace) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (uma entrada que a entidade lê não tem nenhuma fixação registrada para ela no entity.lock ao lado dela, com a Recipe indicada e uma origem remota indicada com sua versão para a qual nenhuma fixação está registrada. solução: execute aggrega pin no caminho da entidade indicado e faça commit do entity.lock que ele escreve ao lado da entidade; para que, em vez disso, esta publicação registre as fixações por conta própria, execute-a de novo com —pin-sources; para que toda publicação neste workspace as registre, defina pin_sources_at_push: true na configuração do workspace)

A cláusula central da mensagem da publicação nomeia o que aceita a superfície a partir da qual você publicou: --pin-sources em um terminal, o campo pinSources no daemon e o argumento pin_sources da ferramenta do assistente.

Como corrigir: onde a entidade é sua, execute aggrega pin nela e faça commit do entity.lock que ele escreve, depois faça o pull ou o push de novo — ou faça o push com --pin-sources, que executa a etapa antes que o bundle seja construído. Onde ela é de outra pessoa — um catálogo que você consome a partir de um diretório próprio —, quem a publica ainda não a fixou; defina pin_sources_at_pull: true na configuração do seu workspace para que todo pull registre as fixações por conta própria, ou passe --pin-sources para um único pull. aggrega pin descreve a etapa por completo.

A provides: template could not be evaluated (Não é possível avaliar um template de provides)

Uma entrada provides: é um template que produz o valor que outro componente lê por meio de uma conexão de dependência. Esta condição é o que relata uma entrada que não pôde ser avaliada: um template que não pode ser analisado, uma função que ele chama e que esta superfície não registra, uma referência que desce através de algo que o contexto de renderização não forneceu, ou uma leitura com index de uma chave que o mapa não contém.

Ela é distinta das duas recusas que são executadas antes da avaliação no mesmo bloco — uma referência a uma raiz fora do conjunto autocontido e uma referência que a própria ordem de autoria do bloco recusa —, ambas documentadas acima. Aquelas nomeiam a expressão a mudar; esta carrega o que quer que a própria avaliação tenha relatado, e é por isso que a entrada é nomeada ao lado.

Mensagem emitida, nomeando a instância de componente, a entrada dentro do bloco e o que a avaliação relatou:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (a avaliação do template de provides falhou, com o nó, a chave de provides e o que a avaliação relatou indicados)

O cabeçalho carrega o código desta condição, E0056, seja o que for que a avaliação tenha relatado. Onde a avaliação parou em uma condição de interrupção própria — uma leitura com index de uma chave que o mapa não contém é a habitual —, essa condição é relatada abaixo desta em vez de no seu lugar: sob caused by (2):, a frase desta condição vem primeiro e o relato próprio da avaliação em segundo, incluindo a sua frase. Assim, quem compara códigos associa toda entrada provides: que falhou a E0056, e lê o que fez a avaliação falhar na condição abaixo dela, cuja frase remete ao seu próprio código na tabela de todas as condições — E0327 para a chave ausente.

Como corrigir: abra o bloco provides: da Recipe na chave que a mensagem nomeia e leia o motivo relatado — ele geralmente nomeia uma posição de análise ou uma função. O tratamento de chaves ausentes nesta superfície renderiza uma chave final ausente como nada em vez de falhar, então uma falha aqui é um defeito estrutural: um template que não pode ser analisado, uma referência que desce através de um contêiner que nunca foi fornecido, ou uma leitura com index de uma chave que o mapa não contém, que o motivo relatado nomeia. Onde o valor é realmente opcional, leia-o pelo helper optional em vez de descer em algo que pode não estar ali.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Uma Recipe ou FeatureRecipe não publica uma chave provides que seu contrato declara)

Um Component e uma Feature declaram cada um, sob schema.provides, as chaves que qualquer coisa associada a eles publicará — o contrato de saída contra o qual um consumidor escreve suas conexões. A Recipe associada a um Component e a FeatureRecipe associada a uma Feature precisam produzir cada chave que esse contrato nomeia. Uma que não o faz é recusada, porque, caso contrário, a chave ausente não entregaria absolutamente nada: a referência do consumidor chegaria como uma variável não definida, um argumento vazio ou um arquivo que não existe, sem que nada dissesse por quê.

O contrato é a presença das chaves, e nada mais. Cada chave declarada precisa aparecer; chaves extras são permitidas. Os próprios valores nunca são inspecionados — são ponteiros opacos encaminhados como strings, então os tipos que um contrato declara continuam sendo uma indicação para o consumidor, e não uma verificação que a build faz.

Cada falta é relatada. Uma Recipe à qual faltam três chaves gera três constatações, cada uma posicionada em sua própria entrada no bloco provides: dessa Recipe, então as três são corrigidas a partir de uma única build. A mensagem nomeia a chave ausente, o tipo cujo contrato a declara e a instância à qual a Recipe estava associada — esta última é o que distingue duas constatações quando uma Recipe atende várias instâncias de um mesmo tipo.

Mensagem emitida:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (a Recipe ou FeatureRecipe não publica uma chave provides que o contrato schema.provides de sua entidade abstrata declara (com a chave indicada, declarada pelo tipo de componente indicado, associada à instância de componente indicada))

O pareamento entre Feature e FeatureRecipe relata a mesma condição por meio da resolução própria da vinculação, nomeando o par e a chave:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (a Recipe ou FeatureRecipe não publica uma chave provides que o contrato schema.provides de sua entidade abstrata declara (com o contexto de vinculação indicado: a FeatureRecipe indicada não publica a chave provides indicada, declarada pelo contrato schema.provides da Feature indicada))

Ali ele relata a primeira chave ausente em ordem alfabética e para, então esse pareamento nomeia uma chave por build, enquanto o pareamento do Component nomeia todas. As chaves são percorridas em ordem alfabética nos dois casos, e é isso que torna ambos iguais de uma execução para outra.

Como corrigir: adicione a chave ausente ao bloco provides: da Recipe ou FeatureRecipe, ou remova-a do schema.provides do Component ou da Feature onde não se espera que nada a publique. Uma chave cujo template é renderizado como nada ainda é publicada, com a string vazia como valor, então uma entrada presente e vazia cumpre o contrato e não é relatada aqui. Onde um valor vazio precisa parar a build, recuse-o em uma asserção: as asserções de uma Recipe leem seus valores provides: resolvidos.

An assertion stopped the build (Uma asserção parou a build)

Um Component, uma Feature, uma Recipe ou uma FeatureRecipe pode trazer assertions: — templates nomeados cujo propósito é recusar uma entrada em vez de produzir texto. Uma asserção chama fail, e é essa chamada que para a build; o argumento é a mensagem que seu autor escreveu para quem a encontrar.

As asserções são avaliadas em dois momentos, para que uma regra leia o estado ao qual se refere: as de um Component ou de uma Feature são executadas assim que o catálogo é resolvido e antes que qualquer coisa seja renderizada, e as de uma Recipe ou de uma FeatureRecipe são executadas assim que a associação é estabelecida e antes que essa associação seja renderizada.

Uma referência a uma chave que nada fornece também é relatada aqui. A superfície avalia com tratamento estrito de chaves ausentes, justamente para que um predicado cuja referência foi renderizada como vazia não possa se comparar com nada e passar silenciosamente — caso contrário, um único erro de digitação tornaria sem efeito a regra que a asserção foi escrita para fazer cumprir. É por isso que um default simples não fornece um fallback nesta superfície: a referência nua para a avaliação antes que o fallback possa ser executado. Condicione a referência com hasKey, ou use o helper optional; lê-la por meio de index também causa uma interrupção, nomeando a chave, como descreve “A template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)”.

Mensagem emitida, que nomeia a classe de entidade e o tipo, a instância e a asserção, e depois traz a mensagem que a própria asserção escreveu:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (asserção indicada da instância indicada, do tipo e da classe de entidade indicados: asserção indicada: template: na linha e na coluna indicadas: execução da asserção indicada na expressão fail indicada: erro ao chamar fail: a asserção falhou: com a mensagem que a asserção escreveu)

e, para uma chave que nada fornece, a frase do mecanismo de templates depois da frase própria da condição:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (asserção indicada da instância indicada, do tipo e da classe de entidade indicados: asserção indicada: a asserção falhou: template: na linha e na coluna indicadas: execução da asserção indicada na referência indicada: o mapa não tem nenhuma entrada para a chave indicada)

e onde o que falhou foi a avaliação, e não o predicado:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (asserção indicada da instância indicada, do tipo e da classe de entidade indicados: análise da asserção indicada: com o resultado da análise indicado)

Um valor declarado sensível não aparece na mensagem. Onde a asserção lê um valor assim e chama fail com sua frase escrita por extenso como uma única string entre aspas — fail "…", sem nada encadeado nela e sem nada composto —, a mensagem traz essa frase como foi escrita, seja qual for o conteúdo do valor, porque a frase não cita nada que a asserção leu. Onde sua mensagem cita o valor, a mensagem mostra <redacted> no lugar do valor. Onde a mensagem é composta de qualquer outra forma e o que a asserção fez dependia do que o valor contém, a mensagem depois da expressão com falha é substituída por failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds; a interrupção e seu código permanecem inalterados. O que conta como declarado, e quais recusas ficam fora disso, está em vocabulary/compact-form-authoring.md “O que uma recusa diz sobre um valor declarado”.

Verificada sozinha, uma entidade relata uma asserção com falha como um aviso. aggrega validate com o arquivo de uma Recipe, a verificação desse arquivo pelo editor por meio de aggrega serve e a ferramenta validate de aggrega mcp com uma entity constroem a Recipe em torno de espaços reservados e valores padrão do esquema em vez dos valores que uma Release define, então não conseguem distinguir uma asserção que aguarda uma Release de uma que está quebrada. Ali, uma asserção que chama fail — a própria da Recipe, ou uma que o Component que ela implementa declara — é relatada como um aviso que traz a mensagem acima, fechada pela frase A Release must satisfy this assertion before a build of it can pass., e a verificação passa. Uma referência a uma chave que nada fornece e uma asserção que não pode ser analisada não são asserções com falha: cada uma é um defeito no próprio texto da asserção, e essa verificação a julga como julga qualquer outro defeito. Uma build sempre tem uma Release, e é interrompida na asserção como descrito aqui; veja uma asserção com falha é um aviso.

Como corrigir: a mensagem depois dos últimos dois-pontos é do autor da asserção, e é ela que diz o que mudar — uma asserção é escrita de modo que encontrá-la lhe dê a resposta. Onde o relato é uma chave ausente em vez da frase do autor, o defeito está na própria asserção: corrija a referência, ou condicione-a como descrito acima. Onde a regra não deveria se aplicar a esta Release, trata-se de uma questão sobre a entidade que traz a asserção, e não sobre o seu próprio arquivo.

A pipeline step addresses documents the node does not have (Uma etapa de pipeline endereça documentos que o nó não tem)

Uma etapa de pipeline endereça um documento por um escopo e uma chave. Três condições cobrem as formas pelas quais um endereço não alcança nada, e cada uma para a build em vez de deixar uma etapa relatar sucesso sobre uma edição que nunca aconteceu.

O nó não o emitiu. Um patch nomeia um par de escopo e chave que não está entre os documentos que este nó produziu:

node "<instance>": pipeline PATCH targets a document the node did not emit (nó indicado: o PATCH de pipeline aponta para um documento que o nó não emitiu)

Não há nenhum hospedeiro para endereçar. Uma etapa buscou os documentos de um componente hospedeiro em um ponto em que não há nenhum — o pipeline próprio de um componente, cujo único escopo é a sua própria saída, ou uma Feature vinculada a uma fronteira em vez de a um único componente. O escopo do hospedeiro está vazio onde quer que um pipeline assim seja executado, então um endereço dentro dele não se resolve contra nada:

node "<instance>": pipeline /host operation from a step with no host component (nó indicado: operação /host de pipeline a partir de uma etapa sem componente hospedeiro)

O documento não traz nenhuma árvore para endereçar. Algumas unidades não têm nenhuma estrutura para a qual um caminho possa apontar — um corpo binário, texto livre, uma região que o destino não consegue percorrer com segurança. Uma unidade assim ainda é entregue à etapa, para que possa ser selecionada e emitida por inteiro; o que ela não pode é receber um patch:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (nó indicado: o destino do PATCH de pipeline não é YAML/JSON estruturado analisável) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (o destino do PATCH de pipeline não é YAML/JSON estruturado analisável (com o nó e o documento indicados))

Cada uma chega com o relato próprio do percurso sobre o endereço abaixo dela, e cada uma é posicionada na instância de componente cujo pipeline a produziu.

Duas das três também são relatadas antes de qualquer percurso. Se um ponto tem ou não documentos do hospedeiro decorre de onde o pipeline foi escrito, então uma etapa que declara operar sobre documentos do hospedeiro em um ponto que não os tem é nomeada assim que a build sabe o que cada plugin declara, sem esperar que um nó seja renderizado — e uma Feature vinculada a uma fronteira é nomeada junto com a etapa:

pipeline /host operation from a step with no host component (operação /host de pipeline a partir de uma etapa sem componente hospedeiro) pipeline /host operation from a step with no host component ("<attachment>") (operação /host de pipeline a partir de uma etapa sem componente hospedeiro (com a vinculação indicada))

As duas leituras são uma divisão de uma única condição, e não a mesma constatação duas vezes: o que uma declaração pode resolver é resolvido a partir da declaração, e o que só a execução pode ver fica com a execução — uma etapa que declara o seu próprio escopo ainda pode devolver uma operação contra outro.

Essas três são a forma que para a build das recusas de endereçamento que o próprio percurso do pipeline relata, documentadas sob “A pipeline patch addresses a document the set does not hold, or one with no tree to address (Um patch de pipeline endereça um documento que o conjunto não contém, ou um sem árvore para endereçar)” mais acima.

Como corrigir: as três cabem ao autor da etapa, e não a você. Para um alvo ausente, aplique o patch a um documento que o nó de fato emite, ou emita aquele que você pretendia em uma etapa anterior e aplique o patch nele em uma posterior — uma etapa pode ler quais chaves recebeu. Para um hospedeiro ausente, mova a etapa para um ponto em que haja um componente hospedeiro, enderece em vez disso os documentos próprios do ponto, ou remova-a. Para uma unidade sem árvore, substitua o patch por uma emissão da unidade inteira: um corpo opaco é substituído, e não editado.

A pipeline patch addresses output that has not been assembled yet (Um patch de pipeline endereça uma saída que ainda não foi montada)

Alguns provedores combinam a saída por nó de um grupo de despacho em um único documento — um arquivo compose mesclado, um chart guarda-chuva. Até que essa mesclagem aconteça, não há documentos separados, apenas fragmentos, então um patch que endereça um deles não tem nada para onde apontar. Um pipeline contra um componente assim é, portanto, adiado por inteiro e reexecutado assim que a mesclagem produz os documentos, que é o caminho comum e não exige nada do autor.

Esta condição é o que chega à build quando um patch alcança um fragmento mesmo assim. O caso que ela nomeia é a saída própria de uma Feature vinculada. Onde o provedor do componente combina o seu grupo, todo o pipeline da vinculação é retido até que a mesclagem tenha produzido os documentos — e o que essa reexecução recebe são apenas os documentos do componente. Uma etapa contra a saída própria da Feature só é oferecida enquanto o componente é renderizado, ou seja, antes que qualquer mesclagem tenha acontecido, então ela não tem nada para endereçar. Isso vale seja qual for a forma como a saída própria da Feature circula: quer ela entre na mesclagem, quer seja escrita como documentos próprios, o seu próprio escopo nunca é o escopo que a reexecução traz.

A emissão nunca é afetada. Uma emissão adiciona um documento em vez de editar um, e é executada por nó com todo provedor, então fica totalmente fora disso.

A condição é relatada antes de qualquer percurso, a partir do que os plugins e os provedores declaram, e de novo como salvaguarda enquanto um nó é renderizado. Mensagens emitidas:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (o PATCH de pipeline aponta para os fragmentos de pré-montagem de um provedor montador (com a vinculação indicada)) pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (o PATCH de pipeline aponta para os fragmentos de pré-montagem de um provedor montador (nó indicado; o documento indicado, no escopo indicado, é renderizado por um provedor montador). a fase de pós-montagem reexecuta este PATCH assim que os documentos estão separados)

Como corrigir: enderece os documentos do componente em vez dos próprios da Feature, que é a forma reexecutada após a mesclagem; ou coloque o componente em um provedor que não combine o seu grupo de despacho; ou remova a etapa. Qual das três é a certa depende do que a etapa devia mudar, e a mensagem nomeia o escopo que ela endereçou para que você possa saber. Mudar a capability: própria da FeatureRecipe não está entre elas: isso não muda qual escopo a reexecução após a mesclagem recebe, e é exatamente disso que esta condição trata.

A pipeline step’s plugin does not claim the provider rendering what it addresses (O plugin de uma etapa de pipeline não reivindica o provedor que renderiza o que a etapa endereça)

Um plugin usado por uma etapa de pipeline pode declarar os provedores com os quais foi testado. Essa lista é uma reivindicação explícita, e não um “qualquer coisa parecida” implícito: executar um plugin com um provedor que ele não nomeia arrisca um patch escrito para outra forma de saída, então a build para em vez de tentar.

O provedor com o qual uma etapa é comparada é o que renderiza os documentos que essa etapa endereça — o provedor próprio do componente para uma etapa contra os documentos do componente, e o provedor próprio da Feature para uma etapa contra os da Feature. Em uma Feature vinculada a um componente surgem ambos, e são dois valores diferentes de dois documentos diferentes.

Uma lista de reivindicações vazia ou ausente não corresponde a nada, então toda etapa que usa um plugin assim é relatada aqui. Um plugin que a build não conseguiu consultar é um caso diferente e não é relatado aqui: uma autodeclaração impossível de obter é a ausência de uma reivindicação, e não uma reivindicação vazia, e uma etapa assim para com a própria falha de resolução, de carregamento ou de autodeclaração, que é o que deve ser reparado.

A condição é relatada assim que a build sabe o que cada plugin declara sobre si mesmo, antes da execução que invocaria a etapa, e uma vez por etapa escrita em vez de uma vez por build — assim um autor vê todas as etapas problemáticas de um pipeline a partir de uma única build. Os nomes de Provider são comparados de forma exata.

Mensagens emitidas, a primeira a partir do pipeline próprio de um componente e a segunda a partir do de uma Feature, que também nomeia a vinculação:

pipeline plugin is not compatible with the rendering provider ("<provider>") (o plugin de pipeline não é compatível com o provedor que renderiza, o indicado) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (o plugin de pipeline não é compatível com o provedor que renderiza (com a vinculação e o provedor indicados))

Como corrigir: a constatação é posicionada na etapa escrita, e o provedor que ela nomeia é aquilo com que a declaração precisa ser conciliada. Onde o plugin é seu, adicione o provedor à compatibilidade que ele declara, depois de tê-lo testado com ele. Onde não é, selecione uma versão do plugin que reivindique o provedor, renderize esse escopo por meio de um provedor que o plugin reivindique, ou remova a etapa.

A provider refused a node’s input (Um provedor recusou a entrada de um nó)

Um provedor pode verificar a entrada que recebe para um componente antes de renderizá-la, e relatar o que encontra. Constatações com severidade de interrupção interrompem a build; constatações com severidade de aviso e de informação são exibidas junto à saída da build e não mudam nada nos bytes emitidos.

Esta é a leitura que o próprio provedor faz da sua entrada, e não a do compilador, então aquilo a que ele se opõe e quão especificamente o diz cabe ao provedor decidir. O compilador nomeia o componente e o provedor, e transmite as mensagens do provedor tal como foram devolvidas; quando um provedor relatou várias, elas chegam juntas separadas por ponto e vírgula, então uma única build informa você sobre todas elas.

O mesmo roteamento é usado quer a entrada pertença à Recipe própria de um componente, quer a uma Feature vinculada, então a verificação de um provedor se lê de forma idêntica nos dois casos.

Mensagem emitida:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (o provedor rejeitou a entrada do nó: com o nó, o provedor e as mensagens do provedor indicados)

Como corrigir: leia as mensagens do provedor — elas nomeiam o que ele não pôde aceitar na entrada resolvida. A entrada é montada a partir dos valores da Recipe e da configuração própria do componente, então a correção geralmente está em um deles; a página de referência própria do provedor diz o que ele exige. Quando o provedor se opõe a algo que você não pode mudar a partir de um documento, essa é uma questão para quem escreveu a Recipe ou o plugin.

A provider rendered the same input twice and produced different output (Um provedor renderizou a mesma entrada duas vezes e produziu saídas diferentes)

Dada uma entrada idêntica, uma build produz uma saída idêntica — esse é o contrato com base no qual as ferramentas de revisão e as ferramentas de implantação leem o resultado de uma build. Um modo de build opcional verifica isso diretamente: cada componente é renderizado duas vezes a partir da mesma entrada e os bytes emitidos são comparados. Um provedor cujas duas renderizações divergem carrega estado de uma para a outra, ou de outra forma não é uma função da sua entrada, e a build para.

A build comum renderiza cada componente uma vez, então esta condição só é encontrada no modo de verificação. Nada em uma build normal muda pelo fato de esse modo estar disponível.

O que é comparado é a saída bruta emitida pelo provedor — os mesmos bytes dos quais os artefatos renderizados são recortados —, então uma diferença em qualquer ponto do que ele produziu é detectada, e não apenas uma diferença que sobrevive até um arquivo final.

Mensagem emitida:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (renderização do nó indicado: nó indicado, com o provedor indicado: duas renderizações de uma entrada idêntica produziram saídas diferentes: a renderização do provedor não é determinística)

Como corrigir: primeiro descubra o que difere entre duas builds do componente que a mensagem nomeia — faça a build dele duas vezes e compare as saídas. Quando a diferença é um valor que um chart usado por você como fonte gera de novo a cada renderização — uma senha aleatória, uma chave gerada, um timestamp em um Secret ou em uma ConfigMap —, a falha está na saída desse chart, e não no provedor, e você mesmo pode eliminá-la de uma de duas formas. Forneça o valor, por meio da configuração que o chart oferecer para ele, a partir do valuesMapping: da Recipe, para que o chart pare de gerá-lo. Ou, quando o documento gerado é um que a Release não deve entregar — um Secret que o operador fornece separadamente, por exemplo —, deixe-o de fora da build com uma entrada omits: na Recipe; consulte Recipe → O campo omits:. Caso contrário, a falha é do provedor, e não dos seus documentos, e nada que você possa escrever a elimina. Relate-a a quem publica o plugin que atende esse provedor, nomeando o componente que a mensagem identifica — as causas habituais são um timestamp, um valor aleatório ou uma ordenação que segue a iteração de um mapa em vez da ordem que o autor escreveu. Até que seja corrigida, o modo de build comum não é afetado, e fixar o plugin em uma versão que passou na verificação é a resposta prática.

An omits entry left out nothing the source rendered (Uma entrada omits não deixou de fora nada do que a fonte renderizou)

Toda entrada da lista omits: de uma Recipe ou de uma FeatureRecipe que se aplica a uma build — com o seu when: ausente, vazio ou verdadeiro — deve deixar de fora da saída pelo menos uma coisa que a fonte renderizou: um documento que um chart renderiza, um serviço, um volume ou uma config que um arquivo compose declara, ou um recurso que um template CloudFormation declara. O provedor que renderiza a fonte compara cada entrada com o que renderizou e relata quantas unidades cada uma deixou de fora; uma entrada que não deixou nenhuma de fora interrompe a build.

Uma entrada que não corresponde a nada é uma afirmação sobre a fonte que deixou de ser verdadeira. A causa habitual é uma atualização da fonte que renomeou ou removeu o que a entrada nomeia — e um documento ou serviço renomeado fica então na saída com o seu novo nome, que é exatamente o que a entrada foi escrita para manter de fora —, e a outra é um erro na própria entrada. Ignorá-la entregaria o que a entrada deveria deixar de fora, então a build para e nomeia a entrada.

A mensagem nomeia o nó, o provedor, o documento que declara a entrada e a posição da entrada na lista omits: desse documento, contando a partir de 0, e o kind, o nome e o namespace em que a entrada se resolveu, o namespace somente quando a entrada nomeia um. Para uma FeatureRecipe vinculada a um componente, o nó é esse componente; para uma vinculada a uma fronteira, a linha acima da mensagem nomeia a vinculação e a sua fronteira. Quando várias entradas não corresponderam a nada, a nomeada é a primeira na ordem em que você as escreveu, então a mesma entrada é nomeada em toda execução. Um campo cujo template leu um valor declarado sensível é mostrado como <redacted> em vez de como aquilo em que se resolveu. Uma entrada que o seu when: descartou nunca é entregue ao provedor nem verificada.

Mensagem emitida. A categoria chega até você no cabeçalho entre colchetes:

an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (uma entrada omits não deixou de fora nada do que a fonte renderizou (com o nó, o provedor, a posição na lista omits do documento, o kind, o nome e o namespace indicados). corrija a entrada para que ela nomeie algo que a fonte renderiza, ou remova-a; a causa habitual é uma atualização da fonte que renomeou ou removeu o que ela nomeava)

O cabeçalho carrega o código curto desta condição, E0334.

Como corrigir: compare a entrada com o que a fonte renderiza agora — faça a build com a entrada removida e leia o que o componente renderiza —, depois corrija o kind, o nome ou o namespace da entrada, ou remova a entrada quando aquilo que ela nomeava não existir mais. Para um chart, uma entrada nomeia um documento pelo kind e pelo metadata.name próprios do documento e, quando a entrada nomeia um namespace, pelo namespace em que o documento está; para um arquivo compose, ela nomeia um service, um volume ou um config pela sua chave; para um template CloudFormation, ela nomeia um recurso pelo seu Type e pelo seu ID lógico, em qualquer um dos templates da fonte. Consulte Recipe → O campo omits:.

A provider’s omitted counts do not match the omits entries it was handed (As contagens de omissões de um provedor não correspondem às entradas omits que ele recebeu)

Um provedor que declara que deixa de fora unidades renderizadas relata, para cada entrada omits: que recebeu, com quantas unidades essa entrada correspondeu — uma contagem por entrada, na ordem em que as entradas foram entregues. Um relato ausente, que contém contagens de menos ou de mais, ou que contém uma contagem abaixo de zero não deixa como saber se uma entrada deixou algo de fora, então a build para. Nada do que você escreveu causa isso: a condição relata um provedor cuja saída devolvida não cumpre o contrato que ele declara.

Mensagem emitida. A mensagem nomeia o nó e o provedor, depois quantas entradas foram entregues e o que voltou — ou quantas contagens, ou a contagem abaixo de zero e a entrada para a qual ela foi dada:

a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (as contagens de omissões de um provedor não correspondem às entradas omits que ele recebeu (com o nó e o provedor indicados, o número indicado de entradas omits entregues e o número indicado de contagens de omissões devolvidas))

O cabeçalho carrega o código curto desta condição, E0336.

Como corrigir: relate isso a quem publica o plugin que atende esse provedor, nomeando o componente que a mensagem identifica. O que um provedor deve cumprir está descrito no contrato de plugins em Deixando unidades renderizadas de fora.

Assembled output still carries a cross-boundary placeholder (A saída montada ainda carrega um marcador de posição entre fronteiras)

Quando uma conexão de dependência atravessa duas saídas montadas, o valor que ela carrega não pode ser conhecido enquanto o lado consumidor é renderizado — ele é publicado pelo outro lado e resolvido assim que ambos tiverem sido montados. Então a build escreve um marcador de posição na entrada do componente consumidor, e o provedor o substitui pela sua própria forma de referência cruzada assim que a montagem existe.

Esta condição é o que relata um marcador de posição que sobreviveu a essa substituição. Sobreviver significa que a resolução nunca o alcançou: o valor foi parar em algum lugar que o provedor não conseguia endereçar — inserido em uma string mais longa em vez de figurar como um valor inteiro, na maioria das vezes —, ou uma travessia foi marcada sem nada do outro lado para resolvê-la. Um marcador de posição nunca é uma saída válida, então a build para em vez de entregar um arquivo que contenha um.

A mensagem nomeia o provedor que escreveu o arquivo e o caminho em que o arquivo está: um caminho só é único dentro de uma mesma montagem, então são os dois juntos que identificam um arquivo. Todo arquivo problemático é relatado, e não apenas o primeiro, e cada um é relatado uma única vez, por mais fronteiras que tenham alimentado a montagem em que ele está. Ele é relatado sobre o documento da Release como um todo, e não sobre uma fronteira dentro dele — a falha está em como um valor chegou ao arquivo, e não em uma declaração de fronteira, então nenhuma declaração de fronteira é o que deve ser mudado.

Mensagem emitida:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (a saída montada retém um marcador de posição de ligação entre fronteiras não resolvido (com o provedor e o caminho de saída indicados))

Como corrigir: a causa mais comum é um valor que o lado consumidor interpolou em uma string mais longa. Uma referência cruzada precisa constituir a totalidade do valor como o qual é injetada, então mude o mapeamento da Recipe para entregá-la inteira e, em vez disso, componha em torno dela no vocabulário próprio do destino. Quando o valor está inteiro e o marcador de posição ainda assim sobrevive, a falha está do lado do provedor na resolução e cabe a quem publica esse plugin.

Um template pode ler os valores de um produtor diretamente de uma conexão, em .context.uses.<alias>.provides — ou, em uma FeatureRecipe com escopo de fronteira, das conexões da fronteira sob .boundary. Quando a conexão une dois componentes que renderizam em saídas diferentes e o provedor a conecta com uma referência própria, cada um desses valores chega ao template como um marcador de posição que o provedor substitui assim que ambas as saídas são montadas: por uma referência entre stacks, ou pelo próprio valor. Por isso, um template só pode copiar um valor assim — escrevê-lo inteiro, dentro de uma string mais longa, ou por meio de uma função que o deixe como está, como quote.

Uma comparação, uma ramificação, um comprimento ou uma função que muda o valor — eq, if, len, upper, trimPrefix — seria decidido com base no marcador de posição, e não no valor, silenciosamente. A build verifica isso avaliando o template duas vezes, uma sobre os marcadores de posição e outra sobre os valores reais, e para onde os dois divergem assim que cada marcador de posição é reescrito. Isso se aplica a todo template que lê uma conexão assim: os templates próprios de uma Recipe, o injectMapping: de uma FeatureRecipe vinculada e os templates de uma FeatureRecipe com escopo de fronteira.

A mensagem nomeia o template — o campo e a Recipe à qual ele pertence — e, para cada valor provides do qual a diferença depende, o componente consumidor, o alias e o socket da conexão, e o componente produtor. Um valor que o template apenas copiou não é nomeado.

Mensagem emitida:

a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (um template faz mais do que copiar um valor que lê de uma ligação entre fronteiras (com o template indicado e a chave provides indicada que o componente consumidor indicado lê da sua conexão indicada, no socket indicado, para o componente produtor indicado). Copie o valor como está, inteiro ou dentro de uma string mais longa, porque o provedor escreve no lugar dele aquilo em que o valor se torna na outra saída, e, em vez disso, ramifique com base em um valor próprio do componente)

Como corrigir: copie o valor que a mensagem nomeia em vez de testá-lo ou transformá-lo, e baseie a decisão em um valor que o próprio componente consumidor escreve — uma das suas próprias chaves values ou infra — em vez de no que a sua conexão lê. O provedor CloudFormation descreve em que um valor copiado se torna no outro stack.

A provider named a directory for a contributor that is not one directory (Um provedor nomeou para um contribuidor um diretório que não é um único diretório)

Um provedor que posiciona cada contribuidor sob a sua própria posição dentro de uma mesma saída envolvente declara o diretório sob o qual essas posições ficam, e a build compõe nele a identidade de cada componente. O valor precisa nomear exatamente um diretório: um valor que contenha um separador de caminho, ou que nomeie o diretório atual ou o diretório pai, colocaria os arquivos de um componente em outro lugar que não sob a sua própria posição — ou totalmente fora da montagem, ou reorganizados silenciosamente dentro dela.

A build para em vez de compor um caminho assim. A mensagem nomeia o provedor que declarou o valor e o próprio valor, então fica claro qual provedor mudar e o que ele declarou.

Um provedor que não declara nenhum diretório assim não é afetado. Cada contribuidor fica então diretamente no diretório de implantação sob o seu próprio nome, então deixar de nomear um diretório envolvente é uma resposta legítima, e não uma omissão.

Mensagem emitida:

provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (o provedor nomeou, para o subdiretório próprio de cada contribuidor, um diretório que não é um único nome de diretório: o provedor indicado declarou nest_segment com o valor indicado; o valor deve nomear um só diretório, sem separador de caminho e sem nomear nem o diretório atual nem o diretório pai)

Como corrigir: nada em nenhum documento de catálogo produz esse valor, então não há nada a corrigir nos seus próprios arquivos — ele vem do plugin que atende o provedor. Relate-o a quem publica esse plugin, citando o valor que a mensagem nomeia. Onde o plugin é seu, declare um único nome de diretório, ou não declare nenhum e deixe cada contribuidor ficar no diretório de implantação.

A boundary-scope Feature is attached only to a component (Uma Feature de escopo de fronteira está vinculada apenas a um componente)

Uma FeatureRecipe pode declarar que gera uma única vez para uma fronteira, em vez de uma vez para cada componente — um recurso compartilhado para tudo o que a fronteira contém, em vez de um por componente. Por isso, a fronteira é onde uma vinculação assim precisa ser escrita: uma vinculação com esse nome escrita apenas em um componente não nomeia nenhum escopo para o qual a receita possa gerar, então nada decide em qual fronteira ela seria executada, quais valores leria ou onde sua saída seria gravada.

Escrevê-la também em um componente é comum e não é relatado. Uma vinculação declarada em uma fronteira alcança todos os componentes que essa fronteira contém, inclusive os dos escopos aninhados dentro dela, então carregá-la é a forma normal. O que é verificado é se o escopo próprio do componente, ou um que o envolve, declara o nome — a busca segue para fora a partir de onde o componente está e para no primeiro escopo que o declara. Um componente que repete em si mesmo uma vinculação que seu escopo envolvente já declara é renderizado exatamente como a forma declarada apenas no escopo, e é admitido pelo mesmo motivo.

Um componente colocado em nenhum escopo não tem nada a percorrer, então uma vinculação de escopo de fronteira nele é relatada aqui — que é a leitura honesta, já que não há nenhum escopo para o qual uma receita assim possa gerar.

Mensagem emitida, que nomeia a vinculação e o escopo em que o componente está:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (a vinculação associa uma FeatureRecipe com executionScope: boundary e nenhuma fronteira que contém o componente a declara (com a vinculação indicada, em um componente na fronteira indicada))

e, para um componente em nenhum escopo, que não contribui com nenhum valor desse tipo:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (a vinculação associa uma FeatureRecipe com executionScope: boundary e nenhuma fronteira que contém o componente a declara (com a vinculação indicada))

Como corrigir: declare a vinculação sob features: na fronteira para a qual ela deve gerar — o escopo em que o componente está, ou um que o envolva — em vez de apenas no componente. Onde o que você queria era uma geração por componente, vincule em vez disso uma Feature cuja FeatureRecipe não declare o escopo de fronteira.

The sandbox refused a plugin (A sandbox recusou um plugin)

Todo plugin relata o que é e do que precisa antes de ter permissão para fazer qualquer trabalho, e a sandbox confere esse relato com o que está disposta a conceder. Esta condição cobre toda a classe de relatos que a sandbox não aceita, e a frase diz qual parte dele foi recusada: uma versão da interface de plugins que o hospedeiro não fala, um tipo de plugin para o qual o hospedeiro não tem vocabulário, um plugin que pede acesso de saída à rede ou acesso ao sistema de arquivos, um plugin que nomeia uma chamada ao hospedeiro fora do conjunto que o hospedeiro oferece ou que importa de um namespace fora do conjunto que ele admite, um export ausente ou malformado, um campo que traz um valor fora do conjunto ao qual está restrito, ou uma autodeclaração que não é legível de forma alguma.

A recusa acontece antes de o plugin ser executado, e um plugin recusado é encerrado antes que a falha se propague, então nada do que ele pediu é concedido, nem mesmo brevemente.

Parte do que um plugin não pode ter não é verificada aqui, porque nunca é concedida. O hospedeiro dá a um convidado um relógio congelado, nenhum sistema de arquivos, nenhum ambiente e nenhum lugar para onde sua própria saída possa ir, então um convidado que tenta alcançar qualquer um deles falha na tentativa, em vez de ser recusado de antemão. O que esta condição cobre é o relato que o plugin faz sobre si mesmo, verificado antes de ele iniciar.

Mensagens emitidas. A frase da condição fecha cada uma, e o que a precede nomeia o plugin e a parte do seu relato que foi recusada. Uma versão de interface que o hospedeiro não fala:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (o plugin indicado declara a abi_version indicada; o hospedeiro fala a versão suportada indicada: wasm: plugin recusado pela sandbox)

um tipo de plugin para o qual o hospedeiro não tem vocabulário:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (o plugin indicado declara um plugin_type desconhecido, o indicado: wasm: plugin recusado pela sandbox)

uma autodeclaração que não pode ser lida:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: a saída de describe() do plugin indicado não é JSON válido: com o resultado da leitura indicado: wasm: plugin recusado pela sandbox)

um plugin ao qual falta o export que seu tipo exige, nomeado a partir do mesmo registro do qual o próprio tipo é lido:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (o plugin indicado, do tipo indicado, não declara o export indicado: wasm: plugin recusado pela sandbox)

um campo restrito a um conjunto fixo que traz outra coisa — a mesma forma cobre o modo de montagem e os campos operates e scope de cada export:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (o export indicado do plugin indicado declara um escopo desconhecido, o indicado (esperado um dos valores indicados, ou vazio): wasm: plugin recusado pela sandbox)

uma capacidade pareada declarada sem seus dois exports, ou os exports sem a reivindicação:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (o plugin indicado declara a capacidade de ligação entre fronteiras, mas não exporta os dois exports indicados: wasm: plugin recusado pela sandbox)

um nome de capacidade que nenhuma Recipe jamais poderia selecionar — um provedor que serve um nome contendo dois-pontos, ou uma etapa de pipeline compatível com um deles — porque o capability: de uma Recipe é lido como o nome até seus últimos dois-pontos, seguido de uma fixação de versão. O parse:<format> de um parser e o import:<format> de um importador não são recusados: os dois-pontos fazem parte desses nomes, e eles são buscados por formato, e não por meio de uma Recipe. A mesma recusa impede que a entidade de um plugin assim seja gerada para publicação:

plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (o plugin indicado (com o plugin_type indicado) serve a capacidade indicada, que contém dois-pontos; a referência de capacidade de uma Recipe é lida como a capacidade até seus últimos dois-pontos, seguida de uma fixação de versão, então nenhuma Recipe pode nomear essa capacidade: relate o nome da capacidade sem dois-pontos: wasm: plugin recusado pela sandbox)

e as chamadas ao hospedeiro que um plugin reivindica em relação às que seu binário de fato usa, o que é verificado nas duas direções para que um plugin não possa nem anunciar uma superfície que não usa nem esconder uma que usa:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (o plugin indicado declara em describe() a função do hospedeiro indicada, que seu wasm não importa: wasm: plugin recusado pela sandbox) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (o plugin indicado importa a função do hospedeiro indicada, que seu describe() não declara: wasm: plugin recusado pela sandbox)

Como corrigir: nada nos seus arquivos de entidade causa isso, e nenhuma alteração de autoria o elimina — o relato que está sendo recusado é o do próprio plugin. Se você consome um plugin publicado, relate a mensagem a quem o publica e, enquanto isso, selecione uma versão que o hospedeiro aceite. Se o plugin é seu, a mensagem nomeia o campo e os dois valores, então a correção é aquela para a qual a frase aponta: fale a versão de interface que o hospedeiro fala, declare um tipo que ele conheça, mantenha cada campo dentro do conjunto ao qual está restrito, declare o export que seu tipo exige e declare exatamente as chamadas ao hospedeiro que seu binário usa — nem mais, nem menos.

A plugin is not the kind of plugin the socket expects (Um plugin não é do tipo de plugin que o socket espera)

Cada ponto de vinculação informa para qual tipo de plugin despacha, e cada plugin relata o seu próprio tipo. Esta condição é o que uma divergência entre os dois relata: um plugin que serve um provedor vinculado onde se espera um linter, um parser vinculado onde se espera um importador, um plugin que não é um comando de terminal executado como tal. A verificação acontece quando o plugin é carregado, então um plugin do tipo errado nunca chega ao trabalho que lhe teria sido pedido.

O motivo pelo qual ela para em vez de tentar mesmo assim é que os tipos não compartilham uma interface. Um plugin de outro tipo seria chamado por meio de exports que não tem, e o que voltasse seria lido em relação a uma estrutura que ele nunca produziu.

A leitura da autodeclaração de um plugin sem afirmar um tipo não é afetada. Uma superfície que só quer saber o que um plugin diz sobre si mesmo — listar o que está configurado, gerar uma entidade para um plugin — não expressa nenhuma expectativa, e esta verificação é pulada ali.

Mensagem emitida, que nomeia o plugin e os dois tipos, com o tipo esperado dado por extenso além de em seu valor declarado:

wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: o plugin indicado: era esperado um plugin do tipo indicado por extenso (com o tipo de plugin esperado indicado), mas seu describe() relata o tipo de plugin indicado: wasm: o tipo de plugin declarado não corresponde ao describe() do plugin)

Como corrigir: vincule um plugin do tipo que o ponto de vinculação aceita — a mensagem nomeia o tipo esperado. Onde o plugin é aquele que você pretendia, a vinculação está no lugar errado: mova-a para a superfície à qual o tipo dele pertence. Onde você escreve o plugin e ele deveria ser do tipo esperado, ele está relatando o tipo errado sobre si mesmo, e isso é uma correção no plugin, e não na configuração que o vincula.

A plugin failed while it was running (Um plugin falhou durante a execução)

Um plugin ao qual se pediu que fizesse algo não voltou com um resultado. Três condições cobrem isso, e o que as separa é apenas como a falha se propagou — um plugin que travou, um plugin que interrompeu a própria execução e um plugin que foi executado até o fim e relatou que não conseguia fazer o que foi pedido. Elas formam deliberadamente uma única taxonomia, para que uma build trate da mesma forma todas as maneiras pelas quais um plugin pode falhar.

Um plugin que travou. A maioria das falhas dentro de um plugin — uma instrução inalcançável, uma divisão por zero, uma leitura fora da sua memória — é convertida em falhas comuns na saída e nunca chega a esta condição. Esta é a rede de proteção por trás desse caminho, para um travamento que escape dele.

Um plugin que interrompeu a própria execução. Um plugin que pede para sair está fazendo algo para o qual o modelo de plugins não tem uso: um plugin devolve seu resultado por meio da chamada com a qual foi invocado, e não saindo. A própria execução dele para; o processo da build não é afetado.

Um plugin que relatou uma falha. O envelope de resultado que um plugin devolve tem um lugar para ele dizer que não conseguiu concluir, e uma mensagem que diz isso é repassada como uma falha, em vez de ser lida como um resultado.

Mensagens emitidas, cada uma nomeando o plugin ou o export e trazendo o que quer que a falha tenha fornecido. Um travamento traz o valor recuperado:

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: o plugin convidado indicado entrou em pânico no export indicado: com o valor recuperado indicado: wasm: o plugin convidado entrou em pânico durante a chamada)

um plugin que parou por conta própria traz o código com o qual parou:

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: a chamada do plugin indicado ao export indicado invocou proc_exit com o código indicado: wasm: o plugin invocou proc_exit)

e uma falha relatada traz a mensagem própria do plugin:

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (chamada ao export indicado: wasm: o plugin convidado relatou um erro: com a mensagem do plugin indicada)

Como corrigir: nada nos seus arquivos de entidade causa nenhuma das três, e nenhuma alteração de autoria as elimina — cada uma é uma falha dentro do plugin. Relate a mensagem a quem o publica, nomeando o export que ela identifica, e fixe o plugin em uma versão que funcionava enquanto ele é corrigido. Se o plugin é seu: devolva uma falha no envelope de resultado em vez de travar ou sair, para que a build receba uma mensagem que possa mostrar; e, onde a falha relatada é a resposta ponderada do próprio plugin, a mensagem dele é o que um leitor verá, então vale a pena dizer o que na entrada ele não conseguiu aceitar.

A plugin returned something that is not the shape the socket reads (Um plugin devolveu algo que não tem a estrutura que o socket lê)

Cada ponto de vinculação lê o resultado que recebe de volta em relação à estrutura que espera, e recusa qualquer outra coisa — um campo que a estrutura não declara, um campo cujo valor não é do tipo declarado para ele, ou bytes que não são de forma alguma um resultado bem formado.

Ele recusa em vez de ler o que consegue, e o motivo é que ler o que consegue seria silencioso. Qual export uma vinculação chama pode ser escolhido por vinculação, então uma vinculação pode nomear um export cujo resultado tem uma estrutura totalmente diferente. Pular as partes que não se encaixam produz um resultado vazio — e um resultado vazio é em si uma resposta legítima: nenhum veredito devolvido, nenhuma constatação levantada. Os dois seriam então indistinguíveis, e uma build seguiria exatamente como se o plugin a tivesse aprovado.

Mensagem emitida, que nomeia o export do qual o resultado voltou e traz o motivo pelo qual a leitura falhou — juntos, eles identificam o export que a vinculação deveria ter nomeado:

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (chamada ao export indicado: wasm: o plugin convidado devolveu uma saída que não tem a estrutura que o socket lê: com o que não pôde ser lido indicado)

Como corrigir: confira a função de entrada que a vinculação nomeia com os exports que o plugin declara — uma vinculação apontada para o export errado é a causa comum, e o motivo na mensagem nomeia o campo que não pertence à estrutura. Onde o export é o correto, o plugin está devolvendo uma estrutura que o ponto de vinculação não lê, o que é uma correção no plugin; relate isso a quem o publica, citando tanto o export quanto o motivo.

A plugin returned a diagnostic at a severity that is not declared (Um plugin devolveu um diagnóstico com uma severidade que não está declarada)

Um plugin pode devolver observações junto com seu resultado, e cada uma traz uma severidade de um conjunto fechado: uma que para a build e nomeia o que corrigir, uma que é mostrada ao lado de uma build que ainda assim é concluída, e uma que registra a observação e não muda nada. Uma severidade fora desse conjunto é uma para a qual o hospedeiro não tem nenhum encaminhamento, e a build para.

Ele recusa em vez de escolher um encaminhamento, e as duas alternativas são piores. Ignorar uma observação que não consegue encaminhar seria tratá-la como algo sem nada a fazer — o que, onde o plugin está decidindo se aceita a build, é lido como aprovação: uma objeção que o plugin levantou deixaria a build passar sem nunca ser mostrada. Tratá-la como a severidade que para a build rejeitaria uma build por um valor que ninguém escolheu. Ambas são silenciosas, então o hospedeiro diz que o valor está errado e, em vez disso, o plugin é corrigido.

A verificação é executada uma única vez, onde o resultado é lido, e não em cada lugar em que uma observação é mostrada depois — que é também o único ponto em que a identidade do plugin ainda está à mão, já que uma observação incorporada a um relato não sabe mais qual plugin a levantou.

Mensagem emitida, que nomeia o plugin, o export, qual observação estava com defeito, seu valor e os valores declarados:

plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (chamada ao export indicado do plugin indicado: wasm: o plugin convidado devolveu um diagnóstico cuja severidade o contrato não declara: o diagnóstico com o índice indicado tem a severidade indicada; as severidades declaradas são as três indicadas)

Como corrigir: nada nos seus arquivos de entidade causa isso — o valor veio do plugin. Relate-o a quem publica o plugin, citando o valor que a mensagem nomeia. Se o plugin é seu, emita uma das três severidades declaradas; a mensagem as nomeia, e o índice informa qual observação examinar.

A provider returned two output files under one path (Um provedor devolveu dois arquivos de saída sob um mesmo caminho)

Um provedor devolve sua saída como uma lista de arquivos, cada um nomeando o caminho em que é escrito. O hospedeiro os coleta indexados por caminho e escreve os bytes de cada arquivo exatamente como estão, sem executar nenhum serializador próprio. Dois arquivos que nomeiam o mesmo caminho deixam essa coleção com dois valores para uma única chave.

Ele recusa em vez de escolher um, porque nenhuma das duas escolhas pode ser distinguida da outra depois. Manter o último descarta um arquivo que o provedor mandou escrever; manter o primeiro descarta um posterior. De qualquer forma, a saída em disco é bem formada e tem um arquivo a menos, sem que nada registre que um arquivo foi descartado — e o caminho que sobreviveu é o caminho que teria sobrevivido de qualquer jeito, então nada no resultado diz que houve uma colisão. Qual dos dois era o pretendido é uma pergunta que só o provedor pode responder.

Ela é levantada onde quer que um provedor devolva arquivos: ao renderizar um nó e ao montar a saída de um grupo de despacho em um único artefato. A condição e a correção são as mesmas nos dois casos, então ambos a relatam.

Mensagem emitida, que nomeia o caminho devolvido duas vezes e o nó ou o caminho de despacho para o qual foi devolvido:

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (o convidado provedor devolveu dois arquivos de saída sob um mesmo caminho; um convidado conforme devolve cada caminho de saída no máximo uma vez (com o caminho e o nó indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso — os caminhos vieram do provedor. Relate isso a quem o publica, citando o caminho que a mensagem nomeia. Se o provedor é seu, devolva cada caminho de saída no máximo uma vez: construa a lista de caminhos em relação a um conjunto, para que um segundo arquivo em um mesmo caminho seja detectado onde é produzido, e dê ao segundo arquivo um caminho distinto se ambos forem desejados.

A provider reported a render fact whose value is not a list (Um provedor relatou um fato de renderização cujo valor não é uma lista)

Um provedor pode relatar fatos sobre a saída que renderizou junto com seus arquivos — um nome e um valor cada, no vocabulário documentado próprio desse provedor — e as Features vinculadas a um componente os leem a partir de seus templates. O valor de cada fato é uma lista, mesmo quando contém uma única entrada: um mesmo nome pode ser relatado por mais de uma renderização de um componente, as chamadas ao seu próprio provedor e as renderizações das Features vinculadas a ele, e as listas são unidas em uma só sob esse nome para os templates que o leem. Um provedor não tem como saber, ao renderizar, se o seu relato será o único sob um nome, então um valor que seja um objeto, uma string, um número, um booleano ou null é recusado onde o provedor o entrega, em toda renderização, quer algum template leia o fato, quer não.

Mensagem emitida, que nomeia o fato, o nó para o qual foi relatado, o provedor que o relatou e de que tipo era o valor:

provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (o convidado provedor relatou um fato de renderização cujo valor não é uma lista; um convidado conforme relata o valor de todo fato de renderização como um array JSON, mesmo com uma única entrada (com o fato, o nó e o provedor indicados; o seu valor é do tipo indicado))

Como corrigir: nada nos seus arquivos de entidade causa isso — o valor veio do provedor. Relate isso a quem o publica, citando o fato que a mensagem nomeia. Se o provedor é seu, relate o valor desse fato como um array JSON — um único objeto se torna uma lista que contém esse objeto — e documente-o como lista nos fatos que o seu provedor relata; veja Relatar fatos sobre o que um convidado emitiu.

Quando uma conexão cruza entre dois grupos de despacho, pede-se ao provedor de cada lado que a cabeie: a extremidade consumida publica uma identidade, a extremidade consumidora se resolve em relação a ela, e cada uma pode devolver um cabeamento estrutural a ser aplicado à saída do seu próprio grupo. Cada peça de cabeamento nomeia o arquivo de saída ao qual se aplica. Uma passagem posterior recorta esse arquivo, aplica as operações e o remonta com fidelidade byte a byte.

Um nome que não corresponde a nenhum arquivo emitido não deixa nada para essa passagem recortar, e ela recusa em vez de ignorar o cabeamento. As operações que ele traz são o que resolve a conexão, então descartá-las deixa uma saída montada que faz referência a uma extremidade que nada cabeou — o que falha no momento da implantação, longe do provedor que causou o problema, e parece um erro na conexão, e não no cabeamento.

Os arquivos que uma peça de cabeamento pode nomear são os arquivos que a renderização própria desse grupo devolveu. Eles são entregues ao provedor na mesma chamada, então o provedor nunca precisa adivinhar um nome: ele escolhe um do conjunto que recebeu.

Mensagem emitida, que nomeia o arquivo que o cabeamento pediu e a extremidade para a qual foi devolvido:

link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>") (o patch de ligação nomeia um arquivo de saída que o grupo de despacho não emitiu; um patch de ligação conforme nomeia um arquivo que a renderização própria do grupo devolveu (com o arquivo e o nó indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso — o nome veio do provedor. Relate isso a quem o publica, citando o arquivo que a mensagem nomeia. Se o provedor é seu, tire o nome do arquivo dos arquivos montados que a chamada lhe entrega, e não de um nome construído de forma independente — um caminho composto à mão fica obsoleto no momento em que muda a renderização que o produz, e é com isso que esse problema se parece.

A pipeline step’s file emission carries no file (A emissão de arquivo de uma etapa de pipeline não traz nenhum arquivo)

Uma etapa de pipeline pode emitir um novo documento junto com os documentos aos quais aplica patches. Cada emissão declara o seu tipo, e uma emissão do tipo arquivo traz o arquivo que escreve: o caminho e o conteúdo.

Aqui o tipo está correto e o arquivo está ausente, então a etapa declarou uma intenção que a sua resposta não cumpre. Essa é a diferença entre esta interrupção e a de tipo não definido mais abaixo: o hospedeiro sabe exatamente o que fazer com uma emissão emit_file e não tem nada a que aplicar isso.

Ele recusa em vez de não emitir nada, porque uma emissão que silenciosamente não contribuísse com nenhum arquivo seria invisível. Uma etapa que emite um documento é muitas vezes toda a razão de ela estar no pipeline, e a sua saída é um arquivo que antes não existia — então uma build que a pulasse produziria uma saída sem um documento, enquanto a etapa relata que foi executada.

Mensagem emitida, que nomeia o nó e qual das emissões da etapa estava com defeito:

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (o efeito colateral emit_file não traz nenhum arquivo; um efeito colateral emit_file conforme traz um arquivo com o seu caminho e o seu conteúdo (com o nó e o índice do efeito colateral indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso — a resposta veio do plugin. Relate isso a quem o publica, citando o índice que a mensagem nomeia. Se o plugin é seu, preencha o membro de arquivo em toda emissão emit_file, com o caminho e o conteúdo; o índice informa qual emissão da resposta dessa etapa examinar.

A pipeline step declares an emission kind the contract does not define (Uma etapa de pipeline declara um tipo de emissão que o contrato não define)

Cada emissão que uma etapa de pipeline devolve declara o seu tipo, e o contrato define dois: um escreve um arquivo, o outro contribui com um documento de recurso personalizado. O tipo é uma string aberta no formato de transmissão, e é isso que permite adicionar um tipo posterior sem quebrar os plugins existentes.

Essa abertura é exatamente o motivo pelo qual um tipo não definido é recusado em vez de ignorado. Um valor que o hospedeiro não define não pode ser distinguido, só pela sua estrutura, de um que uma versão posterior definirá — então um hospedeiro que o pulasse descartaria silenciosamente o que a etapa quis dizer com ele, em toda build, enquanto a etapa relata sucesso. Recusar mantém o ponto de extensão aberto sem transformá-lo em um furo: um tipo que esta build não define é relatado como não definido, citando o valor que a etapa enviou, em vez de ser aceito e ignorado.

Mensagem emitida, que nomeia o nó, qual emissão estava com defeito e o tipo que ela declarou:

side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (o efeito colateral declara um tipo que o contrato de plugins não define; um efeito colateral conforme declara emit_file ou emit_crd (com o nó, o índice do efeito colateral e o tipo indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso — o valor veio do plugin. Relate isso a quem o publica, citando o tipo que a mensagem nomeia. Se o plugin é seu, declare um dos tipos que a mensagem lista; um erro de digitação em um tipo definido é a causa comum, e o valor citado de volta é o que você enviou.

A provider’s reassembly is handed a unit its own carve never produced (A remontagem de um provedor recebe uma unidade que o seu próprio recorte nunca produziu)

Um provedor cuja forma de saída não pode ser endereçada diretamente pode recortá-la por conta própria: ele divide um arquivo de saída em unidades endereçáveis, cada uma sob um token, e as devolve. Uma etapa de pipeline então endereça uma unidade por esse token, e a remontagem insere de volta as unidades editadas no arquivo com fidelidade byte a byte. As duas metades são um único contrato — os tokens sob os quais um arquivo é recortado são os tokens que a sua remontagem resolve.

Quando a remontagem recebe um token que o recorte desse mesmo arquivo não produziu, não há nenhum intervalo de bytes para o qual o conteúdo editado possa voltar. Ela recusa em vez de descartar a unidade, porque uma unidade descartada produz um arquivo bem formado ao qual falta uma edição que uma etapa devia fazer: nada falhou, nada está malformado, e a edição simplesmente não está lá.

As duas metades só podem divergir onde estão separadas — um codec que recorta por conta própria e toma emprestada a remontagem estrutural padrão para o resto. Recortar sob um conjunto de tokens e remontar em relação a outro produz então exatamente isto. Um codec que possui as duas metades não pode chegar a isso: a sua própria remontagem responde pelos seus próprios tokens.

Mensagem emitida, que nomeia o token que não se resolveu em nada e o arquivo em relação ao qual foi nomeado:

reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (a remontagem nomeia um token de unidade com patch que o recorte não produziu; um codec conforme recorta e remonta um arquivo sob os mesmos tokens (com o token e o arquivo indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso. Se o provedor é seu, faça com que os tokens que uma metade produz sejam os tokens que a outra resolve: derive-os uma única vez e repasse-os, em vez de derivá-los de forma independente em cada lado, e, onde o recorte reescreve um arquivo antes de dividi-lo, remonte em relação à mesma forma reescrita. Se o provedor não é seu, relate isso a quem o publica, citando o token que a mensagem nomeia.

A workload declares a form compose cannot express (Uma carga de trabalho declara uma forma que compose não consegue expressar)

O provedor compose renderiza serviços de longa duração. Uma carga de trabalho que declara que executa uma cópia por máquina, que é executada de acordo com um agendamento ou que é executada uma vez e termina não tem um equivalente limpo em uma única máquina, então a renderização para em vez de emitir um serviço simples — que a iniciaria, a manteria em execução e representaria de forma equivocada o que foi pedido.

Mensagem emitida. A condição nomeia o tipo de falha — um provedor sem expressão para algo que a build declara — e a frase própria do provedor nomeia a forma que recebeu:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: a forma de carga de trabalho indicada não tem mapeamento no compose; compose suporta apenas stateless e stateful: compose não consegue expressar esta forma de carga de trabalho)

Como corrigir: onde o destino for de fato um ambiente compose de uma única máquina, expresse o trabalho como um serviço de longa duração — as formas stateless e stateful são as duas que ele renderiza. Onde a forma for o que você pretendia, renderize essa fronteira por meio de um provedor cujo destino tenha um equivalente: uma cópia por máquina, uma execução agendada e um job executado até a conclusão têm todos expressões diretas em outros lugares, e a escolha do provedor cabe à fronteira, e não à carga de trabalho.

A container declares a field compose has no primitive for (Um contêiner declara um campo para o qual compose não tem primitiva)

Dois campos de contêiner não têm equivalente no compose, e ambos param a renderização em vez de serem descartados.

Hooks que são executados quando um contêiner inicia ou está prestes a parar. compose não tem nada que os execute, e um hook que silenciosamente não é executado é uma surpresa de correção que aparece em tempo de execução, e não em tempo de build.

Ambiente em bloco obtido de um objeto nomeado. compose consegue ler variáveis de um arquivo, mas uma referência a um objeto não é um arquivo — reinterpretar um como o outro mudaria o que o contêiner recebe sem dizer isso.

Ambos são verificados para contêineres comuns e para contêineres executados antes do principal, então o mesmo campo interrompe a build onde quer que seja declarado, e a mensagem nomeia de qual contêiner ele veio.

Mensagens emitidas. Ambas relatam a mesma condição — um provedor sem expressão para algo que a build declara — e a frase própria do provedor é o que diz qual campo:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: no nó e no contêiner indicados: compose: o nó indicado declara hooks de ciclo de vida do contêiner; compose não tem primitiva de hook de ciclo de vida: compose não tem primitiva de hook de ciclo de vida; o contêiner declara hooks de ciclo de vida)

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: no nó e no contêiner indicados: compose: o nó indicado declara envFrom para o contêiner; compose não tem primitiva de ambiente a partir de objeto: compose não tem primitiva de ambiente a partir de objeto; o contêiner declara envFrom)

Como corrigir: para um destino compose, remova o campo e faça o trabalho dele de outra forma — o trabalho de inicialização pertence a um contêiner executado antes do principal, e o trabalho de desligamento ao tratamento de sinais do próprio contêiner; o ambiente em bloco pode ser escrito como variáveis explícitas, ou fornecido a partir de um arquivo que o destino compose consiga ler. Onde o campo for o que você pretendia, renderize essa fronteira por meio de um provedor cujo destino tenha a primitiva.

An omits entry names a kind or a namespace a compose file does not have (Uma entrada omits nomeia um kind ou um namespace que um arquivo compose não tem)

Uma entrada omits: em uma Recipe ou uma FeatureRecipe que usa um arquivo compose como fonte deixa de fora uma unidade de nível superior desse arquivo, e um arquivo compose tem exatamente três kinds que uma entrada pode nomear — um service, um volume e um config, cada um identificado pela sua chave sob services:, volumes: ou configs: — e nenhum namespace. Uma entrada que nomeia qualquer outro kind, entre eles o Secret de um documento de chart ou uma network do compose, ou que carrega um namespace, não nomeia nada que o arquivo possa deixar de fora, então a renderização para em vez de tratar a entrada como uma que não correspondeu a nada. Os kinds são comparados exatamente, então Service é recusado onde se quer dizer service. Toda entrada é verificada antes que qualquer coisa seja deixada de fora, e a nomeada é a primeira com erro, na ordem em que as entradas foram escritas.

Mensagens emitidas. Ambas relatam a condição de uma construção para a qual um provedor não tem expressão, e a frase própria do provedor nomeia a entrada e os kinds que ele aceita. Um campo cujo template leu um valor declarado sensível é mostrado como <redacted>:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: uma entrada omits (com o nome indicado) nomeia o kind indicado: o compose deixa de fora um serviço, um volume ou uma config, cada um nomeado pela sua chave sob services:, volumes: ou configs:, e nenhum outro kind)

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: uma entrada omits (com o kind e o nome indicados) nomeia o namespace indicado, e um arquivo compose não tem namespaces: o compose deixa de fora um serviço, um volume ou uma config, cada um nomeado pela sua chave sob services:, volumes: ou configs:, e nenhum outro kind; remova o namespace da entrada)

Como corrigir: nomeie a unidade como o arquivo compose faz — kind: service, volume ou config, e como name: a sua chave sob essa seção — e retire o namespace:. Consulte compose → Modo com fonte.

An omits entry names a namespace a CloudFormation template does not have (Uma entrada omits nomeia um namespace que um template CloudFormation não tem)

Uma entrada omits: em uma Recipe ou uma FeatureRecipe que usa um template CloudFormation como fonte deixa de fora um recurso, nomeado pelo seu Type como o kind da entrada e pelo seu ID lógico como o name da entrada. Um template não tem namespaces, então uma entrada que carrega um namespace não nomeia nada que um template possa deixar de fora, e a renderização para em vez de tratar a entrada como uma que não correspondeu a nada. Toda entrada é verificada antes que qualquer coisa seja deixada de fora, e a nomeada é a primeira que carrega um namespace, na ordem em que as entradas foram escritas.

Mensagem emitida. Ela relata a condição de uma construção para a qual um provedor não tem expressão, e a frase própria do provedor nomeia a entrada e o que este provedor deixa de fora. Um campo cujo template leu um valor declarado sensível é mostrado como <redacted>:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry (cloudformation-provider: uma entrada omits (com o kind e o nome indicados) nomeia o namespace indicado, e um template CloudFormation não tem namespaces: o cloudformation deixa de fora um recurso, nomeado pelo seu Type como o kind da entrada e pelo seu ID lógico sob Resources como o nome da entrada; remova o namespace da entrada)

Como corrigir: retire o namespace: da entrada, que nomeia o recurso apenas pelo seu Type e pelo seu ID lógico. Consulte cloudformation → Deixando recursos de fora de um template de origem.

A published port declares a transport compose cannot spell (Uma porta publicada declara um transporte que o compose não consegue escrever)

Uma porta publicada do compose carrega o seu transporte como sufixo na entrada, e esse sufixo tem duas grafias. Uma porta que declara qualquer outro transporte não tem nenhuma grafia no compose.

A renderização para em vez de descartar o sufixo, porque uma porta publicada que recorre silenciosamente ao transporte padrão sobe carregando tráfego que os seus clientes não conseguem alcançar — que é exatamente a falha que declarar um transporte existe para evitar, reintroduzida no momento da tradução.

Uma porta que não declara nenhum transporte não é afetada. Ela é publicada sem sufixo, exatamente como seria uma porta que nunca carregou um transporte.

Mensagem emitida. A condição nomeia o tipo de falha — um valor sem representação naquilo que o provedor emite — e a frase própria do provedor vem em seguida:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (compose: no nó indicado, aplicação das portas do serviço: o compose publica o transporte de uma porta como sufixo tcp ou udp; esta porta declara um transporte que o compose não consegue expressar)

Como corrigir: para um destino compose, declare o transporte da porta como um dos dois que o compose consegue escrever, ou deixe-o sem declarar e deixe a entrada ser publicada sem sufixo. Quando o transporte é o que você pretendia, renderize essa fronteira por meio de um provedor cujo destino consiga expressá-lo.

A resources quantity cannot be converted to a compose value (Uma quantidade de recursos não pode ser convertida em um valor do compose)

As quantidades de processador e de memória de um contêiner, e a sua contagem nvidia.com/gpu, são escritas na notação que o Kubernetes usa para recursos, e o compose as carrega em unidades próprias — uma contagem de GPU se torna a contagem de uma reserva de dispositivos NVIDIA —, então cada uma é lida como uma quantidade e convertida a partir do seu valor. Duas coisas impedem isso, e a mensagem diz qual encontrou: um valor que não é uma quantidade de forma alguma, e uma quantidade para a qual o compose não tem forma exata — uma quantidade negativa, uma quantidade de memória que não é um número inteiro de bytes, uma quantidade de processador mais fina que nove casas decimais de um núcleo, uma contagem de GPU que não é um número inteiro de dispositivos, ou uma quantidade além da maior que o compose consegue armazenar. Um contêiner cuja solicitação e cujo limite nvidia.com/gpu pedem contagens diferentes também interrompe a renderização, porque o compose reserva uma única contagem para um serviço. A renderização para em vez de arredondar o valor ou emitir uma aproximação, porque um limite que silenciosamente não é o limite pedido é o tipo de diferença que ninguém procura até que algo seja parado por excedê-lo.

Mensagens emitidas. Cada uma começa com a condição — um valor sem representação naquilo que o provedor emite —, depois nomeia o recurso, se o valor é uma solicitação ou um limite, o seu caminho no Workload e o valor. Um valor que não é uma quantidade é seguido do que o impediu de ser uma e da forma que uma quantidade assume:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value (compose: no nó e no contêiner indicados: compose: a solicitação ou o limite indicado do recurso indicado, no caminho indicado: o valor indicado não é uma quantidade: com o motivo indicado; uma quantidade é um número como 2, 0.5 ou 1.5, com um sinal opcional e no máximo um entre um expoente inteiro (1e3, 5E-2) ou um sufixo de unidade (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): a quantidade de resources não pode ser convertida em um valor deploy.resources do compose)

Uma quantidade que o compose não consegue representar é seguida do intervalo que o compose admite para esse recurso:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: no nó e no contêiner indicados: compose: a solicitação ou o limite de memória indicado, no caminho indicado, é o valor indicado, uma quantidade que o compose não consegue representar exatamente; um valor de memória do compose é um número inteiro de bytes de 0 a 9223372036854775807: a quantidade de resources não pode ser convertida em um valor deploy.resources do compose)

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value (compose: no nó e no contêiner indicados: compose: a solicitação ou o limite de cpu indicado, no caminho indicado, é o valor indicado, uma quantidade que o compose não consegue representar exatamente; um valor cpus do compose é uma contagem de núcleos de 0 a 9223372036.854775807 com no máximo nove casas decimais: a quantidade de resources não pode ser convertida em um valor deploy.resources do compose)

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: no nó e no contêiner indicados: compose: a solicitação ou o limite nvidia.com/gpu indicado, no caminho indicado, é o valor indicado, uma quantidade que o compose não consegue representar exatamente; uma contagem de dispositivos do compose é um número inteiro de dispositivos de 0 a 9223372036854775807: a quantidade de resources não pode ser convertida em um valor deploy.resources do compose)

Uma solicitação e um limite de GPU que pedem contagens diferentes nomeiam ambos os caminhos e ambas as contagens:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value (compose: no nó e no contêiner indicados: compose: a solicitação nvidia.com/gpu no caminho indicado e o limite no caminho indicado pedem contagens diferentes (as indicadas); o compose reserva uma única contagem de dispositivos para um serviço, então escreva a mesma contagem em ambos ou apenas o limite: a quantidade de resources não pode ser convertida em um valor deploy.resources do compose)

Quando o template do Workload lê um valor que um autor declarou sensível, nenhuma mensagem cita o valor que recusou, e as duas contagens são omitidas da mesma forma.

Como corrigir: quando o valor não é uma quantidade, escreva-o na forma descrita em Workload → Quantidades de recursos; um sufixo solto como m é o que um template deixa quando o valor que interpola está vazio, então a entrada a corrigir é a que o template leu. Quando é uma quantidade que o compose não consegue representar, escreva uma quantidade dentro do intervalo que a mensagem informa — a memória como um número inteiro de bytes em qualquer unidade (1536Mi em vez de 1.5001Gi), o tempo de processador com no máximo nove casas decimais de um núcleo, e uma contagem de GPU como um número inteiro de dispositivos (1, não 0.5 nem 500m). Quando uma solicitação e um limite de GPU divergem, escreva a mesma contagem em ambos, ou escreva apenas o limite, que é a contagem que o Kubernetes agenda para o mesmo Workload.

A resource quantity the helm provider emits is not a quantity (Uma quantidade de recurso que o provedor helm emite não é uma quantidade)

O provedor helm copia literalmente cada quantidade de recurso nos manifestos que emite — os valores resources.requests e resources.limits de cada contêiner e contêiner de inicialização, recursos estendidos incluídos, e o ephemeral.sizeLimit, o persistent.size e o persistentTemplate.size de cada volume — e primeiro verifica cada uma em relação à forma de uma quantidade, no Workload tal como os templates da Recipe o avaliaram. Um valor fora dessa forma interrompe a build aqui, onde de outro modo seria compilado sem erros e recusado pelo cluster quando o chart fosse instalado.

Mensagem emitida. Ela começa com a condição, depois nomeia o nó, o caminho do campo no Workload, o valor e o que o impediu de ser uma quantidade, e informa a forma que uma quantidade assume:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: no nó indicado: caminho indicado: o valor indicado não é uma quantidade: com o motivo indicado; uma quantidade é um número como 2, 0.5 ou 1.5, com um sinal opcional e no máximo um entre um expoente inteiro (1e3, 5E-2) ou um sufixo de unidade (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei))

Como corrigir: escreva o valor na forma descrita em Workload → Quantidades de recursos. Quando o campo é um template, o valor a corrigir é o que o template leu: um sufixo solto como m ou Mi é o que um template deixa quando o valor que interpola está vazio, e um parâmetro da Release chega ao campo exatamente como foi escrito.

A service type the helm provider cannot render (Um tipo de serviço que o provedor helm não consegue renderizar)

O provedor helm renderiza cada entrada services de um Workload como um Service do Kubernetes cujo tipo é o type da entrada. Uma entrada Loopback pede que as suas portas sejam alcançáveis a partir do próprio endereço de loopback do host e de nenhum outro lugar, e um Service do Kubernetes não tem nenhum tipo que faça isso: em quais endereços de nó um Service NodePort escuta é uma configuração do cluster inteiro, não de um único Service. Então a build para na primeira entrada Loopback, na ordem em que os serviços são declarados, antes que qualquer recurso seja escrito.

A build para em vez de renderizar a entrada como outro tipo, porque cada um dos tipos que um Service tem muda o que a porta alcança: um Service ClusterIP descarta o alcance publicado que a entrada pede, e um NodePort publica a porta em todo endereço de nó que o cluster permite — a exposição mais ampla que a entrada existe para evitar.

Mensagem emitida. Ela começa com a condição, depois nomeia o nó, o caminho do serviço no Workload e o tipo:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: no nó indicado: serviço indicado em services: o tipo “Loopback” publica as portas do serviço apenas no endereço de loopback do host, e um Service do Kubernetes não tem nenhum tipo que faça isso; declare ClusterIP para manter as portas dentro do cluster, ou NodePort ou LoadBalancer para publicá-las fora dele)

Como corrigir: para um destino helm, declare o tipo que diz até onde a porta deve alcançar no cluster — ClusterIP para mantê-la dentro, NodePort ou LoadBalancer para publicá-la. Uma entrada Loopback é para um destino compose, que publica a porta em 127.0.0.1; consulte Workload → services.

A Kubernetes version the helm provider cannot render a chart for (Uma versão do Kubernetes para a qual o provedor helm não consegue renderizar um chart)

O provedor helm renderiza um chart a partir da fonte para a versão do Kubernetes que a anotação aggrega.ai/kubernetes-version nomeia em um componente ou na sua fronteira, e lê o valor da maneira como helm template --kube-version lê a sua flag. Um valor que essa flag recusaria — "one.two", "latest", um único número como "1", um número escrito com um zero à esquerda como "01.20" — não tem nenhuma versão que o chart possa ler como .Capabilities.KubeVersion, então a build para antes que o chart seja renderizado.

A build para em vez de renderizar o chart para a versão padrão, porque um chart lê a versão para escolher uma versão de API, um campo ou um mecanismo inteiro, e um chart renderizado para uma versão diferente da que você nomeou emite a forma daquela outra versão — uma que o cluster em que ele é implantado pode não executar.

Um valor vazio não é recusado. Ele é tratado como não definido, e o chart é renderizado para o padrão: a versão para a qual o helm template original da mesma versão do helm renderiza.

Mensagem emitida. Ela começa com a condição, depois nomeia o nó e a fronteira em que ele está colocado, a anotação, o valor e o que o impediu de ser uma versão, e informa a forma a escrever:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: no nó indicado, na fronteira indicada: anotação aggrega.ai/kubernetes-version: o valor indicado não é uma versão do Kubernetes para a qual um chart possa ser renderizado: com o motivo indicado; escreva a versão do cluster em que o chart é implantado, como “1.31” ou “v1.31.2”, no componente ou na sua fronteira)

A mensagem nomeia tanto o nó quanto a sua fronteira porque o provedor lê juntas as anotações de um componente e as da sua fronteira, prevalecendo o valor próprio do componente, então o valor pode ter sido escrito em qualquer um dos dois.

Como corrigir: escreva a versão do cluster em que o chart é implantado — uma versão principal e secundária como "1.31", ou uma completa como "v1.31.2" — no componente ou na sua fronteira, ou remova a anotação para renderizar para o padrão. Consulte helm → A versão do Kubernetes para a qual um chart é renderizado.

A health probe cannot be turned into a compose healthcheck (Uma sonda de integridade não pode ser transformada em um healthcheck do compose)

Uma sonda de integridade declarada se torna um healthcheck do compose, e duas coisas podem impedir isso.

Uma sonda que verifica um caminho por HTTP, em um contêiner que não publica nenhuma porta. A verificação é construída como uma requisição a uma porta do contêiner, então sem nenhuma porta declarada não há endereço contra o qual construí-la.

Uma sonda que não declara nenhuma forma de verificação — nem um caminho, nem uma porta à qual se conectar, nem um comando a executar. Não há nada a transformar em uma verificação. Esta é uma salvaguarda por trás do esquema, e não uma forma que você provavelmente escreverá: verifica-se se uma sonda tem uma das três antes que ela chegue aqui.

Mensagens emitidas. Ambas relatam a mesma condição — algo que o provedor exige e que ele não conseguiu resolver para exatamente um valor — e a frase própria do provedor diz qual:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: no nó e no contêiner indicados: sonda http: exige pelo menos uma porta de contêiner; o contêiner não declara nenhuma)

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: no nó e no contêiner indicados: a sonda não declara nenhuma forma (http/tcp/exec))

Como corrigir: declare a porta contra a qual a verificação deve ser feita no mesmo contêiner da sonda — uma sonda por HTTP lê a primeira porta do contêiner, então a porta precisa existir para que a verificação seja construída. Quando o contêiner realmente não publica nada, verifique-o de outra forma: uma sonda que executa um comando não precisa de porta. Para uma sonda sem nenhuma forma de verificação declarada, dê a ela uma das três.

A configmap volume has no file behind it (Um volume configmap não tem nenhum arquivo por trás)

Um volume que monta configuração é entregue pelo mecanismo próprio do compose para isso, referenciado por nome, e a entrada que contém o conteúdo vem de um arquivo que a Recipe emite. Esta condição é o que uma referência sem entrada correspondente relata: o arquivo não está lá, então o ponto de montagem existiria sem nada por trás e o contêiner subiria lendo um caminho vazio.

A verificação é executada sobre toda a saída montada em vez de por componente, e isso é deliberado: a referência e a entrada que contém o conteúdo chegam por caminhos diferentes e podem vir de componentes diferentes do mesmo grupo, então a saída montada é o primeiro ponto em que ambas estão presentes. Uma verificação por componente recusaria uma referência cujo conteúdo outro componente do mesmo grupo fornece.

Toda referência não resolvida é relatada, e não só a primeira, em uma ordem estável, então uma única build nomeia todas elas.

Mensagem emitida. A condição vem primeiro, depois cada serviço, a referência que ele fez e onde ela é montada:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found (compose AssembleBoundary: o serviço indicado referencia a config indicada, montada no caminho indicado; declare cada uma como uma entrada configs: de nível superior a partir da entrada artifacts: da Recipe: um volume configmap exige um arquivo emitido pela entrada artifacts: da Recipe; nenhum encontrado)

Como corrigir: emita o arquivo a partir da entrada artifacts: da Recipe sob o nome que o volume referencia — os dois são associados por esse nome, então uma divergência entre o que o volume pede e o que a Recipe emite é a causa comum. Quando o conteúdo deveria vir de outro lugar, o volume é o mecanismo errado para isso: um valor que pertence ao ambiente vai para lá em vez disso.

What an omits entry left out is still named by the compose file (O que uma entrada omits deixou de fora ainda é nomeado pelo arquivo compose)

Uma entrada omits: deixa de fora um serviço, um volume ou uma config de um arquivo compose de origem, e o compose recusa um arquivo que nomeia um que ele não declara. Então, uma vez removidas as unidades das entradas, toda referência que o restante do arquivo ainda faz a uma delas interrompe a renderização: um serviço nomeado por depends_on, links, volumes_from, extends, um valor de build.additional_contexts ou um modo de rede, IPC, PID ou UTS service:; um volume nomeado como origem de uma entrada volumes:; uma config nomeada por uma entrada configs: — lidos em cada serviço, nos hooks pre_start de cada serviço e em cada job. A lista completa, e os valores que apenas parecem referências, estão em compose → Modo com fonte.

A verificação lê o arquivo próprio da Recipe ou da FeatureRecipe que declara a entrada, então interrompe a renderização mesmo quando outro contribuidor para o mesmo arquivo montado declara uma unidade com o nome da que foi deixada de fora. Toda referência é relatada, e não só a primeira — os serviços em ordem de chave, depois os jobs, os hooks de cada serviço depois dele —, então uma única build nomeia todas elas.

Mensagem emitida. A condição vem primeiro, depois cada entrada que faz referência, a unidade que ela nomeia e o campo em que a referência está:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) compose: what an omits entry left out is still named by the file: service "<service>" names <kind> "<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry (compose: o que uma entrada omits deixou de fora ainda é nomeado pelo arquivo: o serviço indicado nomeia a unidade do kind e do nome indicados no campo indicado; o compose recusa um arquivo que nomeia um serviço, um volume ou uma config que ele não declara: deixe de fora também o que o nomeia, mude a referência por meio de valuesMapping, ou remova a entrada)

Uma unidade cujo nome de entrada foi construído a partir de um valor declarado sensível é mostrada como <redacted>.

Como corrigir: decida qual das duas coisas você pretendia. Quando o serviço que faz referência ainda precisa da unidade, mantenha-a: remova a entrada. Quando não precisa, mude a referência por meio do valuesMapping: da Recipe — uma lista ali substitui a lista do arquivo base, então depends_on: [] esvazia uma — ou deixe de fora o serviço que faz referência com uma entrada própria.

What an omits entry left out is still named by a CloudFormation template (O que uma entrada omits deixou de fora ainda é nomeado por um template CloudFormation)

Uma entrada omits: deixa de fora um recurso de um template CloudFormation de origem, e o CloudFormation recusa um template que nomeia um recurso que ele não declara. Então, uma vez removidos os recursos das entradas, toda referência que os templates restantes ainda fazem a um deles interrompe a renderização: um Ref, um Fn::GetAtt na sua forma de lista ou na sua forma de string com ponto, o DependsOn de um recurso, ou uma variável de um Fn::Sub — lidos em qualquer parte do corpo de cada recurso e de cada saída. A lista completa, e os valores que apenas parecem referências, estão em cloudformation → Deixando recursos de fora de um template de origem.

A verificação lê juntos os templates próprios da Recipe ou da FeatureRecipe que declara a entrada: uma referência a um ID lógico que outro desses templates ainda declara não é interrompida, enquanto uma a um recurso deixado de fora interrompe a renderização mesmo quando outro componente declara um recurso com esse ID lógico. Toda referência é relatada, e não só a primeira — template por template na ordem em que a fonte os carrega, em cada template os seus recursos e depois as suas saídas em ordem de chave —, então uma única build nomeia todas elas.

Mensagem emitida. A condição vem primeiro, depois cada referência: o template em que ela está, o recurso que ela nomeia, como ela o nomeia e onde ela fica como caminho a partir da raiz do template:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry (cloudformation-provider: o que uma entrada omits deixou de fora ainda é nomeado pelos templates da fonte: o template indicado nomeia o recurso indicado (do tipo indicado) da forma indicada no caminho indicado; o CloudFormation recusa um template que nomeia um recurso que ele não declara: deixe de fora também o que o nomeia, ou remova a entrada)

Quando os campos de uma entrada foram construídos a partir de um valor declarado sensível, o ID lógico e o tipo do seu recurso são mostrados como <redacted>, assim como qualquer passo do caminho que escreva esse ID lógico.

Como corrigir: decida qual das duas coisas você pretendia. Quando o recurso que faz referência ainda precisa do que foi deixado de fora, mantenha-o: remova a entrada. Quando não precisa, deixe de fora também o recurso que faz referência, com uma entrada própria — um valor associado a um parâmetro substitui apenas uma referência a esse parâmetro, então uma referência a um recurso não pode ser mudada dessa forma. Uma saída que nomeia o recurso não pode ser deixada de fora, então um recurso que uma saída nomeia permanece.

A valuesMapping key names no parameter of a sourced CloudFormation template (Uma chave de valuesMapping não nomeia nenhum parâmetro de um template CloudFormation de origem)

Um template CloudFormation de origem recebe valores pelos Parameters que declara, e o valuesMapping da Recipe ou da FeatureRecipe que o usa como fonte escreve uma chave por parâmetro que preenche. Uma chave que não nomeia nenhum parâmetro que algum template da fonte declare não tem para onde ir, então a renderização para em vez de descartá-la — a falha que o próprio CloudFormation relataria para um parâmetro desconhecido, relatada enquanto ainda cabe a você corrigi-la. Somente um valuesMapping preenche parâmetros: valores que nada mapeou nunca são lidos dessa forma, então os valores próprios de um componente ou de uma vinculação escritos para as suas outras entradas nunca encontram isso.

Mensagem emitida. A condição vem primeiro, depois cada chave que não nomeou nada e o que cada template da fonte declara:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping (cloudformation-provider: o valuesMapping da Recipe ou da FeatureRecipe escreve a chave indicada, e nenhum template da fonte declara um parâmetro com esse nome: o template indicado declara o parâmetro indicado, …; um template de origem recebe valores apenas pelos parâmetros que declara, então renomeie a chave para o parâmetro a que ela se destina, ou remova-a do valuesMapping)

Como corrigir: compare a chave com os parâmetros que a mensagem lista — uma chave escrita errado é a causa habitual — e renomeie-a, ou remova-a do valuesMapping. Consulte cloudformation → Valores para os parâmetros de um template de origem.

Another component references a CloudFormation parameter a sourced template’s binding filled (Outro componente referencia um parâmetro do CloudFormation que a associação de um template de origem preencheu)

Preencher o parâmetro de um template de origem por meio do valuesMapping da Recipe ou da FeatureRecipe da Feature vinculada que o usa como fonte substitui toda referência a ele em todo template dessa fonte e remove a sua declaração. O conteúdo de outra parte da mesma stack montada — o fragmento ou o template de origem de outro componente, ou o fragmento do componente ao qual uma Feature está vinculada — que ainda nomeia o parâmetro por meio de Ref, uma variável de Fn::Sub ou o Fn::ValueOf de uma regra nomeia então algo que a stack não declara mais, o que o CloudFormation recusa quando a stack é implantada, então a montagem para. Um nome que algum componente da stack ainda declara, como parâmetro próprio ou como ID lógico de um recurso, é uma referência que a stack resolve e não é interrompida.

Mensagem emitida. A condição vem primeiro, depois cada referência: o componente e o template em que ela está, o parâmetro, e o componente cujo valuesMapping da Recipe ou da FeatureRecipe vinculada o preencheu — uma Feature vinculada a um componente é nomeada por esse componente, e uma vinculada a uma fronteira pela identidade que os seus recursos carregam como aggrega.ai/component-id, composta a partir do caminho da fronteira e do nome da vinculação, como bfr--stack--aux:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (cloudformation-provider: um parâmetro que a associação de um template de origem preencheu ainda é referenciado de outra parte da stack montada: o template indicado do componente indicado referencia o parâmetro indicado, que o valuesMapping de uma Recipe ou FeatureRecipe que renderiza para o componente indicado associa; …; associar um parâmetro remove a sua declaração da fonte que o declara, e nenhum template na stack o declara mais, então a referência não nomeia nada que o CloudFormation possa resolver: referencie em vez disso o que o componente que faz a associação publica, declare o parâmetro no template que o referencia, ou remova a chave do valuesMapping)

Como corrigir: quando o componente que faz referência precisa do valor, faça o componente que o preenche publicá-lo por meio de provides e referencie isso; ou declare o parâmetro no template que faz referência para que ele receba o seu próprio valor; ou remova a chave do valuesMapping, para que o parâmetro continue declarado e todo componente leia o valor passado quando a stack é implantada. Consulte cloudformation → Valores para os parâmetros de um template de origem.

A value bound to a CloudFormation parameter cannot take the parameter’s type (Um valor associado a um parâmetro do CloudFormation não pode assumir o tipo do parâmetro)

Um literal associado a um parâmetro é convertido da maneira como o CloudFormation converte o mesmo valor passado para o Type desse parâmetro quando a stack é implantada. Quando não existe tal conversão, a renderização para: um valor que não é um número associado a um Number ou a um List<Number>, uma lista ou um mapeamento associado a um parâmetro que aceita um único valor, e qualquer literal associado a um parâmetro AWS::SSM::Parameter::Value<…>, cujo valor o CloudFormation lê do Parameter Store em vez do template. Uma lista associada a um parâmetro que o template nomeia como variável de Fn::Sub também interrompe a renderização, porque uma variável substitui uma única string.

Mensagem emitida. A condição vem primeiro, depois o parâmetro, o seu template e o seu tipo, e por que o valor não se encaixa; nenhum valor é citado:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (cloudformation-provider: o parâmetro indicado do template indicado é do tipo indicado, e o valor não se encaixa pelo motivo indicado)

Como corrigir: associe um valor do tipo do parâmetro — ou, para um tipo do Parameter Store, uma referência dinâmica {{resolve:ssm:…}} ou uma função intrínseca — ou deixe o parâmetro sem associação para um valor passado quando a stack é implantada.

A value bound to a CloudFormation parameter is one its constraints refuse (Um valor associado a um parâmetro do CloudFormation é um que as suas restrições recusam)

Um literal associado a um parâmetro é verificado em relação às restrições que o template declara para ele — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue e MaxValue —, a verificação que o CloudFormation faz em um valor passado quando a stack é implantada, antecipada para o momento da build para que preencher um parâmetro não remova nenhuma verificação que o template declarou. Uma função intrínseca e uma referência dinâmica ficam para o CloudFormation verificar, já que o valor delas não existe até que a stack seja implantada.

Mensagem emitida. A condição vem primeiro, depois o parâmetro, o seu template e a restrição; nenhum valor é citado:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (cloudformation-provider: o valor associado ao parâmetro indicado do template indicado não satisfaz a sua restrição indicada, que o CloudFormation recusaria quando a stack fosse implantada; associe um valor que o parâmetro admita)

Como corrigir: associe um valor que a restrição admita; a própria declaração do parâmetro no template lista o que ele permite.

A secret bound to a CloudFormation parameter would be written into the template (Um segredo associado a um parâmetro do CloudFormation seria escrito no template)

Um valor associado a um parâmetro é escrito no template, onde qualquer pessoa que possa ler o template da stack pode lê-lo. A renderização para em um literal associado a um parâmetro que o template declara NoEcho e, onde o valuesMapping da Recipe ou da FeatureRecipe lê um valor que um autor declarou sensível, em todo literal que esse mapeamento associa, já que nenhuma parte da sua saída pode ser rastreada até o valor de onde veio. Uma referência dinâmica e uma função intrínseca são escritas como foram dadas — incluindo o texto dentro de uma função intrínseca —, então um valor sensível que o mapeamento insere em uma string Fn::Sub chega ao template como esse texto, e só uma referência dinâmica mantém o próprio segredo fora dele.

Mensagem emitida. A condição vem primeiro, depois os parâmetros e o que associar no lugar; nenhum valor é citado. Uma destas:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: o parâmetro indicado do template indicado está declarado como NoEcho, e o valor associado a ele seria escrito no template como está; associe em vez disso uma referência dinâmica ({{resolve:secretsmanager:…}} ou {{resolve:ssm-secure:…}}) ou uma função intrínseca, ou deixe o parâmetro sem associação para um valor no momento da implantação)

cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (cloudformation-provider: o valuesMapping da Recipe ou da FeatureRecipe lê um valor declarado sensível, então um literal que ele produz é recusado, e associar o parâmetro ou os parâmetros indicados, … escreveria um literal no template como está; …)

Como corrigir: armazene o segredo no Secrets Manager ou como string segura do Parameter Store e associe uma referência dinâmica que aponte para ele — {{resolve:secretsmanager:<secret>}} ou {{resolve:ssm-secure:<name>}} — em vez de inseri-lo no texto de uma função intrínseca, ou deixe o parâmetro sem associação para um valor passado quando a stack é implantada. Consulte cloudformation → Valores para os parâmetros de um template de origem.

A dynamic reference is bound where CloudFormation does not resolve it (Uma referência dinâmica está associada onde o CloudFormation não a resolve)

O CloudFormation resolve uma referência dinâmica nas propriedades de um recurso, mas não nos dados de usuário do EC2 nem nos metadados AWS::CloudFormation::Init, e mostra os Outputs de um template a quem lê a stack. Então uma referência dinâmica associada a um parâmetro que qualquer template da fonte referencia em uma propriedade UserData, nesses metadados ou nos seus Outputs interrompe a renderização em vez de chegar a um lugar onde ou não pode ser implantada ou fica exposta.

Mensagem emitida. A condição vem primeiro, depois o parâmetro, o template e onde esse template o referencia; nenhum valor é citado:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (cloudformation-provider: o valor associado ao parâmetro indicado é uma referência dinâmica, e o template indicado referencia o parâmetro no local indicado, onde o CloudFormation não resolve uma referência dinâmica ou a mostra a quem lê a stack; associe em vez disso uma função intrínseca, ou deixe o parâmetro sem associação para um valor no momento da implantação)

Como corrigir: deixe o parâmetro sem associação e passe o seu valor quando a stack for implantada, ou associe uma função intrínseca que produza o que o template precisa ali.

A rule reads a bound CloudFormation parameter by name (Uma regra lê pelo nome um parâmetro do CloudFormation associado)

Fn::ValueOf nas Rules de um template nomeia um parâmetro pelo seu ID lógico em vez de por meio de Ref, e lê o valor passado para ele quando a stack é implantada. Associar o parâmetro remove a sua declaração de todo template da fonte, o que deixaria a regra — em qualquer um desses templates — sem nomear nada, então a renderização para.

Mensagem emitida. A condição vem primeiro, depois a regra, o seu template e o parâmetro:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (cloudformation-provider: a regra indicada do template indicado lê o parâmetro indicado por meio de Fn::ValueOf, que nomeia um parâmetro declarado pelo seu ID lógico, e associar o parâmetro remove a sua declaração da fonte; deixe o parâmetro sem associação para que a regra possa lê-lo no momento da implantação)

Como corrigir: remova a chave do parâmetro do valuesMapping, para que o parâmetro continue declarado e a regra leia o valor passado quando a stack é implantada.

The assembled CloudFormation stack cannot carry a transform (A stack do CloudFormation montada não consegue carregar uma transformação)

O Transform da stack montada é construído a partir do de cada componente, e uma transformação processa o template inteiro, então uma transformação cujo efeito não se restringe ao conteúdo escrito para ela é recusada em vez de poder mudar como o conteúdo de outro componente é implantado: AWS::CodeDeployBlueGreen e AWS::Include sempre, uma macro que a sua conta define e AWS::ServiceCatalog ao lado de qualquer outro componente, AWS::LanguageExtensions ao lado do conteúdo serverless de outro componente, e AWS::Serverless-2016-10-31 onde os seus Globals alcançariam os recursos serverless de outro componente ou uma das suas fontes de eventos nomeia um recurso que outro componente declara. A tabela completa está em cloudformation → Seções de nível superior na stack montada.

Mensagem emitida. A condição vem primeiro, depois cada componente na stack, a transformação e os componentes que a declaram, e por que ela não pode ser carregada:

a plugin has no expression for a construct this build declares (um plugin não tem expressão para uma construção que esta build declara) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (cloudformation-provider: a stack montada do componente indicado, … não consegue carregar a transformação indicada, declarada pelo componente indicado: com o motivo indicado)

Como corrigir: coloque o componente que declara a transformação em uma fronteira própria, para que a sua stack não contenha nada que a transformação possa mudar; ou, onde a mensagem nomeia conteúdo que outro componente declara, mova esse conteúdo para o componente que declara a transformação.

Two components order one pair of transforms oppositely (Dois componentes ordenam um mesmo par de transformações de forma oposta)

A stack montada executa as suas transformações em uma única ordem, construída a partir da ordem própria de cada componente e da ordem documentada pelo CloudFormation. Onde duas ordens não podem valer ao mesmo tempo — dois componentes que listam um mesmo par de transformações ao contrário, ou um componente que lista AWS::Serverless-2016-10-31 antes de AWS::LanguageExtensions, que o CloudFormation documenta ao contrário —, não há uma única ordem a escrever, então a renderização para.

Mensagem emitida. A condição vem primeiro, depois o par e quem o ordenou em cada sentido:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (cloudformation-provider: as transformações indicadas estão ordenadas nos dois sentidos — a primeira antes da segunda por quem é indicado, e a segunda antes da primeira por quem é indicado — e o Transform da stack montada as executa em uma única ordem; declare-as em uma única ordem)

Como corrigir: declare o par em uma única ordem em todo componente que liste os dois, seguindo a ordem própria do CloudFormation onde ele documentar uma.

Two entries reach one stack output name (Duas entradas chegam a um mesmo nome de saída da stack)

Um nome de saída da stack só admite letras e dígitos, então ele é construído a partir do que você escreveu codificando os caracteres que esse alfabeto não admite em vez de descartá-los. Duas entradas que você escreveu distintas continuam, portanto, distintas, e esta interrupção é o que relata o caso em que duas delas ainda assim chegam a um mesmo nome. A renderização para em vez de emitir uma única saída onde duas entradas foram escritas, o que descartaria silenciosamente uma delas.

Todo nome atrás do qual duas ou mais entradas se encontraram é relatado, e toda entrada atrás de cada nome é nomeada, em uma ordem estável — assim uma única build mostra a você a colisão inteira em vez de um lado dela.

Mensagem emitida, que começa com a condição e continua com o detalhe próprio do provedor:

two things a plugin produced occupy one name in its output (duas coisas que um plugin produziu ocupam um mesmo nome na saída dele) cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (cloudformation-provider: duas entradas que um autor escreveu chegam a um mesmo nome de Output da stack: as entradas indicadas que se encontraram chegam ao nome de Output indicado; um nome de Output é construído codificando o componente e a entrada nas letras e nos dígitos que um ID lógico admite, em vez de descartar o que ele não admite, então duas entradas que um autor escreveu distintas continuam distintas — renomear qualquer uma das duas pontas libera a build)

Como corrigir: renomeie uma das entradas, ou um dos componentes, para que as duas não cheguem mais a um mesmo nome — a mensagem nomeia os dois lados. O nome carrega a pontuação e as maiúsculas e minúsculas que você escreveu, codificadas em vez de descartadas, então uma diferença em qualquer uma delas se mantém nele e duas entradas escritas de forma diferente recebem nomes distintos.

A CloudFormation fragment writes one key twice (Um fragmento do CloudFormation escreve uma mesma chave duas vezes)

Um mapeamento contém um valor por chave, então um fragmento que escreve a mesma chave duas vezes manteria o corpo que veio por último e descartaria o outro. Onde o mapeamento é o bloco que contém os recursos ou as saídas, o corpo descartado é um recurso ou uma saída que foi escrito e não estaria no resultado. A renderização para em vez disso.

Os dois lugares onde a chave foi escrita são relatados, porque uma chave escrita duas vezes costuma ser duas edições pensadas como duas chaves diferentes — e o autor precisa dos dois para saber qual mudar.

Mensagem emitida, que começa com a condição e continua com o detalhe próprio do provedor:

two things a plugin produced occupy one name in its output (duas coisas que um plugin produziu ocupam um mesmo nome na saída dele) cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (cloudformation-provider: uma chave de mapeamento é escrita mais de uma vez: a chave indicada é escrita na linha indicada e de novo na segunda linha indicada; um mapeamento contém um valor por chave, então um dos dois corpos seria descartado — remova um, ou renomeie um para que cada chave seja escrita uma única vez)

Como corrigir: abra o fragmento nas duas linhas que a mensagem nomeia. Onde os dois corpos deveriam ser uma coisa só, remova o que agora é redundante; onde deveriam ser dois, renomeie um para que cada um tenha a sua própria chave. O fragmento é um template, então verifique o texto renderizado, e não só a fonte, onde uma chave é composta em vez de escrita literalmente.

A cross-boundary reference has no consuming stack to be written into (Uma referência entre fronteiras não tem nenhuma stack consumidora em que ser escrita)

Onde uma conexão de dependência passa entre duas saídas montadas separadamente, o lado consumidor é renderizado com um marcador de posição e a referência é escrita assim que os dois lados existem. Esta condição é o que acontece quando a saída montada do lado consumidor não contém nenhum template de stack: não há nenhum documento em que escrever a referência, então o marcador de posição não pode ser substituído.

Mensagem emitida. A condição nomeia o tipo de falha, e a frase própria do provedor diz qual entrada:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) cloudformation-provider: cross-boundary link resolve received no consumer stack template (cloudformation-provider: a resolução da ligação entre fronteiras não recebeu nenhum template de stack do consumidor)

Como corrigir: nada que você escreva dentro do componente consumidor produz isso — é a forma do que a fronteira dele montou. Verifique se o lado consumidor é de fato renderizado pelo provedor CloudFormation: uma conexão que passa para uma fronteira que monta outra coisa não tem nenhuma stack em que a referência possa cair, e a conexão deve ficar entre duas fronteiras que o mesmo provedor monta. Onde os dois lados deveriam ser CloudFormation, a fronteira consumidora não produziu nenhum template de stack, o que é uma questão para quem escreveu as Recipes que contribuem para ela.

A cross-boundary reference was spliced into a longer string (Uma referência entre fronteiras foi inserida em uma string mais longa)

Uma referência cruzada do CloudFormation é um objeto e não texto, então ela só pode substituir um valor por inteiro. Esta condição é o que relata um marcador de posição encontrado dentro de uma string maior — um valor composto ao redor dele, em vez de entregue como a totalidade do que foi injetado. Não há nada pelo qual trocar o objeto, então a renderização para em vez de emitir uma referência em uma forma que o destino não consegue ler.

Mensagem emitida. A condição vem primeiro, depois o valor e a conexão pela qual ele chegou:

a plugin has no representation for a value it was given (um plugin não tem representação para um valor que recebeu) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (cloudformation-provider: o valor da ligação entre fronteiras está interpolado em uma string maior; só uma injeção de um escalar inteiro pode carregar uma referência entre stacks: com a chave de saída indicada no socket indicado)

Como corrigir: entregue o valor por inteiro em vez de compor ao redor dele. Onde o lado consumidor precisa do valor dentro de uma string mais longa — uma string de conexão, uma URL —, construa essa composição no vocabulário próprio do destino a partir da referência, em vez de no template da Recipe antes que a referência exista. O mapeamento que injeta o valor é onde a inserção acontece, então essa é a linha a mudar.

Two rendered resources land at one output file (Dois recursos renderizados vão parar em um mesmo arquivo de saída)

Cada recurso renderizado é escrito em um arquivo cujo nome vem do que o recurso é e de como ele se chama. Dois recursos que compartilham essas duas coisas levam o mesmo nome de arquivo, então um ocuparia o espaço do outro e a renderização para em vez de emitir um único arquivo onde dois recursos foram renderizados.

Dois recursos renderizados de forma idêntica não são uma colisão. Onde o conteúdo coincide byte a byte, manter um não perde nada e a renderização continua — então um template incluído duas vezes com o mesmo resultado não é relatado.

Mensagem emitida. A condição vem primeiro, depois os dois templates que os produziram e o arquivo em que eles se encontraram:

two things a plugin produced occupy one name in its output (duas coisas que um plugin produziu ocupam um mesmo nome na saída dele) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (helm: no nó indicado: os recursos renderizados indicados, um e outro, derivam ambos a saída indicada com conteúdo diferente: dois recursos renderizados derivam o mesmo nome de arquivo de saída com conteúdo diferente)

Como corrigir: dê aos dois recursos identidades distintas — o nome é o que costuma diferir, e o nome do arquivo decorre dele. A mensagem nomeia os dois templates, então abra-os e verifique o que cada um produz: dois templates que renderizam o mesmo recurso sob um mesmo nome costumam significar que um deles é uma cópia mais antiga. Onde os dois são desejados, são dois recursos e cada um precisa de um nome próprio.

A synthesized StatefulSet has no single service to govern it (Um StatefulSet sintetizado não tem um único serviço que o governe)

Uma carga de trabalho que declara armazenamento por instância é renderizada como um StatefulSet, e um StatefulSet nomeia um serviço que o governa — o que dá a cada instância seu endereço estável. Esse serviço é o que é declarado sem um endereço de cluster próprio. Duas formas interrompem a renderização: nenhum declarado, então não há nada para nomear; e mais de um, então a pergunta sobre qual deles governa não tem resposta. Qualquer uma das duas produziria um StatefulSet que o destino rejeita, então a renderização para em vez de emitir um.

Mensagens emitidas. Ambas relatam a mesma condição — algo que o provedor exige e que ele não conseguiu resolver para exatamente um valor — e a frase própria do provedor diz qual das duas formas ocorreu. Cada uma é impressa sob uma moldura que nomeia o nó:

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (o StatefulSet sintetizado exige um Service headless que o governe (declare um serviço com type: Headless); nenhum encontrado: o StatefulSet sintetizado não tem nenhum Service headless que o governe)

a plugin could not resolve something it requires to exactly one value (um plugin não conseguiu resolver para exatamente um valor algo de que precisa) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (o StatefulSet sintetizado declara mais de um Service headless; o Service que o governa é ambíguo (declare exatamente um serviço type: Headless): o StatefulSet sintetizado tem mais de um Service headless)

Como corrigir: declare exatamente um serviço do tipo headless na carga de trabalho. Onde nenhum é declarado, adicione-o — uma carga de trabalho com armazenamento por instância precisa de um, e é ele que dá a cada instância um endereço que fica com ela. Onde mais de um é declarado, mantenha o que deve governar e dê aos outros um tipo comum, ou remova-os; um segundo serviço headless costuma ser um que não precisava ser headless.

A plugin reported a failure it did not classify (Um plugin relatou uma falha que não classificou)

Um plugin que interrompe um build relata duas coisas: uma frase própria dizendo o que aconteceu, e qual tipo de falha essa frase nomeia. Os tipos são um pequeno conjunto que o compilador declara — uma construção sem expressão, uma entrada que não pôde ser resolvida para um único valor, duas coisas produzidas querendo um mesmo nome, um valor sem representação — e esta condição é a que um plugin escolhe quando sua falha não se encaixa em nenhum deles.

É um recurso de último caso, e não um destino. Um plugin que recorre a ela onde um dos outros tipos se encaixa está dizendo a você menos do que sabe, e a redação diz claramente que o plugin abriu mão de classificar, e não que algo simplesmente deu errado — assim um recurso de último caso usado em excesso é reconhecível em vez de indistinguível de um relato correto.

Mensagem emitida. A condição vem primeiro e a frase própria do plugin vem depois dela:

a plugin reported a failure that none of the declared kinds names (um plugin relatou uma falha que nenhum dos tipos declarados nomeia) <the plugin's own sentence>

Como corrigir: leia a frase própria do plugin, que é onde está tudo o que é específico do seu build. A condição em si diz a você apenas que o plugin não tinha um tipo para ela. Onde o plugin é seu, escolha o tipo que a falha realmente é; onde não é, a frase é o que citar a quem o publica.

A plugin named a condition the socket does not declare (Um plugin nomeou uma condição que o socket não declara)

Um plugin relata uma condição que este compilador declara em vez de inventar um número próprio, então o identificador que chega até você é sempre um para o qual aggrega explain tem resposta. Esta interrupção é o que produz um relato que nomeia qualquer outra coisa: um número sob o qual nada está registrado, um número que foi retirado, um código curto escrito de forma diferente do registro para o qual ele resolve, ou um par de identificadores que nomeiam duas condições diferentes.

Ela para em vez de descartar o relato em silêncio. Descartar os identificadores e deixar valer a condição genérica de falha de plugin produziria um build exatamente igual ao de um plugin que não nomeou condição alguma, então quem precisa corrigi-lo nunca saberia que havia algo a corrigir. Relatar em vez disso o número oferecido entregaria a você um identificador que não resolve para nada.

Seu build ainda recebe o que o interrompeu. A interrupção cita o número problemático, diz por que ele não resolve para nenhuma condição, nomeia as condições genéricas a que um plugin recorre quando não tem identidade melhor, e repassa sem alterações a frase própria do plugin.

Mensagem emitida:

wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence> (wasm: o plugin convidado nomeou uma condição que o socket não declara: o convidado nomeou o valor indicado, com o motivo indicado pelo qual ele não resolve para nenhuma condição; um plugin nomeia uma condição que este compilador declara, e recorre a uma das condições genéricas indicadas, com seus códigos, quando não tem uma melhor: seguido da frase própria do plugin)

Como corrigir: nada nos seus arquivos de entidade causa isso — é o relato do plugin que está errado, e a falha que ele estava relatando é real. Aja com base na frase própria do plugin, que é a última parte da mensagem. Onde o plugin é seu, relate uma condição que este compilador declara — um dos tipos genéricos que a mensagem lista, onde a falha não se encaixa em nenhuma das condições mais específicas; onde o plugin não é seu, cite o número problemático a quem o publica.

A source artifact is cached without a workspace root to anchor it (Um artefato de origem é armazenado em cache sem uma raiz do workspace para ancorá-lo)

Um artefato de origem adquirido é guardado em um slot sob o cache de artefatos do workspace, e o caminho até esse slot é construído a partir da raiz do workspace para fora. Esta condição relata a raiz chegando vazia, o que deixaria o caminho do slot relativo — resolvido em relação a qualquer diretório em que o processo esteja quando os bytes são escritos, e colocando o cache em um lugar que ninguém escolheu.

Ela é recusada em vez de resolvida, porque um slot escrito no lugar errado é pior do que nenhum slot: leituras posteriores olham no certo, não encontram nada e adquirem de novo, então o que você veria é um cache que parece nunca conter nada, e nada mais apontando o porquê.

Mensagem emitida. A frase própria da condição a abre, e o que identifica o artefato vem a seguir:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: workspaceRoot vazio (com kind, url, chart e version indicados))

Como corrigir: nada nos seus arquivos de entidade causa isso e nenhuma mudança no que você escreve resolve — a raiz do workspace é fornecida pelo que quer que esteja conduzindo o build, e não escrita em um catálogo. Execute o build de dentro do workspace, para que a raiz seja descoberta em vez de passada como nada. Onde você conduz o compilador a partir de software próprio, passe a raiz do workspace explicitamente; um chamador que realmente quer o cache relativo ao diretório atual passa um único ponto, que é aceito e diz isso deliberadamente.

A value would place a cached file outside the cache (Um valor colocaria um arquivo em cache fora do cache)

Uma entidade em cache e um artefato de origem em cache vivem cada um em um slot que o cache nomeia para ele, e esse slot é composto a partir de valores: a referência da entidade e a versão para a qual ela resolveu, ou o tipo, url, chart, module_subdir, a versão e o digest de uma fonte. Cada valor nomeia uma posição na estrutura. Esta condição relata um valor que moveria o que é escrito para ele para um lugar diferente da posição que ele nomeia — ao lado de outro slot, ou totalmente para fora do cache — e o recusa antes que qualquer coisa seja escrita ou lida ali.

A maioria desses valores chega de um lugar que o cache não controla: um corpo servido por um registro, uma entrada relida do disco, uma coordenada escrita pelo autor de uma Recipe ou de uma FeatureRecipe. Uma versão que é um caminho em vez de uma versão, um caminho url ou um module_subdir que sobe acima do seu lugar, e uma referência que resolve para um diretório de pontos são recusados aqui, cada um. Um valor que nomeia um único diretório — e um caminho url ou um module_subdir que fica no seu lugar ou abaixo dele — não é alterado.

Um module_subdir que sobe é recusado antes que qualquer coisa seja buscada. Para uma fonte git-repository, o mesmo valor nomeia também o diretório do repositório que o pull arquiva, e um que suba acima do repositório faria o pull ler os arquivos ao lado do seu checkout. Então o pull avalia module_subdir antes de buscar o repositório, e recusa um valor que sobe com esta condição, citando-o sob sua chave: nada é buscado, e nada ao lado do checkout é lido. Uma barra invertida nele é lida como separador, como um caminho do Windows a lê, então ..\shared é recusado em toda máquina em vez de ser lido de ao lado do checkout em uma delas; um separador no início ou no fim do valor é descartado, então /charts/app nomeia charts/app.

Mensagem emitida. A frase própria da condição a abre, depois o valor como foi escrito sob a chave com que foi escrito, e a solução:

a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one (um valor a partir do qual um local do cache é construído colocaria arquivos em cache fora do lugar que ele nomeia no cache (a versão indicada para a entidade indicada). uma versão, um nome, um tipo ou um host nomeia um único diretório do cache, então não contém nem barra nem barra invertida e não é nem um ponto simples nem um ponto duplo; um caminho de URL ou um subdiretório de módulo pode nomear diretórios abaixo do seu lugar, mas não pode subir acima dele. Corrija o valor onde ele foi escrito, ou, onde um registro o serviu, peça a quem o publica que publique uma versão que traga um bem formado)

Como corrigir: onde o valor é um que você escreveu — source.version, url ou module_subdir de uma Recipe ou de uma FeatureRecipe —, corrija-o para que nomeie um único diretório, ou um caminho que fique dentro do seu lugar; a mensagem cita o valor e a chave de onde ele foi lido. Onde um registro o serviu, a entidade publicada traz uma versão ou uma coordenada que não é uma, o que nenhuma mudança sua pode corrigir: a mensagem nomeia o que foi buscado, e a solução cabe a quem a publica.

Várias operações escrevem ou removem arquivos próprios, em lugares que elas mesmas determinam em vez de lugares que você nomeou: o diretório de saída de um build e cada arquivo que ele escreve ali, e o diretório .trace que um build com rastreamento substitui; o arquivo de bloqueio de uma Release, e o registro de confiança de plugins ao lado dele, que um pull escreve; o arquivo entity.lock ao lado de uma entidade, que aggrega pin escreve, e que um pull que fixa fontes escreve ao lado de cada entidade que fixa; o arquivo .aggrega-config.yaml do workspace, quando um comando escreve a configuração do workspace; o cache de artefatos e cada subárvore dele, que um pull preenche e que aggrega cache clear e aggrega cache prune esvaziam; os bundles de assinatura que um pull mantém nesse cache para cada artefato cuja assinatura ele verificou; os rascunhos que aggrega import escreve; as entidades Plugin que aggrega plugin gen-catalog escreve sob seu diretório de saída; e o marcador .aggrega/active-release que o servidor de linguagem do editor escreve quando uma Release padrão é registrada, e o diretório .aggrega que o contém. O mesmo vale qualquer que seja a superfície que iniciou a operação — a linha de comando, o servidor de linguagem do editor ou as ferramentas de um assistente. A fronteira do workspace estabelece a regra que se aplica aqui, e os caminhos que saem do workspace de propósito.

Cada um desses lugares tem um diretório dentro do qual deve permanecer, e qual é depende do diretório sob o qual a operação o compõe:

  • O workspace, para tudo o que é composto dentro dele. Esse é o caso comum, e vale também para um diretório que você nomeou e que fica dentro do workspace. dist e .trace de um build são sempre compostos aqui, sob a raiz do workspace, qualquer que seja a pasta a partir da qual o build é executado, e o mesmo vale para os rascunhos de uma importação que não nomeia nenhum diretório de saída.
  • Um diretório que você nomeou e que fica fora do workspace, para tudo o que é composto abaixo dele: o diretório de saída que você passa para aggrega plugin gen-catalog ou aggrega import; o diretório de uma Release que você nomeia, ou que a configuração do workspace nomeia, que fica fora do workspace, para o arquivo de bloqueio e o registro de confiança ao lado dela; e o diretório de uma entidade que você nomeia para aggrega pin, ou um diretório de catálogo que você nomeia com --catalog ou que a configuração lista em catalog_dirs, para o arquivo entity.lock ao lado de cada entidade ali. O próprio diretório é usado como você o nomeou — em um que seja um link, a escrita passa por ele, até onde ele aponta — e o que é escrito abaixo dele permanece dentro dele.
  • O próprio diretório do cache de artefatos, para tudo o que é escrito no cache abaixo dele e tudo o que aggrega cache clear e aggrega cache prune removem ali — tanto o padrão .aggrega/cache quanto um artifact_cache_dir que a configuração escreve subindo para fora da raiz do workspace (../shared-cache). Um dos diretórios próprios do cache, ou um arquivo nele, que seja um link que leva para fora do diretório do cache é recusado mesmo onde leva a outro lugar dentro do workspace, de modo que nada do que é escrito no cache, e nada do que um clear ou um prune remove, vá parar em um arquivo fora dele. Onde fica o próprio diretório do cache é avaliado primeiro: um escrito dentro da raiz do workspace é seguido aonde quer que leve dentro do workspace e recusado, vinculado ao workspace, onde leva para fora dele; um escrito subindo para fora da raiz do workspace é usado como você o nomeou, com a escrita passando por ele até onde ele aponta, se for um link.

Cada um desses lugares é verificado antes que qualquer coisa seja escrita ou removida ali. A parte mais profunda do caminho que existe, com cada link simbólico pelo caminho seguido, tem de ser o diretório dentro do qual deve permanecer ou ficar abaixo dele. Um link em qualquer ponto do caminho que leve para fora desse diretório — um dist ligado a um diretório em outro lugar, um arquivo de bloqueio ligado a um arquivo em outro projeto, um .aggrega/cache ligado a um diretório compartilhado com outro trabalho, um diretório sob um diretório de saída do gen-catalog ligado a outro lugar — faria a escrita ou a remoção ir parar fora, então a operação para em vez disso, e esse caminho fica exatamente como estava. Isso importa mais para um build: esvaziar e reescrever um diretório de saída que é um link apagaria e reescreveria, caso contrário, um diretório em outro lugar da máquina.

Um link que não leva a lugar nenhum é tratado como o que é — não algo que existe — então o diretório que o contém é o que é verificado. Onde um link desses fica bem no fim de um caminho que a operação está prestes a criar, o arquivo seria criado onde o link aponta, então o lugar para onde ele aponta também é verificado. Um link que aponta para algum lugar dentro do diretório dentro do qual o caminho deve permanecer é seguido normalmente.

Mensagem emitida. A frase própria da condição a abre, depois o caminho que a operação estava prestes a escrever ou remover — writing ou removing diz qual — o diretório dentro do qual ele deve permanecer, o link que ele encontra pelo caminho e o lugar para onde esse link leva, e depois a solução. Um build cujo dist é um link que leva para fora do workspace é interrompido na primeira coisa que tocaria, o esvaziamento da saída anterior:

a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (um caminho que esta operação escreve ou exclui leva, por meio de um link, para fora do diretório dentro do qual deve permanecer (remoção do caminho indicado, que deve permanecer dentro do workspace indicado; o link indicado leva ao destino indicado). nada foi escrito nesse caminho nem removido dele. Remova o link, ou faça-o levar a um lugar dentro do workspace indicado, e execute a operação novamente)

O diagnóstico não traz categoria: o que está errado é a disposição no disco, não um documento que você escreveu.

Como corrigir: remova o link que a mensagem nomeia e execute a operação novamente, para que ela crie um diretório ou um arquivo real nesse lugar; ou faça o link levar a algum lugar dentro do diretório que a mensagem nomeia, onde ele é seguido. Nada nos seus arquivos de entidade causa isso e nenhuma mudança no que você escreve resolve.

A name the operation writes holds a part Windows cannot hold (Um nome que a operação escreve contém uma parte que o Windows não consegue conter)

No Windows, alguns nomes não chegam a um arquivo como estão escritos. Um nome que o Windows reserva para um dispositivo — CON, PRN, AUX, NUL, CONIN$, CONOUT$, de COM0 a COM9 e de LPT0 a LPT9, e os nomes COM e LPT escritos com um um, um dois ou um três sobrescrito — nomeia o dispositivo em vez de um arquivo, em qualquer combinação de maiúsculas e minúsculas e qualquer que seja a extensão que o siga, de modo que nul, Aux.yaml e com1.txt são todos dispositivos. E uma parte de um caminho que termina em um ponto ou em um espaço é uma parte que o Windows pode cortar em vez de mantê-la como está escrita. Escrever um nome assim colocaria seus bytes em outro lugar que não o arquivo que ele nomeia.

Por isso, onde uma operação está prestes a escrever, sob um diretório em uma máquina Windows, um nome que ela não escolheu por si mesma, um nome que contém uma parte assim é recusado antes que qualquer coisa seja escrita: uma entrada do arquivo compactado que um artefato de origem ou uma entidade do catálogo carrega, quando o cache dispõe o arquivo compactado para ser lido; um arquivo que um build renderiza em seu diretório de saída; um rascunho que um importador devolve a aggrega import, tanto em uma execução de teste quanto em uma escrita; e o documento que aggrega edit-document grava de volta, qualquer que seja a superfície que pediu a edição. Cada parte do nome é julgada, com uma barra invertida lida como separador, como o Windows a lê — assim, aux/x.yaml é recusado por seu diretório aux, report. por seu ponto final e .. \evil.yaml por sua primeira parte, dois caracteres de ponto e um espaço. Um conjunto recusado por um único nome não escreve nenhum dos outros: um arquivo compactado não é disposto, a saída de um build não é limpa nem escrita, e nenhum rascunho chega ao disco.

No Linux e no macOS os mesmos nomes são escritos como são nomeados, e esta condição nunca dispara. Um nome que sobe para fora do diretório sob o qual é escrito é uma falha diferente, recusada em todas as plataformas com a mensagem própria daquela operação antes que esta condição seja consultada.

Mensagem emitida. A frase própria da condição a abre, depois vêm o nome, a parte que o Windows não consegue conter e o diretório sob o qual o nome seria escrito, depois a correção:

a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written; rename that segment where the name is produced (um nome que esta operação escreve contém um segmento de caminho que o Windows não consegue conter como está escrito (o nome, seu segmento e o diretório indicados). Ele não foi escrito. O Windows reserva nomes de dispositivo como CON, PRN, AUX, NUL, COM1 e LPT1, em qualquer combinação de maiúsculas e minúsculas e qualquer que seja a extensão que siga, e não mantém como está escrito um segmento que termina em um ponto ou em um espaço; renomeie esse segmento onde o nome é produzido)

O diagnóstico não carrega nenhuma categoria: o nome vem do que o produziu — quem publica um arquivo compactado, uma Recipe ou uma biblioteca, um importador, o caminho que uma edição nomeia — e não de um único documento ao qual o compilador atribua a falha.

Como corrigir: renomeie a parte que a mensagem nomeia no lugar de onde o nome vem. Para uma entrada de arquivo compactado, trata-se do artefato de origem ou da entidade publicados, que só quem os publica pode alterar. Para um arquivo renderizado, é o nome de saída que uma Recipe ou uma ArtifactLibrary lhe dá; para um rascunho, o importador que o nomeou; para uma edição, o caminho do documento. Nada na máquina Windows torna o nome utilizável como está escrito.

Condições que não interrompem um build

Toda condição acima interrompe um build. Algumas condições carregam um código curto e uma mensagem próprios sem nunca interromper um, e estão catalogadas aqui para que um código que você tenha em mãos sempre resolva para algo, qualquer que seja a página de onde você chegou.

Elas se dividem em quatro tipos, e vale a pena conhecer a diferença antes de sair procurando uma correção.

  • Um aviso. O build o relata e continua, e a saída renderizada é a mesma, quer você aja sobre ele, quer não. Cada um é explicado por completo em warnings.md — o que o dispara, em que ponto da compilação é lido, o que imprime e o que fazer a respeito — e as entradas abaixo dizem qual seção, em vez de repeti-lo aqui.
  • Uma condição que o editor absorve. Ela é respondida pela própria integração do editor e não chega nem à saída de um build nem a um diagnóstico.
  • Uma salvaguarda atrás de uma recusa anterior. A regra que ela protege é aplicada antes dela por uma condição que de fato interrompe, de modo que um build encontra primeiro a anterior.
  • Uma recusa em um comando que não é um build. É uma interrupção definitiva com uma correção real — encerra o comando que a encontrou, e nada é publicado, escrito ou alterado — mas nenhuma etapa da compilação chega a ela, então nenhum build a relata. Publicar ou assinar um artefato, fixar as entradas de uma entidade, adicionar um registro, editar um documento, transformar a descrição de uma origem externa em arquivos de autoria em rascunho e verificar um catálogo inteiro — quanto à correção ou em relação às convenções de publicação — são os lugares onde elas são encontradas, e cada entrada diz a qual comando pertence e quem detém a correção.

An annotation binding declares one path in both pillar lists (Uma associação de anotação declara um mesmo caminho em ambas as listas de pilares)

Um aviso. Uma associação de anotação do Manifest nomeia o mesmo caminho com pontos tanto em sua lista maps.infra quanto em sua lista maps.values. Declarar a sobreposição é legal e o compilador não a fiscaliza: o critério de desempate do roteamento envia de forma determinística o caminho por infra, o que deixa o lado values desse caminho inalcançável a partir do Aggregate.

Sua mensagem começa assim:

annotation binding declares one path in both pillar lists (uma associação de anotação declara um mesmo caminho em ambas as listas de pilares)

É o que avisa você antes que um build chegue à interrupção descrita acima em “An annotation routes through a pillar its authoring side may not use (Uma anotação é roteada por um pilar que seu lado de autoria não pode usar)” — o aviso é a superfície antecipada, aquela interrupção é a que impõe a regra. O lint é explicado em “Binding-map-overlap lint (Lint de sobreposição de mapas da associação)” em warnings.md.

An attachment name is one edit from a declared slot (Um nome de vinculação está a uma edição de distância de um slot declarado)

Um aviso. Um componente vincula uma Feature sob um nome que não é um dos slots declarados de seu tipo, mas que está a uma única edição de um deles — a estrutura que um erro de digitação no nome de um slot assume. Uma vinculação sob um nome que nenhum slot declara é legal, então nada é interrompido; o que o aviso nomeia é a consequência, que é a vinculação ser uma vinculação livre em vez do preenchimento do slot que você pretendia, e o slot ficar vazio. Em uma conexão o mesmo erro de digitação não é legal e causa, em vez disso, uma interrupção, que nomeia o slot próximo; veja “A connection carries an attachment under a name its socket declares no slot for (Uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot)”. Onde a Feature da vinculação satisfaz o selector: do slot próximo, o aviso não é gerado: esse emparelhamento é julgado pela interrupção descrita em “An attachment written under another name fits a slot its component leaves empty (Uma vinculação escrita sob outro nome se encaixa em um slot que seu componente deixa vazio)”, que o relata quando o slot fica vazio.

Sua mensagem começa assim:

attachment name is a near miss for a declared slot (o nome da vinculação é uma quase correspondência com um slot declarado)

Explicado em “Attachment-slot near-miss lint (Lint de quase correspondência de slots de vinculação)” em warnings.md, com o limiar de emparelhamento e o que ele deliberadamente não detecta.

A uses: socket name is one edit from a declared socket (Um nome de socket está a uma edição de distância de um socket declarado)

Um aviso. O próprio bloco uses: de um componente nomeia um socket que seu tipo não declara, mas que está a uma única edição de um deles. Um desenvolvedor é dono da topologia que o Aggregate declara e pode nomear um socket que o catálogo não previu, então um nome de socket que o tipo não declara é legal nessa superfície e nada é interrompido. O que o aviso nomeia é a consequência: o nome escrito errado traça uma conexão ad hoc própria, sem seletor nem contrato por aresta, enquanto o socket que você pretendia fica sem cabeamento.

Sua mensagem começa assim:

uses socket name is a near miss for a declared socket (o nome do socket uses é uma quase correspondência com um socket declarado)

Explicado em “Uses-socket near-miss lint (Lint de quase correspondência de sockets uses)” em warnings.md. As duas superfícies vizinhas em que um nome de socket ausente do usesSchema da entidade proprietária de fato causa uma interrupção são tratadas acima em “uses: socket not declared in the owning entity’s usesSchema (Socket não declarado no esquema de sockets da entidade proprietária)”.

A Recipe publishes a provides key its Component does not declare (Uma Recipe publica uma chave que seu Component não declara)

Um aviso. A Recipe associada a um componente publica sob provides: uma chave que o tipo do componente não declara em seu contrato spec.schema.provides:. Publicar mais do que o Component declara é legal e continua legal — o contrato exige o subconjunto e permite o superconjunto. O que o aviso nomeia é uma consequência invisível de ambos os lados: um consumidor que lê através de uma aresta uses: vê o contrato declarado do destino, não o que quer que sua Recipe emita, então uma chave não declarada não é entregue e um template consumidor que a lê é renderizado vazio.

Sua mensagem começa assim:

Recipe publishes a provides key its Component does not declare (a Recipe publica uma chave provides que seu Component não declara)

O caso oposto não é um aviso: um Component que declara uma chave que sua Recipe não publica deixa o contrato não cumprido e causa uma interrupção. Explicado em “Undeclared-provides-key lint (Lint de chaves provides não declaradas)” em warnings.md.

A declared parameter is read by nothing (Um parâmetro declarado não é lido por nada)

Um aviso. Um Aggregate declara uma entrada sob spec.parameters: e nenhuma referência {{ .parameters.<key> }} no próprio texto desse Aggregate a lê, então, o que quer que uma Release forneça para ela, a saída renderizada é a mesma. O compilador não fiscaliza quais ajustes um autor expõe, e um parâmetro pode legitimamente ser declarado antes da referência que o lerá, então isto avisa em vez de interromper.

Sua mensagem começa assim:

declared parameter is read by no reference in the Aggregate (o parâmetro declarado não é lido por nenhuma referência no Aggregate)

Explicado em “Unread declared-parameter warnings (Avisos de parâmetros declarados não lidos)” em warnings.md, incluindo por que um valor padrão não é uma isenção e quais referências a leitura consegue e não consegue ver.

A provider binding names a capability no plugin the build reads serves (Uma associação de provedor nomeia uma capacidade que nenhum plugin lido pelo build serve)

Um aviso. Uma entrada plugins.providers nomeia uma capacidade e nenhum plugin, e nenhum dos plugins de provedor que o build lê — nos diretórios do catálogo, dentro do compilador ou entre os que o arquivo de bloqueio registra — serve essa capacidade. Essa é a estrutura que uma capacidade escrita errado assume, e uma entrada assim não é lida por nada: uma associação só é consultada quando uma Recipe pede sua capacidade, e uma que não nomeia nenhum plugin não seleciona nada que a resolução da capacidade não selecionaria sem ela.

Ela avisa em vez de interromper porque o build não pode ter certeza. As associações são escritas uma vez para todo o espaço de trabalho, enquanto um build é de uma única Release, então o plugin que serve a capacidade pode ser um que só outra Release lê. A entrada que nomeia um plugin é julgada de outra forma, e interrompe onde está certamente errada — veja acima “A plugins.providers binding names a plugin that does not serve the capability (Uma associação nomeia um plugin que não serve a capacidade)”.

Sua mensagem começa assim:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (a entrada plugins.providers nomeia uma capacidade que nenhum plugin de renderização de provedores lido pelo build serve)

e continua com a capacidade, e com uma capacidade servida a uma edição de distância, onde houver uma. Explicado em “Provider-binding unserved-capability warning (Aviso de capacidade não servida de uma associação de provedor)” em warnings.md.

An editor position falls outside the document (Uma posição do editor fica fora do documento)

Uma condição que o editor absorve. Os recursos do editor que dependem de onde está o seu cursor — ir para a definição, hover, preenchimento automático — primeiro localizam o cursor dentro da estrutura analisada do documento. Esta condição é o que essa etapa relata quando a posição aponta para uma linha que o documento não tem, o que acontece de forma transitória enquanto uma edição está em andamento e a posição que o editor enviou foi medida em relação a um texto que o documento já deixou para trás.

Sua mensagem diz:

position out of range (posição fora do intervalo)

Ela não chega a nenhum build nem a nenhum diagnóstico. Todo recurso que pode encontrá-la responde sem resultado em vez de exibir um erro, que é o comportamento que o protocolo do editor pede: uma solicitação que não pode ser respondida não retorna nada, e o editor pergunta de novo após a próxima tecla pressionada.

Não há nada a corrigir nos seus arquivos, e nada aparece em um build. Um recurso que fica sem responder em vez de se recuperar na próxima edição merece ser relatado como defeito.

The schema-merge step’s own input guard (A salvaguarda de entrada própria da etapa de mesclagem de esquemas)

Uma salvaguarda que um build não alcança. Quando um Component ou uma Feature estende outro e ambos declaram esquemas, esses esquemas são combinados em um só. A biblioteca que faz a combinação recusa uma entrada que não consegue mesclar estruturalmente:

merger: invalid merge input (merger: entrada de mesclagem inválida)

Ela pertence à etapa de combinação, que um build de fato alcança sempre que uma entidade que estende outra e sua base declaram esquemas. O que ela evita é receber uma cadeia vazia, ou uma entrada da cadeia cujo esquema está ausente — e o chamador não pode lhe passar nenhuma das duas: ele monta a cadeia só a partir de esquemas que já encontrou presentes, e combina só quando essa cadeia não sai vazia.

A salvaguarda permanece porque é a recusa de uma entrada malformada por parte de uma biblioteca exportada. Removê-la não removeria nenhuma interrupção que um build possa alcançar; transformaria uma recusa clara em uma falha abrupta para um chamador fora do compilador que passasse uma entrada assim, o que é estritamente pior.

A cadeia em si não é assunto desta etapa. Uma cadeia que forma um ciclo e uma cadeia que ultrapassa o limite de profundidade são recusadas pelo único percurso de extends: antes que qualquer esquema seja combinado — veja acima “Cyclic extends chain (Cadeia extends cíclica)” e “An extends: chain runs past the depth bound (Uma cadeia de extensão ultrapassa o limite de profundidade)”.

Ela está catalogada porque é declarada e carrega um código próprio, de modo que um código que você tenha em mãos se resolve. Nada que você possa escrever produz uma, e encontrar uma significaria que o arranjo descrito acima não vale mais — vale a pena relatá-lo como defeito em vez de contorná-lo.

An explicit value displaced one an annotation supplied (Um valor explícito substituiu um que uma anotação fornecia)

Um aviso. A expansão orientada por anotações transforma uma anotação que um Aggregate ou uma Release carrega em uma vinculação de Feature com configuração própria. Onde a mesma vinculação também carrega configuração escrita explicitamente — no componente, em um escopo acima dele ou na Release —, o valor explícito prevalece em cada chave que ambos cobrem. Essa é a regra pretendida e a saída emitida não está errada, então o build termina. O que o aviso nomeia é a consequência: a contribuição da anotação para essa chave não fica mais visível em nenhum lugar da saída, e o autor que escreveu a anotação pode não saber que ela foi suprimida.

Ele relata cada substituição em vez de apenas as que mudaram algo. A mesclagem sobrescreve o valor suprimido, então não resta nenhuma comparação a fazer nem nada que pudesse dizer se os dois coincidiam — o rastro de que uma substituição aconteceu é toda a evidência. Ele é lido depois que toda a cascata de vinculações e a expansão foram combinadas, que é o primeiro ponto em que esse rastro existe.

Sua mensagem começa assim:

annotation contribution overridden by an explicit value (contribuição da anotação sobrescrita por um valor explícito)

e continua com a anotação que foi substituída, depois as coordenadas da chave que a substituiu, depois onde a anotação substituída foi escrita. A posição que vem antes é o documento em que o achado está e a chave dentro dele:

<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>") (no arquivo e na chave indicados: contribuição da anotação sobrescrita por um valor explícito (anotação, componente, vinculação, pilar, chave em questão e local onde a anotação foi declarada indicados))

Dois desses valores são fáceis de interpretar errado. O valor component só é nomeado onde a entrada que substitui tem um componente: uma entrada escrita para todo um escopo não tem componente próprio, e nomear um que ela nunca teve mandaria o leitor para uma chave que ninguém escreveu. E annotation declared at nomeia onde a anotação substituída foi escrita, que é o escopo do qual ela foi herdada sempre que não foi escrita no componente que a substituiu — portanto não é a chave do componente repetida sob outro rótulo.

O que fazer a respeito: nada, onde o valor explícito é o que você pretendia. O aviso existe para que a precedência seja uma escolha e não uma surpresa. Onde não é o que você pretendia, há duas saídas e elas diferem em alcance. Exclua a entrada explícita, e o valor da anotação chega até essa chave. Ou remova a anotação do componente ou do escopo que a carrega, e nenhuma contribuição é feita — o que também afeta todas as outras chaves que essa anotação fornece. Onde os dois lados são desejados, mas para chaves diferentes, restrinja aquele que está indo mais longe do que o pretendido para que os dois não se sobreponham mais.

A connection crosses between two different providers’ assembled outputs (Uma conexão atravessa as saídas montadas de dois provedores diferentes)

Onde as duas pontas de uma conexão de dependência são montadas em saídas diferentes, um provedor que anuncia a ligação entre fronteiras faz a fiação dela nativamente — publicando uma referência no lado produtor e resolvendo-a no lado consumidor. Essa fiação é escrita no vocabulário próprio de um provedor, e um provedor não consegue resolver uma referência que outro publicou. Assim, uma conexão cujas duas pontas são renderizadas por provedores diferentes não recebe fiação de nenhum deles.

Isto avisa e não interrompe o build. A conexão continua carregando seu valor: o contrato de injeção encaminha o escalar do lado produtor até o lado consumidor exatamente como faz em qualquer outro lugar, então o que fica é uma conexão funcionando, com fiação feita da forma comum, e não uma quebrada. O que o achado diz é que a fiação nativa que você talvez esperasse não aconteceu — e a saída fica inalterada, quer você aja sobre ele, quer não.

Um provedor anunciando a ligação basta para relatar. As duas pontas não precisam declará-la: uma declaração significa que a fiação nativa era esperada e é impossível, e o autor que vinculou esse provedor é quem a queria. Exigir as duas declarações não diria nada na Release mista comum, em que um provedor faz a ligação e o outro não, que é justamente o caso para o qual isto existe.

Onde as pontas foram posicionadas não entra na conta. Uma saída montada é identificada pelo seu caminho e pelo seu provedor juntos, de modo que duas pontas cujos provedores diferem estão sempre em saídas diferentes, qualquer que seja o seu posicionamento. O que é lido são os dois provedores e suas duas declarações.

Ele é relatado uma vez por conexão desse tipo, posicionado no documento e na chave em que a conexão foi escrita.

Mensagem emitida, que começa pela ponta distante e depois nomeia o socket e o provedor de cada ponta:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (a ligação entre fronteiras entre pontas renderizadas por provedores diferentes não é suportada (componente de destino, socket, provedor do consumidor e provedor de destino indicados))

Como corrigir: onde o valor escalar que a conexão já carrega é suficiente, não há nada a fazer — isto é uma notificação, não uma falha. Onde a fiação nativa é desejada, as duas pontas têm de ser renderizadas por um único provedor: mova uma ponta para uma fronteira que passe pelo provedor da outra, ou sirva as duas capacidades com um só. Onde nenhuma das duas coisas é possível, a forma que carrega o valor é a que a Release tem, e a conexão funciona.

A command-line plugin runner was built without a way to find plugins (Um executor de plugins de linha de comando foi construído sem uma forma de encontrar plugins)

Um plugin que contribui com um comando de terminal é executado por um componente que primeiro precisa transformar a referência do plugin em bytes. Esta condição relata que esse componente foi construído sem a parte que faz a transformação, de modo que não há caminho da referência até algo a executar.

Ela diz respeito a um comando de terminal e não a um build, então nenhuma etapa da compilação chega a ela: ela é gerada onde um comando instalado é despachado, e a resposta que produz é a falha desse comando ao iniciar, e não uma interrupção em algum build.

Nenhum caminho na ferramenta de linha de comando distribuída pode gerá-la. Todo lugar em que a ferramenta constrói esse componente fornece a busca, então a salvaguarda só dispara onde outra coisa o constrói e deixa a busca de fora.

Mensagem emitida, que é a própria frase da condição:

cliplugin: no plugin resolver configured (cliplugin: nenhum resolvedor de plugins configurado)

Como corrigir: nada nos seus arquivos de entidade causa isto, e nada que você possa escrever em um catálogo ou em um workspace o elimina. Onde você executa a ferramenta de linha de comando publicada, esta não é uma condição que você possa alcançar — um comando instalado que não inicia está relatando outra coisa, e a mensagem que ele imprimiu é a que deve ser lida. Onde você incorpora o executor de plugins em um software próprio, forneça, ao construí-lo, a busca que resolve uma referência de plugin para seus bytes.

A registry alias is already bound to another host (Um alias de registro já está associado a outro host)

Uma recusa ao adicionar um registro ao workspace, não em um build. Um alias é um nome curto que seleciona uma entrada de registro, então ele é único entre as entradas. Registrar um alias já mantido por um host diferente é recusado, em vez de permitir que ele encubra a associação existente, o que mudaria silenciosamente para onde aponta cada referência que usa esse alias.

Adicionar de novo o mesmo host sob seu alias existente não é um conflito — isso atualiza a entrada no lugar, que é o que faz executar o comando de novo para mudar as outras configurações de um host.

Mensagem emitida, que nomeia o alias e o host que já o mantém:

workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: o alias de registro indicado já é usado pelo host indicado; escolha um alias diferente ou aponte diretamente para esse host: o alias de registro já é usado por outro host)

Como corrigir: a correção cabe ao operador, na linha de comando. Dê ao novo registro um alias diferente, ou deixe-o sem alias e refira-se a ele pelo host. Onde você pretendia mover o alias para o novo host, remova-o primeiro da entrada que a mensagem nomeia em .aggrega-config.yaml — a recusa existe para que mover um alias seja algo que você faz de propósito e não um efeito colateral de adicionar um registro.

A registry serves a trust document that cannot be read as one (Um registro serve um documento de confiança que não pode ser lido como tal)

Uma recusa ao adicionar um registro, não em um build. Um registro pode publicar as identidades de assinatura com que espera que os artefatos sejam assinados, para que adicionar o registro possa fixá-las em vez de obrigar um operador a transcrevê-las. Esta condição relata um registro que respondeu com um documento que não pode ser usado como política de confiança.

É uma recusa definitiva justamente porque o endpoint respondeu. Um registro que não publica nada é um resultado comum e esperado, que é tolerado; um que publica algo ilegível é uma configuração incorreta, e não fixar nada a partir dele deixaria o registro silenciosamente sem fixação, parecendo que tinha sido fixado.

Três estruturas são relatadas aqui: conteúdo que não decodifica de forma alguma, incluindo um documento que traz um campo que o formato não define; uma entrada de identidade que não nomeia nem uma identidade exata nem um padrão; e uma entrada de identidade sem emissor. As duas últimas são recusadas porque uma entrada assim nunca pode corresponder a uma assinatura, então enfraqueceria a fixação parecendo reforçá-la.

Mensagens emitidas. Conteúdo que não decodifica:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: a configuração de confiança anunciada está malformada, seguida do que o decodificador relatou)

uma entrada de identidade sem nada com que corresponder:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: a configuração de confiança anunciada está malformada: na lista e no índice indicados, uma entrada de identidade deve definir identity ou identity_regexp)

e uma sem emissor:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: a configuração de confiança anunciada está malformada: na lista e no índice indicados, uma entrada de identidade deve definir issuer)

Cada uma é enquadrada pelo comando que a encontrou:

aggrega registry add: <the message above> (aggrega registry add: a mensagem acima)

Como corrigir: a correção cabe a quem opera o registro, não a você — repasse a mensagem a essa pessoa, já que ela nomeia a entrada exata e o que falta nela. Para prosseguir enquanto isso, adicione o registro sem fixar a política que ele anuncia e forneça você mesmo as identidades ou a chave; o comando as aceita diretamente, que é também o que você faz para um registro que não publica política nenhuma.

A registry publishes no trust document (Um registro não publica nenhum documento de confiança)

Um resultado comum e esperado, e não uma falha, e não interrompe nada. Um registro pode publicar as identidades de assinatura que espera, e a maioria não publica. Quando um documento desses lhe é pedido, um registro assim responde que não tem nenhum, e a adição do registro prossegue — o resultado é relatado como uma notificação e as identidades são fixadas manualmente em vez disso.

Ele é deliberadamente distinto de um registro que não pôde ser alcançado. Este respondeu; a resposta foi que ele não publica nenhuma política. Manter os dois separados é o que permite tolerar uma ausência deliberada enquanto um problema de alcance continua visível como tal.

Relatado como uma notificação, que nomeia o registro, o que ele respondeu e o que fazer em vez disso:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Notificação: o host indicado não publica nenhuma política de confiança (HTTP 404); fixe a confiança dele manualmente com —identity ou —key)

A condição sob a qual ele é catalogado é registrytrust: registry advertises no trust config.

O hub oficial é a exceção: ele traz uma linha de base embutida, então onde não publica nenhum documento essa linha de base é fixada em seu lugar, e a notificação diz o que o hub respondeu e que a linha de base é usada no lugar dele, em vez de pedir que você fixe identidades.

Como corrigir: nada está quebrado. Se você quer que as assinaturas deste registro sejam verificadas, forneça a identidade ou a chave ao adicioná-lo, exatamente como a notificação diz — esse é o caminho normal para um registro que não publica nenhuma política. Se não quiser, o registro é adicionado sem uma postura de assinatura, e os artefatos vindos dele só são verificados quando trazem uma assinatura.

A registry is added offline with no trust policy to pin (Um registro é adicionado offline sem uma política de confiança a fixar)

Uma recusa ao adicionar um registro, não em um build. Adicionar um registro é o único momento em que sua confiança é fixada: as identidades de assinatura que ele anuncia são buscadas uma vez e cada pull posterior verifica em relação a essa cópia fixada. Quando o workspace está offline, essa busca não pode ser feita, então o registro nunca é consultado. Em vez de escrever uma entrada que não confia em nada — e à qual cada pull posterior submeteria o registro —, adicionar um registro diferente do hub oficial é recusado, a menos que você mesmo forneça a política.

Três casos não são recusados. Fornecer identidades ou uma chave registra exatamente essas e não faz busca alguma, então funciona da mesma forma offline e online. O hub oficial é adicionado com sua linha de base embutida, que ele carrega quer a busca seja feita, quer não. E pedir que não haja busca — --fetch-trust=false — registra a entrada a partir das flags, exatamente como faz online.

Ela é encontrada onde quer que um registro seja adicionado: aggrega registry add, aggrega config init --registry <host>, as solicitações aggrega/registryAdd e aggrega/configInit de aggrega serve, cuja mensagem de erro traz o código curto antes da frase, e as ferramentas de registro de aggrega mcp, que executam esses comandos. Inicializar uma configuração não aceita identidades nem chave, então offline só é possível inicializar o hub; adicione qualquer outro registro com aggrega registry add em vez disso.

Mensagem emitida, que é a própria frase da condição:

a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file> (um registro diferente do hub oficial não é registrado offline sem uma política de confiança fornecida manualmente, porque a política que ele anuncia não pode ser buscada; registre-o uma vez enquanto estiver online, ou fixe sua confiança manualmente com uma identidade e seu emissor ou com um arquivo de chave pública)

enquadrado pelo comando que o encontrou e pelo registro que ele nomeia:

aggrega registry add: <host>: <the message above> (aggrega registry add: o host indicado e, depois, a mensagem acima)

Como corrigir: adicione o registro uma vez enquanto o workspace estiver online — passe --offline=false para essa única execução, ou limpe a configuração offline — para que sua política anunciada seja buscada e fixada; depois não é preciso repetir nada, pois os pulls posteriores verificam em relação à cópia fixada. Onde você não puder ficar online, forneça a política manualmente: uma ou mais entradas --identity <identity>=<issuer> para um registro sem chave, ou --key apontando para seu arquivo de chave pública para um com chave, que é o que você teria fixado a partir do anúncio dele.

A tag is already published with different content (Uma tag já está publicada com conteúdo diferente)

Uma recusa ao publicar, não em um build. Bytes publicados são congelados: antes que qualquer coisa seja enviada, a versão de destino é consultada e o digest para o qual ela aponta é comparado com o digest que o conteúdo em mãos produziria. Uma versão que já aponta para um conteúdo diferente é recusada.

Republicar conteúdo idêntico byte a byte não é um conflito. Os digests coincidem, nada é enviado e o comando informa que a versão já está publicada — então executar novamente uma publicação que teve sucesso em parte é seguro, e isso completa a publicação: a data de publicação que ainda falta à versão, e sua assinatura onde o push assina, são anexadas, e uma versão à qual não falta nenhuma das duas não recebe nada, como descreve Concluir uma publicação que um push anterior deixou parcial.

Não há flag que anule isso. Conteúdo alterado é publicado sob uma nova versão, o que deixa aos consumidores uma versão para a qual migrar deliberadamente, em vez de uma versão que mudou sem que eles percebessem.

Mensagens emitidas, que nomeiam a versão, o digest que ela contém e o digest oferecido. Ao publicar uma entidade do catálogo, que também nomeia a verificação que valida o incremento de versão:

aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (aggrega push: a versão indicada já está publicada com o digest existente indicado; recusando sobrescrevê-la com o digest proposto — publique uma nova versão (aggrega lint —pre-publish verifica o incremento): oci: tag já publicada com conteúdo diferente)

e ao publicar um artefato de dados:

aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (aggrega push-artifact: a versão indicada já está publicada com o digest existente indicado; recusando sobrescrevê-la com o digest proposto — publique uma nova versão: oci: tag já publicada com conteúdo diferente)

Como corrigir: aumente a versão e publique novamente. Para uma entidade do catálogo, isso significa metadata.version e o diretório por versão em que a entidade está, que mudam juntos. Antes de fazer isso, verifique se a mudança é uma que você pretendia: os dois digests diferirem em uma versão que você acredita não ter tocado significa que o conteúdo no disco não é o conteúdo que foi publicado, e descobrir por quê vale mais do que publicar por cima. A verificação de pré-publicação nomeada na mensagem compara uma versão com a anterior e é o modo de confirmar que o incremento está correto.

An entity shares its directory with another entity (Uma entidade compartilha seu diretório com outra entidade)

Uma recusa ao fixar e ao publicar, não em um build. Todo tipo de entidade tem um diretório próprio, exceto os três que uma raiz do workspace contém lado a lado: um Aggregate, uma Release e um Manifest. Uma entidade publicada é um artefato em uma coordenada para cada versão, e o diretório em que ela é escrita reflete isso — a etapa de fixação escreve o único arquivo entity.lock para o qual um diretório tem espaço, e uma publicação empacota a entidade a partir de seu diretório. Assim, uma entidade de qualquer outro tipo com outra entidade ao lado é recusada nesses dois momentos: por aggrega pin, por um pull ou um push solicitado a fixar em nome do autor, e por aggrega push, fixe ele ou não. Ela é recusada antes que qualquer coisa seja buscada, e nada é escrito.

Um diretório com várias entidades ainda é carregado, passa pelo lint, é validado e passa pelo build. A disposição só é julgada quando algo é produzido a partir do diretório, que é também o momento em que a mensagem pode nomear a entidade que está atrapalhando. Um pull que não fixa não escreve nada ao lado da entidade e não é recusado.

O que conta como entidade ao lado é qualquer outro documento YAML diretamente no mesmo diretório cujo kind: seja um tipo de entidade. Os arquivos próprios de um chart, um fragmento compose, um manifesto do Kubernetes ou um README não são entidades, e um subdiretório — um chart local, uma árvore source/ — não está ao lado da entidade, seja o que for que contenha. Só o tipo e o nome de cada vizinho são lidos, então nada que um vizinho declare pode mudar a resposta.

O nome do diretório não é julgado. Uma entidade sozinha em seu diretório é fixada e publicada na versão que declara, onde quer que esse diretório esteja; a disposição <name>/<version>/ que o catálogo da biblioteca padrão usa é uma convenção, e não uma verificação.

Mensagem emitida, que nomeia a entidade, cada entidade ao lado dela e os arquivos a mover:

the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (a entidade compartilha seu diretório com outra entidade, e uma entidade de seu tipo tem um diretório próprio (a Recipe indicada e, ao lado dela, a Recipe indicada no arquivo indicado). correção: dê a cada entidade um diretório próprio — mova o arquivo indicado para um diretório próprio, junto com qualquer arquivo que só essa entidade lê; somente os tipos Aggregate, Manifest e Release podem compartilhar um diretório com outras entidades)

Como corrigir: mova cada entidade que a mensagem nomeia para um diretório próprio, levando junto os arquivos que só ela lê — um chart local, um arquivo importado e o arquivo entity.lock, se ele registrar as fixações dessa entidade — e execute aggrega pin em cada uma que lê uma origem remota ou importa um arquivo, para que cada lock registre sua própria entidade. Dispor cada uma como <kind>/<provider-or-publisher>/…/<name>/<version>/ a mantém onde o catálogo da biblioteca padrão mantém cada entidade. Um diretório de catálogo é encontrado ao percorrê-lo, então um build sobre o catálogo renderiza a mesma saída após a mudança.

An entity kind has no artifact media type (Um tipo de entidade não tem tipo de mídia de artefato)

Uma recusa ao publicar, não em um build. Cada tipo de entidade publicável tem um tipo de mídia para cada uma das duas formas que seu artefato assume — só seu documento, ou um arquivo compactado do documento e dos arquivos que ele declara — e o empacotamento de uma entidade o procura pelo tipo. Esta condição relata um tipo sem entrada.

Nenhum build chega a ela. O único outro lugar em que a mesma consulta é executada trata uma entrada ausente como “isto não é uma biblioteca” e continua, então a condição nunca aparece ali.

Mensagem emitida, a frase própria da condição enquadrada pelo comando e pelo arquivo que ele estava empacotando:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: bundle no caminho indicado: oci: tipo de entidade desconhecido para a seleção do tipo de mídia)

Como corrigir: compare o campo kind: do arquivo que você está publicando com os tipos que aggrega push --list-kinds imprime — um tipo escrito errado ou não suportado é relatado aqui, e corrigir o campo é toda a correção. Onde o tipo é um que essa lista traz, trata-se de uma lacuna no conjunto de ferramentas, e não na sua entidade, e vale a pena relatá-la citando o tipo.

A published archive carries an entry Windows cannot use (Um arquivo compactado publicado traz uma entrada que o Windows não consegue usar)

Um aviso gerado quando uma entidade é publicada; ele nunca interrompe nada, e um build não o gera. Uma entidade que traz arquivos ao lado de seu documento é publicada como um arquivo compactado, e cada nome que o arquivo compactado contém — o próprio nome de arquivo do documento da entidade, depois cada arquivo que ela traz — é julgado pela regra que a interrupção “A name the operation writes holds a part Windows cannot hold (Um nome que a operação escreve contém uma parte que o Windows não consegue conter)” acima aplica no Windows: uma parte que o Windows reserva para um dispositivo, em qualquer combinação de maiúsculas e minúsculas e qualquer que seja a extensão que a siga, ou uma parte que termina em um ponto ou em um espaço. Assim, aux/x.yaml o provoca por seu diretório aux, report. por seu ponto final, e um documento chamado con.yaml que importa um arquivo de esquema, por seu próprio nome. Uma entidade que não traz nada é publicada apenas como seu documento, disposto sob um nome que o produto escolhe, e um Plugin não publica nenhum arquivo compactado, então nenhum dos dois o provoca.

Ele é gerado em todas as plataformas e não recusa nada. Um workspace no Windows se recusa a dispor uma entrada assim, sob aquela interrupção, então não consegue usar a versão; o aviso é o modo como quem publica fica sabendo disso antes que alguém no Windows fique. A publicação, ou sua execução de teste, segue em frente ou para exatamente como faria sem ele.

Toda superfície que publica uma entidade o gera, cada uma em sua própria forma. aggrega push, e seu --dry-run, imprime uma linha por entrada na saída de erro padrão, cada uma começando com warning: . A ferramenta publish-entity do assistente responde com as entradas como windows_unusable_entries, e o texto da resposta também as nomeia. aggrega serve responde a aggrega/publishEntity com elas como windowsUnusableEntries e repassa as próprias linhas de aviso a uma solicitação que pediu para ser informada. Cada resposta omite o campo onde não há nenhuma entrada assim.

Sua mensagem começa assim:

an entry this publication carries cannot be used on Windows (uma entrada que esta publicação traz não pode ser usada no Windows)

e continua com a entrada e a primeira de suas partes que o Windows não consegue conter, depois a correção. Explicado em “A published archive carries an entry Windows cannot use (Um arquivo compactado publicado traz uma entrada que o Windows não consegue usar)” em warnings.md.

Como corrigir: renomeie a parte que a mensagem nomeia, no disco e onde quer que as declarações da entidade nomeiem o arquivo, e publique novamente. Onde a versão não se destina a ser usada no Windows, nada precisa mudar.

Two catalog identities publish to one repository location (Duas identidades do catálogo publicam em um mesmo local de repositório)

Uma recusa ao verificar um catálogo inteiro, não em um build. O lugar para onde uma entidade é publicada é derivado de sua identidade e convertido para minúsculas, então duas identidades que diferem apenas em maiúsculas e minúsculas vão parar no mesmo lugar. Publicar ambas deixaria os bytes de uma entidade sobrescritos pelos da outra, e nada em nenhuma das duas entidades diria isso.

A verificação é executada sobre o catálogo inteiro de uma vez, porque uma colisão é uma propriedade de um par, e não de cada entidade isoladamente — nenhuma está errada por si só, e ler qualquer uma delas isoladamente não mostra nada.

Mensagem emitida. A moldura da verificação do catálogo a abre, depois vem a frase própria da condição, depois cada grupo em colisão, cada um nomeando o local compartilhado e as identidades que chegam a ele:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (a validação do catálogo falhou: oci: identidades de catálogo distintas são mapeadas para o mesmo local de repositório OCI)

  • <location> <- <identity>, <identity>

Como corrigir: renomeie uma das entidades que a mensagem nomeia, em seu metadata.name e no diretório que o reflete. Qual renomear fica a seu critério; os pares que diferem só em maiúsculas e minúsculas são a forma comum, e escolher uma grafia e usá-la de forma consistente é o que impede o par de se repetir. Renomear é uma mudança real na identidade de uma entidade, então tudo o que se refere ao nome antigo precisa acompanhá-la — o que é um motivo para resolver a colisão antes que qualquer um dos nomes seja publicado, e não depois.

Keyless signing was asked for without the services it needs (A assinatura sem chave foi solicitada sem os serviços de que precisa)

Uma recusa ao assinar durante a publicação, não em um build. A assinatura sem chave não tem forma offline: ela obtém uma identidade, faz com que um certificado de curta duração seja emitido para ela, registra a assinatura onde ela possa ser verificada depois e então descarta a chave. Cada uma dessas etapas é uma troca com um serviço em execução. Esta condição relata que a identidade da qual o fluxo parte não estava disponível, então o fluxo é recusado em vez de ser iniciado e abandonado no meio do caminho.

Duas formas a relatam: nada configurado para fornecer uma identidade, e algo configurado que não produziu nada.

Um workspace offline relata de outra forma, sob a recusa que cobre toda etapa de rede, porque a recusa acontece antes mesmo de uma identidade ser solicitada.

Mensagens emitidas. Nenhuma origem de identidade:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (signing: a assinatura sem chave requer um provedor de identidade ativo, Fulcio e Rekor: uma origem de token de identidade é obrigatória)

e uma origem que não produziu nada:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (signing: a assinatura sem chave requer um provedor de identidade ativo, Fulcio e Rekor: um token de identidade é obrigatório)

Como corrigir: a correção cabe ao operador, na forma como a publicação é executada. Em um pipeline automatizado, a identidade vem das próprias credenciais do pipeline, então isso geralmente significa que o job não recebeu a permissão que as emite. Em uma execução interativa, a identidade vem do login, que o comando vai solicitar. Onde você não quiser nenhuma identidade ativa, assine com uma chave própria em vez disso — esse caminho não precisa de nenhum desses serviços e é o que se deve usar a partir de um ambiente que não consegue alcançá-los.

An unsigned publish targets a registry or a policy that requires a signature (Uma publicação não assinada tem como destino um registro ou uma política que exige uma assinatura)

Uma recusa ao publicar, não em um build. Onde uma assinatura é exigida, conteúdo não assinado não é publicado. A verificação é executada antes que qualquer byte seja enviado, então nada parcial chega ao registro.

Duas condições, porque um requisito tem duas origens e as correções diferem. Uma é a postura própria do registro de destino, que se aplica a tudo o que é publicado nele. A outra é a política de assinatura do workspace, que cobre um conjunto de tipos de artefato onde quer que sejam publicados. Quando ambas valem, a do registro é relatada, porque nomear o destino é a mais útil das duas.

Não há flag que publique conteúdo não assinado aqui. Desativar a assinatura explicitamente não relaxa a recusa — só muda o padrão para artefatos em que a assinatura é opcional.

A assinatura é produzida antes do envio, e não depois, então uma falha de assinatura também cai aqui e nada é publicado.

Mensagens emitidas. O requisito próprio do registro:

aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: o registro indicado exige assinaturas; execute novamente assinando o artefato (não há flag para fazer push de conteúdo não assinado aqui): signing: o registro exige assinaturas; recusando fazer push de conteúdo não assinado)

o da política do workspace, que nomeia o tipo que trouxe o artefato para o seu escopo:

aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: a política de assinatura exige uma assinatura para o tipo indicado; execute novamente assinando o artefato (não há flag para fazer push de conteúdo não assinado aqui): signing: a política de assinatura exige uma assinatura para este tipo de artefato; recusando fazer push de conteúdo não assinado)

e uma assinatura que não pôde ser produzida, que é relatada sob a condição do registro e cita a falha subjacente:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: assinatura da versão indicada: a falha subjacente indicada: signing: o registro exige assinaturas; recusando fazer push de conteúdo não assinado)

Uma forma de falha de assinatura é nomeada especificamente, porque uma rejeição genérica leva as pessoas a obter de novo uma credencial que não pode ajudar:

aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: assinatura da versão indicada: o token de identidade não traz nenhuma claim de e-mail ou subject verificada — o fluxo/cliente OIDC não retornou uma identidade com escopo de e-mail (exportar ou obter o token de novo não vai ajudar); configure o provedor de identidade/cliente/escopo para retornar uma: a falha subjacente indicada: signing: o registro exige assinaturas; recusando fazer push de conteúdo não assinado)

Como corrigir: a correção cabe ao operador. Assine o artefato e publique novamente — com uma chave própria ou pelo caminho sem chave, conforme o workspace estiver configurado. Onde você não esperava que uma assinatura fosse exigida, a mensagem diz qual origem a exigiu: a postura própria de um registro fica na entrada desse registro em .aggrega-config.yaml, e o requisito limitado a um tipo fica na política de assinatura de todo o workspace. Relaxar qualquer um dos dois é uma decisão sobre o que você está disposto a publicar sem assinatura, então restringir o escopo da política geralmente é melhor do que desativá-la.

References signed together need different signing credentials (Referências assinadas juntas precisam de credenciais de assinatura diferentes)

Uma recusa ao assinar, não em um build. aggrega sign com várias referências, e aggrega deprecate --from com um arquivo de lote, assinam tudo o que recebem com uma única credencial: uma única chave própria ou uma única identidade sem chave. Qual credencial uma referência precisa é decidido pela configuração do seu registro — um signing.key_path que se aplica a esse registro seleciona a chave que nomeia, e onde nenhum se aplica a referência é assinada sem chave. Quando as referências nomeadas juntas precisariam de credenciais diferentes — uma chave para um registro e nenhuma para outro, ou duas chaves diferentes —, nada é assinado, e a mensagem nomeia os registros de cada lado.

A verificação é executada antes que uma identidade seja solicitada e antes que qualquer registro seja lido, então nada é assinado ou anexado e nada é solicitado a ninguém por uma execução que não vai acontecer. Uma assinatura não pode ser recolhida de quem já a buscou, e é por isso que a execução é recusada em vez de assinada com a credencial de que uma das referências precisa.

Uma chave passada com --key decide por todas as referências. Ela se aplica a toda referência nomeada, independentemente do que a configuração diga para cada registro, então uma execução assim nunca é recusada aqui.

Ela é encontrada onde quer que um lote seja assinado: aggrega sign, aggrega deprecate --from, as solicitações aggrega/signArtifacts e aggrega/deprecateArtifact de aggrega serve, cuja mensagem de erro traz o código curto antes da frase, e as ferramentas sign-artifacts e deprecate-artifact de aggrega mcp. Uma chamada de ferramenta que chega a um servidor por um listener nunca usa uma chave que a configuração nomeia, então ali cada referência é assinada com a identidade que a chamada envia e a chamada não é recusada aqui.

Mensagem emitida. A frase própria da condição a abre, cada credencial vem em seguida com os registros para os quais assinaria, e a correção vem por último:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (aggrega sign: signing: as referências nomeadas juntas precisam de credenciais de assinatura diferentes, então nada foi assinado (o registro indicado assina com a chave própria que signing.key_path nomeia, o registro indicado assina sem chave: nenhum signing.key_path se aplica). correção: assine-as em execuções separadas, uma por credencial: as referências no registro indicado, depois as referências no registro indicado; cada execução assina como assinaria sozinha)

e, onde um registro do lote exige assinaturas, nomeando-o no fim da correção:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (aggrega sign: signing: as referências nomeadas juntas precisam de credenciais de assinatura diferentes, então nada foi assinado (o registro indicado assina com a chave própria que signing.key_path nomeia, o registro indicado assina sem chave: nenhum signing.key_path se aplica). correção: assine-as em execuções separadas, uma por credencial: as referências no registro indicado, depois as referências no registro indicado; cada execução assina como assinaria sozinha, e o registro indicado exige assinaturas, então esta recusa retém uma assinatura que de outra forma teria prosseguido, e não uma assinatura impossível de fazer)

Um segundo registro com uma chave própria é nomeado como assinando “with a different held key (com outra chave própria)”. O caminho de uma chave nunca é impresso: a mensagem nomeia a configuração, que é o que você pode mudar.

Como corrigir: divida as referências pela credencial de que seus registros precisam e execute uma vez por credencial — um aggrega sign nomeando as referências nos registros assinados com uma chave, outro nomeando o resto; para aggrega deprecate --from, um arquivo de lote por credencial. Cada execução então assina como teria assinado sozinha. Para assinar em vez disso todas as referências com uma única chave em uma única execução, passe essa chave com --key.

A detached signature does not verify against the key supplied (Uma assinatura destacada não é verificada com a chave fornecida)

O resultado negativo de verificar uma assinatura avulsa sobre um payload em relação a uma chave pública, inteiramente offline: o payload difere do que foi assinado, a assinatura foi alterada ou a chave não é a que a produziu.

Nada no conjunto de ferramentas distribuído chega a ela. A verificação à qual pertence não tem nenhum chamador fora dos próprios testes, então nenhum comando que um usuário executa — build, pull ou publicação — a relata. Ela está catalogada aqui para que o código remeta a algo, não porque um build possa imprimi-la. A verificação que um pull realmente faz é sobre um bundle de assinatura completo e é relatada separadamente.

Mensagem emitida, citando o que o verificador relatou:

signing: signature does not verify: <what the verifier reported> (signing: a assinatura não é verificada, seguido do que o verificador relatou)

Como corrigir: nada nos seus arquivos de entidade causa isso, e nada que você possa escrever em um catálogo ou em um workspace o elimina. Se você executa a ferramenta de linha de comando publicada, esta não é uma condição que você possa alcançar, e um problema de assinatura que você está de fato vendo é relatado, em vez disso, por uma das condições de verificação de bundle descritas acima. Se você usa o pacote de assinatura diretamente a partir do seu próprio software, o payload, a assinatura e a chave têm de ser os três que andam juntos — um payload reserializado entre a assinatura e a verificação é a causa habitual, já que os bytes então diferem mesmo que o conteúdo pareça o mesmo.

A resolved artifact is not a documentation bundle (Um artefato resolvido não é um bundle de documentação)

Uma referência que resolve para um artefato de outro tipo — uma entidade do catálogo, um plugin — é rejeitada em vez de armazenada em cache como documentação, então uma referência mal apontada falha onde é apontada, e não mais tarde como um bundle que não pode ser lido.

Onde ela surge. O bundle de documentação é adquirido para o cache que todos os projetos da máquina compartilham, a partir do registro configurado do workspace sob o namespace reservado docs: pelo servidor voltado a assistentes uma vez, ao iniciar e antes de responder qualquer coisa, por aggrega explain e pela explicação de um código em um editor na primeira vez que qualquer um deles precisa, e por aggrega scaffold --example — em cada caso só onde a máquina não tem nenhuma cópia que a verificação de assinaturas do workspace admita. Esta é a verificação que toda aquisição executa sobre o que voltou.

Ela nunca interrompe uma sessão. A aquisição relata seu resultado no fluxo de log do servidor e a conexão prossegue de qualquer forma; o que um artefato rejeitado custa são os recursos de documentação, que então respondem “não encontrado” nessa sessão. aggrega scaffold --example não tem nada a escrever sem o bundle, então ali é a recusa do comando, e nada é escrito.

Mensagem emitida, nomeando a referência e ambos os tipos de mídia:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (docscache: a referência indicada na versão indicada tem o tipo de mídia encontrado, quando se esperava o de um bundle de documentação: docscache: o artefato não é um bundle de documentação)

Como corrigir: nada nos seus arquivos de entidade causa isso, e nenhuma mudança de autoria o elimina. A referência que a aquisição usou aponta para algo que não é um bundle de documentação — verifique o registro configurado do workspace, já que a referência do bundle é derivada dele, e uma referência bem formada que aponta para outro artefato é resolvida com sucesso e só falha aqui.

A page is absent from a documentation bundle (Uma página está ausente de um bundle de documentação)

Um bundle de documentação foi armazenado em cache e seu conteúdo verificado, e a página pedida — ou, para aggrega scaffold --example, o diretório do exemplo — não está nele. É diferente de não ter bundle nenhum: o bundle está presente e íntegro, e a entrada falta nele.

Ela não chega a nenhum build. A superfície que serve páginas de documentação a um editor ou a um assistente a transforma em uma resposta comum de “não encontrado” para o recurso solicitado. aggrega scaffold --example a relata como uma recusa que nomeia o exemplo e o bundle, seguida de uma indicação para aggrega scaffold --example --list, que imprime os exemplos que o bundle de fato traz, e não escreve nada.

Vale a pena saber distinguir qual das duas respostas de “não encontrado” você recebe, mesmo que a superfície as apresente da mesma forma. Esta significa que o bundle está em cache e íntegro e que a página não está nele. A outra — nenhum bundle que o workspace possa ler, porque nenhum está em cache ou a única cópia é uma que a verificação de assinaturas do workspace recusa — significa que a aquisição não foi concluída, e o fluxo de log do servidor diz por quê.

Mensagem emitida, nomeando a página e o bundle em que ela foi procurada:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (a página indicada na referência e na versão indicadas: docscache: página não encontrada no bundle de documentação)

Como corrigir: nada está quebrado nos seus arquivos. Uma página que falta no bundle falta porque o bundle é anterior a ela ou porque o caminho pedido não é o caminho sob o qual ela é publicada — o bundle é adquirido na versão que o servidor informa como sua, então uma página adicionada depois dessa versão não está nele. Onde a página nunca existiu, a solicitação nomeou um caminho que a documentação não usa, e a documentação publicada é o lugar para encontrar o que ela usa.

An edit would produce a document its schema refuses (Uma edição produziria um documento que seu esquema recusa)

Uma recusa em uma edição de documento, não em um build. Uma edição estruturada — adicionar um componente, vincular uma Feature, fazer a fiação de uma aresta ou definir um valor — é composta e inserida no documento, e o resultado é então verificado em relação ao esquema do tipo de documento que ele é. Onde essa verificação objeta, a edição é recusada e nada é escrito. Ela pertence a aggrega edit-document, e à mesma capacidade alcançada por um editor via aggrega serve ou por um assistente, que são pontos de entrada finos para uma única implementação.

O tipo é lido do documento, nunca fornecido por quem chama. Um chamador que nomeasse o tipo poderia nomear o errado, e o resultado seria então verificado em relação a um esquema segundo o qual o documento não está escrito — o que admitiria exatamente a edição que esta verificação existe para recusar.

O arquivo fica byte a byte como estava, e a escrita é atômica, então uma edição recusada não se distingue de uma nunca tentada, e uma solicitação corrigida pode ser repetida sobre o documento com que você começou.

Seu objeto é uma solicitação bem formada. A solicitação nomeava uma edição que esta capacidade aplica, e o documento que ela teria produzido é um que o esquema de autoria teria recusado se você o tivesse digitado à mão — e é por isso que nenhuma regra de autoria é repetida para ela: pedir a uma Release que carregue um valor do desenvolvedor é recusado pelo mesmo esquema de qualquer forma. Uma solicitação que nunca endereçou uma edição — um caminho de nó que não alcança nada no documento, um valor escrito como mapeamento onde um escalar é exigido, uma entrada já presente que traz outra coisa — é recusada por seus próprios motivos, e cada superfície relata isso em seu próprio canal.

Um documento que já era inválido também o relata. A verificação é executada mesmo onde a edição não mudou nada, então uma edição sobre um documento que o produto se recusaria a ler diz isso em vez de relatar sucesso.

A verificação é a mesma que toda leitura do documento aplica, então ela também recusa uma Recipe ou FeatureRecipe cujo pipeline declara duas vezes um mesmo id de etapa, uma regra que nenhum esquema consegue expressar; a objeção após a frase abre então com a frase e o conselho próprios dessa condição, conforme descrito em A pipeline declares one step id twice (Um pipeline declara duas vezes um mesmo id de etapa).

Mensagem emitida, trazendo a objeção própria do esquema após a frase — o tipo de documento e o arquivo, depois a posição, a chave com problema e o que o esquema disse ali — e terminando com o conselho:

the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (a edição foi recusada porque o documento resultante não seria válido, e nada foi escrito: a validação do envelope do documento falhou (o tipo indicado, no caminho indicado); a linha e a coluna indicadas: o caminho do campo indicado: … seguido da objeção própria do esquema. corrija o documento para que corresponda ao esquema do seu tipo)

Como corrigir: abra o documento na posição que a mensagem cita e leia a objeção, que diz o que o esquema queria naquela chave. A mudança a fazer geralmente é na solicitação, e não no documento — peça uma entrada que o esquema admita naquele lugar, e a mesma solicitação se aplica sem problemas. Onde a chave é uma que o tipo desse documento não pode trazer de forma alguma, ela pertence à superfície de autoria que pode, e a página da entidade desse tipo nomeia os campos que ele declara. O que é semanticamente admissível não é decidido neste ponto — se um socket de dependência é um que o produtor declara, por exemplo —, então esta recusa é sempre sobre a forma do documento, nunca sobre o que pode ser consumido através de uma conexão.

An annotation key uses a prefix the platform reserves (Uma chave de anotação usa um prefixo que a plataforma reserva)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. O prefixo aggrega.ai/, e feature.aggrega.ai/ fora de uma Feature, pertencem à plataforma: uma chave escrita sob um deles carrega um significado que a plataforma atribui, então uma entidade sua que escreve ali reivindica um namespace que não detém.

Ela avisa durante a autoria e recusa no controle de publicação, e as duas leituras nomeiam esta mesma condição. O que foi encontrado é o mesmo em ambos os casos; só a consequência difere. Essa divisão é o modo como se comporta a maioria das regras das convenções de publicação catalogadas aqui, então ela é enunciada uma vez e dada como certa nas entradas abaixo que não digam o contrário — as duas que comparam com uma versão já publicada dizem isso em suas próprias entradas, porque não podem ser executadas de forma alguma sobre conteúdo local.

Sua mensagem começa assim:

an annotation key on the entity uses a prefix the platform reserves (uma chave de anotação da entidade usa um prefixo que a plataforma reserva)

Como corrigir: mova a chave para baixo de um prefixo que pertença à sua própria organização. Onde um workspace tiver mesmo assim um motivo para escrever sob o prefixo reservado, esta regra é uma das que têm uma opção de exclusão, descritas em “As regras de disciplina” em aggrega-lint.md.

An entity’s name does not follow the shape its kind expects (O nome de uma entidade não segue a forma que seu tipo espera)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. Cada tipo de entidade carrega uma convenção de forma de nome — o número de segmentos para os tipos cloud-native, PascalCase para os tipos de biblioteca — e o nome que esta entidade declara não corresponde ao que seu tipo espera.

Sua mensagem começa assim:

the entity’s name does not follow the documented name shape for its kind (o nome da entidade não segue a forma de nome documentada para seu tipo)

Como corrigir: renomeie a entidade para a forma que seu tipo espera; as convenções por tipo estão listadas em “As regras de disciplina” em aggrega-lint.md, junto com a opção de exclusão para um catálogo que nomeia deliberadamente as entidades à sua maneira.

A schema uses a dynamic reference that cannot be resolved ahead of time (Um esquema usa uma referência dinâmica que não pode ser resolvida antecipadamente)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. Um esquema que a entidade traz usa uma construção de referência dinâmica, cujo destino é escolhido enquanto um documento está sendo validado, em vez de ser fixado quando o esquema é escrito. Aqui as referências são expandidas antecipadamente, então não há nenhuma validação em andamento em relação à qual uma construção dessas possa ser resolvida.

Sua mensagem começa assim:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (um esquema na entidade usa uma construção de referência dinâmica que a resolução de referências entre documentos não consegue seguir)

Como corrigir: substitua a construção dinâmica por uma referência simples que nomeie diretamente o destino. Onde o esquema realmente precisar da construção e não for referenciado entre documentos, a regra tem uma opção de exclusão descrita em “As regras de disciplina” em aggrega-lint.md.

A schema declares an identifier the platform owns (Um esquema declara um identificador que pertence à plataforma)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. Um esquema que a entidade traz declara um identificador próprio, enquanto o identificador canônico é derivado da identidade da entidade. O declarado substitui o derivado, então uma referência escrita em relação ao identificador canônico deixa de ser resolvida.

Sua mensagem começa assim:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (um esquema na entidade declara um identificador próprio, enquanto a identidade desse esquema pertence à plataforma)

Como corrigir: remova o identificador declarado e deixe que ele seja derivado. A opção de exclusão, para um esquema publicado deliberadamente sob um identificador próprio, está descrita em “As regras de disciplina” em aggrega-lint.md.

A Component’s category label and its directory name different categories (O rótulo de categoria de um Component e seu diretório nomeiam categorias diferentes)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. Um Component carrega um rótulo de categoria e fica arquivado sob um diretório de categoria; a convenção é que os dois nomeiem a mesma categoria, para que o diretório que um leitor percorre e o rótulo com o qual um seletor faz correspondência não possam divergir.

Sua mensagem começa assim:

the entity’s category label does not match the category directory the entity is filed under (o rótulo de categoria da entidade não corresponde ao diretório de categoria sob o qual a entidade está arquivada)

Como corrigir: altere aquele dos dois que estiver errado para que concordem — mova o arquivo para baixo do diretório que seu rótulo nomeia, ou corrija o rótulo para a categoria que o diretório nomeia. O conjunto fechado de categorias, e a opção de exclusão, estão em “As regras de disciplina” em aggrega-lint.md.

A schema extension is written directly into schema content (Uma extensão de esquema é escrita diretamente no conteúdo do esquema)

Uma recusa ao verificar uma entidade em relação às convenções de publicação, não em um build. Um Component ou uma Feature escreve uma extensão de esquema do Aggrega diretamente no conteúdo de seu esquema, enquanto a entidade dispõe de uma superfície de primeira classe para declarar a mesma coisa. A forma escrita diretamente funciona, e a convenção prefere a superfície declarada porque é ela que as páginas das entidades ensinam e é ela que as ferramentas leem.

Esta é a única regra do grupo que um build também relata, como um aviso que não interrompe o build. Verificar a entidade em relação às convenções de publicação no controle de publicação eleva a mesma constatação a uma recusa.

Sua mensagem começa assim:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (a entidade escreve uma extensão de esquema do Aggrega diretamente no conteúdo do esquema em vez de declará-la no esquema de sockets ou no esquema de vinculações)

Como corrigir: mova a extensão para a superfície de sockets ou de vinculações própria da entidade, que é onde as páginas das entidades component.md e feature.md a declaram. A opção de exclusão está em “As regras de disciplina” em aggrega-lint.md.

A Plugin pins neither runtime cap, so the platform’s own apply (Um Plugin não fixa nenhum dos dois limites de runtime, então os da plataforma se aplicam)

Um aviso gerado quando uma entidade é verificada em relação às convenções de publicação, tanto durante a autoria quanto no controle de publicação; ele nunca interrompe nada, e um build não o gera. Um Plugin declara o teto de memória e o limite de tempo que o host aplica quando carrega e executa o plugin. Um que não declara nenhum dos dois é executado com os valores padrão da plataforma, o que é um resultado suportado, e não um erro — então o que isto relata é que os valores padrão estão em vigor e que é possível fixá-los explicitamente.

Sua mensagem começa assim:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (a entidade Plugin não declara nenhum limite de recursos de runtime próprio, então os valores padrão da plataforma se aplicam)

Como corrigir: fixe os limites de que o plugin realmente precisa, ou deixe deliberadamente os valores padrão em vigor. Ela não tem nenhuma configuração de exclusão, e o motivo é que relata um fato sobre a entidade, e não um julgamento sobre ela: não há nada a afrouxar. Os campos estão descritos em plugin.md.

An attachment slot admits only secret material without saying it handles it (Um slot de vinculação admite apenas material secreto sem dizer que o manipula)

Um aviso gerado quando uma entidade é verificada em relação às convenções de publicação, tanto durante a autoria quanto no controle de publicação; ele nunca interrompe nada, e um build não o gera. Um slot de vinculação pode fixar, por meio de seu seletor, que somente uma Feature que carrega segredos possa preenchê-lo, e pode registrar separadamente que o que quer que o preencha manipula material secreto. O seletor estabelece quais preenchimentos são admissíveis; o registro estabelece a manipulação. Um slot que fixa o primeiro e omite o segundo deixa que a manipulação seja inferida do seletor, em vez de lida no slot. Todo slot que uma entidade declara é verificado: os de seu próprio bloco de vinculações e, em um Component, os que um socket de dependência declara para cada conexão cabeada através dele — a constatação sobre o slot de um socket nomeia o socket ao lado do slot.

Sua mensagem começa assim:

an attachment slot admits only secret material and does not declare that it handles it (um slot de vinculação admite apenas material secreto e não declara que o manipula)

Como corrigir: declare a manipulação no slot, ao lado do seletor que fixa o que ele admite. Ela não tem nenhuma configuração de exclusão, pelo mesmo motivo pelo qual a regra dos limites do Plugin não tem: relata um fato sobre a entidade e deixa a decisão com você.

A Recipe publishes a provides key its Component does not declare, checked at publication (Uma Recipe publica uma chave que seu Component não declara, com verificação na publicação)

Um aviso gerado quando uma entidade é verificada em relação às convenções de publicação, tanto durante a autoria quanto no controle de publicação; ele nunca interrompe nada, e um build não o gera. Uma Recipe publica uma chave sob provides:, e o Component que a Recipe implementa não declara essa chave no pilar provides de seu esquema. Um consumidor que faz o cabeamento através de uma conexão lê o contrato declarado do Component, e não o que quer que a Recipe emita, então a chave é produzida e depois recusada onde algo tenta consumi-la.

🔴 Duas condições descrevem isso, e elas não são a mesma. O aviso que um build relata está documentado acima em “A Recipe publishes a provides key its Component does not declare (Uma Recipe publica uma chave que seu Component não declara)”; esta é gerada quando a entidade é verificada em relação às convenções de publicação, e carrega seu próprio código. A constatação é o mesmo fato encontrado em duas superfícies — leia o código no diagnóstico para saber qual você tem em mãos.

Sua mensagem começa assim:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (a Recipe publica uma chave provides que o Component que ela implementa não declara, então um consumidor que faz o cabeamento dessa chave é recusado)

Como corrigir: declare a chave no Component, para que o contrato que um consumidor lê inclua o que a Recipe emite — ou pare de publicá-la a partir da Recipe onde nada deve consumi-la. A opção de exclusão está em “As regras de disciplina” em aggrega-lint.md.

A Component’s metrics annotation and its provides key disagree (A anotação de métricas de um Component e sua chave provides divergem)

Um aviso gerado quando uma entidade é verificada em relação às convenções de publicação, tanto durante a autoria quanto no controle de publicação; ele nunca interrompe nada, e um build não o gera. Um Component pode declarar como as métricas de seu produto se autenticam, em sua anotação observability.aggrega.ai/metrics-credential — none, target-key ou separate-token — e pode declarar a chave provides metrics_credential_required, que cada uma de suas Recipes publica para dizer se as métricas de uma instância precisam de uma credencial. As duas são um único fato sobre o produto visto de dois lados, então um Component que afirma que suas métricas não exigem credencial não declara nenhuma chave assim, e um que afirma que elas exigem uma credencial a declara. Esta condição relata um Component em que as duas divergem, nomeando o Component, o valor da anotação e a chave que sobra ou falta.

Sua mensagem começa assim:

a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential (a anotação de um Component que afirma como suas métricas se autenticam diverge de ele declarar ou não a chave provides que diz que as métricas de uma instância precisam de uma credencial)

Como corrigir: corrija aquele dos dois que estiver errado — declare metrics_credential_required no pilar provides, e publique-a a partir de cada Recipe, onde as métricas exigirem uma credencial; remova-a onde não exigirem nenhuma; ou altere a anotação para o valor que descreve o produto. Ela não tem nenhuma configuração de exclusão, pelo mesmo motivo pelo qual a regra dos limites do Plugin não tem; quais valores ela lê, e quais Components ela deixa sem ler, estão em “As regras de disciplina” em aggrega-lint.md.

A connection and the target it reaches do not name one key (Uma conexão e o destino que ela alcança não nomeiam uma mesma chave)

Um aviso gerado quando uma Release é verificada em relação às convenções de publicação; ele nunca interrompe nada, e um build não o gera. Um servidor que verifica uma chave guarda a chave que verifica em um slot próprio, e um chamador apresenta uma chave na conexão pela qual alcança esse servidor. Nenhuma das duas pontas vê a da outra, então as duas são uma única chave só porque seus autores escrevem o mesmo localizador nas duas pontas. Esta condição relata uma conexão cujo destino declara o slot para a chave que exige de seus chamadores, nos casos em que elas não são uma mesma chave: a conexão carrega uma credencial e o slot de chave do destino não está preenchido, o slot de chave do destino está preenchido e a conexão não carrega nenhuma credencial, ou ambos estão preenchidos e os dois escrevem seus localizadores de forma diferente.

Ao contrário das regras acima dela, esta lê uma Release inteira, e não uma única entidade, então só é encontrada quando uma Release é verificada e nunca no controle de publicação, que verifica uma única entidade isoladamente; onde quer que seja relatada, é um conselho. A constatação nomeia o componente, a conexão, o destino e os dois slots, e nunca cita nenhum dos dois localizadores. Um scrape — uma conexão no socket scrape_target — é julgado pelo que seu destino afirma sobre suas métricas: de forma alguma onde a anotação observability.aggrega.ai/metrics-credential do destino diz none, nunca em relação à chave do destino onde ela diz separate-token, e como qualquer outra conexão nos demais casos; uma conexão em qualquer outro socket é julgada independentemente do que o destino afirme.

Sua mensagem começa assim:

a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one (uma conexão e o destino que ela alcança não nomeiam uma mesma chave: escrevem localizadores diferentes para ela, ou apenas um dos dois nomeia uma)

Como corrigir: faça as duas pontas lerem um único parâmetro — o campo credential da conexão e o campo api_key do destino — para que a chave que o chamador apresenta e a chave que o servidor verifica não possam ser escritas de forma diferente; ou, onde uma conexão não deve apresentar nenhuma chave, retire a credencial dela. Quais slots são lidos, o que é comparado e a opção de exclusão estão em “As regras de disciplina” em aggrega-lint.md.

The change being published breaks what the evolution rubric allows (A alteração em publicação viola o que a rubrica de evolução permite)

Uma recusa na verificação que precede a publicação, não em um build. A versão em publicação é comparada com a versão já publicada antes dela, e a diferença entre as duas é classificada segundo uma rubrica documentada. Esta condição relata que a diferença é uma à qual a rubrica faz objeção.

Ela precisa de um predecessor publicado com o qual comparar, então ela e a verificação do incremento de versão abaixo são as duas regras deste grupo que não podem ser executadas apenas sobre conteúdo local: sem nenhum registro consultado não há nada a comparar, e a verificação é pulada em vez de aprovada.

Sua mensagem começa assim:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (a versão em publicação altera o predecessor publicado de um modo ao qual a rubrica de evolução documentada faz objeção)

Como corrigir: leia a classificação no diagnóstico, que nomeia o que na alteração motivou a objeção da rubrica, e torne a alteração compatível ou publique-a sob uma versão que a admita. A rubrica é apresentada em “A rubrica de incremento de versão” em aggrega-lint.md.

The version offered is a smaller bump than the change requires (A versão oferecida é um incremento menor do que a alteração exige)

Uma recusa na verificação que precede a publicação, não em um build. A alteração em publicação é classificada segundo a rubrica de evolução, e a versão oferecida para ela é um passo menor do que essa classificação exige — uma remoção ou um estreitamento oferecido como patch, por exemplo. Um incremento excessivo é sempre aceito; é um incremento insuficiente que para aqui.

Ao contrário das regras acima dela, esta é decidida aqui, e não pelo plugin de convenções. Qual incremento foi oferecido só é conhecido no momento da publicação, e nenhuma compilação está em andamento nesse momento, então a comparação entre a classificação e a versão oferecida é feita nesse ponto.

Sua mensagem começa assim:

the version bump being published is smaller than the evolution check’s classification of the change requires (o incremento de versão em publicação é menor do que exige a classificação da alteração feita pela verificação de evolução)

Como corrigir: publique sob a versão que a classificação exige; o diagnóstico nomeia qual é. Onde você acreditar que a alteração é menor do que a classificação indica, a rubrica em “A rubrica de incremento de versão” em aggrega-lint.md diz o que coloca uma alteração em cada classe. A primeira publicação de uma entidade não tem predecessor, então a comparação é pulada e relatada como não realizada em vez de aprovada.

An import stopped partway through translating a source (Uma importação parou no meio da tradução de uma origem)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. O importer relatou um diagnóstico grave o bastante para interromper a tradução, então o que ele produziu é parcial: parte da origem se tornou rascunhos de arquivos de autoria e parte não.

O resultado parcial é deliberado, e não um destroço. Ele nomeia o desfecho e não a causa — o que não pôde ser traduzido é relatado nos diagnósticos que o acompanham, um por construção que o importer não conseguiu transpor, nas próprias palavras do importer. Esta condição é o que permite a um chamador distinguir “a importação parou e produziu parte de uma resposta” de “a importação falhou por completo”, que são situações diferentes com próximos passos diferentes.

Sua mensagem começa assim:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (o importer relatou um diagnóstico que interrompe a importação, então a origem não foi totalmente transformada em rascunhos de arquivos de autoria)

Como corrigir: leia os diagnósticos relatados ao lado dela — cada um nomeia uma construção da origem que o importer não conseguiu traduzir. A correção está na origem que você forneceu, ou em concluir o rascunho manualmente: uma importação produz um ponto de partida para editar, então uma construção que não sobreviveu à tradução deve ser escrita diretamente do lado do Aggrega. aggrega-import.md descreve o que o comando produz e onde ele escreve.

More than one importer recognises the source (Mais de um importer reconhece a origem)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A importação não nomeou nenhum formato, então o formato foi reconhecido a partir das assinaturas que os importers declaram — tanto os do catálogo do workspace quanto os importers principais do compilador, cada um dos quais nomeia a sintaxe em que uma origem é lida, os nomes de arquivo aos quais se aplica e os caminhos que sua árvore analisada deve ou não deve conter — e assinaturas de importers que atendem mais de um formato corresponderam à origem. A importação não escolhe entre eles: em que formato uma origem está é uma afirmação dos importers, não do compilador, e escolher seria um palpite que entregaria a origem a um importer ao qual ela talvez não se destine.

Isto não é o mesmo que um único formato anunciado por mais de um importer, descrito em “A parse or import format is advertised by more than one plugin (Um formato de análise ou de importação é anunciado por mais de um plugin)” acima. Lá o formato está definido e os importers que o atendem concorrem, então uma entrada plugins.importer escolhe entre eles; aqui são os próprios formatos que diferem, então nenhuma vinculação resolve a questão, e nomear o formato a resolve. Um importer que reconhece uma origem a reconhece como cada formato que anuncia, então um importer que anuncia mais de um formato, uma de cujas assinaturas corresponde, também é recusado aqui.

Sua mensagem começa assim:

more than one importer recognises the source (mais de um importer reconhece a origem)

O restante da mensagem nomeia a origem e cada formato como o qual ela foi reconhecida, na ordem das identidades e versões dos importers, e depois a solução:

more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (mais de um importer reconhece a origem (origem indicada, reconhecida como os formatos indicados). Passe —format para nomear o formato em que lê-la (por exemplo —format seguido de um dos formatos))

Como corrigir: nomeie o formato — --format em aggrega import, ou format na ferramenta de importação do assistente e no método aggrega/import da sessão. Onde um dos importers nunca deveria reconhecer uma origem assim, a alteração é nas assinaturas desse importer, que seu autor declara em seu autorrelato describe() e que sua entidade Plugin registra quando é gerada; ou, onde for um que o catálogo do workspace contém, deixe-o fora do catálogo que o workspace lê — um importer principal está sempre entre os testados, então uma origem que um deles reconhece junto com outro importer é resolvida nomeando o formato. aggrega-import.md descreve como um formato é reconhecido.

No importer recognises the source (Nenhum importer reconhece a origem)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A importação não nomeou nenhum formato, então o formato foi reconhecido a partir das assinaturas que os importers declaram — tanto os do catálogo do workspace quanto os importers principais do compilador — e as assinaturas de nenhum formato corresponderam à origem. A importação não adivinha: entregar a origem a um importer que nunca declarou que lê essa forma geraria um rascunho a partir de uma origem à qual ele talvez não se destine.

Esta é a contrapartida de “More than one importer recognises the source (Mais de um importer reconhece a origem)” acima. Lá vários formatos reivindicam a origem; aqui nenhum o faz. Em ambos, nomear o formato resolve a questão, e nada é escrito até que ele seja nomeado.

Sua mensagem começa assim:

no importer recognises the source (nenhum importer reconhece a origem)

O restante da mensagem nomeia a origem, depois a solução e cada formato que os importers do catálogo anunciam, na ordem em que foram lidos:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (nenhum importer reconhece a origem (origem indicada). Passe —format para nomeá-lo explicitamente (por exemplo —format seguido de um dos formatos anunciados))

Onde nenhum importer anuncia formato algum, a solução diz isso no lugar dos exemplos.

Um diretório recebe uma solução diferente, porque nomear um formato qualquer não pode ajudá-lo. Um diretório é lido apenas pelos padrões de arquivo que seu importer declara, e uma assinatura que não declara nenhum padrão de arquivo não se aplica a nenhum dos arquivos de um diretório — assim, um diretório que contém, por exemplo, uma única exportação do Langflow não é reconhecido por nenhuma assinatura, e nomear o formato langflow seria, por sua vez, recusado conforme An importer that declares no file patterns is handed a directory (Um importer que não declara padrões de arquivo recebe um diretório). Por isso, a recusa de um diretório o nomeia como diretório e oferece importar um de seus arquivos isoladamente, ou nomear um formato cujo importer declare padrões de arquivo — somente esses formatos, extraídos das próprias declarações dos importers:

no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (nenhum importer reconhece a origem (diretório). Importe isoladamente um dos arquivos do diretório, ou passe —format nomeando um formato cujo importer leia um diretório pelos padrões de arquivo que declara (por exemplo —format ou —format))

Quando nenhum importer declara um padrão de arquivo, a recusa oferece importar isoladamente um dos arquivos do diretório e informa que nenhum importer do catálogo declara os padrões de arquivo pelos quais um diretório é lido.

Como corrigir: nomeie o formato — --format em aggrega import, ou format na ferramenta de importação do assistente e no método aggrega/import da sessão, cada um dos quais formula a recusa em torno do campo que recebe e a abre com o código curto desta condição; a resposta da sessão também traz os dois códigos da condição em seus dados. Para um diretório, importe isoladamente o arquivo que você pretendia — uma assinatura que não nomeia nenhum arquivo se aplica a um arquivo importado isoladamente, qualquer que seja seu nome — ou nomeie um dos formatos que a recusa lista. Onde a origem deveria ter sido reconhecida, a alteração é nas assinaturas do importer que atende seu formato, que seu autor declara em seu autorrelato describe() e que sua entidade Plugin registra quando é gerada. aggrega-import.md descreve como um formato é reconhecido.

An importer that declares no file patterns is handed a directory (Um importer que não declara padrões de arquivo recebe um diretório)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A origem nomeada é um diretório, e um diretório é entregue ao seu importer exatamente como os arquivos que os padrões de arquivo declarados pelo importer selecionam — então quais arquivos de um diretório um importer lê é uma afirmação do próprio importer. O importer que atende o formato da origem não declara padrões de arquivo: ele lê um único arquivo e não diz nada sobre quais arquivos de um diretório são seus.

Nada é aberto. A importação para assim que o importer é resolvido e antes que qualquer arquivo do diretório seja lido, em vez de entregar ao importer todos os arquivos que o diretório contém.

Sua mensagem começa assim:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (o importer que atende o formato da origem não declara padrões de arquivo, então lê um único arquivo e não consegue ler um diretório)

O restante da mensagem nomeia o formato, o importer e o diretório como você o nomeou, e depois a solução:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (o importer que atende o formato da origem não declara padrões de arquivo, então lê um único arquivo e não consegue ler um diretório (formato, importer e diretório indicados). Importe em vez disso um dos arquivos do diretório isoladamente; o importer lê um diretório assim que declara os padrões de arquivo pelos quais seus arquivos são nomeados)

Como corrigir: importe isoladamente um arquivo do formato. Para que um importer leia diretórios do seu formato, seu autor declara os padrões pelos quais seus arquivos são nomeados — o campo files de uma assinatura de reconhecimento em seu autorrelato describe(), que sua entidade Plugin registra quando é gerada. aggrega-import.md descreve o que uma importação de um diretório lê.

No file in the directory matches the importer’s file patterns (Nenhum arquivo do diretório corresponde aos padrões de arquivo do importer)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A origem nomeada é um diretório, o formato está definido e o importer que o atende declara padrões de arquivo — mas nenhum arquivo que o diretório contém, em qualquer profundidade, corresponde a um deles. Não entregar nenhuma origem ao importer o faria falhar em uma origem vazia, com palavras sobre o conteúdo em vez de sobre quais arquivos foram lidos, então a importação para aqui sem ter lido nada.

Onde o formato foi reconhecido em vez de nomeado, o importer cuja assinatura reconheceu o diretório correspondeu a um dos seus arquivos, então isto só ocorre onde o importer que é executado não é esse — outro importer do mesmo formato que uma entrada plugins.importer seleciona, ou outra versão dele.

Sua mensagem começa assim:

no file in the directory matches the file patterns the importer serving the source’s format declares (nenhum arquivo do diretório corresponde aos padrões de arquivo que o importer que atende o formato da origem declara)

O restante da mensagem nomeia o formato, o importer, o diretório como você o nomeou e cada padrão que o importer declara, e depois a solução:

no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (nenhum arquivo do diretório corresponde aos padrões de arquivo que o importer que atende o formato da origem declara (formato, importer, diretório e padrões de arquivo indicados). Nomeie um diretório que contenha um arquivo ao qual um desses padrões corresponda, ou o formato de um importer cujos padrões correspondam aos arquivos que este diretório contém)

Como corrigir: importe o diretório que contém os arquivos do formato — um padrão é comparado com o final do caminho de um arquivo dentro do diretório, então um arquivo em qualquer profundidade conta — ou nomeie o formato em que os arquivos do diretório estão. aggrega-import.md descreve o que uma importação de um diretório lê.

A file read from the directory and a file named in the importer’s with.sources have the same name (Um arquivo lido do diretório e um arquivo nomeado nas origens do importer têm o mesmo nome)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A origem nomeada é um diretório, e seus arquivos chegam ao importer como origens nomeadas, cada um sob seu caminho dentro do diretório. A entrada plugins.importer que vincula o importer nomeia arquivos próprios em with.sources, que também chegam a ele como origens nomeadas, cada um sob seu nome base — e um mesmo nome é usado por ambos. Um nome é como um importer distingue uma origem de outra, então entregar ambos a ele deixaria uma encobrir a outra sem nada que diga qual; em vez disso, a importação para, sem entregar nada.

Sua mensagem começa assim:

a file read from the directory and a file named in the importer’s with.sources have the same name (um arquivo lido do diretório e um arquivo nomeado nas origens do importer têm o mesmo nome)

O restante da mensagem nomeia o nome e o arquivo de with.sources, e depois a solução:

a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources (um arquivo lido do diretório e um arquivo nomeado nas origens do importer têm o mesmo nome (nome e arquivo de with.sources indicados). Cada origem chega ao importer sob um único nome, então renomeie um dos dois arquivos, ou deixe o arquivo fora das with.sources do importer)

Como corrigir: renomeie um dos dois arquivos, ou retire o arquivo do campo with.sources da entrada onde o diretório já o contém. Um arquivo de with.sources mantém seu nome base, então é um arquivo de mesmo nome no nível superior do diretório que ele encontra; um arquivo em um diretório abaixo traz esse diretório em seu nome. Qual importer transforma uma origem em rascunhos descreve o campo with.sources de uma entrada.

An import’s target names a capability no Recipe in the catalog binds to (O destino de uma importação nomeia uma capacidade à qual nenhuma Recipe do catálogo se vincula)

Uma recusa ao transformar uma descrição de origem externa em rascunhos de arquivos de autoria, não em um build. A importação recebeu um destino — --target em aggrega import, ou target na ferramenta de importação do assistente e no método aggrega/import da sessão — para que gere o rascunho de um Manifest que mapeie cada tipo de componente do rascunho para uma Recipe desse provedor. O destino é uma capacidade de provedor, comparada com o spec.capability ao qual cada Recipe do catálogo do workspace se vincula, e nenhuma Recipe ali se vincula à informada. Um Manifest gerado para ela não mapearia nada, e cada tipo de componente apareceria então como ausente do catálogo quando o que está errado é a própria opção — na maioria das vezes um erro de digitação.

Nada é executado e nada é escrito. A importação para assim que o catálogo é carregado, antes que o formato da origem seja reconhecido e antes que o importer seja executado, então nenhum rascunho é produzido e nenhum arquivo é escrito, inclusive em uma simulação.

Sua mensagem começa assim:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (nenhuma Recipe do catálogo do workspace se vincula à capacidade que o destino da importação nomeia)

O restante da mensagem nomeia o destino exatamente como foi informado e as capacidades às quais as Recipes do catálogo de fato se vinculam, cada uma uma vez e em ordem, e depois a solução:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written (nenhuma Recipe do catálogo do workspace se vincula à capacidade que o destino da importação nomeia (destino indicado, capacidades às quais as Recipes do catálogo se vinculam). Nomeie uma dessas capacidades como destino, ou omita o destino e nenhum Manifest é gerado; nada foi gerado nem escrito)

Onde o catálogo não contém Recipe alguma, a mensagem diz isso no lugar da lista, e a solução é adicionar ao catálogo uma Recipe do provedor.

Como corrigir: nomeie uma das capacidades que a mensagem lista — compose ou helm, por exemplo, como o spec.capability de uma Recipe as escreve — ou omita o destino, o que não gera nenhum rascunho de Manifest. Onde o provedor que você pretendia é um para o qual o catálogo ainda não contém nenhuma Recipe, adicione suas Recipes a uma pasta de catálogo que o workspace lê primeiro. aggrega-import.md descreve o que gera uma importação que recebe um destino.

A child Release inherits a boundary directory that resolves where its parent writes (Uma Release filha herda um diretório de fronteira que se resolve onde sua Release pai escreve)

Um aviso. Uma Release estende outra e herda dela o diretório de saída de uma fronteira, e esse diretório não contém nenhuma variável de template — então ele se resolve no mesmo caminho para ambas, e o build da filha escreve onde o build da Release pai escreve.

Herdar o diretório é a forma suportada, e não um erro. Um diretório é um template, então uma Release pai o escreve uma vez e uma filha que preenche um parâmetro o resolve em outro lugar sem duplicar nada; esse é todo o motivo pelo qual uma filha não precisa repetir a topologia de fronteiras da sua Release pai. O que é estreito e real é o caso residual que isto nomeia: sem nenhuma variável nele, não resta nada para resolver de forma diferente.

Ele não pode causar uma interrupção, e isso é uma propriedade da regra, e não cautela em relação a ela. Escrever no mesmo caminho resolvido é algo que um autor pode legitimamente pretender — uma filha que troca apenas as Recipes de renderização para comparar sua saída, ou que muda apenas o dimensionamento — então uma regra que interrompesse com base nessa inferência recusaria uma entrada legítima com base em um palpite.

Sua mensagem começa assim:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to (o diretório de fronteira herdado não contém nenhuma variável de template, então se resolve no caminho em que a Release estendida escreve)

Como corrigir: onde as duas deveriam escrever em lugares diferentes, coloque uma referência a parâmetro no diretório e deixe cada Release preenchê-la. Onde escrever em um único caminho é o que você pretendia, nada precisa mudar — o aviso disse a você o que vai acontecer, e o build produz sua saída de qualquer forma.

Encontrar uma interrupção a partir do código curto que o build imprimiu

O cabeçalho entre colchetes de um diagnóstico de interrupção nomeia a categoria à qual a falha é atribuível e, onde a falha nomeia uma das condições catalogadas aqui, o código curto dessa condição — a letra E e quatro dígitos, como em [CATALOG_ERROR E0209]. Um número é atribuído uma vez e depois fica fixo, então um código curto que você cola em um relatório ou em uma busca ainda nomeia a condição que nomeava quando você o registrou. Os outros dois identificadores que uma condição traz, e qual dos três usar e quando, são explicados em sentinels.md.

A própria linha de mensagem da condição começa com uma frase fixa que enuncia a condição. Tudo depois dessa frase varia com a ocorrência — o documento com problema, a chave escrita, o valor problemático e o conselho para essa ocorrência — e as entradas acima citam a forma inteira para a condição que cada uma documenta. A frase fixa é a parte que é igual toda vez, e é isso que faz dela a parte com a qual fazer a correspondência.

A tabela abaixo relaciona as duas, restrita a esta página: para cada condição catalogada aqui, o código curto que um build imprime e a frase com que sua linha de mensagem começa, ao lado da entrada acima que explica a correção de autoria. Os títulos das entradas são citados exatamente, de modo que buscar um deles nesta página leva à sua entrada. A tabela de todas as condições resolve um código curto entre todas as condições que o compilador declara, incluindo as que nenhuma entrada aqui cobre.

Onde uma entrada aparece ao lado de dois códigos curtos, ela cobre duas condições distintas e cada uma registra sua própria frase; leia as frases em vez do título compartilhado para saber qual delas um build relatou.

aggrega explain <code> faz essa busca para você no terminal, aceitando qualquer um dos códigos da condição e imprimindo a condição junto com a entrada acima que a documenta. Ele é descrito em aggrega explain.

Código curtoComeça comDocumentado em
E0001cliplugin: no plugin resolver configuredA command-line plugin runner was built without a way to find plugins (Um executor de plugins de linha de comando foi construído sem uma forma de encontrar plugins)
E0003malformed attachment requirementMalformed attachment requirement (Requisito de vinculação malformado)
E0004annotation contribution overridden by an explicit valueAn explicit value displaced one an annotation supplied (Um valor explícito substituiu um que uma anotação fornecia)
E0005policy violationA governance plugin rejected the build (Um plugin de governança rejeitou a build)
E0006required attachment slot unfilledRequired attachment slot not bound (Slot de vinculação obrigatório sem associação)
E0007selector violationCross-node type safety violation via selector: (Violação da segurança de tipos entre nós via selector)
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (A Feature que preenche um slot de vinculação não satisfaz o seletor do slot)
E0009pipeline step typed-I/O contract violationA pipeline step’s typed input or output does not satisfy its declared contract (A entrada ou a saída tipada de uma etapa de pipeline não satisfaz seu contrato declarado)
E0010pipeline step failedA pipeline step failed (Uma etapa de pipeline falhou)
E0011pipeline patch targets a document not present in the setA pipeline patch addresses a document the set does not hold, or one with no tree to address (Um patch de pipeline endereça um documento que o conjunto não contém, ou um sem árvore para endereçar)
E0012pipeline patch targets an opaque (non-structured) unitA pipeline patch addresses a document the set does not hold, or one with no tree to address (Um patch de pipeline endereça um documento que o conjunto não contém, ou um sem árvore para endereçar)
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release (Divergência de tipo de Feature entre Aggregate e Release)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key (Uma entrada de inject traz ao mesmo tempo um literal e uma chave de origem)
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses edge dictates delivery on a socket that allowlists none (Uma aresta dita a entrega em um socket que não permite nenhum mecanismo); uses edge dictates a delivery mechanism outside the socket’s allowlist (Uma aresta dita um mecanismo de entrega fora da lista de permissões do socket)
E0016jsonpatch: test operation failedA patch’s test operation did not match the document (A operação de teste de um patch não correspondeu ao documento)
E0017annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeysAn annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Um plugin annotation-transform nomeia um componente que não lhe foi entregue, ou injeta um valor que nenhuma anotação aceita)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaA governance attachment’s settings do not match the plugin’s declared schema (As configurações de uma vinculação de governança não correspondem ao esquema declarado do plugin)
E0019endpoint requires form: referenceA workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)
E0020schedule is not a valid cron expressionA workload schedule: is not an expression the check accepts (O agendamento de uma carga de trabalho não é uma expressão que a verificação aceita)
E0021persistentTemplate volume requires form: statefulA workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)
E0022pipeline PATCH target is not parseable structured YAML/JSONA pipeline step addresses documents the node does not have (Uma etapa de pipeline endereça documentos que o nó não tem)
E0023form: reference requires an endpointA workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)
E0024schedule requires form: scheduledA workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)
E0025form: scheduled requires a scheduleA workload: form and the fields beside it do not agree (A forma de uma carga de trabalho e os campos ao lado dela não concordam)
E0026imported artifact content does not match the digest recorded for it in entity.lockAn imported artifact no longer matches the digest recorded beside its Recipe (Um artefato importado não corresponde mais ao digest registrado ao lado de sua Recipe)
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)A library $import: is not written in the bare-name form (Uma importação de biblioteca não está escrita na forma de nome simples)
E0028artifacts output filename collision: two artifact outputs carry the same filenameTwo artifact outputs of one Recipe carry the same filename (Duas saídas de artefatos de uma mesma Recipe têm o mesmo nome de arquivo)
E0029artifact template references a pillar the Recipe does not declareAn artifacts: template reads a pillar the Recipe does not declare (Um template de artifacts lê um pilar que a Recipe não declara)
E0030artifact-library import references a bundle not present in the ArtifactLibraryA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0031artifact-library import references an ArtifactLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path (Dois contribuidores escrevem o mesmo caminho de saída)
E0033assertion failedAn assertion stopped the build (Uma asserção parou a build)
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed (Uma vinculação entrega uma chave que outra fonte de inject já reivindicou)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (O plugin que serve um provedor não consegue montar o que esse provedor combina)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella (Nome de chart divergente em um chart guarda-chuva helm-chart mesclado)
E0037cross-boundary link between endpoints rendered by different providers is not supportedA connection crosses between two different providers’ assembled outputs (Uma conexão atravessa as saídas montadas de dois provedores diferentes)
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output (O mesmo nome é derivado mais de uma vez dentro da saída)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist (O template de FeatureRecipe referencia um campo fora da lista de permissões do seu escopo)
E0040library $import: carries a registry host; reference the library by bare-name identityA library $import: addresses its library by registry location (Uma importação de biblioteca endereça sua biblioteca pela localização no registro)
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path (Colisão de ID de instância entre fronteiras que se montam no mesmo caminho)
E0042locals entry references a sibling defined later in the same blocklocals: entry references a sibling defined later in the same block (Uma entrada de locals referencia uma entrada irmã definida mais adiante no mesmo bloco)
E0043template references a key the locals block does not declarelocals: key does not exist (A chave de locals não existe)
E0044mapping-library import references an entry not present in the MappingLibraryA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)A library $import: is not written in the bare-name form (Uma importação de biblioteca não está escrita na forma de nome simples)
E0046mapping-library import references a MappingLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder (A saída montada ainda carrega um marcador de posição entre fronteiras)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths (Colisão de caminhos: dois contribuidores emitem em caminhos incompatíveis)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist (O template de caminho referencia uma variável fora da lista de permissões)
E0050pipeline /host operation from a step with no host componentA pipeline step addresses documents the node does not have (Uma etapa de pipeline endereça documentos que o nó não tem)
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsA pipeline patch addresses output that has not been assembled yet (Um patch de pipeline endereça uma saída que ainda não foi montada)
E0052pipeline PATCH targets a document the node did not emitA pipeline step addresses documents the node does not have (Uma etapa de pipeline endereça documentos que o nó não tem)
E0053pipeline plugin is not compatible with the rendering providerA pipeline step’s plugin does not claim the provider rendering what it addresses (O plugin de uma etapa de pipeline não reivindica o provedor que renderiza o que a etapa endereça)
E0054provider rejected node inputA provider refused a node’s input (Um provedor recusou a entrada de um nó)
E0055Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declaresA Recipe or FeatureRecipe does not publish a provides key its contract declares (Uma Recipe ou FeatureRecipe não publica uma chave provides que seu contrato declara)
E0056provides template evaluation failedA provides: template could not be evaluated (Não é possível avaliar um template de provides)
E0057provides block references a root outside the self-contained setprovides: template references a non-self-contained root (O template de provides referencia uma raiz não autocontida)
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (Um provedor renderizou a mesma entrada duas vezes e produziu saídas diferentes)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources (Chave de entrega duplicada entre as fontes de inject)
E0060template references a root the render context does not defineTemplate references a root the render context does not define (O template referencia uma raiz que o contexto de renderização não define); Self-inject value template references cross-node data (O template do valor de self-inject referencia dados entre nós)
E0061unknown providerUnknown provider (Provedor desconhecido)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingA component declares an inject mechanism the attached Feature maps nothing to (Um componente declara um mecanismo de inject para o qual a Feature vinculada não mapeia nada)
E0063workload-library import references an entry not present in the WorkloadLibraryA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)A library $import: is not written in the bare-name form (Uma importação de biblioteca não está escrita na forma de nome simples)
E0065workload-library import references a WorkloadLibrary not present in the catalogA library $import: names a library or an entry the catalog does not hold (Uma importação de biblioteca nomeia uma biblioteca ou uma entrada que o catálogo não contém)
E0066uses edge target does not existDangling uses target (Destino de aresta pendente)
E0067active toggle did not resolve to a booleanAn active: toggle does not resolve to true or false (Um interruptor não se resolve em true nem em false)
E0068max sub-aggregate nesting depth exceededSub-aggregate nesting depth exceeded (Profundidade de aninhamento de subagregados excedida)
E0069mutator patch rejectedA label-transform plugin’s patch reaches outside node labels (O patch de um plugin label-transform vai além dos rótulos dos nós)
E0070re-exported component alias forms a cycleA re-published component alias points back at itself (Um alias de componente republicado aponta para si mesmo)
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge (A Release muda o destino de uma aresta declarada pelo desenvolvedor)
E0072sub-aggregate load failedA module a composition imports cannot be loaded, or imports itself (Um módulo que uma composição importa não pode ser carregado, ou importa a si mesmo)
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differTwo instances flatten to one identifier (Duas instâncias são achatadas em um único identificador)
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to (A configuração por aresta da Release não tem nenhuma aresta à qual se aplicar)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised (Um Aggregate chegou à construção do grafo sem ter sido normalizado)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`A sub-module’s components are placed in no boundary (Os componentes de um submódulo não estão posicionados em nenhuma fronteira)
E0077uses edge target was pruned because its active toggle resolved to falseA uses edge targets a component an active: toggle removed (Uma aresta tem como destino um componente que um interruptor removeu)
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callA plugin asks the host to parse a source while a parse is already running for it (Um plugin pede ao host que analise uma origem enquanto já há uma análise em andamento para ele)
E0079wasm: recorded command mirror does not match plugin describe()A Plugin entity’s recorded command set does not match the plugin (O conjunto de comandos registrado de uma entidade Plugin não corresponde ao plugin)
E0080wasm: entity contract claim does not match plugin describe()A Plugin entity’s claims disagree with the plugin’s own self-report (As afirmações de uma entidade Plugin divergem da autodescrição do próprio plugin)
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared (Um plugin devolveu um diagnóstico com uma severidade que não está declarada)
E0082wasm: guest plugin reported an errorA plugin failed while it was running (Um plugin falhou durante a execução)
E0083wasm: guest plugin panicked during callA plugin failed while it was running (Um plugin falhou durante a execução)
E0084wasm: stamped host-function record does not match .wasm importsA Plugin entity’s recorded host functions do not match the binary (As funções host registradas de uma entidade Plugin não correspondem ao binário)
E0085wasm: plugin rejected by the sandboxThe sandbox refused a plugin (A sandbox recusou um plugin)
E0086wasm: plugin invoked proc_exitA plugin failed while it was running (Um plugin falhou durante a execução)
E0087wasm: declared plugin type does not match plugin describe()A plugin is not the kind of plugin the socket expects (Um plugin não é do tipo de plugin que o socket espera)
E0088wasm: entity metadata.version does not match plugin describe()A Plugin entity’s recorded version does not match the plugin (A versão registrada de uma entidade Plugin não corresponde ao plugin)
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn (Toda versão que uma referência poderia selecionar foi retirada)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin (Um formato de análise ou de importação é anunciado por mais de um plugin)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one plugin (Um formato de análise ou de importação é anunciado por mais de um plugin)
E0092capability is served by more than one provider plugin; add a plugins.providers entry to select oneA capability is served by more than one provider plugin (Uma capacidade é servida por mais de um plugin provedor)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousA Manifest maps two version-distinct keys onto one type (Um Manifest mapeia duas chaves de versões distintas para um mesmo tipo)
E0094duplicate entity identity within a single catalog directoryTwo catalog entities in one directory share an identity (Duas entidades do catálogo em um mesmo diretório compartilham uma identidade)
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts (O valor de mapeamento do Manifest não tem uma estrutura que uma referência de receita aceite)
E0096manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type keyRecipe implements does not match the mapped component type (A declaração de implementação da Recipe não corresponde ao tipo de componente mapeado)
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format (Nenhum plugin anuncia um formato de análise ou de importação solicitado)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format (Nenhum plugin anuncia um formato de análise ou de importação solicitado)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its typeNo Recipe is mapped for a component or feature instance (Nenhuma Recipe está mapeada para uma instância de componente ou de funcionalidade)
E0100plugins.providers entry names a plugin no provider-rendering plugin serving the capability matchesA plugins.providers binding names a plugin that does not serve the capability (Uma associação nomeia um plugin que não serve a capacidade)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin (Nenhuma versão de plugin provedor satisfaz a fixação de provedor de uma Recipe)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathA plugin reference carries a registry host or an artifact path (Uma referência de plugin contém um host de registro ou um caminho de artefato)
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint (Nenhuma versão do catálogo satisfaz uma restrição de versão)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationA plugin or recipe reference carries no scope (Uma referência de plugin ou de receita não tem escopo)
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationA plugin or recipe reference carries no scope (Uma referência de plugin ou de receita não tem escopo)
E0106resolve: invalid library reference URIA library reference is not written in the identity form (Uma referência a biblioteca não está escrita na forma de identidade)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions (Dois consumidores de uma mesma biblioteca exigem versões incompatíveis)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs (A visão do catálogo fornecida a uma build não consegue carregar os corpos de que a fixação precisa)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs (A visão do catálogo fornecida a uma build não consegue carregar os corpos de que a fixação precisa)
E0110resolve: source-template evaluation failure at lock timeResolving a source: coordinate registers a narrower function set (A resolução de uma coordenada source registra um conjunto de funções mais restrito)
E0111resolve: source-template parse errorResolving a source: coordinate registers a narrower function set (A resolução de uma coordenada source registra um conjunto de funções mais restrito)
E0112resolve: source-template references .provides (invalid reverse reference)Resolving a source: coordinate registers a narrower function set (A resolução de uma coordenada source registra um conjunto de funções mais restrito)
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (A cadeia de importações de módulos é mais profunda do que o percurso de fixação desce)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds (Uma referência não nomeia nenhuma entidade que o catálogo contenha)
E0115compactform: ambiguous dispatch — $mode requiredA compact-form schema declares a field literally named type (Um esquema em forma compacta declara um campo chamado literalmente assim)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on (Uma restrição em forma compacta não se aplica ao tipo em que foi escrita)
E0117compactform: $jsonschema content invalidA $jsonschema: escape carries content that is not a schema (Um escape contém um conteúdo que não é um esquema)
E0118compactform: cross-document $ref carries a registry host; reference the library by identityA $ref: addresses a library by registry location (Uma referência endereça uma biblioteca pela sua localização no registro)
E0119compactform: $ref unresolvableA $ref: is not written in a form the compiler can resolve (Uma referência não está escrita em uma forma que o compilador consiga resolver)
E0120compactform: unknown keywordA compact-form schema uses a keyword the compact form does not know (Um esquema em forma compacta usa uma palavra-chave que a forma compacta não conhece)
E0121compactform: cross-document $ref target not foundA $ref: is not written in a form the compiler can resolve (Uma referência não está escrita em uma forma que o compilador consiga resolver)
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated (O build consome um artefato que seu publicador descontinuou)
E0123docscache: artifact is not a documentation bundleA resolved artifact is not a documentation bundle (Um artefato resolvido não é um bundle de documentação)
E0124docscache: page not found in documentation bundleA page is absent from a documentation bundle (Uma página está ausente de um bundle de documentação)
E0125egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cacheThe workspace is offline and the step needs the network (O espaço de trabalho está offline e a etapa precisa da rede)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (Uma renderização solicita uma entrada externa que o arquivo de bloqueio não fixa)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (Os bytes baixados não correspondem a um digest fixado)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (A URL de uma entrada externa usa um esquema não permitido)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (Uma entrada externa armazenada não corresponde mais ao seu registro)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to (O arquivo de bloqueio não corresponde mais àquilo em que a Release se resolve)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema (O arquivo de bloqueio não satisfaz seu esquema)
E0132oci: manifest has multiple layers of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Um manifesto não traz nenhuma camada do tipo esperado, ou traz mais de uma)
E0133oci: cached manifest digest mismatchFetched or cached bytes do not match the digest committed for them (Os bytes baixados ou em cache não correspondem ao digest declarado para eles)
E0135oci: content digest mismatchFetched or cached bytes do not match the digest committed for them (Os bytes baixados ou em cache não correspondem ao digest declarado para eles)
E0136oci: network unreachableThe registry could not be reached (Não foi possível acessar o registro)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it (Um artefato não está na fonte em que a build foi instruída a encontrá-lo)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts (O registro não serve um artefato sem credenciais que ele aceite)
E0139oci: tag already published with different contentA tag is already published with different content (Uma tag já está publicada com conteúdo diferente)
E0140oci: manifest has no layer of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Um manifesto não traz nenhuma camada do tipo esperado, ou traz mais de uma)
E0141oci: distinct catalog identities map to the same OCI repository locationTwo catalog identities publish to one repository location (Duas identidades do catálogo publicam em um mesmo local de repositório)
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact (O registro não conseguiu responder o que está vinculado a um artefato)
E0143oci: unknown entity kind for mediatype dispatchAn entity kind has no artifact media type (Um tipo de entidade não tem tipo de mídia de artefato)
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it (Um bundle de assinatura em cache não corresponde ao digest registrado para ele)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity (Uma referência de plugin não é uma entidade Plugin)
E0146circular reference expansionA library reference expands into itself (Uma referência de biblioteca se expande em si mesma)
E0147registrytrust: advertised trust config is malformedA registry serves a trust document that cannot be read as one (Um registro serve um documento de confiança que não pode ser lido como tal)
E0148registrytrust: registry advertises no trust configA registry publishes no trust document (Um registro não publica nenhum documento de confiança)
E0149attachment name is a near miss for a declared slotAn attachment name is one edit from a declared slot (Um nome de vinculação está a uma edição de distância de um slot declarado)
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape (A vinculação não está em conformidade com a forma declarada de seu slot)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary (Um componente é colocado em mais de uma fronteira)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice (O diretório da Release declara duas vezes um Aggregate ou um Manifest)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged (Uma funcionalidade vinculada tanto pelo Aggregate quanto pela Release não pode ser mesclada)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (Uma guarda precisa de uma entidade do catálogo que a build resolveu e que ela não consegue ver)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources (Chave de entrega duplicada entre as fontes de inject)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides (A chave de inject não está entre o que o destino fornece)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (Uma referência a parâmetros não pode ser interpolada)
E0160manifest annotation bindings collide on same Feature path+pillarTwo Manifest annotation bindings compete for one routing slot (Duas associações de anotação do Manifest competem por um mesmo slot de roteamento)
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Uma associação de anotação do Manifest reivindica o prefixo reservado)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (Funcionalidade obrigatória não vinculada)
E0163required uses socket not populatedRequired uses: socket not populated (Socket obrigatório não preenchido)
E0164parameter contract violatedParameter type mismatch / contract violation (Tipo de parâmetro incompatível / violação de contrato)
E0165required parameter not suppliedParameter type mismatch / contract violation (Tipo de parâmetro incompatível / violação de contrato)
E0167Recipe publishes a provides key its Component does not declareA Recipe publishes a provides key its Component does not declare (Uma Recipe publica uma chave que seu Component não declara)
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema (Os values ou infra escritos não estão em conformidade com o esquema declarado)
E0169self-inject on component without spec.inject allowlistSelf-inject on a component without an allowlist (Self-inject em um componente sem lista de permissões); Self-inject mechanism not in the component’s allowlist (Mecanismo de self-inject fora da lista de permissões do componente)
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (A referência de uma Release não se resolve em nada)
E0171unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declareuses: socket not declared in the owning entity’s usesSchema (Socket não declarado no esquema de sockets da entidade proprietária)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)A Release reached resolution without passing through the load path (Uma Release chegou à resolução sem passar pelo caminho de carregamento)
E0173declared parameter is read by no reference in the AggregateA declared parameter is read by nothing (Um parâmetro declarado não é lido por nada)
E0174uses socket name is a near miss for a declared socketA uses: socket name is one edit from a declared socket (Um nome de socket está a uma edição de distância de um socket declarado)
E0175file load failed: the file could not be read, or its bytes did not parseA file cannot be read, or its bytes do not parse (Um arquivo não pode ser lido, ou seus bytes não podem ser analisados)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorKeyless signing was asked for without the services it needs (A assinatura sem chave foi solicitada sem os serviços de que precisa)
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature (Um artefato que precisa ser assinado não traz nenhuma assinatura)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer (Uma política de confiança sem chave não nomeia nenhum signatário aceitável)
E0179signing: signature does not verifyA detached signature does not verify against the key supplied (Uma assinatura destacada não é verificada com a chave fornecida)
E0180signing: signature bundle does not verifyA signature does not verify (Uma assinatura não passa na verificação)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Uma publicação não assinada tem como destino um registro ou uma política que exige uma assinatura)
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read (A raiz de confiança fixada não pode ser lida)
E0183signing: registry requires signatures; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Uma publicação não assinada tem como destino um registro ou uma política que exige uma assinatura)
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts (Uma chave de verificação fixada não é do perfil de chave que o verificador aceita)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts (Uma assinatura passa na verificação, mas o seu signatário não é um em quem o registro confia)
E0186no source adapter serves the source kindA Recipe’s source: names a kind nothing knows how to acquire (A origem de uma Recipe nomeia um tipo que nada sabe como adquirir)
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it (Um artefato de origem é armazenado em cache sem uma raiz do workspace para ancorá-lo)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}An inline-or-import field is written in neither shape (Um campo inline ou de importação não está escrito em nenhuma das duas formas)
E0189artifactlibrary: entry must be a mapping of filename to a string bodyA library entry’s body is not the shape that library holds (O corpo de uma entrada de biblioteca não tem a forma que essa biblioteca contém)
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit (Um esquema usa uma palavra-chave de JSON Schema que a biblioteca não admite)
E0191mappinglibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (O corpo de uma entrada de biblioteca não tem a forma que essa biblioteca contém)
E0192a document nests too many levels deepA document nests deeper than the reader will descend (Um documento se aninha mais fundo do que o leitor desce)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (O bloco de parâmetros de uma Release não está escrito em nenhuma de suas duas formas)
E0194schemalibrary: template not foundA $instantiate: reference cannot be resolved (Não é possível resolver uma referência)
E0195schemalibrary: template parameter missingA $instantiate: reference cannot be resolved (Não é possível resolver uma referência)
E0196schemalibrary: template parameter type mismatchA $instantiate: reference cannot be resolved (Não é possível resolver uma referência)
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Um campo inline ou de importação não está escrito em nenhuma das duas formas)
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderA provider declares a well-known annotation at a scope it does not render (Um provedor declara uma anotação well-known em um escopo que ele não renderiza)
E0199workloadlibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (O corpo de uma entrada de biblioteca não tem a forma que essa biblioteca contém)
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Um campo inline ou de importação não está escrito em nenhuma das duas formas)
E0201assertion name declared twice across the extends chainAn assertion name is declared twice along an extends: chain (Um nome de asserção é declarado duas vezes ao longo de uma cadeia de extensão)
E0202cyclic extends chainCyclic extends chain (Cadeia extends cíclica); Cyclic extends on Components or Features (Extends cíclico em Components ou Features)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (O mapeamento de valores de uma FeatureRecipe exige uma origem)
E0205inheritance merge failedAn extends: chain cannot be assembled (Uma cadeia de extensão não pode ser montada)
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally (Um rótulo de componente promovido também é declarado literalmente)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace (Uma chave de rótulo de saída usa um namespace reservado)
E0209Recipe: valuesMapping requires sourcevaluesMapping requires source (o mapeamento de valores requer uma fonte)
E0210Recipe: at least one input kind requiredAt least one input kind must be present (Pelo menos um tipo de entrada deve estar presente)
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds (Colisão de nomes de arquivo no momento da emissão entre tipos de entrada)
E0212workload attachment slot is not referenceableA Workload references a slot whose fill publishes no locator (Um Workload faz referência a um slot cujo preenchimento não publica nenhum localizador)
E0213workload featuresSchema cross-check failedA Workload attachment names a slot the entity does not declare, or a delivery the slot forbids (Uma vinculação de Workload nomeia um slot que a entidade não declara, ou uma entrega que o slot proíbe)
E0214workload validation failedA Workload does not satisfy the Workload schema (Um Workload não satisfaz o esquema Workload)
E0215document envelope validation failedYAML anchor aliased inside its own content (Âncora YAML referenciada por um alias dentro do seu próprio conteúdo); Divergent Release (extends + aggregate pointer) (Release divergente (extends + ponteiro aggregate))
E0216validator/jsonschema: x-aggrega extension evaluation failedAn x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Não é possível avaliar um predicado)
E0218validator/jsonschema: schema resolution failedA declared schema cannot be resolved (Um esquema declarado não pode ser resolvido)
E0220extends chain exceeds maximum depthAn extends: chain runs past the depth bound (Uma cadeia de extensão ultrapassa o limite de profundidade)
E0221merger: invalid merge inputThe schema-merge step’s own input guard (A salvaguarda de entrada própria da etapa de mesclagem de esquemas)
E0222registry alias matches more than one hostA registry alias matches more than one host (Um alias de registro corresponde a mais de um host)
E0223a cross-cutting socket is bound by capability but attaches by uriA plugin binding sets a key the socket it attaches to does not read (Uma associação de plugin define uma chave que o socket ao qual ela se vincula não lê)
E0224workspace configuration is invalidThe workspace configuration is invalid (A configuração do espaço de trabalho é inválida)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin (Uma capacidade está associada a mais de um plugin provedor)
E0226registry alias is already used by another hostA registry alias is already bound to another host (Um alias de registro já está associado a outro host)
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role (Uma vinculação de governança não declara nenhum papel, ou declara um que não é um papel conhecido)
E0228a provider socket binding sets a field with no referent on that socketA plugin binding sets a key the socket it attaches to does not read (Uma associação de plugin define uma chave que o socket ao qual ela se vincula não lê)
E0229position out of rangeAn editor position falls outside the document (Uma posição do editor fica fora do documento)
E0246the digest recorded as trusted for this plugin does not match the digest its cached manifest reportsA trusted plugin’s recorded digest disagrees with the cached artifact (O digest registrado de um plugin confiável diverge do artefato em cache)
E0247a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict roleA plugin recorded as a trusted gate is no longer attached (Um plugin registrado como controle confiável não está mais vinculado)
E0248wasm: guest plugin returned an output that is not the shape the socket readsA plugin returned something that is not the shape the socket reads (Um plugin devolveu algo que não tem a estrutura que o socket lê)
E0250provider named a directory for each contributor's own sub-directory that is not a single directory nameA provider named a directory for a contributor that is not one directory (Um provedor nomeou para um contribuidor um diretório que não é um único diretório)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modeRecipe source: is an empty string (O campo source da Recipe é uma string vazia)
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underAn ArtifactLibrary bundle file names no file of its own under the key it was imported at (Um arquivo de bundle de uma ArtifactLibrary não nomeia nenhum arquivo próprio sob a chave em que foi importado)
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature (A associação da anotação não se resolve em relação à sua Feature de destino)
E0254annotation subkey does not conform to the target Feature's schema at the routed pillarA bound annotation value does not conform to the target Feature’s schema (Um valor de anotação associado não está em conformidade com o esquema da Feature de destino)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use (Uma anotação é roteada por um pilar que seu lado de autoria não pode usar)
E0256annotation binding declares one path in both pillar listsAn annotation binding declares one path in both pillar lists (Uma associação de anotação declara um mesmo caminho em ambas as listas de pilares)
E0257declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validationA declared schema contract cannot be read as a schema (Um contrato de esquema declarado não pode ser lido como esquema)
E0259attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares itA boundary-scope Feature is attached only to a component (Uma Feature de escopo de fronteira está vinculada apenas a um componente)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`A component the composition holds is placed in no boundary (Um componente que a composição contém não está posicionado em nenhuma fronteira)
E0261boundary names a component the composition does not hold: correct the name, or remove the entryA boundary names a component the composition does not hold (Uma fronteira nomeia um componente que a composição não contém)
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits (A identidade do Component não pode ser carimbada no que ele emite)
E0263the target will not accept a name derived from this component's authored identity: rename the componentThe target will not accept a name derived from an authored identity (O destino não aceita um nome derivado de uma identidade escrita)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed (Um provedor nunca aceitou um nome composto pelo compilador)
E0265provider does not support the node's input kindworkload: requires a provider that can synthesize (requer um provedor capaz de sintetizar)
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied (Uma importação de esquema não pode ser aplicada)
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar (Um bloco de esquema nomeia uma chave que não é um pilar de dados)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensA provider’s reassembly is handed a unit its own carve never produced (A remontagem de um provedor recebe uma unidade que o seu próprio recorte nunca produziu)
E0269provider guest returned two output files under one path; a conforming guest returns each output path at most onceA provider returned two output files under one path (Um provedor devolveu dois arquivos de saída sob um mesmo caminho)
E0270link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returnedA provider’s link wiring names an output file that was never emitted (O cabeamento de ligação de um provedor nomeia um arquivo de saída que nunca foi emitido)
E0271emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and contentA pipeline step’s file emission carries no file (A emissão de arquivo de uma etapa de pipeline não traz nenhum arquivo)
E0272side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crdA pipeline step declares an emission kind the contract does not define (Uma etapa de pipeline declara um tipo de emissão que o contrato não define)
E0273template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider suppliesA template reads a rendered name the node’s provider does not report (Um template lê um nome renderizado que o provedor do nó não informa)
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity (Um controle registrado como confiável é resolvido para uma identidade diferente)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenAn edit would produce a document its schema refuses (Uma edição produziria um documento que seu esquema recusa)
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects toThe change being published breaks what the evolution rubric allows (A alteração em publicação viola o que a rubrica de evolução permite)
E0277an annotation key on the entity uses a prefix the platform reservesAn annotation key uses a prefix the platform reserves (Uma chave de anotação usa um prefixo que a plataforma reserva)
E0278the entity's name does not follow the documented name shape for its kindAn entity’s name does not follow the shape its kind expects (O nome de uma entidade não segue a forma que seu tipo espera)
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followA schema uses a dynamic reference that cannot be resolved ahead of time (Um esquema usa uma referência dinâmica que não pode ser resolvida antecipadamente)
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityA schema declares an identifier the platform owns (Um esquema declara um identificador que pertence à plataforma)
E0281the entity's category label does not match the category directory the entity is filed underA Component’s category label and its directory name different categories (O rótulo de categoria de um Component e seu diretório nomeiam categorias diferentes)
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaA schema extension is written directly into schema content (Uma extensão de esquema é escrita diretamente no conteúdo do esquema)
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyA Plugin pins neither runtime cap, so the platform’s own apply (Um Plugin não fixa nenhum dos dois limites de runtime, então os da plataforma se aplicam)
E0284an attachment slot admits only secret material and does not declare that it handles itAn attachment slot admits only secret material without saying it handles it (Um slot de vinculação admite apenas material secreto sem dizer que o manipula)
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedA Recipe publishes a provides key its Component does not declare, checked at publication (Uma Recipe publica uma chave que seu Component não declara, com verificação na publicação)
E0286the version bump being published is smaller than the evolution check's classification of the change requiresThe version offered is a smaller bump than the change requires (A versão oferecida é um incremento menor do que a alteração exige)
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring filesAn import stopped partway through translating a source (Uma importação parou no meio da tradução de uma origem)
E0288a plugin has no expression for a construct this build declaresA workload declares a form compose cannot express (Uma carga de trabalho declara uma forma que compose não consegue expressar); A container declares a field compose has no primitive for (Um contêiner declara um campo para o qual compose não tem primitiva); An omits entry names a kind or a namespace a compose file does not have (Uma entrada omits nomeia um kind ou um namespace que um arquivo compose não tem); An omits entry names a namespace a CloudFormation template does not have (Uma entrada omits nomeia um namespace que um template CloudFormation não tem); A rule reads a bound CloudFormation parameter by name (Uma regra lê pelo nome um parâmetro do CloudFormation associado); The assembled CloudFormation stack cannot carry a transform (A stack do CloudFormation montada não consegue carregar uma transformação)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck (Uma sonda de integridade não pode ser transformada em um healthcheck do compose); A configmap volume has no file behind it (Um volume configmap não tem nenhum arquivo por trás); What an omits entry left out is still named by the compose file (O que uma entrada omits deixou de fora ainda é nomeado pelo arquivo compose); What an omits entry left out is still named by a CloudFormation template (O que uma entrada omits deixou de fora ainda é nomeado por um template CloudFormation); A valuesMapping key names no parameter of a sourced CloudFormation template (Uma chave de valuesMapping não nomeia nenhum parâmetro de um template CloudFormation de origem); Another component references a CloudFormation parameter a sourced template’s binding filled (Outro componente referencia um parâmetro do CloudFormation que a associação de um template de origem preencheu); Two components order one pair of transforms oppositely (Dois componentes ordenam um mesmo par de transformações de forma oposta); A cross-boundary reference has no consuming stack to be written into (Uma referência entre fronteiras não tem nenhuma stack consumidora em que ser escrita); A synthesized StatefulSet has no single service to govern it (Um StatefulSet sintetizado não tem um único serviço que o governe)
E0290two things a plugin produced occupy one name in its outputAn authored export name is one the build derives for a cross-stack reference (Um nome de exportação escrito é um que a build deriva para uma referência entre stacks); The output a cross-stack reference publishes on already carries an Export (A saída na qual uma referência entre stacks publica já traz um Export); Two entries reach one stack output name (Duas entradas chegam a um mesmo nome de saída da stack); A CloudFormation fragment writes one key twice (Um fragmento do CloudFormation escreve uma mesma chave duas vezes); Two rendered resources land at one output file (Dois recursos renderizados vão parar em um mesmo arquivo de saída)
E0291a plugin has no representation for a value it was givenA published port declares a transport compose cannot spell (Uma porta publicada declara um transporte que o compose não consegue escrever); A resources quantity cannot be converted to a compose value (Uma quantidade de recursos não pode ser convertida em um valor do compose); A resource quantity the helm provider emits is not a quantity (Uma quantidade de recurso que o provedor helm emite não é uma quantidade); A service type the helm provider cannot render (Um tipo de serviço que o provedor helm não consegue renderizar); A Kubernetes version the helm provider cannot render a chart for (Uma versão do Kubernetes para a qual o provedor helm não consegue renderizar um chart); A value bound to a CloudFormation parameter cannot take the parameter’s type (Um valor associado a um parâmetro do CloudFormation não pode assumir o tipo do parâmetro); A value bound to a CloudFormation parameter is one its constraints refuse (Um valor associado a um parâmetro do CloudFormation é um que as suas restrições recusam); A secret bound to a CloudFormation parameter would be written into the template (Um segredo associado a um parâmetro do CloudFormation seria escrito no template); A dynamic reference is bound where CloudFormation does not resolve it (Uma referência dinâmica está associada onde o CloudFormation não a resolve); A cross-boundary reference was spliced into a longer string (Uma referência entre fronteiras foi inserida em uma string mais longa)
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify (Um plugin relatou uma falha que não classificou)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare (Um plugin nomeou uma condição que o socket não declara)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identityTwo subsystems declare a component under one name (Dois subsistemas declaram um componente com um mesmo nome)
E0295library reference: a reference to a library entry carries no whitespace or line breakA reference to a library entry carries whitespace (Uma referência a uma entrada de biblioteca contém espaços em branco)
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothA Release chain’s links disagree about the routing shape (Os elos de uma cadeia de Release divergem quanto à estrutura de roteamento)
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toA child Release inherits a boundary directory that resolves where its parent writes (Uma Release filha herda um diretório de fronteira que se resolve onde sua Release pai escreve)
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two (Um bundle publicado não contém nenhuma entidade, ou contém duas)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two (Um bundle publicado não contém nenhuma entidade, ou contém duas)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity (Um artefato publicado não pode ser lido como uma entidade)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity (Um artefato publicado não pode ser lido como uma entidade)
E0302an input the entity reads has no pin recorded for it in the entity.lock beside itAn entity reads an input the lock beside it records no pin for (Uma entidade lê uma entrada para a qual o lock ao lado dela não registra nenhuma fixação)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its ownAn entity shares its directory with another entity (Uma entidade compartilha seu diretório com outra entidade)
E0304a path names content outside the entity's own directoryA path names content outside the entity’s own directory (Um caminho nomeia conteúdo fora do diretório da própria entidade)
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockA local source no longer matches the pins recorded beside its Recipe (Uma origem local não corresponde mais às fixações registradas ao lado de sua Recipe)
E0306plugin artifact not found on this machineA plugin’s .wasm is not on this machine (O arquivo Wasm de um plugin não está nesta máquina)
E0307a value a cache location is built from would place cached files outside the place it names in the cacheA value would place a cached file outside the cache (Um valor colocaria um arquivo em cache fora do cache)
E0308a Feature reaches a component alongside a Feature it declares a conflict withTwo Features declared to conflict reach one component (Duas Features declaradas em conflito alcançam um mesmo componente)
E0309a symbolic link sits among the files an entity carriesA symbolic link sits among the files an entity carries (Um link simbólico está entre os arquivos que uma entidade carrega)
E0310a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`A registry is added offline with no trust policy to pin (Um registro é adicionado offline sem uma política de confiança a fixar)
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes (Uma fixação de versão não tem nenhuma das formas que uma fixação assume)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon (Uma associação de provedor nomeia uma capacidade que contém dois-pontos)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesA provider binding names a capability no plugin the build reads serves (Uma associação de provedor nomeia uma capacidade que nenhum plugin lido pelo build serve)
E0314plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reportsA plugin was built from a working tree with uncommitted changes (Um plugin foi construído a partir de uma árvore de trabalho com alterações sem commit)
E0315a connection carries an attachment under a name its socket declares no slot forA connection carries an attachment under a name its socket declares no slot for (Uma conexão traz uma vinculação sob um nome para o qual seu socket não declara nenhum slot)
E0316a Release attachment takes the name of an attachment one of a component's connections carriesA Release attachment takes the name of a connection’s attachment (Uma vinculação da Release usa o nome da vinculação de uma conexão)
E0317a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makesA Release connection attachment names no Feature type (Uma vinculação de conexão da Release não nomeia nenhum tipo de Feature)
E0318duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already deliveredTwo attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Duas Features vinculadas entregam uma mesma chave, a posterior por meio do injectMapping de sua FeatureRecipe)
E0319connection alias is already used by another connection of the same componentTwo connections of one component under one alias (Duas conexões de um componente sob um mesmo alias)
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideA path the operation writes leads through a link out of the directory it must stay inside (Um caminho que a operação escreve leva, por meio de um link, para fora do diretório dentro do qual deve permanecer)
E0321a file this operation reads leads through a link out of the directory it must stay insideA file the operation reads leads through a link out of the directory it must stay inside (Um arquivo que a operação lê leva, por meio de um link, para fora do diretório dentro do qual deve permanecer)
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFactsA template reads its callers’ render facts without declaring it (Um template lê os fatos de renderização de seus chamadores sem declarar isso)
E0324a reference a document makes to another file leads out of the directory it must stay insideA reference to another file leads out of the directory it must stay inside (Uma referência a outro arquivo sai do diretório dentro do qual deve permanecer)
E0325provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entryA provider reported a render fact whose value is not a list (Um provedor relatou um fato de renderização cujo valor não é uma lista)
E0326pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render factsA pipeline step reads its callers’ render facts (Uma etapa de pipeline lê os fatos de renderização de seus chamadores)
E0327template indexes a map with a key the map does not holdA template indexes a map with a key the map does not hold (Um template indexa um mapa com uma chave que o mapa não contém)
E0328attachment written under a name no slot declares fits a slot its component leaves emptyAn attachment written under another name fits a slot its component leaves empty (Uma vinculação escrita sob outro nome se encaixa em um slot que seu componente deixa vazio)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names oneA connection and the target it reaches do not name one key (Uma conexão e o destino que ela alcança não nomeiam uma mesma chave)
E0330signing: the references named together need different signing credentials, so nothing was signedReferences signed together need different signing credentials (Referências assinadas juntas precisam de credenciais de assinatura diferentes)
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one (Nenhuma assinatura verificada está registrada para um artefato que exige uma)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact (Uma assinatura registrada foi feita para um artefato diferente)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record (Uma assinatura registrada não é a que um pull registraria)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (Uma entrada omits não deixou de fora nada do que a fonte renderizou)
E0335provider does not support omitsThe provider does not support omits (O provedor não oferece suporte a omits)
E0336a provider's omitted counts do not match the omits entries it was handedA provider’s omitted counts do not match the omits entries it was handed (As contagens de omissões de um provedor não correspondem às entradas omits que ele recebeu)
E0337no importer plugin version satisfies the plugins.importer entry's version pinA plugins.importer entry pins a version of its importer the catalog does not hold (Uma entrada fixa uma versão do seu importador que o catálogo não contém)
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (Um importador está vinculado por mais de uma entrada)
E0339more than one importer recognises the sourceMore than one importer recognises the source (Mais de um importer reconhece a origem)
E0340a name this operation writes holds a path segment Windows cannot hold as writtenA name the operation writes holds a part Windows cannot hold (Um nome que a operação escreve contém uma parte que o Windows não consegue conter)
E0341the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directoryAn importer that declares no file patterns is handed a directory (Um importer que não declara padrões de arquivo recebe um diretório)
E0342no file in the directory matches the file patterns the importer serving the source's format declaresNo file in the directory matches the importer’s file patterns (Nenhum arquivo do diretório corresponde aos padrões de arquivo do importer)
E0343a file read from the directory and a file named in the importer's `with.sources` have the same nameA file read from the directory and a file named in the importer’s with.sources have the same name (Um arquivo lido do diretório e um arquivo nomeado nas origens do importer têm o mesmo nome)
E0344an entry this publication carries cannot be used on WindowsA published archive carries an entry Windows cannot use (Um arquivo compactado publicado traz uma entrada que o Windows não consegue usar)
E0345a container declares one environment variable twiceA container gives one environment variable two values (Um contêiner dá dois valores a uma mesma variável de ambiente)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialA Component’s metrics annotation and its provides key disagree (A anotação de métricas de um Component e sua chave provides divergem)
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsA template reads its targets’ render facts without declaring it (Um template lê os fatos de renderização de seus destinos sem declarar isso)
E0348pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render factsA pipeline step reads its targets’ render facts (Uma etapa de pipeline lê os fatos de renderização de seus destinos)
E0349no Recipe in the workspace's catalog binds to the capability the import's target namesAn import’s target names a capability no Recipe in the catalog binds to (O destino de uma importação nomeia uma capacidade à qual nenhuma Recipe do catálogo se vincula)
E0350no importer recognises the sourceNo importer recognises the source (Nenhum importer reconhece a origem)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (O provedor não oferece suporte a artefatos de fronteira)
E0352boundary output directory does not name a directory beneath the output rootA boundary’s output directory is not a directory beneath the output root (O diretório de saída de uma fronteira não é um diretório sob a raiz de saída)
E0353boundary-level Feature instance name is not a directory nameA boundary-level Feature is named . or .. (Uma Feature de escopo de fronteira se chama . ou ..)
E0354a template does more than copy a value it reads off a cross-boundary linkA template did more than copy a value it read off a cross-boundary link (Um template fez mais do que copiar um valor que leu de uma ligação entre fronteiras)
E0355inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`An inject: delivery is not a list of entries (Uma entrega de inject não é uma lista de entradas)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled (A suspensão de uma carga de trabalho está definida em uma forma diferente da agendada)
E0357a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothingA Manifest name mapping names nothing in the build (Um mapeamento por nome do Manifest não nomeia nada no build)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export (Um destino de aresta nomeia um componente de um módulo que o módulo não exporta)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind (Nenhum adaptador de origem está registrado neste programa para um tipo de origem)
E0360the netrc file could not be readThe netrc file cannot be read (O arquivo netrc não pode ser lido)
E0361the source URL carries a credentialA source URL carries a credential (Uma URL de origem contém uma credencial)
E0362inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`An inject: entry on a connection carries a literal (Uma entrada de inject em uma conexão traz um literal)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding (Uma subchave de anotação não é roteada pela sua associação)
E0364a value template failed while it ranA value template failed while it ran (Um template de valores falhou durante a execução)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file (A saída de uma Feature de escopo de fronteira não chega a nenhum arquivo montado)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read (A saída de injectMapping de uma Feature anexada não pode ser lida)
E0367a scalar annotation value does not route to exactly one path of its bindingA bare annotation value does not route to exactly one path of its binding (Um valor de anotação simples não é roteado para exatamente um caminho da sua associação)
E0368FeatureRecipe injectMapping output writes a key no delivery mechanism of the host readsAn attached Feature’s injectMapping output writes deliveries under a key nothing delivers (A saída de injectMapping de uma Feature anexada grava entregas sob uma chave que nada entrega)
E0369template reads a path as a value and iterates it, and the data holds nothing at that pathA template reads and iterates a path that holds nothing (Um template lê e itera um caminho que não contém nada)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (Um pipeline declara duas vezes um mesmo id de etapa)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (Um documento de catálogo declara um tipo que um catálogo não contém)
E0372inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject blockAn inject: entry on an attached Feature carries a literal (Uma entrada de injeção em uma Feature anexada carrega um literal)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads (Um documento declara uma versão de API que este compilador não lê mais)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks (Um plugin declara uma versão da ABI de plugins que este compilador não suporta mais)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads (Um artefato traz um tipo de mídia que este compilador não lê mais)
E0376egress: the server did not answer in timeA server did not answer in time (Um servidor não respondeu a tempo)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (A listagem de repositórios de um registro não terminou a tempo)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (Um registry continuou pedindo para desacelerar)

O domínio do linter (não fatal)

O compilador se mantém estritamente sem opiniões próprias quanto à execução. Ele nunca interrompe o build por padrões que são apenas suspeitos — valores não usados, segredos órfãos, destinos desconectados. No máximo, um padrão desses gera um aviso — o do próprio build, para os poucos catalogados acima em “Condições que não interrompem um build”, como um parâmetro declarado que nada lê — e o restante pertence ao domínio do linter, onde as empresas optam por adotar plugins Wasm que aplicam as suas próprias convenções.

Credenciais órfãs

Uma Feature de credenciais vinculada sem um contrato de entrega inject: não é um erro de compilação. O compilador central preserva a declaração no grafo IR e não emite nenhum aviso. Plugins linter corporativos podem detectar esse padrão e alertar sobre ele; renderizadores corporativos também podem optar por montar implicitamente os segredos órfãos segundo as suas próprias convenções Black-Box. Como ambas as interpretações são válidas, o compilador central não toma partido de nenhuma.