Avisos e saída do linter
Avisos não fatais que o compilador emite durante a compilação. Os avisos não interrompem a compilação — revelam indícios de problemas de autoria, critérios de desempate determinísticos escolhidos pelo compilador e recursos que os templates do programador nunca consumiram. Cada constatação chega ao stderr precedida de um prefixo que nomeia o seu tipo — warning:, lint: ou notice:, consoante a passagem que a levantou — para que os pipelines de CI as possam capturar e voltar a apresentar; os artefactos renderizados são produzidos de qualquer forma.
Para as interrupções fatais da compilação (os diagnósticos que param uma compilação), ver fatal-halts.md.
Cada aviso, por código curto
Parte daquilo que o compilador comunica sem interromper é uma condição própria: tem 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 a sua mensagem abre. A tabela abaixo faz a consulta de um para o outro, de modo que um código que se tenha em mãos se resolve naquilo de que trata a constatação, mesmo quando a linha que se está a ler é um aviso e não uma interrupção.
O que ganha aqui um lugar é uma declaração, não uma descrição. Cada regra que o compilador avalia declara o que uma violação faz — interromper a compilação, ou comunicar a constatação e deixar a compilação terminar — e as linhas abaixo são do segundo tipo. Assim, um aviso acrescentado ao compilador aparece aqui sem que uma linha seja escrita à mão, e um que se torne uma condição de interrupção sai daqui.
Dois limites ao que a tabela abrange, e vale a pena conhecer ambos antes de concluir que falta um código:
- Nem tudo nesta página é um destes. Várias das constatações explicadas abaixo são levantadas por uma passagem própria e não por uma regra declarada, e algumas não têm condição nenhuma — as linhas que imprimem continuam exatamente como descritas nas suas secções, mas não há código a resolver e, portanto, não há linha. O código de classe
unsupported-fieldé a forma a esperar aí: nomeia uma classe de constatação e não uma condição. - Uma linha aqui não promete uma secção mais abaixo. Um aviso levantado tarde na renderização é catalogado em vez de explicado, pelo que um código pode resolver-se aqui numa frase e ter o seu tratamento mais completo em fatal-halts.md em «Condições que não interrompem uma compilação», que cataloga todas as condições que têm um código sem interromper uma compilação.
sentinels.md resolve qualquer código curto que uma compilação imprima, de aviso ou de interrupção, e é o sítio por onde começar quando ainda não se sabe de que tipo é aquele que se 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)
É acionado quando um Component ou uma Feature declara o mesmo nome de propriedade tanto no pilar values: como no pilar infra: do seu bloco spec.schema: à mesma profundidade de aninhamento. Os autores de esquemas que colocam o mesmo nome de campo em ambos os pilares pretendem normalmente colocá-lo num ou noutro; o lint assinala a duplicação para que o autor possa resolver a que pilar pertence o 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. Percorre o esquema após a expansão da forma compacta, sem seguir um $ref: (ver a disciplina de omissão silenciosa abaixo), e comunica 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é à 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 pelo seu nome e versão e pelo ficheiro de onde foi lida, como acima. Uma compilação, ou uma validação de uma única Release, lê apenas as entidades que essa Release alcança e nomeia cada uma pelo 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 pelo seu nome simples e um Manifest que a mapeia por nome e versão alcançam uma única Feature, que é comunicada uma vez.
Visibilidade no editor. A constatação chega aos diagnósticos do editor através do servidor de linguagem, com severidade de aviso, no início do ficheiro e não numa chave — nomeia uma entidade do catálogo e não uma posição dentro do documento que se está a editar, pelo que não há nenhuma chave de autoria onde um marcador possa ficar. É levantada antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-a quer serve.build_on_inspect esteja ativado, quer não.
Disciplina de omissão silenciosa. O percurso termina sem aviso quando um ramo do esquema tem 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 as nomear) e os operadores de composição oneOf / anyOf / allOf (disjunções e conjunções cujos ramos podem declarar conjuntos de propriedades divergentes). Percorrer estes ramos exigiria avaliar o esquema referenciado ou composto no momento do 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 coincidisse por acaso 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 a ser percorridos e sujeitos ao 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 programador e o infra.storage_size do lado do operador são validados de forma independente pelos esquemas dos seus pilares, e o template valuesMapping: da Recipe escolhe de que pilar o valor flui para a saída renderizada. O lint existe porque este padrão de autoria é quase sempre um erro; a duplicação consciente entre pilares é rara o suficiente para que os autores que realmente a pretendem possam ignorar o aviso. Para a mecânica entre pilares em geral — incluindo os raros casos em que canalizar valores deliberadamente entre pilares se justifica — ver vocabulary/data-pillars.md «Mecânica entre pilares».
Binding-map-overlap lint (Lint de sobreposição de mapas da associação)
É acionado quando uma associação de anotação do Manifest declara o mesmo caminho com pontos tanto na sua lista maps.infra como na sua lista maps.values. O caminho seria encaminhado por ambos os pilares; o critério de desempate determinístico do compilador envia-o por infra:, o que deixa o lado values: inalcançável a partir do Aggregate. O lint revela-o para que o autor possa restringir a associação a um único pilar ou aceitar conscientemente o encaminhamento apenas pelo lado infra.
Posição no pipeline. O lint é executado depois de o Manifest ser resolvido e antes de qualquer expansão de anotações ser acionada, pelo que uma compilação comunica uma associação sobreposta quer uma anotação de um Aggregate chegue alguma vez a essa associação, quer não. Percorre as associações sob mappings.features.annotations pela ordem em que foram escritas, faz a interseção das listas maps.infra e maps.values de cada associação e comunica uma constatação por caminho sobreposto. Dentro de uma associação, os caminhos sobrepostos são comunicados pela ordem em que a lista maps.values dessa associação os declara — a ordem em que os escreveu — de modo que execuções repetidas sobre uma entrada idêntica comunicam 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 uma única compilação sobre um único Manifest, e o que difere entre os seus localizadores é a forma da chave de anotação. Um localizador endereça um documento por caminho com pontos, pelo que 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, ao passo que 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 cada constatação — é a única parte que o localizador nem sempre consegue transportar.
Visibilidade no editor. A constatação chega também aos diagnósticos do editor através do servidor de linguagem, com severidade de aviso, posicionada onde quer que o seu localizador chegue — 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 continua a vê-la. É levantada antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-a quer serve.build_on_inspect esteja ativado, quer não.
Fazer a correspondência programaticamente. A constatação tem ErrAnnotationBindingPillarOverlap de pkg/resolver, pelo que um consumidor reconhece a classe com errors.Is em vez de comparar o texto da mensagem. Como todas as sentinelas de aviso, nunca chega ao veredicto de uma compilação — ver 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 encaminhando o caminho exclusivamente pelo pilar infra:. A escolha é consistente entre compilações; o autor pode contar com ela. O lado values: é retirado do encaminhamento efetivo da associação — as anotações do lado do Aggregate que tentam alcançar o caminho não recebem nenhum destino de encaminhamento e a compilação é interrompida 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 é encaminhada por um pilar que o 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. Tal 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 é acionado porque este padrão de autoria é quase sempre involuntário; um autor de associações que quisesse realmente que ambos os pilares encaminhassem 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 anexo)
É acionado quando uma instância de componente anexa uma Feature sob um nome que não é um dos slots featuresSchema declarados do seu tipo de Component, mas está a uma edição de um deles — um único carácter inserido, eliminado ou substituído, ou dois caracteres adjacentes trocados — cujo selector a Feature anexada não satisfaz. Essa é a forma que uma gralha no nome de um slot assume, e o lint nomeia ambas as grafias para que o autor possa ver o par.
Porque existe. Declarar um slot não fecha a superfície de anexos: um anexo sob um nome que nenhum slot declara é legal, porque é essa abertura que permite que uma mesma entidade do catálogo sirva tanto um anexo que preenche um slot como uma credencial partilhada num âmbito mais amplo. O custo é que um nome de slot mal escrito passa a ser silenciosamente um anexo livre e não o preenchimento do slot que o autor pretendia — a compilação é bem-sucedida e o slot fica simplesmente 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 têm em conta o catálogo, sobre o Aggregate resolvido. Compara os nomes de anexo de cada instância de componente com os nomes de slot declarados do tipo de Component dessa instância e emite um aviso por cada 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 o anexo foi escrito, que é aquilo de 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 anexo se encontra e o slot declarado do qual está a uma edição.
Visibilidade no editor. O aviso chega também aos diagnósticos do editor através do servidor de linguagem, com severidade de aviso, posicionado na chave de anexo problemática. Um autor que nunca lê a saída do terminal continua a ver o par. É levantado antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-o quer serve.build_on_inspect esteja ativado, quer não.
Limiar e a 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 todos os nomes curtos estão a uma edição de todos os outros, pelo que emparelhá-los produziria ruído em vez de sinal; acima de uma edição, os pares deixam de se parecer com gralhas. Uma transposição conta como uma edição e não como duas, porque um par de caracteres trocados é o deslize mais comum e uma contagem mais rigorosa deixá-lo-ia escapar.
Nota de autoria. O lint é um aviso e nunca altera o veredicto da compilação — o compilador não fiscaliza o nome que um autor dá a um anexo. Um autor que anexe deliberadamente uma Feature sob um nome semelhante a um slot pode ignorar o aviso; o anexo comporta-se exatamente como foi escrito.
Não quando a Feature encaixa no slot. Um nome a uma edição de um slot cujo selector a Feature anexada satisfaz não gera nenhum aviso. Esse emparelhamento não é um anexo livre mal escrito, mas um preenchimento escrito sob outro nome, e se isso importa depende de o slot acabar vazio, o que só se sabe depois de todos os âmbitos terem sido combinados. Quando o slot fica vazio, a compilação é interrompida e nomeia o anexo e o slot — ver «An attachment written under another name fits a slot its component leaves empty (Um anexo escrito sob outro nome encaixa num slot que o seu componente deixa vazio)» em fatal-halts.md — pelo que a interrupção é a única constatação comunicada, nunca um aviso ao lado dela. Quando outra coisa associa o slot, o anexo é um anexo adicional comum e nada é comunicado. Nenhuma Feature encaixa num slot que não declare nenhum selector, pelo que um nome próximo de um slot assim gera sempre o aviso.
Não numa ligação. O lint lê o próprio bloco features: de um componente, que é aberto. Os anexos que uma ligação traz são indexados pelos slots que o seu socket declara e por nada mais, pelo que um nome a uma edição de um desses slots não é legal aí: em vez disso, a compilação é interrompida, e a interrupção nomeia na mesma frase o slot de que o nome está próximo. Nenhum aviso é levantado ao lado dela. Ver «A connection carries an attachment under a name its socket declares no slot for (Uma ligação traz um anexo sob um nome para o qual o seu socket não declara nenhum slot)» em fatal-halts.md.
Uses-socket near-miss lint (Lint de quase correspondência de sockets uses)
É acionado quando o próprio bloco uses: de um componente nomeia um socket que não é um dos sockets usesSchema declarados do seu tipo de Component, mas está a uma edição de um deles — um único carácter inserido, eliminado ou substituído, ou dois caracteres adjacentes trocados. Essa é a forma que uma gralha no nome de um socket assume, e o lint nomeia ambas as grafias para que o autor possa ver o par.
Porque existe. Declarar um socket não fecha a superfície uses: no próprio componente de um programador: um nome de socket que nenhuma entrada usesSchema declara é legal, porque o silêncio do catálogo sobre um socket significa que a ligação não foi prevista, e não que seja proibida, e o programador é dono da topologia do Aggregate. O custo é que um nome de socket mal escrito se torna uma ligação ad hoc própria em vez de cablar o socket que o autor pretendia — a compilação é bem-sucedida, o socket pretendido fica simplesmente por cablar e a aresta ad hoc não tem seletor nem contrato por aresta. O lint é a mitigação declarada exatamente para esse caso. Para aquilo de que um socket ad hoc abdica e aquilo que mantém, ver entities/component.md «Sockets de topologia: usesSchema».
Que superfície abrange. Apenas o próprio bloco uses: do componente — a única superfície em que um nome de socket não declarado é aceite. O uses: de um anexo de Feature só pode nomear um socket que a Feature anexada declare, e o uses: por aresta de uma Release só pode nomear um socket que o Component consumidor declare; um nome errado em qualquer uma delas já interrompe a compilação, pelo que 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 têm em conta o catálogo, sobre o Aggregate resolvido. 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 cada par de quase correspondência. Um componente que chega de um subagregado não está abrangido: os seus componentes internos são incorporados no grafo depois de esta passagem ser 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 é aquilo de 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 está a uma edição. A consequência que o aviso não explicita é a descrita acima: o nome mal escrito é uma ligação ad hoc, pelo que não tem seletor nem contrato por aresta, e o socket que o autor pretendia fica por cablar.
Visibilidade no editor. O aviso chega também aos diagnósticos do editor através do 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 continua a ver o par. É levantado antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-o quer serve.build_on_inspect esteja ativado, quer não.
Limiar e a 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 anexo usa, pela mesma razão. Abaixo desse comprimento, quase todos os nomes curtos estão a uma edição de todos os outros, pelo que emparelhá-los produziria ruído em vez de sinal; acima de uma edição, os pares deixam de se parecer com gralhas. Uma transposição conta como uma edição e não como duas, porque um par de caracteres trocados é o deslize mais comum e uma contagem mais rigorosa deixá-lo-ia escapar.
Nota de autoria. O lint é um aviso e nunca altera o veredicto da compilação — o compilador não fiscaliza o nome que um autor dá a um socket. Um autor que trace deliberadamente uma ligação ad hoc sob um nome semelhante a um socket declarado (uma ligação cache ao lado de um socket declarado caches, destinada a outra coisa) pode ignorar o aviso; a aresta comporta-se exatamente como foi escrita. Não há nenhuma flag para o suprimir, e nenhuma é necessária: não tem qualquer peso no veredicto.
Undeclared-provides-key lint (Lint de chaves provides não declaradas)
É acionado quando a Recipe associada a uma instância de componente publica sob o seu provides: uma chave que o tipo de Component da instância não declara no seu contrato spec.schema.provides:.
Porque existe. Publicar mais do que o Component declara é legal e continua a sê-lo: o contrato provides exige o subconjunto e permite o superconjunto, pelo que uma Recipe que cobre o contrato do seu Component e emite ainda chaves adicionais é 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 aquilo que a Recipe do destino emita — é isso que mantém as Recipes intercambiáveis, uma vez que 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 de que um consumidor passou a depender. Assim, uma chave não declarada não é entregue através da aresta, e um template consumidor que a leia produz um valor vazio em vez de falhar.
A constatação é indicada na sua causa — na Recipe que publicou a chave — porque é aí que 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 ficam deliberadamente em locais diferentes: o valor vazio aparece no consumidor, a explicação aqui, e ambos aparecem na mesma saída da compilação.
Que emparelhamento é comparado. As chaves provides: escritas na Recipe associada face às chaves spec.schema.provides: declaradas do tipo de Component. Esse conjunto declarado é o mesmo com que é verificada uma chave from: dentro de um bloco inject:, pelo que os dois concordam quanto ao que um Component declara. A comparação é exata, e não um teste de semelhança, pelo que, ao contrário dos dois lints de quase correspondência acima, não tem limiar e não emparelha nomes.
A Recipe comparada é aquela a que a instância está efetivamente associada, localizada pelo mesmo nome de instância e pelo mesmo tipo de catálogo com que a renderização a associa, pelo que uma substituição de Recipe por instância no Manifest é respeitada em vez de se diluir numa média. Uma instância de componente cujo tipo não se resolve em nenhum Component do catálogo é ignorada: não foi lida nenhuma declaração, 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 têm em conta o catálogo, sobre o Aggregate resolvido — antes da renderização, pelo que surge tanto em aggrega validate --release como em aggrega build. Estão abrangidos tanto os Components declarados na raiz do Aggregate como os componentes aninhados em subsistemas. Um componente que chega de um subagregado não está abrangido: os seus componentes internos são incorporados no grafo depois de esta passagem ser executada, pelo que a chave não declarada de um componente desses continua a não ser entregue aos consumidores, mas nenhum aviso a nomeia.
Formato emitido. Uma linha por instância de componente e chave, que nomeia 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 contém, pelo que dez instâncias de um mesmo tipo de Component que publiquem a mesma chave não declarada geram dez linhas em vez de uma, cada uma a nomear a sua própria instância. Cada linha é atribuída à Recipe que publicou a chave, porque é esse o documento que se edita para a resolver. O percurso é determinístico, pelo que a mesma entrada produz a mesma sequência de avisos em cada execução.
Visibilidade no editor. O aviso chega também aos diagnósticos do editor através do 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 continua a vê-lo. É levantado antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-o quer serve.build_on_inspect esteja ativado, quer não.
Nota de autoria. O lint é um aviso e nunca altera o veredicto da compilação — com uma Recipe que publica mais do que o seu Component declara, a compilação conclui-se na mesma. A correção é uma de duas, e cabe ao autor decidir qual é a certa: declarar a chave no Component quando os consumidores a devem ler, ou deixá-la por declarar quando é 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 a sua Recipe não publica deixa o contrato por cumprir e interrompe a compilação.
Ghost Infrastructure Tracker warnings (Avisos do rastreador de Ghost Infrastructure)
É acionado quando uma chave que um autor declarou chega a um nó e nenhum template que a Recipe associada declara alguma vez lhe faz referência. As chaves não lidas tornam-se infraestrutura silenciosa: configuração que o programador ou o operador pediu e que a Recipe nunca liga à saída renderizada. O rastreador revela-as para que a discrepância entre aquilo que foi escrito e aquilo que a saída contém seja visível em vez de silenciosa.
Que chaves escritas são comparadas. Três grupos, por nó:
.values— o pilar próprio do nó, do lado do programador..infra— o pilar próprio do nó, do lado do operador..context.uses.<alias>.values— os valores por ligação transportados em cada arestauses:através da qual o nó consome. Este grupo fica restrito ao consumidor sem custo adicional: o mapausesde um nó contém apenas as arestas de que ele é a origem, pelo que um valor por ligação não lido é sempre atribuído ao nó que o escreveu e nunca ao destino da aresta.
Que referências são recolhidas. 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, pelo que qualquer coisa mais restrita do que a Recipe inteira a tornaria falsa em vez de aproximada — uma chave que uma coordenada source: consome seria comunicada como não lida precisamente pela execução que obteve a versão que ela nomeava. Os blocos lidos são:
valuesMapping:, a sobreposição de values entregue ao fornecedor.source:— o campo inteiro quando é escrito como uma única cadeia, e cada um dos seus campos com valor de cadeia quando é escrito como um objeto. Uma coordenada de origem é um template avaliado por cada instância consumidora, pelo que 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 passo e o seu controlowhen:.
Daí decorrem três limites, e todos os três são limites àquilo que se pode afirmar honestamente, e não escolhas. Cada um deles silencia a leitura em vez de a alargar, que é a direção que custa menos: uma chave não comunicada custa a um leitor um aviso que ele ainda pode encontrar lendo a Recipe, ao passo que uma comunicada por engano lhe diz que uma definição que funciona foi ignorada.
- Uma Recipe sem um
valuesMapping:inline não é lida de todo. As suas chaves são saltadas em vez de comunicadas, seja o que for que os seus outros templates façam. - Um bloco que a Recipe importa de um ficheiro ou de uma referência de biblioteca não está disponível neste ponto, pelo que as suas referências não podem ser recolhidas. As chaves do nó são saltadas por completo em vez de comunicadas — isto vale igualmente para um
valuesMapping:importado, umworkload:importado e uma entradaartifacts:importada. - Um template que não é analisável não produz nenhum conjunto de referências. Comunicar cada chave como não lida soterraria o diagnóstico de análise que a avaliação levanta sobre o mesmo template, pelo que, em vez disso, nada é comunicado. Uma entrada
artifacts:é lida com os delimitadores padrão{{ }}, que não são o par que todos os fornecedores declaram para esse campo; lido com o par errado, um corpo destes produz referências que o seu autor nunca escreveu, ou não é analisável, e ambos os resultados só podem silenciar um aviso.
O valueSchema de um socket nunca é assinalado. usesSchema.<socket>.valueSchema declara o contrato que um valor por ligação tem de satisfazer. É um esquema, não uma instância escrita, e não está entre as entradas comparadas — pelo que nunca pode ser comunicado. Aquilo que o valor predefinido declarado de um socket produz é uma instância como qualquer outra, lida ou não lida pelos seus próprios méritos.
Uma referência que nomeia um pilar inteiro conta como lidas todas as chaves 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, pelo que a referência recolhida nomeia o pilar em vez de uma chave abaixo dele, todas as chaves desse pilar contam como lidas e o pilar não levanta nada. O mesmo vale para percorrer um pilar com range e para alcançar uma entrada de uses através de index. Um autor de Recipe que pretenda cobertura por chave escreve referências por chave.
Isto abrange todos os blocos acima, o que vale a pena saber antes que um pilar silencioso seja tomado por um aviso em falta: uma Recipe cuja versão source: está escrita como {{ optional .infra `source_version` "1.2.3" }} entregou o mapa .infra inteiro a uma função, pelo que essa Recipe não comunica nada sobre nenhuma chave .infra em nenhum nó que renderize. O pilar .values não é afetado — os dois são contados separadamente.
Posição no pipeline. O rastreador é executado na renderização base, a par da avaliação de templates. Cada um dos templates da Recipe é analisado e percorrido para recolher os caminhos de campo qualificados por pontos a que 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. Aquilo que é percorrido é a Recipe tal como foi escrita: uma coordenada source: é lida como o texto do seu template, e 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 programador, 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 num 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 mal escrita é a causa comum, e uma chave que nunca iria ser lida merece ser eliminada.
A ordem é fixa: primeiro o .values do nó, depois o seu .infra, depois cada alias de uses pela ordem em que as arestas foram emitidas, com as chaves ordenadas dentro de cada grupo. A mesma entrada produz, portanto, a mesma sequência de avisos em cada execução.
Visibilidade no editor. O aviso chega aos diagnósticos do editor apenas onde o servidor de linguagem executa a fase de renderização de artefactos 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 predefinição. Esse ajuste acrescenta os avisos que uma compilação levanta ao renderizar, e nenhuma das verificações em que uma compilação é interrompida. A entrada nomeia um nó e não uma chave de autoria, pelo que é apresentada na chave kind: do Aggregate.
Porque um aviso e não uma interrupção fatal. Os programadores podem legitimamente consumir subconjuntos diferentes de .values numa lógica de template condicional — uma Recipe cujo template se ramifica consoante .values.mode lê mode, mas lê .values.replication_password condicionalmente, apenas quando mode == "replication". O percurso estático não consegue distinguir se uma chave não referenciada é indiferente ou um erro. O propósito do rastreador é tornar a discrepância visível em vez de a fiscalizar; 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 é ligar 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 os futuros leitores saibam que a discrepância é intencional.
Unread declared-parameter warnings (Avisos de parâmetros declarados não lidos)
É acionado 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 fazer 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 pertence. Uma declaração que nada lê deixa essa variação sem sítio onde chegar — seja o que for 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 transporta.
Um valor predefinido não é uma isenção. Um valor predefinido que nenhuma referência lê não chega à saída mais do que um valor fornecido por uma Release, pelo que uma declaração com valor predefinido é comunicada exatamente como uma declaração sem ele.
Que referências são recolhidas. 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 destes nomeia o parâmetro através do mapa de parâmetros resolvido, e não através de uma referência com pontos no Aggregate, pelo que a declaração é comunicada como não lida mesmo que o predicado a leia. - Um texto que não é analisável como template não produz nenhum conjunto de referências. Comunicar cada declaração como não lida soterraria o diagnóstico que a interpolação levanta sobre o mesmo texto, pelo que, em vez disso, nada é comunicado.
- Uma referência que nomeia o mapa
parametersinteiro — iterando sobre ele, ou alcançando uma entrada através de index — conta todas as declarações como lidas, porque a referência recolhida 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 em bruto do Aggregate e o seu contrato de parâmetros declarado — antes da renderização. Por isso surge em aggrega validate tal como 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 pela ordem em que o Aggregate declara os seus parâmetros, pelo que o mesmo Aggregate produz a mesma sequência em cada execução. Cada uma tem 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 numa 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, pelo que uma mensagem que omitisse a chave seria lida de forma idêntica para todas as declarações não lidas.
Visibilidade no editor. O aviso chega também aos diagnósticos do editor através do servidor de linguagem, com severidade de aviso, posicionado na declaração que o seu localizador nomeia, e não no Aggregate como um todo. É levantado antes da fase de renderização de artefactos, pelo que não precisa de nenhum ajuste: uma sessão do editor apresenta-o quer serve.build_on_inspect esteja ativado, quer não.
Porque um aviso e não uma interrupção fatal. Um parâmetro pode ser declarado antes da referência que o irá ler, e um percurso estático não consegue distinguir isso de um erro — a mesma razão pela qual a leitura das chaves escritas se limita sempre a avisar. O compilador não fiscaliza que ajustes um autor expõe.
Provider-binding unserved-capability warning (Aviso de capacidade não servida de uma associação de fornecedor)
É acionado 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 fornecedor que a compilação lê serve essa capacidade. Os plugins que uma compilação lê são os dos seus diretórios do catálogo, os fornecedores dentro do compilador e os plugins que o seu ficheiro de bloqueio regista.
Porque existe. Uma associação só é lida quando o capability: de uma Recipe pede a sua capacidade, e uma entrada que não nomeie nenhum plugin não seleciona nada que a resolução da capacidade não selecionasse sem ela. Assim, uma entrada cuja capacidade está mal escrita — hlem em vez de helm — não é consultada por nada e não altera nada, e sem este aviso nada o diria.
Porque 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 uma compilação é de uma única Release. O plugin que serve a capacidade pode ser um que só outra Release do espaço de trabalho lê, e esta compilação não o consegue ver, pelo que uma interrupção aqui recusaria um espaço de trabalho legal com base num palpite. Uma entrada que também nomeia um plugin é um caso diferente: um pull resolve cada entrada destas, quer uma Recipe a use, quer não, pelo que a compilação tem o plugin e sabe o que ele serve, e uma capacidade que esse plugin não serve provoca uma interrupção — ver 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 pela compilação de facto serve não é comunicada de forma nenhuma, quer uma Recipe desta Release a use, quer não.
Posição no pipeline. Cada compilação e cada validação de uma Release lê cada entrada da configuração composta do espaço de trabalho — as camadas e os seus complementos providers_append em conjunto — antes de o grafo da Release ser analisado, pelo que o aviso surge em aggrega validate --release tal como em aggrega build, e em aggrega pull, que renderiza a Release uma vez, sobre o ficheiro de bloqueio que está prestes a escrever, para descobrir as entradas externas que uma compilação dela obtém. O juízo não altera nada quanto ao plugin que renderiza uma Recipe; isso é lido do ficheiro de bloqueio.
Formato emitido. Uma linha por entrada, pela ordem em que a lista composta as traz, que nomeia a capacidade e uma capacidade servida a uma edição de distância, quando existe 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ó é proposta 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 pela mesma razão.
Visibilidade no editor. O aviso chega aos diagnósticos do editor através do servidor de linguagem com severidade de aviso. A entrada encontra-se no ficheiro de configuração e não no documento que se está a editar, pelo que é posicionada no início desse documento em vez de numa chave.
Cobertura de metadados por entidade
Os envelopes de entidade que têm metadata.labels e metadata.annotations variam consoante o tipo. Component, Feature e os tipos de biblioteca têm ambas; Aggregate tem apenas rótulos; Recipe, FeatureRecipe, Manifest, Release e Plugin não aceitam nenhuma das duas chaves ao nível do envelope. Estado da linguagem regista a situação de cada entidade e é a superfície a consultar.
Visibilidade no editor. Nenhum aviso abrange isto, em nenhuma definição: não há nada a comunicar, porque uma entidade ou tem estas chaves ou não as aceita, e uma chave que um tipo não aceita é uma questão a que o seu esquema responde quando o documento é carregado, e não algo que a fase de renderização comunique depois. Um autor consulta a página de estado em vez de esperar por um aviso.
Unsupported-field warnings (Avisos de campo não suportado)
Uma única classe abrange tudo aquilo que foi escrito e que o destino não consegue respeitar. Tem dois membros — um campo do Workload que o destino não consegue exprimir, e uma anotação aggrega.ai/ sobre a qual o destino não atua — e partilham um único código de classe e uma única flag de supressão, porque um autor que pretenda silenciar «as coisas que este destino ignora» pretende silenciá-las em conjunto 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 exprimir)
Os destinos diferem em fidelidade. Um campo do Workload que um destino exprime nativamente pode não ter equivalente noutro — 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 destes e o destino não o consegue exprimir, o campo é omitido com um aviso, um aviso por cada campo escrito. 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 a compilação de forma ruidosa — o destino não consegue de todo produzir essa forma de carga de trabalho. Uma forma suportada que tenha um campo inexprimível é renderizada, sem esse campo, e di-lo.
No destino compose, a classe abrange atualmente scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, o runAsNonRoot de um contentor e todas as chaves de recurso estendido exceto nvidia.com/gpu — amd.com/gpu, por exemplo — uma vez que essa está reservada para GPU 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, pelo que o volume se reduz a um único volume persistente partilhado em vez de desaparecer.- Uma entrada
attachmentsde um contentor comas: env— o compose não consegue obter uma variável de ambiente a partir de um anexo, pelo que a variável é emitida com um valor vazio. O aviso nomeia a entrada na sua coordenada escrita (containers.<name>.attachments.<KEY>, ouinitContainers[<i>].attachments.<KEY>para uma entrada init posicional), de modo que fica claro que variável chega vazia e a que contentor pertence. Uma entrada comas: fileé montada normalmente por bind mount e não levanta nada. - Uma entrada
volumesque nenhum contentor monta — o aviso nomeia o volume na sua coordenada escrita (volumes.<name>). Aquilo que chega à saída depende da variante: um volumepersistentoupersistentTemplatecontinua a ser declarado como volume com nome, que é então criado e deixado sem uso, ao passo que um volumeconfigmap,secretouephemeralsó chega à saída através do ponto de montagem de um contentor, pelo que, sem nada que o monte, a declaração não produz saída nenhuma. Em qualquer dos casos, o volume escrito não está a fazer nada: deve montá-lo a partir de um contentor, ou removê-lo. Todos os contentores da carga de trabalho contam como montadores, incluindo os contentores de inicialização, pelo que um volume montado apenas por um contentor de inicialização não levanta nada. - Um bloco
healthque declara mais de um slot de sonda — um serviço compose tem um únicohealthcheck, pelo que 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 na sua coordenada escrita (containers.<name>.health, ouinitContainers[<i>].healthpara uma entrada init posicional) e nomeia tanto o slot que foi traduzido como os slots que foram descartados, de modo que fica claro que sonda está ativa na saída e que intenção escrita está inerte. Um bloco que declara um único slot é traduzido sem perda e não levanta nada. hostNetworknuma carga de trabalho que também declarainitContainers— o serviço próprio da carga de trabalho é executado na rede do nó, mas cada contentor de inicialização torna-se um serviço próprio que entra na rede da fronteira por direito próprio, porque partilhar o namespace do serviço principal tornaria circular a espera do serviço principal por ele. Isto é mais restrito do que a forma de pod que está a ser modelada, em que todos os contentores partilham um único namespace, pelo que a diferença é nomeada em vez de ficar por descobrir em tempo de execução. Uma carga de trabalho que declarahostNetworksem contentores de inicialização é traduzida sem perda e não levanta nada.
An annotation the target does not act on (Uma anotação sobre a qual o destino não atua)
As anotações aggrega.ai/ são diretivas de plataforma que um fornecedor lê e aplica àquilo que renderiza — um namespace, um prefixo de registo, uma conta de serviço. Quais delas um fornecedor lê é uma declaração própria desse fornecedor, feita por tipo de entrada, porque um fornecedor que detém cada campo de uma unidade de implementação que ele próprio sintetiza muitas vezes não tem onde colocar o mesmo valor quando renderiza um artefacto vendorizado. Anotações bem conhecidas é a matriz.
A Recipe própria de um nó e cada funcionalidade anexada a esse nó são renderizadas separadamente, cada uma através do destino que o seu próprio capability: nomeia e nos tipos de entrada que os seus próprios source:, workload: e artifacts: declaram. Quando uma anotação destas chega a uma dessas renderizações e a declaração do destino resolvido não abrange a chave em nenhum dos tipos de entrada que essa renderização declara, o destino não aplica nada para essa chave, e a compilação comunica-o 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 da forma 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 propaga-se em cascata a cada componente abaixo dela, e esses componentes podem ser renderizados através de destinos diferentes e tipos de entrada diferentes. Cada aviso é uma afirmação verdadeira sobre uma única renderização, pelo que se recebe um por cada renderização que não consegue atuar sobre a chave — e é também isso que indica que partes da saída são afetadas.
- Uma funcionalidade anexada a um nó é avaliada pela sua própria FeatureRecipe, e não pela Recipe do nó. Um anexo que gera recursos próprios renderiza-os através do destino que a sua FeatureRecipe nomeia, nos tipos de entrada que essa FeatureRecipe declara — pelo que uma anotação que o destino próprio do nó aplica pode não chegar a nada nos ficheiros do anexo, e o inverso também se verifica. Cada um é comunicado de forma independente, porque são ficheiros diferentes. O mesmo se aplica a uma funcionalidade anexada a uma fronteira em vez de a um componente com nome. Um anexo cuja FeatureRecipe não declara nenhum de
source:,workload:eartifacts:não renderiza ficheiros próprios — contribui injetando valores, através da arestausesque a sua Feature tem, ou através de um pipeline sobre documentos que outra coisa emitiu — pelo que não existe nenhuma saída própria da qual uma anotação possa estar ausente, e nada é avisado a seu respeito. - Uma renderização que declara mais de um tipo de entrada é avaliada por todos eles. Os seus tipos declarados compõem-se por adição e as suas saídas são somadas, pelo que um destino que lê a chave em qualquer um deles aplica-a e o valor surge na saída renderizada. Nada é avisado nesse caso, porque não há nada a comunicar. Um aviso surge apenas quando todos os tipos declarados falham a chave, e nomeia-os a 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 uma chave própria comoacme.aggrega.ai/team— pertence ao vocabulário de quem a escreve, que o compilador transporta sem interpretar. Nada avisa alguma vez sobre uma chave destas. - Um destino que não declara qualquer afirmação de suporte não levanta nada. O aviso compara aquilo que foi escrito com aquilo que o fornecedor disse ler; um fornecedor que nada disse não lhe dá nada com que comparar, e inferir uma recusa a partir do silêncio comunicaria uma afirmação que o autor do fornecedor nunca fez. Um fornecedor que não lê nenhuma das chaves di-lo com
readsNoWellKnownAnnotations: true, como fazterraform, e cada chave sem subprefixo que chegue a uma das suas renderizações passa então a gerar um aviso.
Porque um aviso e não uma interrupção. Uma fronteira que abrange legitimamente componentes em destinos heterogéneos terá sempre algum nó que não consegue atuar sobre uma dada chave — essa é a forma normal de uma Release que abrange vários destinos, e não um erro — pelo que recusar a compilação rejeitaria Releases corretas. O valor passa intacto, e o aviso indica-o.
O código de classe e a garantia fora de banda
Cada aviso tem 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 atua — tem esse único código, e é isso que permite que um único filtro suprima a classe inteira. Os avisos circulam fora de banda em relação aos artefactos renderizados, o que significa que os bytes renderizados são idênticos byte a byte, quer os avisos surjam, quer não — suprimi-los não pode alterar a saída.
Visibilidade no editor. Cada membro da classe chega aos diagnósticos do editor apenas onde o servidor de linguagem executa a fase de renderização de artefactos 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 predefinição. Esse ajuste acrescenta os avisos que uma compilação levanta ao renderizar, e nenhuma das verificações em que uma compilação é interrompida. O código de classe acima circula no diagnóstico publicado tal como na linha do terminal, pelo que um cliente do editor faz a correspondência com a mesma classe que um autor lê. Cada entrada nomeia um nó e um destino e não uma chave de autoria, pelo que é apresentada na chave kind: do Aggregate.
Suprimir a classe
Ambos os comandos que renderizam aceitam --no-unsupported-field-warnings, que silencia apenas esta classe enquanto todos os outros avisos de renderização continuam a surgir:
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 apresentaçã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 — verifica apenas convenções de publicação, pelo que nenhum aviso de renderização pode surgir aí.
A flag é indicada quando a fidelidade reduzida foi aceite deliberadamente — 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, deve ficar desativada: o aviso é a forma de saber que um campo escrito não está a chegar ao destino.
A declared-sensitive value travels as a literal (Um valor declarado sensível circula como literal)
É acionado quando um anexo preenche um slot entregando um dado que o seu esquema declara sensível numa chave de entrega como valor literal, em vez de como uma referência que o destino resolve ao implementar.
Formato emitido. Uma linha por chave de entrega, que nomeia a instância do anexo, o mecanismo de entrega em que a chave acaba 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 tem 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 circula na linha do terminal e no diagnóstico estruturado que o servidor de linguagem publica, pelo que 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 fase de renderização de artefactos 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 predefinição. Esse ajuste acrescenta os avisos que uma compilação levanta ao renderizar, e nenhuma das verificações em que uma compilação é interrompida. A entrada nomeia um nó e um destino e não uma chave de autoria, pelo que é apresentada na chave kind: do Aggregate.
É uma classe própria, e --no-unsupported-field-warnings não a abrange. Essa flag silencia a classe de campo não suportado descrita acima; este aviso continua a surgir ao lado dela. Não existe nenhuma flag que silencie este.
A compilação é bem-sucedida e os bytes renderizados não se alteram. O aviso circula fora de banda em relação aos artefactos renderizados, tal como a classe de campo não suportado, pelo que aquilo que chega à saída é o mesmo, quer a linha surja, quer não.
A declared-sensitive value reaches the target through a values mapping (Um valor declarado sensível chega ao destino através de um mapeamento de values)
É acionado 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 o seu Component declara, ou o mapeamento da FeatureRecipe de uma Feature anexada a um componente sobre uma folha que essa Feature declara. Um mapeamento é um único template cujas chaves de saída são invenção sua, pelo que 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 na 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 anexada começa pelo nome sob o qual está anexada, porque um componente pode ter vários anexos de uma mesma Feature e as suas linhas seriam, de outro modo, idênticas — a segunda linha abaixo é uma Feature anexada 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, pelo que a declaração se une exatamente à sua chave renderizada e a marcação circula com ela — no destino Terraform, esse é o ficheiro de substituição gerado descrito em Entradas de módulo declaradas sensíveis. Com um mapeamento, a marcação que de facto chega abrange a saída do mapeamento como um todo, e apenas onde o mapeamento lê o valor declarado: 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 artefactos e uma renderização apenas de carga de trabalho não entregam ao seu destino nenhum mapa de valores, pelo que uma folha de values não tem aí nenhuma chave renderizada a marcar, seja como for escrita. Uma Feature anexada a uma fronteira também não gera aviso, seja o que for que a sua FeatureRecipe mapeie: uma fronteira não tem nenhum bloco values:, pelo que um anexo destes é renderizado contra um pilar values vazio, nenhuma das folhas de values da sua Feature pode ter aí 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, pelo que um aviso sobre ela seria acionado em cada compilação e não indicaria nada a fazer; o limite é ensinado, em vez disso, em Declarar uma folha sensível. Uma renderização a partir de um source: sem valuesMapping: também é silenciosa, porque aí a marcação chega.
O código de classe. O aviso tem 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. Nomeia uma classe de constatação, e não uma condição registada, pelo que 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 com a mesma linha que uma compilação imprime no terminal, sempre que o servidor de linguagem renderiza a Release — uma compilação ou uma pré-visualização de compilação 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 predefinição. A entrada nomeia um nó e um destino e não uma chave de autoria, pelo que é apresentada na chave kind: do Aggregate.
É uma classe própria, e --no-unsupported-field-warnings não a abrange. Essa flag silencia os avisos de fidelidade de um destino, um juízo diferente feito por razões diferentes; este aviso continua a surgir ao lado dela. Não existe nenhuma flag que silencie este.
A compilação é bem-sucedida e os bytes renderizados não se alteram. O aviso comunica uma ausência — nenhuma chave renderizada tem a marcação — e um mapeamento é uma forma comum e suportada, pelo que não há nada que justifique uma interrupção e nada na saída se altera, quer a linha surja, quer não.
A Terraform module call the engine fetches when it initialises (Uma chamada de módulo Terraform que o motor obtém ao inicializar)
É acionado quando um módulo Terraform que a compilação vendoriza, ou o corpo Terraform escrito de uma Recipe, declara um bloco module cujo source o Terraform descarrega quando a configuração é inicializada, em vez de o ler dos ficheiros que a compilação colocou: um endereço de registo, um URL git, Mercurial ou de arquivo HTTP, um bucket S3 ou GCS, ou um caminho absoluto — ou um caminho local que sai do módulo vendorizado, e que nomeia ficheiros que a compilação não vendorizou. O bloqueio fixa o commit e o digest do arquivo do módulo vendorizado, e o próprio ficheiro de bloqueio de dependências do Terraform regista apenas fornecedores, pelo que o módulo que uma chamada destas nomeia é obtido na versão que o motor selecionar nesse momento e nada do que esta compilação regista o abrange.
O que é lido. Os ficheiros 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 daí — e nada num diretório que nada chama, pelo que uma chamada escrita no diretório examples/ ou tests/ de um módulo não é comunicada. É lido aquilo que um source diz, e nunca o módulo que essa origem nomeia. Um ficheiro sob spec.boundary.artifacts de uma Recipe é avaliado e escrito pelo próprio compilador e não é entregue a nenhum fornecedor, pelo que um bloco module escrito nele não é lido e não gera aviso. Validação estrutural da entrada, na página do fornecedor, enuncia a regra por completo.
Formato emitido. Uma linha por chamada, que nomeia o nó e o fornecedor, depois o bloco, o ficheiro e a linha em que se encontra, e a origem tal como foi escrita; uma origem que sai do módulo di-lo em vez de nomear uma transferência:
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 pela ordem em que o motor as alcança — primeiro o diretório próprio do módulo, depois cada diretório pela ordem em que uma origem local o alcança pela primeira vez, e dentro de um ficheiro pela ordem em que os seus blocos estão escritos — pelo que a mesma entrada produz a mesma sequência em cada execução. Cada execução que renderiza levanta-as: aggrega build; aggrega pull, que renderiza a Release uma vez para descobrir o que uma compilação dela obtém; 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 tem 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 circula no diagnóstico estruturado: a ferramenta build do assistente lista cada constatação sob advisories com ele, e o servidor de linguagem publica-o em cada entrada. Nomeia uma classe de constatação, e não uma condição registada, pelo que 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 — uma compilação ou uma pré-visualização de compilação 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 predefinição. A entrada nomeia um nó e não uma chave de autoria, pelo que é apresentada 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 abrange esta.
A compilação é bem-sucedida e os bytes renderizados não se alteram. O aviso circula fora de banda em relação aos artefactos renderizados, pelo que o módulo vendorizado, o corpo escrito e a configuração raiz são idênticos byte a byte, quer ele surja, quer não.
Porque um aviso e não uma interrupção. Um módulo que chama outro módulo é uma entrada legítima: o Terraform obtém o módulo chamado e a configuração funciona. Aquilo de que o autor abdica é a fixação que a compilação mantém sobre esse módulo, o que é um facto a comunicar, e não uma falha a recusar, e cabe ao autor decidir se a obtenção é aceitável.
A plugin ran with no recorded digest to check it against (Um plugin foi executado sem nenhum digest registado com o qual o verificar)
É acionado quando o compilador está prestes a executar um plugin, um digest registado deveria governar os bytes desse plugin e o espaço de trabalho não regista nenhum para ele. O plugin é executado; o aviso é a forma de saber que nada comparou os bytes executados com os bytes que alguém reviu.
aggrega pull escreve o digest de cada plugin que adquire no ficheiro 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 ficheiro de bloqueio é anterior a um plugin que a configuração anexou entretanto, não tem digest para esse plugin — pelo que a comparação não tem com que comparar, e sem esta linha passaria em silêncio.
Um passo do pipeline, um fornecedor ou um plugin anexado a um papel de veredicto cuja entidade Plugin é escrita num 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 destas, e uma compilação lê o seu .wasm de novo de cada vez — de junto da entidade, no caso comum — em vez de o comparar com algo que um pull tenha registado. Um plugin anexado a um papel de transformação e escrito aí é a exceção: os seus bytes moldam a saída renderizada, pelo que um pull regista o digest do .wasm que encontra para ele, e, depois de o ter feito, uma compilação verifica esse plugin face ao 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 uma compilação, um pull ou uma validação mostra entre os seus outros avisos. Um comando que resolve um plugin fora de uma execução destas — ao instalar, listar ou executar os plugins de linha de comandos do próprio espaço de trabalho, ou aggrega lint ao resolver os plugins com que faz o lint — imprime a mesma frase numa linha própria, sem indentação.
A linha nomeia a origem de onde vieram os bytes — a mesma palavra que aggrega pull e aggrega plugin list usam para ela — e termina com o que se aplica a essa origem. Para bytes da cache de conteúdo, a correção é fazer pull da Release, o que regista o digest e torna verificada cada execução posterior desse plugin. Para bytes lidos de junto de uma entidade Plugin num diretório do catálogo, um pull regista o digest apenas para um plugin anexado a um papel de transformação, e a linha di-lo: para qualquer outro plugin escrito aí, nenhum pull o altera, e a forma de o colocar sob um digest registado é publicá-lo e referenciar a entidade publicada.
É mostrado uma vez por plugin em cada comando, independentemente de quantas vezes o comando resolva esse plugin. Uma renderização resolve o seu fornecedor uma vez por nó, e uma compilação que preenche o seu próprio ficheiro de bloqueio pode renderizar a Release mais de uma vez; repetir a linha de cada vez soterrá-la-ia. O serviço do editor mostra-a no seu próprio fluxo de erro uma única vez enquanto estiver em execução, ao passo que cada pedido a que responde a comunica de novo ao editor — pelo que qualquer resposta de que o editor se sirva o informa sobre os plugins que essa execução usou sem verificação.
Visibilidade no editor. O aviso chega aos diagnósticos do editor juntamente com os outros avisos da execução, com severidade de aviso: uma validação de uma Release publica-o no Aggregate da Release, e uma compilação ou uma pré-visualização de compilação que o editor peça publica-o na camada aggrega-build. Nomeia um plugin em vez de uma chave que escreveu, pelo que é posicionado no início do ficheiro. Como cada execução comunica 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 faça. Não altera nenhum veredicto nem faz falhar nenhuma resolução, pelo que aquilo que uma sessão responde é o mesmo, quer seja mostrado, quer não.
Duas resoluções não geram nada, e nenhuma delas é um descuido:
- Um plugin que o compilador transporta dentro de si.
aggrega pullregista o que obteve, e não há nada a obter para bytes que vêm no binário — pelo que nunca é registado um digest para um destes, e não haveria nada que pudesse executar para o alterar. O binário é a identidade desses bytes. Os plugins próprios do compilador e as respetivas versões são listados poraggrega plugin liste inscritos na secçãotoolchaindo ficheiro de bloqueio. - Uma resolução à qual nenhum digest se destinou alguma vez.
aggrega validate --plugin ./some.wasmaponta para um ficheiro que nomeou na linha de comandos, eaggrega lintinspeciona o próprio artefacto que está a verificar; em ambos os casos, o plugin é o objeto do exame e não uma ferramenta em que se confia, pelo que não existe nenhum registo a que possa ser sujeito.
Porque um aviso e não uma interrupção. Ler um documento vale a pena num espaço de trabalho que ninguém preparou ainda — recusar validar ou fazer o lint até que alguém execute aggrega pull tornaria os comandos de comunicação inutilizáveis precisamente no momento em que são mais úteis. aggrega build não produz artefactos sem nenhum ficheiro de bloqueio, pelo que a compilação só encontra este aviso para um plugin para o qual o seu ficheiro de bloqueio não regista digest — sendo o caso comum um lido de junto da sua entidade num diretório do catálogo.
Onde a falta de um ficheiro de bloqueio provoca antes 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 ficheiro de bloqueio, o serviço para e pede um em vez de desenhar um grafo. Um ficheiro de bloqueio que existe e simplesmente não regista digest para um plugin é, em vez disso, o caso acima: o plugin é executado, e este aviso é a forma de o saber. Um grafo desenhado é aquilo sobre que um leitor raciocina depois, e um construído a partir de bytes não verificados teria exatamente o mesmo aspeto de um verificado. Ver aggrega serve.
A published archive carries an entry Windows cannot use (Um arquivo publicado traz uma entrada que o Windows não consegue usar)
É acionado quando aggrega push — ou o seu --dry-run — publica um arquivo em que uma das entradas contém uma parte que o Windows não consegue conter tal 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 se siga, ou uma parte que termina num ponto final ou num espaço. aux/x.yaml contém uma no seu diretório; report. e COM1.yaml contêm uma no seu nome de ficheiro. No Windows, aggrega recusa-se a extrair uma entrada destas, pelo que um espaço de trabalho no Windows não consegue de todo usar a versão. O aviso é acionado em todas as plataformas, porque uma publicação se destina a quem quer que faça pull dela, e é a forma de o seu autor o saber antes que alguém no Windows o descubra.
O que lê. Os nomes que o arquivo conterá: o próprio nome de ficheiro do documento da entidade e, depois, cada ficheiro que a entidade nomeia ao lado dele — os ficheiros que Empacotamento lista. Assim, um documento chamado con.yaml que importa um ficheiro de esquema provoca o aviso pelo seu próprio nome. Uma entidade que não nomeia nada é publicada apenas como o seu documento, que um consumidor dispõe sob um nome escolhido pelo produto e não sob aquele que escreveu, pelo que nunca recebe aviso, seja qual for o nome do seu ficheiro. Um Plugin não publica nenhum arquivo e também nunca recebe aviso.
Formato emitido. Uma linha por entrada, na saída de erros standard, pela ordem em que os nomes são compostos — primeiro o documento, depois os ficheiros que transporta por ordem lexical — antes do relato próprio da execução de teste ou da publicação na saída standard:
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 tal como o arquivo a nomeia. O segundo é o primeiro dos seus segmentos — as partes que as suas barras separam — que o Windows não consegue conter, que é a parte a mudar de nome. A linha começa com a frase fixa da condição. É emitida pela publicação e não por uma regra que uma compilação avalie, pelo que não tem linha na tabela no topo desta página; a tabela de todas as condições lista-a sob E0344.
Não recusa nada. O push, ou a sua execução de teste, prossegue ou é recusado exatamente como seria sem o aviso, e termina como teria terminado.
Onde mais 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. Ver aggrega mcp e aggrega serve. O serviço também passa a própria linha de aviso a um pedido que pediu para ser informado, juntamente com o resto do relato da publicação.
Visibilidade no editor. Nenhuma como diagnóstico: publicar não é uma compilação, pelo que nada aqui chega a uma lista de problemas. Um editor que publica através do serviço lê windowsUnusableEntries na resposta.
Porque um aviso e não uma interrupção. Um nome destes é legal, e o Linux e o macOS usam o ficheiro tal como está nomeado, pelo que recusar a publicação recusaria uma entidade que funciona com base num palpite sobre quem fará pull dela. Mudar o nome ou não é decisão do autor.