Avisos e saída do linter
Avisos não fatais que o compilador emite durante a compilação. Os avisos não interrompem o build — eles revelam indícios de problemas de autoria, critérios de desempate determinísticos que o compilador escolheu e recursos que os templates do desenvolvedor nunca consumiram. Cada constatação chega ao stderr atrás de um prefixo que nomeia seu tipo — warning:, lint: ou notice:, conforme a passagem que a gerou — para que os pipelines de CI possam capturá-las e exibi-las novamente; os artefatos renderizados são produzidos de qualquer forma.
Para interrupções fatais da compilação (os diagnósticos que param um build), veja fatal-halts.md.
Cada aviso, por código curto
Parte do que o compilador relata sem interromper é uma condição própria: ela carrega um código curto, o mesmo identificador de quatro dígitos que um diagnóstico de interrupção imprime, e uma frase fixa com que sua mensagem começa. A tabela abaixo faz a consulta de um para o outro, de modo que um código que você tenha em mãos resolva para aquilo de que trata a constatação mesmo quando a linha que você está lendo é um aviso e não uma interrupção.
O que ganha um lugar aqui é uma declaração, não uma descrição. Cada regra que o compilador avalia declara o que uma violação faz — interromper o build, ou relatar a constatação e deixar o build terminar — e as linhas abaixo são do segundo tipo. Assim, um aviso adicionado ao compilador aparece aqui sem que uma linha seja escrita à mão, e um que se torna uma condição de interrupção sai daqui.
Dois limites para o que a tabela cobre, e vale a pena conhecer ambos antes de concluir que um código está faltando:
- Nem tudo nesta página é um destes. Várias das constatações explicadas abaixo são geradas por uma passagem própria e não por uma regra declarada, e algumas não carregam nenhuma condição — as linhas que imprimem continuam exatamente como descritas em suas seções, mas não há código a resolver e, portanto, nenhuma linha. O código de classe
unsupported-fieldé a forma a esperar ali: ele nomeia uma classe de constatação e não uma condição. - Uma linha aqui não promete uma seção abaixo. Um aviso gerado tarde na renderização é catalogado em vez de explicado, então um código pode resolver aqui para uma frase e ter seu tratamento mais completo em fatal-halts.md em “Condições que não interrompem um build”, que cataloga toda condição que carrega um código sem interromper um build.
sentinels.md resolve qualquer código curto que um build imprima, de aviso ou de interrupção, e é o lugar por onde começar quando você ainda não sabe de que tipo é o que tem em mãos.
| Código curto | Começa com |
|---|---|
E0004 | annotation contribution overridden by an explicit value |
E0037 | cross-boundary link between endpoints rendered by different providers is not supported |
E0149 | attachment name is a near miss for a declared slot |
E0167 | Recipe publishes a provides key its Component does not declare |
E0173 | declared parameter is read by no reference in the Aggregate |
E0174 | uses socket name is a near miss for a declared socket |
E0256 | annotation binding declares one path in both pillar lists |
E0297 | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
Schema-pillar-overlap lint (Lint de sobreposição de pilares do esquema)
Dispara quando um Component ou uma Feature declara o mesmo nome de propriedade tanto no pilar values: quanto no pilar infra: de seu bloco spec.schema: na mesma profundidade de aninhamento. Os autores de esquemas que colocam o mesmo nome de campo em ambos os pilares costumam querer colocá-lo em um ou no outro; o lint sinaliza a duplicação para que o autor possa resolver qual pilar é dono do campo.
Posição no pipeline. O lint é executado na passagem de validação após a unificação dos esquemas, antes da construção da topologia. Ele percorre o esquema após a expansão da forma compacta, sem seguir um $ref: (veja a disciplina de omissão silenciosa abaixo), e relata cada propriedade sobreposta como um aviso separado.
Formato emitido:
notice: LINT: Component "core/compute/web-server:1.0.0" at ./catalog/component/core/compute/web-server/1.0.0/component.yaml declares property "storage_size" in both values: and infra: pillars (path: storage_size)Para propriedades aninhadas, o caminho é o caminho com pontos até a propriedade a partir da raiz do pilar:
notice: LINT: Feature "core/db-pool:1.0.0" at ./catalog/feature/core/db-pool/1.0.0/feature.yaml declares property "timeout" in both values: and infra: pillars (path: connection.timeout)Um carregamento do catálogo inteiro — aggrega validate sem argumento — nomeia cada entidade por seu nome e versão e pelo arquivo de onde foi lida, como acima. Um build, ou uma validação de uma única Release, lê apenas as entidades que essa Release alcança e nomeia cada uma por nome e versão — at core/db-pool:1.0.0 — uma vez por entidade, por mais referências da Release que a alcancem: um Aggregate que nomeia uma Feature por seu nome simples e um Manifest que a mapeia por nome e versão alcançam uma única Feature, que é relatada uma vez.
Visibilidade no editor. A constatação chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, no início do arquivo e não em uma chave — ela nomeia uma entidade do catálogo e não uma posição dentro do documento que você está editando, então não há chave de autoria em que um marcador possa ficar. Ela é gerada antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor a exibe esteja serve.build_on_inspect ativado ou não.
Disciplina de omissão silenciosa. O percurso termina sem aviso quando um ramo do esquema carrega uma das vias de escape do JSON Schema 2020-12 que impedem conjuntos de propriedades deriváveis estaticamente: $ref (referências entre documentos ou dentro do documento), patternProperties (declarações de propriedades baseadas na forma da chave), additionalProperties definido como true ou como um esquema (propriedades que o ramo admite sem nomeá-las) e os operadores de composição oneOf / anyOf / allOf (disjunções e conjunções cujos ramos podem declarar conjuntos de propriedades divergentes). Percorrer esses ramos exigiria avaliar o esquema referenciado ou composto em tempo de lint (um tipo de trabalho que o lint não realiza) ou produziria falsos positivos quando o nome de uma propriedade values: de um ramo por acaso colidisse com o nome de uma propriedade infra: de outro ramo. O lint não emite nenhum aviso para a profundidade de aninhamento afetada; os níveis mais profundos do mesmo esquema continuam sendo percorridos e passíveis de lint.
Nota de autoria. O compilador não rejeita sobreposições de nomes entre pilares — o lint é um aviso. Um Component com storage_size em ambos os pilares compila; o values.storage_size do lado do desenvolvedor e o infra.storage_size do lado do operador são validados de forma independente pelos esquemas de seus pilares, e o template valuesMapping: da Recipe escolhe de qual pilar o valor flui para a saída renderizada. O lint existe porque esse padrão de autoria é quase sempre um erro; a duplicação consciente entre pilares é rara o bastante para que os autores que realmente a querem possam ignorar o aviso. Para a mecânica entre pilares de modo geral — incluindo os raros casos em que canalizar valores deliberadamente entre pilares se justifica — veja vocabulary/data-pillars.md “Mecânica entre pilares”.
Binding-map-overlap lint (Lint de sobreposição de mapas da associação)
Dispara quando uma associação de anotação do Manifest declara o mesmo caminho com pontos tanto em sua lista maps.infra quanto em sua lista maps.values. O caminho seria roteado por ambos os pilares; o critério de desempate determinístico do compilador o envia por infra:, o que deixa o lado values: inalcançável a partir do Aggregate. O lint revela isso para que o autor possa restringir a associação a um único pilar ou aceitar conscientemente o roteamento apenas pelo lado infra.
Posição no pipeline. O lint é executado depois que o Manifest é resolvido e antes que qualquer expansão de anotação dispare, então um build relata uma associação sobreposta quer uma anotação de um Aggregate chegue a essa associação, quer não. Ele percorre as associações sob mappings.features.annotations na ordem em que foram escritas, faz a interseção das listas maps.infra e maps.values de cada associação e relata uma constatação por caminho sobreposto. Dentro de uma associação, os caminhos sobrepostos são relatados na ordem em que a lista maps.values dessa associação os declara — a ordem em que você os escreveu — de modo que execuções repetidas sobre uma entrada idêntica relatam uma sequência idêntica.
Formato emitido:
lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations, "compliance.aggrega.ai/data-class", on Feature "core/pii-redaction", at path "classifier_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values") lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations.audit-scope, "audit-scope", on Feature "core/pii-redaction", at path "retention_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values")Essas duas linhas vêm de um único build sobre um único Manifest, e o que difere entre seus localizadores é a forma da chave de anotação. Um localizador endereça um documento por caminho com pontos, então ele para no primeiro segmento que contém um ponto próprio: audit-scope não contém nenhum e o localizador alcança a associação, enquanto compliance.aggrega.ai/data-class contém, e o localizador nomeia em vez disso o bloco annotations que a contém. É por isso que a chave problemática é também o primeiro valor entre aspas de toda constatação — é a única parte que o localizador nem sempre consegue carregar.
Visibilidade no editor. A constatação também chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, posicionada onde quer que seu localizador alcance — na própria associação para uma chave simples, e no bloco annotations que a envolve para uma chave que contém um ponto. Um autor que nunca lê a saída do terminal ainda assim a vê. Ela é gerada antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor a exibe esteja serve.build_on_inspect ativado ou não.
Fazer a correspondência programaticamente. A constatação carrega ErrAnnotationBindingPillarOverlap de pkg/resolver, então um consumidor reconhece a classe com errors.Is em vez de comparar o texto da mensagem. Como toda sentinela de aviso, ela nunca chega ao veredito de um build — veja sentinels.md para a função de acesso e os códigos da condição.
Critério de desempate determinístico. O runtime resolve a colisão roteando o caminho exclusivamente pelo pilar infra:. A escolha é consistente entre builds; o autor pode contar com ela. O lado values: é descartado do roteamento efetivo da associação — as anotações do lado do Aggregate que tentam alcançar o caminho não recebem nenhum destino de roteamento e o build é interrompido do lado do Aggregate no momento da expansão, com a interrupção descrita em fatal-halts.md “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 lint é a superfície de aviso antecipado; essa interrupção é a superfície que impõe a regra.
Nota de autoria. Como o lint de sobreposição de pilares do esquema, este lint é um aviso — a associação compila e o critério de desempate em tempo de execução produz uma saída determinística. O lint dispara porque esse padrão de autoria é quase sempre involuntário; um autor de associações que realmente quisesse que ambos os pilares roteassem o mesmo caminho escreveria duas associações separadas com chaves de anotação diferentes.
Attachment-slot near-miss lint (Lint de quase correspondência de slots de vinculação)
Dispara quando uma instância de componente vincula uma Feature sob um nome que não é um dos slots featuresSchema declarados de seu tipo de Component, mas está a uma edição de um deles — um único caractere inserido, excluído ou substituído, ou dois caracteres adjacentes trocados — cujo selector a Feature vinculada não satisfaz. Essa é a forma que um erro de digitação no nome de um slot assume, e o lint nomeia ambas as grafias para que o autor possa ver o par.
Por que existe. Declarar um slot não fecha a superfície de vinculação: uma vinculação sob um nome que nenhum slot declara é legal, porque é essa abertura que permite que uma mesma entidade do catálogo sirva tanto a uma vinculação que preenche um slot quanto a uma credencial compartilhada em um escopo mais amplo. O custo é que um nome de slot escrito errado passa a ser silenciosamente uma vinculação livre em vez do preenchimento do slot que o autor pretendia — o build é bem-sucedido e o slot simplesmente fica vazio. O lint é a mitigação declarada exatamente para esse caso.
Posição no pipeline. O lint é executado na resolução, na mesma passagem que as salvaguardas semânticas que levam em conta o catálogo, sobre o Aggregate resolvido. Ele compara os nomes de vinculação de cada instância de componente com os nomes de slot declarados do tipo de Component dessa instância e emite um aviso por par de quase correspondência.
Formato emitido:
lint: attachment name is a near miss for a declared slot (Aggregate nearmiss, at .spec.components.db.features.app_user_passwrod, "app_user_passwrod", on component type "core/datastore/postgres", near the declared slot "app_user_password")O primeiro valor entre aspas é o nome sob o qual a vinculação foi escrita, que é do que trata a frase inicial do aviso. Os dois seguintes são introduzidos pelas palavras que dizem o que são: o tipo de Component em que a vinculação está e o slot declarado do qual ela está a uma edição.
Visibilidade no editor. O aviso também chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, posicionado na chave de vinculação problemática. Um autor que nunca lê a saída do terminal ainda assim vê o par. Ele é gerado antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor o exibe esteja serve.build_on_inspect ativado ou não.
Limiar e sua contrapartida. O lint emparelha nomes apenas a uma edição de distância, e apenas quando ambos os nomes têm pelo menos quatro caracteres. Abaixo desse comprimento quase todo nome curto está a uma edição de qualquer outro, então emparelhá-los produziria ruído em vez de sinal; acima de uma edição os pares deixam de parecer erros de digitação. Uma transposição conta como uma edição e não duas, porque um par de caracteres trocados é o deslize mais comum e uma contagem mais rígida o deixaria passar.
Nota de autoria. O lint é um aviso e nunca muda o veredito do build — o compilador não fiscaliza como um autor nomeia uma vinculação. Um autor que vincula deliberadamente uma Feature sob um nome parecido com um slot pode ignorar o aviso; a vinculação se comporta exatamente como foi escrita.
Não onde a Feature se encaixa no slot. Um nome a uma edição de um slot cujo selector a Feature vinculada satisfaz não gera nenhum aviso. Esse emparelhamento não é uma vinculação livre digitada errado, mas um preenchimento escrito sob outro nome, e se isso importa depende de o slot acabar vazio, o que só se sabe depois que todos os escopos foram combinados. Onde o slot fica vazio, o build é interrompido e nomeia a vinculação e o slot — veja “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)” em fatal-halts.md — então a interrupção é a única constatação relatada, nunca um aviso ao lado dela. Onde outra coisa associa o slot, a vinculação é uma vinculação extra comum e nada é relatado. Nenhuma Feature se encaixa em um slot que não declara nenhum selector, então um nome próximo a um slot assim sempre gera o aviso.
Não em uma conexão. O lint lê o próprio bloco features: de um componente, que é aberto. As vinculações que uma conexão traz são indexadas pelos slots que seu socket declara e nada mais, então um nome a uma edição de um desses slots não é legal ali: em vez disso, o build é interrompido, e a interrupção nomeia na mesma frase o slot do qual o nome está próximo. Nenhum aviso é gerado ao lado dela. 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)” em fatal-halts.md.
Uses-socket near-miss lint (Lint de quase correspondência de sockets uses)
Dispara quando o próprio bloco uses: de um componente nomeia um socket que não é um dos sockets usesSchema declarados de seu tipo de Component, mas está a uma edição de um deles — um único caractere inserido, excluído ou substituído, ou dois caracteres adjacentes trocados. Essa é a forma que um erro de digitação no nome de um socket assume, e o lint nomeia ambas as grafias para que o autor possa ver o par.
Por que existe. Declarar um socket não fecha a superfície uses: no próprio componente de um desenvolvedor: um nome de socket que nenhuma entrada usesSchema declara é legal, porque o silêncio do catálogo sobre um socket significa que a conexão não foi prevista, e não que seja proibida, e o desenvolvedor é dono da topologia do Aggregate. O custo é que um nome de socket escrito errado se torna uma conexão ad hoc própria em vez de cabear o socket que o autor pretendia — o build é bem-sucedido, o socket pretendido simplesmente fica sem cabeamento e a aresta ad hoc não carrega seletor nem contrato por aresta. O lint é a mitigação declarada exatamente para esse caso. Para o que um socket ad hoc perde e o que mantém, veja entities/component.md “Sockets de topologia: usesSchema”.
Qual superfície ele cobre. Apenas o próprio bloco uses: do componente — a única superfície em que um nome de socket não declarado é aceito. O uses: de uma vinculação de Feature só pode nomear um socket que a Feature vinculada declara, e o uses: por aresta de uma Release só pode nomear um socket que o Component consumidor declara; um nome errado em qualquer uma delas já interrompe o build, então um aviso não teria nada a acrescentar.
Posição no pipeline. O lint é executado na resolução, na mesma passagem que as salvaguardas semânticas que levam em conta o catálogo, sobre o Aggregate resolvido. Ele compara os próprios nomes de socket de cada instância de componente com os nomes de socket declarados do tipo de Component dessa instância e emite um aviso por par de quase correspondência. Um componente que vem de um subagregado não é coberto: seus componentes internos são incorporados ao grafo depois que esta passagem é executada.
Formato emitido:
lint: uses socket name is a near miss for a declared socket (Aggregate aggregate, at .spec.components.web, "databses", on component type "core/devtool/adminer", near the declared socket "databases")O primeiro valor entre aspas é o nome de socket que o autor escreveu, que é do que trata a frase inicial do aviso. Os dois seguintes são introduzidos pelas palavras que dizem o que são: o tipo de Component em que o socket foi nomeado e o socket declarado do qual ele está a uma edição. A consequência que o aviso não explicita é a descrita acima: o nome escrito errado é uma conexão ad hoc, então não carrega seletor nem contrato por aresta, e o socket que o autor pretendia fica sem cabeamento.
Visibilidade no editor. O aviso também chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, posicionado no componente cujo bloco uses: contém o nome problemático. Um autor que nunca lê a saída do terminal ainda assim vê o par. Ele é gerado antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor o exibe esteja serve.build_on_inspect ativado ou não.
Limiar e sua contrapartida. O lint emparelha nomes apenas a uma edição de distância, e apenas quando ambos os nomes têm pelo menos quatro caracteres — o mesmo limite que o lint de quase correspondência de slots de vinculação usa, pelo mesmo motivo. Abaixo desse comprimento quase todo nome curto está a uma edição de qualquer outro, então emparelhá-los produziria ruído em vez de sinal; acima de uma edição os pares deixam de parecer erros de digitação. Uma transposição conta como uma edição e não duas, porque um par de caracteres trocados é o deslize mais comum e uma contagem mais rígida o deixaria passar.
Nota de autoria. O lint é um aviso e nunca muda o veredito do build — o compilador não fiscaliza como um autor nomeia um socket. Um autor que traça deliberadamente uma conexão ad hoc sob um nome parecido com um socket declarado (uma conexão cache ao lado de um socket declarado caches, destinada a outra coisa) pode ignorar o aviso; a aresta se comporta exatamente como foi escrita. Não há nenhuma flag para suprimi-lo, e nenhuma é necessária: ele não tem nenhum peso no veredito.
Undeclared-provides-key lint (Lint de chaves provides não declaradas)
Dispara quando a Recipe associada a uma instância de componente publica sob seu provides: uma chave que o tipo de Component da instância não declara em seu contrato spec.schema.provides:.
Por que existe. Publicar mais do que o Component declara é legal e continua legal: o contrato provides exige o subconjunto e permite o superconjunto, então uma Recipe que cobre o contrato de seu Component e ainda emite chaves extras é uma Recipe que o cumpre. O que o lint nomeia é uma consequência que, de outro modo, é invisível de ambos os lados. Um consumidor que lê através de uma aresta uses: vê o contrato declarado do destino, e não o que quer que a Recipe do destino emita — é isso que mantém as Recipes intercambiáveis, pois duas Recipes que realizam um mesmo Component apresentam então a mesma superfície a um consumidor, e trocá-las não pode retirar silenciosamente uma chave da qual um consumidor passou a depender. Assim, uma chave não declarada não é entregue através da aresta, e um template consumidor que a lê renderiza um valor vazio em vez de falhar.
A constatação é indicada em sua causa — na Recipe que publicou a chave — porque é ali que ela pode ser nomeada. No consumidor, a chave é uma referência de template que o compilador não consegue atribuir a um destino específico, e um diagnóstico que tentasse adivinhar seria pior do que nenhum. Por isso os dois deliberadamente não ficam no mesmo lugar: o valor vazio aparece no consumidor, a explicação aqui, e ambos aparecem na mesma saída do build.
Qual emparelhamento é comparado. As chaves provides: escritas na Recipe associada em relação às chaves spec.schema.provides: declaradas do tipo de Component. Esse conjunto declarado é o mesmo com o qual uma chave from: dentro de um bloco inject: é verificada, então os dois concordam sobre o que um Component declara. A comparação é exata, e não um teste de semelhança, então, ao contrário dos dois lints de quase correspondência acima, ela não tem limiar e não emparelha nomes.
A Recipe comparada é aquela à qual a instância está de fato associada, localizada pelo mesmo nome de instância e pelo mesmo tipo de catálogo com que a renderização a associa, então uma substituição de Recipe por instância no Manifest é respeitada em vez de se perder em uma média. Uma instância de componente cujo tipo não se resolve em nenhum Component do catálogo é ignorada: nenhuma declaração foi lida, o que não é o mesmo que uma declaração de nada.
Posição no pipeline. O lint é executado na resolução, na mesma passagem que as salvaguardas semânticas que levam em conta o catálogo, sobre o Aggregate resolvido — antes da renderização, então ele aparece tanto em aggrega validate --release quanto em aggrega build. Tanto os Components declarados na raiz do Aggregate quanto os componentes aninhados em subsistemas são cobertos. Um componente que vem de um subagregado não é coberto: seus componentes internos são incorporados ao grafo depois que esta passagem é executada, então a chave não declarada de um componente desses continua não sendo entregue aos consumidores, mas nenhum aviso a nomeia.
Formato emitido. Uma linha por instância de componente e chave, nomeando a Recipe que publicou a chave e o Component que não a declara:
lint: Recipe publishes a provides key its Component does not declare (Recipe broker-with-region, at .spec.provides.region, "region", on component type "core/ai-model/openai-compatible", bound to component instance "gateway")A constatação pertence à instância que a carrega, então dez instâncias de um mesmo tipo de Component que publicam a mesma chave não declarada geram dez linhas em vez de uma, cada uma nomeando sua própria instância. Cada linha é atribuída à Recipe que publicou a chave, porque esse é o documento que você edita para resolvê-la. O percurso é determinístico, então a mesma entrada produz a mesma sequência de avisos em cada execução.
Visibilidade no editor. O aviso também chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, posicionado na instância de componente cujo type: associa a Recipe. Um autor que nunca lê a saída do terminal ainda assim o vê. Ele é gerado antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor o exibe esteja serve.build_on_inspect ativado ou não.
Nota de autoria. O lint é um aviso e nunca muda o veredito do build — com uma Recipe que publica mais do que seu Component declara, o build ainda é concluído. A correção é uma de duas, e cabe ao autor decidir qual é a certa: declarar a chave no Component quando os consumidores devem lê-la, ou deixá-la não declarada quando ela é o estado de trabalho próprio da Recipe, caso em que locals: é o lugar desse estado. 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 interrompe o build.
Ghost Infrastructure Tracker warnings (Avisos do rastreador de Ghost Infrastructure)
Dispara quando uma chave que um autor declarou chega a um nó e nenhum template que a Recipe associada declara jamais faz referência a ela. As chaves não lidas se tornam infraestrutura silenciosa: configuração que o desenvolvedor ou o operador pediu e que a Recipe nunca conecta à saída renderizada. O rastreador as revela para que a discrepância entre o que foi escrito e o que a saída contém seja visível em vez de silenciosa.
Quais chaves escritas são comparadas. Três grupos, por nó:
.values— o pilar próprio do nó, do lado do desenvolvedor..infra— o pilar próprio do nó, do lado do operador..context.uses.<alias>.values— os valores por conexão carregados em cada arestauses:pela qual o nó consome. Esse grupo fica restrito ao consumidor sem custo adicional: o mapausesde um nó contém apenas as arestas das quais ele é a origem, então um valor por conexão não lido é sempre atribuído ao nó que o escreveu e nunca ao destino da aresta.
Quais referências são coletadas. Cada template que a Recipe associada declara. O aviso diz que uma chave não é lida por nada, o que é uma afirmação sobre a Recipe inteira, então qualquer coisa mais estreita do que a Recipe inteira a tornaria falsa em vez de aproximada — uma chave que uma coordenada source: consome seria relatada como não lida justamente pela execução que baixou a versão que ela nomeava. Os blocos lidos são:
valuesMapping:, a sobreposição de values entregue ao provedor.source:— o campo inteiro onde é escrito como uma única string, e cada um de seus campos com valor de string onde é escrito como um objeto. Uma coordenada de origem é um template avaliado por instância consumidora, então uma versão, um nome de chart, uma referência git ou um subdiretório de módulo escolhidos a partir de.valuesou.infraleem essas chaves.locals:eprovides:, cada entrada.assertions:, cada entrada.workload:, o corpo do Workload sintetizado.artifacts:, o conteúdo de cada entrada.pipeline:, a entradawith:de cada etapa e seu controlewhen:.
Daí decorrem três limites, e todos os três são limites do que se pode afirmar honestamente, não escolhas. Cada um deles silencia a leitura em vez de ampliá-la, que é a direção que custa menos: uma chave não relatada custa a um leitor um aviso que ele ainda pode encontrar lendo a Recipe, enquanto uma relatada por engano lhe diz que uma configuração que funciona foi ignorada.
- Uma Recipe sem um
valuesMapping:inline não é lida de forma alguma. Suas chaves são ignoradas em vez de relatadas, seja o que for que seus outros templates façam. - Um bloco que a Recipe importa de um arquivo ou de uma referência de biblioteca não está disponível neste ponto, então suas referências não podem ser coletadas. As chaves do nó são ignoradas por completo em vez de relatadas — isso vale igualmente para um
valuesMapping:importado, umworkload:importado e uma entradaartifacts:importada. - Um template que não pode ser analisado não produz nenhum conjunto de referências. Relatar cada chave como não lida soterraria o diagnóstico de análise que a avaliação gera sobre o mesmo template, então, em vez disso, nada é relatado. Uma entrada
artifacts:é lida com os delimitadores padrão{{ }}, que não são o par que todo provedor declara para esse campo; lido com o par errado, um corpo assim produz referências que seu autor nunca escreveu, ou não pode ser analisado, e ambos os resultados só podem silenciar um aviso.
O valueSchema de um socket nunca é sinalizado. usesSchema.<socket>.valueSchema declara o contrato que um valor por conexão deve satisfazer. É um esquema, não uma instância escrita, e não está entre as entradas comparadas — então nunca pode ser relatado. O que o valor padrão declarado de um socket produz é uma instância como qualquer outra, lida ou não lida por seus próprios méritos.
Uma referência que nomeia um pilar inteiro conta como lida cada chave abaixo dele. {{ .infra.port }} marca port como lida e deixa as outras chaves do pilar sujeitas a um aviso. {{ optional .infra `port` 8080 }} entrega o mapa .infra inteiro a uma função, então a referência coletada nomeia o pilar em vez de uma chave abaixo dele, cada chave desse pilar conta como lida e o pilar não gera nada. O mesmo vale para percorrer um pilar com range e para alcançar uma entrada de uses por meio de index. Um autor de Recipe que quer cobertura por chave escreve referências por chave.
Isso alcança todos os blocos acima, o que vale a pena saber antes que um pilar silencioso seja lido como um aviso que faltou: uma Recipe cuja versão source: é escrita como {{ optional .infra `source_version` "1.2.3" }} entregou o mapa .infra inteiro a uma função, então essa Recipe não relata nada sobre nenhuma chave .infra em nenhum nó que renderiza. O pilar .values não é afetado — os dois são contados separadamente.
Posição no pipeline. O rastreador é executado na renderização base, junto com a avaliação de templates. Cada um dos templates da Recipe é analisado e percorrido para coletar os caminhos de campo qualificados por ponto aos quais ele faz referência (.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget); o conjunto de chaves resolvido de cada grupo é comparado com a união dessas referências, e a diferença é o conjunto não lido. O que é percorrido é a Recipe tal como foi escrita: uma coordenada source: é lida como o texto do seu template, não como o valor que esse template produziu para esta instância.
Formato emitido. Uma linha por chave não lida, que nomeia o nó, o caminho do grupo, a chave e a Recipe da qual nenhum template a lê:
warning: node "data.main-db": .values key "database_name" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "data.main-db": .infra key "storage_class" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "frontend": .context.uses.my-api.values key "retry_budget" is read by no template in recipe "helm-web-ui-sourced-with-artifacts" — correct the spelling, or remove the keyA linha não nomeia nenhum campo da Recipe, e isso é deliberado: quem escreveu a chave é o desenvolvedor, o operador ou o autor da aresta uses: em que ela viaja, e nenhum deles edita a Recipe. Nomear o bloco em que a referência foi procurada daria a esse leitor uma coordenada em um documento que ele não abre. Os dois remédios que a linha oferece são os dois sobre os quais ele pode agir — uma chave escrita errado é a causa comum, e uma chave que nunca seria lida merece ser excluída.
A ordem é fixa: primeiro o .values do nó, depois seu .infra, depois cada alias de uses na ordem em que as arestas foram emitidas, com as chaves ordenadas dentro de cada grupo. A mesma entrada, portanto, produz a mesma sequência de avisos em toda execução.
Visibilidade no editor. O aviso chega aos diagnósticos do editor apenas onde o servidor de linguagem executa a etapa de renderização de artefatos enquanto inspeciona um grafo IR — aggrega serve --build-on-inspect, ou a chave de configuração serve.build_on_inspect que a flag substitui, desativada por padrão. Esse ajuste acrescenta os avisos que um build gera ao renderizar, e nenhuma das verificações em que um build é interrompido. A entrada nomeia um nó em vez de uma chave de autoria, então é exibida na chave kind: do Aggregate.
Por que um aviso e não uma interrupção fatal. Os desenvolvedores podem legitimamente consumir subconjuntos diferentes de .values em uma lógica de template condicional — uma Recipe cujo template se ramifica por .values.mode lê mode, mas lê .values.replication_password condicionalmente, apenas quando mode == "replication". O percurso estático não consegue dizer se uma chave não referenciada é indiferente ou um bug. O propósito do rastreador é tornar a discrepância visível em vez de fiscalizá-la; a omissão silenciosa é o modo de falha que o rastreador previne.
Resposta do autor da Recipe. Quando um autor de Recipe vê um aviso de Ghost Infrastructure para uma chave que esperava que a Recipe consumisse, a correção é conectar a chave ao template. Quando a chave não lida é uma omissão deliberada (uma funcionalidade que o chart não suporta, um recurso de autoria que a Recipe ignora deliberadamente), o autor pode documentar a omissão no comentário de cabeçalho da Recipe para que futuros leitores saibam que a discrepância é intencional.
Unread declared-parameter warnings (Avisos de parâmetros declarados não lidos)
Dispara quando um Aggregate declara uma entrada sob spec.parameters: e nenhuma referência {{ .parameters.<key> }} no próprio texto desse Aggregate a lê.
Um parâmetro declarado é a superfície de autoria para variar um valor por Release: a Release cumpre a declaração, e uma referência leva o valor fornecido aos valores do componente a que ele pertence. Uma declaração que nada lê deixa essa variação sem lugar onde chegar — o que quer que uma Release forneça para ela, a saída renderizada é a mesma. É a forma, no âmbito dos parâmetros, do mesmo indício de problema que uma chave de values escrita que nada consome carrega.
Um valor padrão não é uma isenção. Um valor padrão que nenhuma referência lê não chega à saída mais do que um valor fornecido por uma Release, então uma declaração com valor padrão é relatada exatamente como uma declaração sem ele.
Quais referências são coletadas. O próprio texto do Aggregate, e nada mais. Daí decorrem três consequências:
- Um parâmetro alcançado apenas pelo predicado
validate:do esquema de um Component não é visível aqui. Um predicado assim nomeia o parâmetro por meio do mapa de parâmetros resolvido, e não por meio de uma referência com pontos no Aggregate, então a declaração é relatada como não lida mesmo que o predicado a leia. - Um texto que não pode ser analisado como template não produz nenhum conjunto de referências. Relatar cada declaração como não lida soterraria o diagnóstico que a interpolação gera sobre o mesmo texto, então, em vez disso, nada é relatado.
- Uma referência que nomeia o mapa
parametersinteiro — iterando sobre ele, ou alcançando uma entrada por meio de index — conta cada declaração como lida, porque a referência coletada nomeia então o mapa em vez de uma chave abaixo dele e nenhuma afirmação por chave pode ser feita.
Posição no pipeline. A leitura é executada na resolução, sobre o texto bruto do Aggregate e seu contrato de parâmetros declarado — antes da renderização. Por isso aparece em aggrega validate tanto quanto em aggrega build.
Formato emitido. Uma linha por declaração não lida, que nomeia o Aggregate e o localizador da declaração:
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")As constatações chegam na ordem em que o Aggregate declara seus parâmetros, então o mesmo Aggregate produz a mesma sequência em toda execução. Cada uma carrega o localizador da declaração, que nomeia a chave problemática. A mensagem também nomeia a chave, e é por isso que ela aparece duas vezes em uma linha de terminal que imprime também o localizador: um editor mostra a mensagem na posição em que a colocou e nunca o texto do localizador, então uma mensagem que omitisse a chave seria lida de forma idêntica para toda declaração não lida.
Visibilidade no editor. O aviso também chega aos diagnósticos do editor pelo servidor de linguagem, com severidade de aviso, posicionado na declaração que seu localizador nomeia, e não no Aggregate como um todo. Ele é gerado antes da etapa de renderização de artefatos, então não precisa de nenhum ajuste: uma sessão do editor o exibe esteja serve.build_on_inspect ativado ou não.
Por que um aviso e não uma interrupção fatal. Um parâmetro pode ser declarado antes da referência que o lerá, e um percurso estático não consegue distinguir isso de um erro — o mesmo motivo pelo qual a leitura das chaves escritas sempre apenas avisa. O compilador não fiscaliza quais ajustes um autor expõe.
Provider-binding unserved-capability warning (Aviso de capacidade não servida de uma associação de provedor)
Dispara quando uma entrada sob plugins.providers na configuração do espaço de trabalho nomeia uma capability e nenhum uri, e nenhum dos plugins de provedor que o build lê serve essa capacidade. Os plugins que um build lê são os dos seus diretórios do catálogo, os provedores dentro do compilador e os plugins que seu arquivo de bloqueio registra.
Por que existe. Uma associação só é lida quando o capability: de uma Recipe pede sua capacidade, e uma entrada que não nomeia nenhum plugin não seleciona nada que a resolução da capacidade não selecionaria sem ela. Então uma entrada cuja capacidade está escrita errado — hlem em vez de helm — não é consultada por nada e não muda nada, e sem este aviso nada diria isso.
Por que um aviso e não uma interrupção fatal. As associações são escritas uma vez para todo o espaço de trabalho, enquanto um build é de uma única Release. O plugin que serve a capacidade pode ser um que só outra Release do espaço de trabalho lê, e este build não consegue vê-lo, então uma interrupção aqui recusaria um espaço de trabalho legal com base em um palpite. Uma entrada que também nomeia um plugin é um caso diferente: um pull resolve cada entrada desse tipo, quer uma Recipe a use, quer não, então o build tem o plugin e sabe o que ele serve, e uma capacidade que esse plugin não serve causa uma interrupção — veja fatal-halts.md “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)”. Uma entrada para uma capacidade que algum plugin lido pelo build de fato serve não gera relato algum, quer uma Recipe desta Release a use, quer não.
Posição no pipeline. Todo build e toda validação de uma Release lê cada entrada da configuração composta do espaço de trabalho — as camadas e seus complementos providers_append juntos — antes que o grafo da Release seja analisado, então o aviso aparece em aggrega validate --release tanto quanto em aggrega build, e em aggrega pull, que renderiza a Release uma vez, sobre o arquivo de bloqueio que está prestes a escrever, para descobrir as entradas externas que um build dela baixa. O julgamento não muda nada sobre qual plugin renderiza uma Recipe; isso é lido do arquivo de bloqueio.
Formato emitido. Uma linha por entrada, na ordem em que a lista composta as traz, que nomeia a capacidade e uma capacidade servida a uma edição de distância, onde houver uma:
warning: plugins.providers entry names a capability no provider-rendering plugin the build reads serves: capability "hlem", which is one edit from "helm"; the entry names no plugin, so it selects nothing a Recipe would not resolve without it, and none of the plugins this build reads — in the catalog directories, inside the compiler, or among those the lockfile records — serves the capability: correct its spelling, or keep it where the plugin serving it is one only another Release readsLimiar. Uma grafia só é oferecida a uma edição de distância e apenas quando ambos os nomes têm pelo menos quatro caracteres, o mesmo limite que os lints de quase correspondência acima usam, e pelo mesmo motivo.
Visibilidade no editor. O aviso chega aos diagnósticos do editor pelo servidor de linguagem com severidade de aviso. A entrada fica no arquivo de configuração, e não no documento que está sendo editado, então é posicionada no início desse documento em vez de em uma chave.
Cobertura de metadados por entidade
Quais envelopes de entidade carregam metadata.labels e metadata.annotations varia conforme o tipo. Component, Feature e os tipos de biblioteca carregam ambas; Aggregate carrega apenas rótulos; Recipe, FeatureRecipe, Manifest, Release e Plugin não aceitam nenhuma das duas chaves no nível do envelope. Status da linguagem registra a situação de cada entidade e é a superfície a consultar.
Visibilidade no editor. Nenhum aviso cobre isso, em nenhuma configuração: não há nada a relatar, porque uma entidade ou carrega essas chaves ou não as aceita, e uma chave que um tipo não aceita é uma questão que seu esquema responde quando o documento é carregado, e não algo que a etapa de renderização relata depois. Um autor consulta a página de status em vez de esperar um aviso.
Unsupported-field warnings (Avisos de campo não suportado)
Uma única classe cobre tudo o que você escreveu e que o destino não consegue atender. Ela tem dois membros — um campo do Workload que o destino não consegue expressar, e uma anotação aggrega.ai/ sobre a qual o destino não age — e eles compartilham um único código de classe e uma única flag de supressão, porque um autor que quer silenciar “as coisas que este destino ignora” quer silenciá-las juntas, e não um interruptor de cada vez.
A Workload field the target cannot express (Um campo do Workload que o destino não consegue expressar)
Os destinos diferem em fidelidade. Um campo do Workload que um destino expressa nativamente pode não ter equivalente em outro — o Docker Compose não tem noção de restrição de agendamento, de conta de serviço ou de classe de prioridade, por exemplo. Quando um Workload declara um campo assim e o destino não consegue expressá-lo, o campo é omitido com um aviso, um aviso por campo escrito. Ele não é descartado silenciosamente nem tratado como erro fatal.
A diferença em relação a uma interrupção fatal é a granularidade. Uma forma não suportada interrompe o build de forma ruidosa — o destino não consegue produzir de modo algum essa forma de carga de trabalho. Uma forma suportada que carrega um campo inexprimível é renderizada, sem esse campo, e diz isso.
No destino compose, a classe cobre atualmente scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, o runAsNonRoot de um contêiner e toda chave de recurso estendido exceto nvidia.com/gpu — amd.com/gpu, por exemplo — já que essa é reservada para GPUs NVIDIA. Os casos abaixo emitem uma variante parcial da mesma classe, em que o campo é reduzido em vez de removido:
persistentTemplate— a geração de volumes por réplica a partir de um template não está disponível, então o volume se reduz a um único volume persistente compartilhado em vez de desaparecer.- Uma entrada
attachmentsde um contêiner comas: env— o compose não consegue obter uma variável de ambiente a partir de uma vinculação, então a variável é emitida com um valor vazio. O aviso nomeia a entrada em sua coordenada escrita (containers.<name>.attachments.<KEY>, ouinitContainers[<i>].attachments.<KEY>para uma entrada init posicional), de modo que fica claro qual variável chega vazia e a qual contêiner ela pertence. Uma entrada comas: fileé montada normalmente via bind mount e não gera nada. - Uma entrada
volumesque nenhum contêiner monta — o aviso nomeia o volume em sua coordenada escrita (volumes.<name>). O que chega à saída depende da variante: um volumepersistentoupersistentTemplateainda é declarado como volume nomeado, que então é criado e deixado sem uso, enquanto um volumeconfigmap,secretouephemeralchega à saída apenas pelo ponto de montagem de um contêiner, então, sem nada que o monte, a declaração não produz saída alguma. De qualquer forma, o volume que você escreveu não está fazendo nada: monte-o a partir de um contêiner, ou remova-o. Todo contêiner da carga de trabalho conta como montador, incluindo os contêineres de inicialização, então um volume montado apenas por um contêiner de inicialização não gera nada. - Um bloco
healthque declara mais de um slot de sonda — um serviço compose carrega um únicohealthcheck, então a ordem de prioridadelive > ready > startupmantém um slot e todos os outros slots declarados não chegam a nenhuma parte da saída. O aviso nomeia o bloco em sua coordenada escrita (containers.<name>.health, ouinitContainers[<i>].healthpara uma entrada init posicional) e nomeia tanto o slot que foi traduzido quanto os slots que foram descartados, de modo que fica claro qual sonda está ativa na saída e qual intenção escrita está inerte. Um bloco que declara um único slot é traduzido sem perda e não gera nada. hostNetworkem uma carga de trabalho que também declarainitContainers— o serviço próprio da carga de trabalho é executado na rede do nó, mas cada contêiner de inicialização se torna um serviço próprio que entra na rede da fronteira por conta própria, porque compartilhar o namespace do serviço principal tornaria circular a espera do serviço principal por ele. Isso é mais estreito do que a forma de pod que está sendo modelada, em que todo contêiner compartilha um único namespace, então a diferença é nomeada em vez de ficar para ser descoberta em tempo de execução. Uma carga de trabalho que declarahostNetworksem contêineres de inicialização é traduzida sem perda e não gera nada.
An annotation the target does not act on (Uma anotação sobre a qual o destino não age)
As anotações aggrega.ai/ são diretivas de plataforma que um provedor lê e aplica ao que renderiza — um namespace, um prefixo de registry, uma conta de serviço. Quais delas um provedor lê é uma declaração própria desse provedor, feita por tipo de entrada, porque um provedor que é dono de cada campo de uma unidade de implantação que ele mesmo sintetiza muitas vezes não tem onde colocar o mesmo valor quando renderiza um artefato vendorizado. Anotações bem conhecidas é a matriz.
A Recipe própria de um nó e cada funcionalidade vinculada a esse nó são renderizadas separadamente, cada uma pelo destino que seu próprio capability: nomeia e nos tipos de entrada que seus próprios source:, workload: e artifacts: declaram. Quando uma anotação desse tipo chega a uma dessas renderizações e a declaração do destino resolvido não cobre a chave em nenhum dos tipos de entrada que essa renderização declara, o destino não aplica nada para essa chave, e o build informa isso com um aviso que nomeia a chave, o destino e cada tipo de entrada que essa renderização declara:
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored itEstas consequências decorrem de como as anotações chegam a uma renderização, e cada uma delas é deliberada:
- Uma única linha escrita pode produzir vários avisos. Uma anotação de fronteira se propaga em cascata a cada componente abaixo dela, e esses componentes podem ser renderizados por destinos diferentes e tipos de entrada diferentes. Cada aviso é uma afirmação verdadeira sobre uma única renderização, então você recebe um por renderização que não consegue agir sobre a chave — e é também isso que lhe diz quais partes da sua saída são afetadas.
- Uma funcionalidade vinculada a um nó é julgada pela sua própria FeatureRecipe, não pela Recipe do nó. Uma vinculação que gera recursos próprios os renderiza pelo destino que sua FeatureRecipe nomeia, nos tipos de entrada que essa FeatureRecipe declara — então uma anotação que o destino próprio do nó aplica pode não chegar a nada nos arquivos da vinculação, e o inverso também vale. Você é informado de cada uma de forma independente, porque são arquivos diferentes. O mesmo vale para uma funcionalidade vinculada a uma fronteira em vez de a um componente nomeado. Uma vinculação cuja FeatureRecipe não declara nenhum de
source:,workload:eartifacts:não renderiza arquivos próprios — ela contribui injetando valores, pela arestausesque sua Feature carrega, ou por um pipeline sobre documentos que outra coisa emitiu — então não há nenhuma saída própria da qual uma anotação possa estar ausente, e nada é avisado sobre ela. - Uma renderização que declara mais de um tipo de entrada é julgada por todos eles. Seus tipos declarados se compõem por adição e suas saídas são somadas, então um destino que lê a chave em qualquer um deles a aplica e o valor aparece na saída renderizada. Nada é avisado nesse caso, porque não há nada a relatar. Um aviso aparece apenas quando todos os tipos declarados deixam de ler a chave, e ele nomeia todos —
on sourced or synthesized input. - Apenas as chaves
aggrega.ai/sem subprefixo são verificadas. Uma chave com subprefixo —compliance.aggrega.ai/data-class, ou a sua própriaacme.aggrega.ai/team— é o seu vocabulário, que o compilador transporta sem interpretar. Nada avisa jamais sobre uma chave assim. - Um destino que não declara nenhuma afirmação de suporte não gera nada. O aviso compara o que você escreveu com o que o provedor disse que lê; um provedor que não disse nada não lhe dá nada com que comparar, e inferir uma recusa a partir do silêncio relataria uma afirmação que o autor do provedor nunca fez. Um provedor que não lê nenhuma das chaves diz isso com
readsNoWellKnownAnnotations: true, como fazterraform, e cada chave sem subprefixo que chega a uma de suas renderizações passa então a gerar um aviso.
Por que um aviso e não uma interrupção. Uma fronteira que legitimamente abrange componentes em destinos heterogêneos sempre terá algum nó que não consegue agir sobre uma dada chave — essa é a forma normal de uma Release que abrange vários destinos, não um erro — então recusar o build rejeitaria Releases corretas. O valor passa intacto, e o aviso lhe diz isso.
O código de classe e a garantia fora de banda
Cada aviso carrega o código de classe estável e comparável por máquina unsupported-field, para que as ferramentas possam fazer a correspondência com a classe em vez de analisar o texto da mensagem. Cada membro da classe — o campo omitido por completo, o campo em forma reduzida e a anotação sobre a qual não se age — carrega esse único código, e é isso que permite que um único filtro suprima a classe inteira. Os avisos trafegam fora de banda em relação aos artefatos renderizados, o que significa que os bytes renderizados são idênticos byte a byte, apareçam os avisos ou não — suprimi-los não pode alterar a sua saída.
Visibilidade no editor. Cada membro da classe chega aos diagnósticos do editor apenas onde o servidor de linguagem executa a etapa de renderização de artefatos enquanto inspeciona um grafo IR — aggrega serve --build-on-inspect, ou a chave de configuração serve.build_on_inspect que a flag substitui, desativada por padrão. Esse ajuste acrescenta os avisos que um build gera ao renderizar, e nenhuma das verificações em que um build é interrompido. O código de classe acima trafega no diagnóstico publicado tal como na linha do terminal, então um cliente do editor faz a correspondência com a mesma classe que um autor lê. Cada entrada nomeia um nó e um destino em vez de uma chave de autoria, então é exibida na chave kind: do Aggregate.
Suprimindo a classe
Os dois comandos que renderizam aceitam --no-unsupported-field-warnings, que silencia apenas esta classe enquanto todos os outros avisos de renderização continuam aparecendo:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warningsA flag afeta apenas a exibição e não altera a saída renderizada. aggrega lint não tem uma flag equivalente porque não executa nenhuma passagem de renderização — ele verifica apenas convenções de publicação, então nenhum aviso de renderização pode surgir ali.
Recorra à flag quando você tiver aceitado deliberadamente a fidelidade reduzida — um destino compose usado para desenvolvimento local, onde se espera que os campos de agendamento e de conta de serviço do Workload de produção sejam inertes. Caso contrário, deixe-a desativada: o aviso é a forma como você descobre que um campo que escreveu não está chegando ao destino.
A declared-sensitive value travels as a literal (Um valor declarado sensível trafega como literal)
Dispara quando uma vinculação preenche um slot entregando um dado que seu esquema declara sensível em uma chave de entrega como valor literal, em vez de como uma referência que o destino resolve ao implantar.
Formato emitido. Uma linha por chave de entrega, que nomeia a instância da vinculação, o mecanismo de entrega em que a chave vai parar e a própria chave, atribuída ao nó e ao destino que a renderizaram:
warning: node "db" (provider "compose"): attachment "user_password" delivers a value declared sensitive to env delivery key "MARIADB_PASSWORD" as a literal; where the target supports it, fill the slot with an attachment that delivers a reference insteadO código de classe. O aviso carrega o código de classe estável e comparável por máquina sensitive-by-value, para que as ferramentas façam a correspondência com a classe em vez de analisar o texto da mensagem. O código trafega na linha do terminal e no diagnóstico estruturado que o servidor de linguagem publica, então um autor e um cliente do editor leem a mesma classe — sob a condição de visibilidade no editor descrita abaixo, que determina se o servidor de linguagem publica ou não este aviso.
Visibilidade no editor. O aviso chega aos diagnósticos do editor apenas onde o servidor de linguagem executa a etapa de renderização de artefatos enquanto inspeciona um grafo IR — aggrega serve --build-on-inspect, ou a chave de configuração serve.build_on_inspect que a flag substitui, desativada por padrão. Esse ajuste acrescenta os avisos que um build gera ao renderizar, e nenhuma das verificações em que um build é interrompido. A entrada nomeia um nó e um destino em vez de uma chave de autoria, então é exibida na chave kind: do Aggregate.
É uma classe própria, e --no-unsupported-field-warnings não a cobre. Essa flag silencia a classe de campo não suportado descrita acima; este aviso continua aparecendo ao lado dela. Não há nenhuma flag que silencie este.
O build é bem-sucedido e os bytes renderizados não mudam. O aviso trafega fora de banda em relação aos artefatos renderizados, como faz a classe de campo não suportado, então o que chega à sua saída é o mesmo, apareça a linha ou não.
A declared-sensitive value reaches the target through a values mapping (Um valor declarado sensível chega ao destino por meio de um mapeamento de values)
Dispara quando uma renderização a partir de um source: entrega ao seu destino a saída de um valuesMapping: enquanto a entidade cujos values esse mapeamento lê declara sensível uma folha de values: o mapeamento de uma Recipe sobre uma folha que seu Component declara, ou o mapeamento da FeatureRecipe de uma Feature vinculada a um componente sobre uma folha que essa Feature declara. Um mapeamento é um único template cujas chaves de saída são invenção dele mesmo, então nenhuma declaração nomeia qualquer uma delas, e o destino não recebe nenhuma marcação de sensibilidade por chave para a folha. É a única forma de renderização em que uma declaração não chega a nenhuma chave renderizada enquanto o autor ainda tem uma alavanca sobre ela.
Formato emitido. Uma linha por folha declarada, que nomeia a folha em sua coordenada escrita e a Recipe ou FeatureRecipe cujo mapeamento condiciona a junção, atribuída ao nó e ao destino que a renderizaram. A linha de uma Feature vinculada começa com o nome sob o qual ela está vinculada, porque um componente pode carregar várias vinculações de uma mesma Feature e suas linhas seriam, de outro modo, idênticas — a segunda linha abaixo é uma Feature vinculada ao componente api como token:
warning: node "api" (provider "terraform"): "values.token" is declared sensitive, but recipe "terraform/api" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a recipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them warning: node "api" (provider "terraform"): attachment "token": "values.token" is declared sensitive, but FeatureRecipe "terraform/api-token" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a FeatureRecipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with themQual é a alavanca. Sem um mapeamento, os valores que uma renderização a partir de uma origem recebe são indexados pelos próprios caminhos das folhas declaradas, então a declaração se une exatamente à sua chave renderizada e a marcação trafega com ela — no destino Terraform, esse é o arquivo de substituição gerado descrito em Entradas de módulo declaradas sensíveis. Com um mapeamento, a marcação que de fato chega cobre a saída do mapeamento como um todo, e apenas onde o mapeamento lê o valor declarado: ela rege o texto que um plugin compõe quando recusa ou avisa, e não altera nenhum byte renderizado.
Três formas permanecem em silêncio, e deliberadamente. Uma renderização apenas de artefatos e uma renderização apenas de carga de trabalho não entregam ao seu destino nenhum mapa de valores, então uma folha de values não tem ali nenhuma chave renderizada a marcar, seja como for escrita. Uma Feature vinculada a uma fronteira também não gera aviso, seja o que for que sua FeatureRecipe mapeie: uma fronteira não carrega nenhum bloco values:, então uma vinculação desse tipo é renderizada contra um pilar values vazio, nenhuma das folhas de values da sua Feature pode carregar ali um dado, e remover o mapeamento não marcaria nada. Cada uma é uma propriedade permanente da forma, e não algo que um autor possa mudar, então um aviso sobre ela dispararia em todo build e não indicaria nada a fazer; o teto é ensinado, em vez disso, em Declarar uma folha sensível. Uma renderização a partir de um source: sem valuesMapping: também é silenciosa, porque ali a marcação chega.
O código de classe. O aviso carrega o código de classe estável e comparável por máquina sensitivity-not-conveyed, para que as ferramentas façam a correspondência com a classe em vez de analisar o texto da mensagem: a ferramenta build do assistente lista cada constatação sob advisories com ele. Ele nomeia uma classe de constatação, e não uma condição registrada, então não tem linha na tabela no topo desta página.
Visibilidade no editor. O aviso chega aos diagnósticos do editor, com severidade de aviso e carregando a mesma linha que um build imprime no terminal, sempre que o servidor de linguagem renderiza a Release — um build ou uma prévia de build que lhe é pedida, ou uma inspeção do grafo IR com aggrega serve --build-on-inspect, ou a chave de configuração serve.build_on_inspect que a flag substitui, desativada por padrão. A entrada nomeia um nó e um destino em vez de uma chave de autoria, então é exibida na chave kind: do Aggregate.
É uma classe própria, e --no-unsupported-field-warnings não a cobre. Essa flag silencia os avisos de fidelidade de um destino, um julgamento diferente feito por razões diferentes; este aviso continua aparecendo ao lado dela. Não há nenhuma flag que silencie este.
O build é bem-sucedido e os bytes renderizados não mudam. O aviso relata uma ausência — nenhuma chave renderizada carrega a marcação — e um mapeamento é uma forma comum e suportada, então não há nada por que interromper e nada na sua saída se move, apareça a linha ou não.
A Terraform module call the engine fetches when it initialises (Uma chamada de módulo Terraform que o motor baixa ao inicializar)
Dispara quando um módulo Terraform que o build vendoriza, ou o corpo Terraform escrito de uma Recipe, declara um bloco module cujo source o Terraform baixa quando a configuração é inicializada, em vez de lê-lo dos arquivos que o build colocou: um endereço de registry, uma URL de git, Mercurial ou de arquivo compactado HTTP, um bucket S3 ou GCS, ou um caminho absoluto — ou um caminho local que sai do módulo vendorizado, e que nomeia arquivos que o build não vendorizou. O bloqueio fixa o commit e o digest do arquivo compactado do módulo vendorizado, e o próprio arquivo de bloqueio de dependências do Terraform registra apenas provedores, então o módulo que tal chamada nomeia é baixado na versão que o motor selecionar nesse momento e nada que este build registra o cobre.
O que é lido. Os arquivos de configuração que o motor carrega quando o módulo é chamado — os que estão diretamente no diretório próprio do módulo e em cada diretório que um source local alcança a partir dali — e nada em um diretório que nada chama, então uma chamada escrita no diretório examples/ ou tests/ de um módulo não é relatada. É lido o que um source diz, e nunca o módulo que essa origem nomeia. Um arquivo sob spec.boundary.artifacts de uma Recipe é avaliado e escrito pelo próprio compilador e não é entregue a nenhum provedor, então um bloco module escrito nele não é lido e não gera aviso. Validação estrutural da entrada, na página do provedor, enuncia a regra por completo.
Formato emitido. Uma linha por chamada, que nomeia o nó e o provedor, depois o bloco, o arquivo e a linha em que ele está, e a origem como foi escrita; uma origem que sai do módulo diz isso em vez de nomear um download:
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module warning: node "app" (provider "terraform"): module "shared" (main.tf, line 2) has the local source "../shared", which resolves outside the module this build placed, so Terraform reads whatever sits at that path when the configuration is initialised rather than files this build vendoredAs chamadas chegam na ordem em que o motor as alcança — primeiro o diretório próprio do módulo, depois cada diretório na ordem em que uma origem local o alcança pela primeira vez, e dentro de um arquivo na ordem em que seus blocos estão escritos — então a mesma entrada produz a mesma sequência em toda execução. Toda execução que renderiza as gera: aggrega build; aggrega pull, que renderiza a Release uma vez para descobrir o que um build dela baixa; e aggrega validate sobre uma Recipe cujo módulo o espaço de trabalho contém, que renderiza essa Recipe isoladamente.
O código de classe. Cada aviso carrega o código de classe estável e comparável por máquina module-fetched-at-init, para que as ferramentas façam a correspondência com a classe em vez de analisar o texto da mensagem. O código trafega no diagnóstico estruturado: a ferramenta build do assistente lista cada constatação sob advisories com ele, e o servidor de linguagem o publica em cada entrada. Ele nomeia uma classe de constatação, e não uma condição registrada, então não tem linha na tabela no topo desta página.
Visibilidade no editor. O aviso chega aos diagnósticos do editor na camada aggrega-build, com severidade de aviso, sempre que o servidor de linguagem renderiza a Release — um build ou uma prévia de build que lhe é pedida, ou uma inspeção do grafo IR com aggrega serve --build-on-inspect, ou a chave de configuração serve.build_on_inspect que a flag substitui, desativada por padrão. A entrada nomeia um nó em vez de uma chave de autoria, então é exibida na chave kind: do Aggregate.
É uma classe própria, e nenhuma flag a silencia. --no-unsupported-field-warnings silencia a classe de campo não suportado e não cobre esta.
O build é bem-sucedido e os bytes renderizados não mudam. O aviso trafega fora de banda em relação aos artefatos renderizados, então o módulo vendorizado, o corpo escrito e a configuração raiz são idênticos byte a byte, apareça ele ou não.
Por que um aviso e não uma interrupção. Um módulo que chama outro módulo é uma entrada legítima: o Terraform baixa o módulo chamado e a configuração funciona. Aquilo de que o autor abre mão é a fixação que o build mantém sobre esse módulo, o que é um fato a relatar, e não uma falha a recusar, e se o download é aceitável é decisão do autor.
A plugin ran with no recorded digest to check it against (Um plugin foi executado sem nenhum digest registrado com o qual verificá-lo)
Dispara quando o compilador está prestes a executar um plugin, um digest registrado deveria governar os bytes desse plugin e o espaço de trabalho não registra nenhum para ele. O plugin é executado; o aviso é a forma como você fica sabendo que nada comparou os bytes executados com os bytes que alguém revisou.
aggrega pull grava o digest de cada plugin que adquire no arquivo de bloqueio da Release, e cada resolução posterior compara os bytes que encontra com esse digest. Um espaço de trabalho em que ainda não foi feito pull, ou cujo arquivo de bloqueio é anterior a um plugin que a configuração vinculou desde então, não tem digest para esse plugin — então a comparação não tem com o que comparar, e sem esta linha ela passaria em silêncio.
Uma etapa do pipeline, um provedor ou um plugin vinculado a um papel de veredito cuja entidade Plugin é escrita em um dos seus diretórios do catálogo também não tem digest, e um pull não lhe dá um: o pull nunca fixa uma entidade assim, e um build lê o .wasm dela de novo toda vez — de junto da entidade, no caso comum — em vez de compará-lo com algo que um pull tenha registrado. Um plugin vinculado a um papel de transformação e escrito ali é a exceção: seus bytes moldam a saída renderizada, então um pull registra o digest do .wasm que encontra para ele, e, uma vez feito isso, um build verifica esse plugin com o digest e esta linha não é emitida para ele.
warning: plugin "governance/label-injector:1.0.0" resolved from cache with no recorded digest to check it against, so it runs unverified; run `aggrega pull --release <release>` to record it warning: plugin "pipeline-step/patch" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recordedEssa é a linha que um build, um pull ou uma validação mostra entre seus outros avisos. Um comando que resolve um plugin fora de uma execução assim — ao instalar, listar ou executar os plugins de linha de comando do próprio espaço de trabalho, ou aggrega lint ao resolver os plugins com que faz o lint — imprime a mesma frase em uma linha própria, sem recuo.
A linha nomeia a fonte de onde vieram os bytes — a mesma palavra que aggrega pull e aggrega plugin list usam para ela — e termina com o que vale para essa fonte. Para bytes do cache de conteúdo, a correção é fazer pull da Release, o que registra o digest e torna verificada cada execução posterior desse plugin. Para bytes lidos de junto de uma entidade Plugin em um diretório do catálogo, um pull registra o digest apenas para um plugin vinculado a um papel de transformação, e a linha diz isso: para qualquer outro plugin escrito ali, nenhum pull muda isso, e a forma de colocá-lo sob um digest registrado é publicá-lo e referenciar a entidade publicada.
Ele é mostrado uma vez por plugin em cada comando, não importa quantas vezes o comando resolva esse plugin. Uma renderização resolve seu provedor uma vez por nó, e um build que preenche seu próprio arquivo de bloqueio pode renderizar a Release mais de uma vez; repetir a linha a cada vez a soterraria. O serviço do editor a mostra em seu próprio fluxo de erro uma única vez enquanto estiver em execução, enquanto cada requisição que ele responde a relata ao editor de novo — assim, qualquer resposta da qual o editor se sirva informa você sobre os plugins que aquela execução usou sem verificação.
Visibilidade no editor. O aviso chega aos diagnósticos do editor junto com os outros avisos da execução, com severidade de aviso: uma validação de uma Release o publica no Aggregate da Release, e um build ou uma pré-visualização de build que o editor solicita o publica na camada aggrega-build. Ele nomeia um plugin em vez de uma chave que você escreveu, então é posicionado no início do arquivo. Como cada execução relata o que resolveu, a entrada permanece enquanto uma execução resolver o plugin sem verificação e desaparece com a primeira execução que não o fizer. Ele não muda nenhum veredito nem faz falhar nenhuma resolução, então o que uma sessão responde é o mesmo, seja ele mostrado ou não.
Duas resoluções não geram nada, e nenhuma delas é um descuido:
- Um plugin que o compilador carrega dentro de si.
aggrega pullregistra o que baixou, e não há nada para baixar para bytes que vêm no binário — então nenhum digest é registrado para um deles, e não haveria nada que você pudesse executar para mudar isso. O binário é a identidade desses bytes. Os plugins próprios do compilador e suas versões são listados poraggrega plugin liste gravados na seçãotoolchaindo arquivo de bloqueio. - Uma resolução à qual nenhum digest jamais se destinou.
aggrega validate --plugin ./some.wasmaponta para um arquivo que você nomeou na linha de comando, eaggrega lintinspeciona o próprio artefato que está verificando; em ambos os casos, o plugin é o objeto do exame e não uma ferramenta em que se confia, então não há registro algum ao qual ele possa ser submetido.
Por que um aviso e não uma interrupção. Ler um documento vale a pena em um espaço de trabalho que ninguém preparou ainda — recusar-se a validar ou a fazer o lint até que alguém execute aggrega pull tornaria os comandos de relato inutilizáveis exatamente no momento em que são mais úteis. aggrega build não produz artefatos sem nenhum arquivo de bloqueio, então o build só encontra este aviso para um plugin para o qual seu arquivo de bloqueio não registra digest — o caso comum é um lido de junto da sua entidade em um diretório do catálogo.
Onde a falta de um arquivo de bloqueio causa, em vez disso, uma recusa. Quando um editor pede ao serviço do compilador o grafo de uma Release e o espaço de trabalho não tem nenhum arquivo de bloqueio, o serviço para e pede um em vez de desenhar um grafo. Um arquivo de bloqueio que existe e simplesmente não registra digest para um plugin é, em vez disso, o caso acima: o plugin é executado, e este aviso é a forma como você fica sabendo. Um grafo desenhado é aquilo sobre o que um leitor raciocina depois, e um construído a partir de bytes não verificados pareceria exatamente igual a um verificado. Veja aggrega serve.
A published archive carries an entry Windows cannot use (Um arquivo compactado publicado traz uma entrada que o Windows não consegue usar)
Dispara quando aggrega push — ou seu --dry-run — publica um arquivo compactado em que uma das entradas contém uma parte que o Windows não consegue conter da forma como está escrita: um nome que o Windows reserva para um dispositivo, como CON, PRN, AUX, NUL, COM1 ou LPT1, em qualquer combinação de maiúsculas e minúsculas e com qualquer extensão que venha depois, ou uma parte que termina em um ponto final ou em um espaço. aux/x.yaml contém uma em seu diretório; report. e COM1.yaml contêm uma em seu nome de arquivo. No Windows, aggrega se recusa a extrair uma entrada assim, então um espaço de trabalho no Windows não consegue usar a versão de forma alguma. O aviso dispara em todas as plataformas, porque uma publicação é para quem quer que faça pull dela, e é a forma como seu autor fica sabendo disso antes que alguém no Windows fique.
O que lê. Os nomes que o arquivo compactado conterá: o próprio nome de arquivo do documento da entidade e, depois, cada arquivo que a entidade nomeia ao lado dele — os arquivos que Empacotamento lista. Assim, um documento chamado con.yaml que importa um arquivo de esquema provoca o aviso pelo próprio nome. Uma entidade que não nomeia nada é publicada apenas como seu documento, que um consumidor dispõe sob um nome escolhido pelo produto, e não sob o que você escreveu, então nunca recebe aviso, seja qual for o nome do seu arquivo. Um Plugin não publica arquivo compactado e também nunca recebe aviso.
Formato emitido. Uma linha por entrada, na saída de erro padrão, na ordem em que os nomes são compostos — primeiro o documento, depois os arquivos que ele carrega em ordem léxica — antes do relato próprio da execução de teste ou da publicação na saída padrão:
warning: an entry this publication carries cannot be used on Windows (the entry "aux/x.yaml", its segment "aux"). 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, so a workspace on Windows refuses to unpack the entry. This warning does not stop the publication; rename that segment to publish a version Windows can useO primeiro valor entre aspas é a entrada como o arquivo compactado a nomeia. O segundo é o primeiro dos seus segmentos — as partes que suas barras separam — que o Windows não consegue conter, que é a parte a renomear. A linha começa com a frase fixa da condição. Ela é emitida pela publicação e não por uma regra que um build avalia, então não tem linha na tabela no topo desta página; a tabela de todas as condições a lista sob E0344.
Ele não recusa nada. O push, ou sua execução de teste, prossegue ou é recusado exatamente como seria sem o aviso, e termina como teria terminado.
Aonde mais ele chega. A ferramenta publish-entity do assistente responde com as mesmas entradas como windows_unusable_entries, e aggrega serve responde a aggrega/publishEntity com elas como windowsUnusableEntries; cada um está ausente quando não há nenhuma. Veja aggrega mcp e aggrega serve. O serviço também repassa a própria linha de aviso a uma requisição que pediu para receber relatos, junto com o restante do relato da publicação.
Visibilidade no editor. Nenhuma como diagnóstico: publicar não é um build, então nada aqui chega a uma lista de problemas. Um editor que publica pelo serviço lê windowsUnusableEntries na resposta.
Por que um aviso e não uma interrupção. Um nome assim é legal, e o Linux e o macOS usam o arquivo com o nome que ele tem, então recusar a publicação recusaria uma entidade que funciona com base em um palpite sobre quem fará pull dela. Renomear ou não é decisão do autor.