aggrega validate
aggrega validate verifica a correção — esquema, estrutura de pilares, resolução de referências entre documentos, cadeias extends, capacidade de tipo de entrada do fornecedor e (para uma entidade que renderiza) que esta efetivamente renderiza. Tem três modos, selecionados pelo seu argumento, que aplicam a mesma disciplina de correção em três âmbitos: o catálogo inteiro (sem argumento), o fecho de dependências de uma Release (--release) e um ficheiro de entidade (um caminho de entidade). Cada âmbito responde à mesma pergunta — «este conteúdo está correto?» — sobre uma fatia diferente do catálogo.
A correção é distinta das convenções. aggrega validate pergunta se o conteúdo está bem formado e se compilaria; aggrega lint pergunta se o conteúdo segue a disciplina de publicação do catálogo (nomenclatura, alinhamento com os diretórios de categoria, dimensão do incremento de versão, e o resto). Os dois comandos espelham os três âmbitos um do outro, para que seja possível verificar qualquer uma das dimensões com a granularidade de que se precisar.
aggrega validate não escreve nada em disco e não lê nenhum estado de execução. Executa a mesma resolução e validação que uma compilação executa, parando antes da renderização (ou, para uma única entidade, isolando-a).
Um caminho de entidade pode ser dado posicionalmente. --release dado ao lado de um caminho de entidade não seleciona o âmbito da Release: a entidade continua a ser verificada isoladamente, nos termos dessa Release — consulte Verificar uma entidade nos termos de uma Release.
Correção do catálogo inteiro (sem argumento)
aggrega validate sem argumento carrega todas as entidades de catálogo nos diretórios de catálogo configurados e verifica-as de ponta a ponta. Antes de carregar o que quer que seja, lê todos os ficheiros YAML nesses diretórios, e um documento Aggrega entre eles que não consiga carregar interrompe a execução, como descrito abaixo. Depois:
- Estrutura dos pilares de esquema — o bloco
spec.schema:de cada Component e de cada Feature é expandido e validado (a mesma verificação de pilares de esquema que a compilação aplica), incluindo a expansão da forma compacta. - Resolução de referências entre documentos — as referências
$refe$importpara entradas de SchemaLibrary resolvem, e uma SchemaLibrary que não pode ser resolvida ou que é inválida por outro motivo é rejeitada. - Cadeias
extends— cada entidade que declaraextendsé resolvida face ao seu pai, e a forma combinada pai+filho é verificada. Um pai que os diretórios de catálogo não contêm é lido onde um build o lê: a partir da cache de artefactos, sob a fixação que o lockfile de uma Release regista para ele — os lockfiles das Releases para as quais a passagem é executada, ou de cada Release que o espaço de trabalho contém, quando este é validado numa única passagem. Assim, uma base publicada num registry é validada assim queaggrega pulla tiver obtido e fixado, e um pai que nenhum dos dois contém interrompe a execução, indicandoaggrega pull --release <release>. Nada é obtido. - Seletores declarados — cada seletor de etiquetas que um documento de Component ou Feature declara num socket de dependência em
spec.usesSchema, ou num slot de anexo emspec.featuresSchema— incluindo, num Component, os slots que um socket declara — é lido face à gramática de seletores, quer algo ligue ou não o socket ou preencha o slot. Consulte seletores declarados. - Colisões de localização OCI — duas identidades de catálogo distintas que publicariam na mesma localização do registo são rejeitadas ruidosamente, para que uma compilação nunca substitua silenciosamente os bytes publicados de uma entidade pelos de outra.
- Capacidade de tipo de entrada do Provider — uma Recipe ou FeatureRecipe que declara um bloco
workload:associado a um fornecedor que não consegue sintetizar é assinalada como erro, porque nunca pode ser construída.
Esta é a contraparte, ao nível de todo o catálogo, da validação por Release de uma compilação — o local onde uma entidade de catálogo danificada deve aparecer, antes que qualquer Release chegue a ela. Para ruidosamente num documento Aggrega que não consegue carregar, e em qualquer violação de pilar de esquema, biblioteca irresolúvel ou inválida, falha de resolução de extends, seletor declarado que a gramática recusa, colisão de localização ou erro de capacidade de tipo de entrada. As constatações de sobreposição de pilares de esquema e de estreitamento em extensão, bem como cada palavra-chave x-aggrega-* que um Component ou uma Feature escreve inline no conteúdo do seu esquema, são linhas notice: informativas que nunca alteram o código de saída.
Um documento Aggrega que não pode ser carregado interrompe a execução. Um ficheiro YAML num diretório de catálogo é um documento Aggrega quando uma das suas linhas começa, sem indentação, com apiVersion: e um valor iniciado por aggrega.ai/, entre aspas ou não. Um documento destes que não pode ser lido, cujo YAML não é analisável, ou cujo kind ou metadata não tem a forma que o envelope de uma entidade assume — um metadata escrito como lista, por exemplo — interrompe a execução com E0175 depois de lidos os diretórios, nomeando cada um desses ficheiros com o motivo indicado pela leitura ou pelo parser; nada é verificado e nenhuma linha catalog validation passed é impressa. Um documento que é carregado e declara um kind que nenhum catálogo contém — um Componnent mal escrito, por exemplo, ou nenhum kind — interrompe a mesma execução com E0371, sendo nomeado ao lado daqueles com o tipo que declara; um Manifest, uma Release e um Workload que uma Recipe importa do seu próprio diretório são ignorados. Qualquer outro YAML — os templates de um chart Helm, que só são analisáveis depois de renderizados, os valores de um chart, as definições de workflow — é ignorado.
Os diretórios que lê dependem da forma do espaço de trabalho:
-
Um espaço de trabalho cuja configuração não dá a nenhuma Release diretórios de catálogo próprios é validado uma vez, sobre a sua pilha de pesquisa: os diretórios
--catalog, depoisworkspace.catalog_dirs, depois o diretóriocatalogna raiz do espaço de trabalho, quando existe. -
Um espaço de trabalho que nomeia Releases em
workspace.releasespode manter um catálogo em várias variantes lado a lado, cada uma lida pela sua própria Release, e carregá-las todas de uma vez poria todas as variantes num único catálogo, com a entidade de uma variante a sombrear a de outra. Por isso, é validado uma vez para cada Release que o espaço de trabalho contém, sobre os diretórios que essa Release lê, com os diretórios--catalogem primeiro lugar em cada passagem; uma Release que a configuração não nomeia lê a lista do espaço de trabalho. Cada passagem é reportada sob uma linha que nomeia a sua Release e os diretórios que leu, seguida do resultado dessa passagem:Release release-compose.yaml reads catalog-composecatalog validation passed (schema-pillar + library + extends + oci-location)Release release-helm-synth.yaml reads catalog-helm-synthcatalog validation passed (schema-pillar + library + extends + oci-location)As Releases que leem exatamente os mesmos diretórios partilham uma passagem, que nomeia cada uma delas. Uma Release que não lê nenhum diretório — a sua entrada escreve
catalog_dirs: []— é reportada como não tendo nada para verificar, e as outras passagens correm normalmente. Todas as passagens são reportadas independentemente do que uma anterior tenha encontrado, uma vez que uma entidade danificada numa variante nada diz sobre outra, e o comando falha quando qualquer passagem falha, nomeando as Releases cujos diretórios falharam. As Releases que um espaço de trabalho contém são os seus documentos Release — ficheiros YAML cujokindéRelease, em qualquer lugar sob a raiz do espaço de trabalho, fora de diretórios ocultos e denode_modules,vendoredist.
Uma execução sem nada para ler em nenhuma passagem é recusada em vez de ser reportada como um catálogo limpo: coloque as entidades em catalog/, passe --catalog ou defina workspace.catalog_dirs — ou, num espaço de trabalho que nomeia Releases, os catalog_dirs próprios de uma Release em workspace.releases. Nunca enumera implicitamente o diretório de trabalho atual, pelo que nunca inclui árvores não relacionadas.
A ferramenta validate de aggrega mcp, quando questionada sobre o catálogo inteiro, valida as mesmas passagens; num espaço de trabalho que nomeia Releases, a sua resposta transporta cada uma em passes — as Releases, os diretórios lidos e o veredicto próprio dessa passagem — ao lado do veredicto sobre todas elas.
Uma biblioteca que só a cache de artefactos contém
A cache de artefactos contém aquilo que uma obtenção lá colocou, e uma SchemaLibrary em cache só conta como conteúdo de catálogo quando uma entrada no lockfile de uma Release garante o seu digest — consulte O que a cache é, e o que não é. Quando um $ref: não se resolve em nada enquanto a cache contém uma biblioteca que nenhuma entrada de lockfile fixa e que nenhum diretório de catálogo lido pela verificação fornece, o relatório é seguido de uma linha remediation: que nomeia cada uma dessas bibliotecas e a ação que resulta para o âmbito que falhou:
- Sem argumento, e com um caminho de entidade, seja ou não dado
--release, validate lê bibliotecas apenas dos diretórios de catálogo, nunca através de uma entrada de lockfile, pelo que uma entrada registada não alteraria o seu veredicto. A linha di-lo e aponta para a escrita da biblioteca num diretório de catálogo, ou paraaggrega pull --release <release>seguido deaggrega validate --release <release>, que verifica a Release face às bibliotecas que o seu lockfile fixa. - Apenas com
--release, validate lê o lockfile da Release, pelo que a linha nomeiaaggrega pull --release <release>, que resolve a biblioteca e regista a sua entrada, ou a escrita da biblioteca num diretório de catálogo.
A linha não altera nem o veredicto nem o código de saída.
Seletores declarados
Um Component ou uma Feature restringe o que pode ser ligado aos seus sockets de dependência, e o que pode preencher os seus slots de anexo, com seletores de etiquetas — o selector: de cada entrada de spec.usesSchema e de cada entrada de spec.featuresSchema, e, num Component, o selector: de cada slot que um socket declara no seu próprio featuresSchema. Um build só lê um seletor onde algo o alcança: uma aresta traçada através do socket, um anexo que preenche o slot. Por isso, o âmbito de todo o catálogo e o âmbito de entidade única leem todos os seletores que um documento de Component ou Feature declara, quer algo ligue ou não o socket ou preencha o slot, e um seletor que a gramática recusa — uma lista de valores sem o parêntese de fecho, uma vírgula duplicada, uma chave que contém = ou ! — faz falhar a verificação. A gramática é a que é ensinada em a gramática de cadeias.
A recusa é a que um build reporta quando alcança o mesmo seletor, com o mesmo código e nas mesmas palavras: E0007 para o seletor de um socket e E0008 para o de um slot, indicando o seletor, o socket ou slot que o declara e porque é que a gramática não o conseguiu ler. É registada como falha de catálogo no ficheiro da entidade:
selector violation (
"<selector>", declared on socket"<socket>", which could not be evaluated:"<why it could not be read>"). Correct the selector on the socket’s declaration in the component type’s usesSchema. (violação de seletor: o seletor declarado no socket não pôde ser avaliado. Corrija o seletor na declaração do socket no usesSchema do tipo de componente.)
Cada documento é lido tal como o seu autor o escreveu, pelo que um seletor que uma entidade base declara é reportado uma vez, no próprio ficheiro da base, em vez de uma vez por cada entidade que a estende. Os appliesTo e appliesToAnyOf de uma Feature não são lidos aqui: são lidos sempre que um anexo da Feature é avaliado.
O âmbito de todo o catálogo reporta cada seletor recusado na sua própria linha selector: e falha com a contagem deles; o âmbito de entidade única reporta-os como falha do seu nível de forma — com ou sem --release ao lado do caminho da entidade, uma vez que essa forma é o âmbito de entidade única executado nos termos de uma Release (consulte verificar uma entidade nos termos de uma Release). --release isoladamente, que valida o fecho de dependências de uma Release, e um build só leem um seletor onde uma aresta ou um preenchimento o alcança, e param nele aí.
Correção no âmbito de uma Release (--release)
aggrega validate --release <release-path> valida exatamente as entidades que as dependências resolvidas de uma única Release alcançam, em vez do catálogo inteiro ou de uma entidade. Calcula o fecho através do mesmo mecanismo que uma compilação usa, pelo que as entidades que verifica são exatamente as entidades que uma compilação dessa Release resolveria, e, sobre esse fecho:
- resolve as cadeias
extendsno âmbito do fecho, falhando num erro de resolução; - valida os pilares de esquema de cada entidade resolvida (no âmbito do fecho), falhando num erro de pilar de esquema;
- executa a mesma conformidade de valores pré-renderização que uma compilação executa — resolve os parâmetros da Release nos valores de autoria (para que um valor
{{ .parameters.* }}seja verificado já resolvido e não como template) e valida o resultado em relação aos esquemas compostos do fecho, incluindo a conformidade com o esquema composto pai+filho para uma entidade que usaextends. Um valor que viola o seu esquema falha com um código de saída diferente de zero; - avalia cada asserção de Recipe e de FeatureRecipe face aos valores em que a Release se resolve, tal como uma compilação as avalia antes de renderizar: a Recipe de cada componente é associada tal como o Manifest a mapeia, os seus
localseprovidessão resolvidos, e a primeira asserção que falha — uma que chamafail, ou uma cujo template para numa chave que não encontra — faz falhar a validação com a condição e a frase com que uma compilação para. Um templatelocalsouprovidesque não pode ser avaliado também a faz falhar, tal como faz falhar uma compilação. Ao provider através do qual cada Recipe renderiza é pedido o nome que dá aos recursos desse componente, tal como uma compilação o pede, porque osprovidesde uma Recipe podem ler esse nome; nada é renderizado. Estas asserções só são avaliadas quando nada do que está acima já falhou, pelo que uma Release reporta a falha mais precoce em que uma compilação pararia; - apresenta as constatações de sobreposição de pilares de esquema e de estreitamento em extensão como linhas
notice:informativas que nunca alteram o código de saída; - mostra cada palavra-chave
x-aggrega-*que uma entidade que lê escreve inline no conteúdo do seu esquema como uma linhawarning:, uma vez por entidade, tal como uma compilação a mostra — também isto nunca altera o código de saída.
Isto faz de --release uma verdadeira verificação pré-compilação: deteta o que uma compilação rejeitaria, antes da compilação — a validação de dependências da compilação sem a renderização. Não executa nenhuma renderização nem desencadeia nenhum pull de rede: o fecho resolve a partir do catálogo local (e das fixações do lockfile da Release, quando presente); um conjunto de dependências fixado num registo que precisa de um lockfile apresenta um erro honesto de referência irresolúvel em vez de ir obter os dados. O estreitamento é apresentado como conselho, nunca imposto.
Um lockfile que já não corresponde àquilo para que a Release resolve recusa a validação com a paragem que aggrega build imprime. Quando há um lockfile ao lado da Release, --release confronta-o com aquilo para que a Release resolve, com a comparação de desvio que um build executa antes de renderizar, assim que as dependências da Release se resolvem e antes de qualquer verificação acima ser executada. Um lockfile do qual uma entidade fixada, uma biblioteca, um plugin ou o próprio ficheiro da Release se desviou interrompe a validação com a recusa E0130 do build — cada entrada que se desviou e, depois, o aggrega pull --release <release> que a resolve — e um código de saída diferente de zero, pelo que uma validação nunca deixa passar um lockfile que o build recusa por desvio. Sem argumento, e com um caminho de entidade, validate não fica sujeito a nenhum lockfile: a verificação do catálogo completo lê as fixações do lockfile apenas para encontrar um pai de extends, e a verificação de uma única entidade não lê nenhum lockfile.
Como executa as mesmas verificações que uma compilação executa, executa também os mesmos plugins de barreira anexados — pelo que está sujeito ao mesmo registo de identidades de plugins de confiança a que uma compilação está sujeita. Um espaço de trabalho que anexa um plugin que devolve um veredicto de aceitação ou rejeição tem um registo de confiança de plugins ao lado da sua Release, e --release compara a configuração com ele antes de qualquer um desses plugins correr: uma barreira registada que a configuração já não anexa interrompe a validação, e um plugin resolvido a partir da cache que aggrega pull preenche cujo artefacto não é o registado é recusado em vez de executado. Um espaço de trabalho que não registou nada não tem registo, o que nada altera nessa comparação. --release nomeia também cada retirada registada contra aquilo de que a Release depende, no erro padrão, como uma linha deprecation: nas palavras que aggrega build imprime: tanto um marcador que o lockfile regista contra uma referência fixada como um que o registo de confiança regista contra um plugin anexado num papel de veredicto. Uma retirada não altera nem o veredicto nem o código de saída, e um registo de confiança que existe e não pode ser lido interrompe a validação em vez de passar por um que não regista nada.
Um plugin lido da cache também está sujeito à assinatura que a sua entrada regista, tal como uma compilação o sujeita, no momento em que é carregado. Quando a sua entrada regista uma assinatura verificada, o material de assinatura que esse facto nomeia na cache é verificado novamente, e um plugin cujo material falta ou difere é recusado — tal como um cujo material foi feito para um plugin diferente daquele que foi lido, que é o aspeto de uma signature copiada de outra entrada, diga o requisito de assinatura o que disser. Quando a configuração de confiança do espaço de trabalho exige uma assinatura, um plugin lido da cache cuja entrada não regista nenhuma — ou para o qual o registo não contém nenhuma entrada, incluindo um registo eliminado — também é recusado, sob as mesmas definições que levariam aggrega pull a recusá-lo sem assinatura, pelo que skip_signature_verification e um registo advisory o deixam correr. Uma recusa faz falhar a validação e é reportada entre os seus diagnósticos, nomeando o plugin e aggrega pull --release <release>, o comando que verifica a sua assinatura no seu registo, a regista e coloca em cache o pacote que ela nomeia, reescrevendo uma cópia em cache que já não corresponda ao seu digest; um plugin servido a partir de um dos seus diretórios de catálogo, ou da cópia dentro do binário do compilador, nunca está sujeito ao requisito. Os outros dois âmbitos não estão sujeitos a nada disto: não leem os anexos de plugins do espaço de trabalho, pelo que nenhum desses plugins corre neles.
O mesmo se aplica aos plugins que alteram o grafo em vez de o julgarem. Um anexo label-transform ou annotation-transform molda o que seria a saída renderizada, pelo que o lockfile fixa tanto a sua identidade como os ficheiros de origem que lê — e --release executa esses anexos da forma como uma compilação os executa: reconstruídos a partir do lockfile, sujeitando cada um ao seu digest registado e lendo o conteúdo de origem que o lockfile transporta em vez do ficheiro em disco. Há duas consequências que vale a pena conhecer antes de as encontrar:
- Anexar um plugin de transformação em
.aggrega-config.yamlnão altera o que--releasefaz até se fazer pull. Esta é a mesma regra que uma compilação segue, e pela mesma razão: o conjunto de anexos é uma entrada que determina os bytes, pelo que é adotado no pull e não no momento em que é editado. - Um plugin em cache cujos bytes já não correspondem ao digest que o lockfile registou é recusado, exatamente como seria durante uma compilação.
Se a Release não tiver lockfile, --release valida na mesma — avisa que não conseguiu verificar a identidade de um plugin e indica o que executar, em vez de recusar. Consulte avisos.
Devolver o grafo compilado
--ir-graph escreve o grafo que esta validação resolveu na saída padrão como JSON, antes da linha do veredicto. É aditivo: correm as mesmas verificações, são escritos os mesmos diagnósticos e o código de saída é o mesmo que sem ele. O grafo devolvido é aquele sobre o qual a validação foi efetuada, pelo que não pode descrever uma resolução diferente daquela sobre a qual o veredicto informa.
Aplica-se apenas a este âmbito — os âmbitos de catálogo inteiro e de entidade única conduzem uma estrutura de teste sintetizada em vez de uma Release, e não resolvem nenhum grafo — e pedi-lo noutro âmbito é recusado em vez de silenciosamente ignorado. Se a execução parar antes de o grafo ser resolvido, nada é escrito na saída padrão e os próprios diagnósticos do comando indicam o que a parou.
Repare na flag ao lado. --response-format define quanto do relatório próprio deste comando é escrito (detailed ou concise); --ir-graph pede um segundo documento ao lado desse relatório. Um é volume, o outro é assunto, e nenhum altera o veredicto.
Os valores que um autor declarou sensíveis são ocultados do grafo — incluindo os values e o infra de uma ligação, quando o socket do componente consumidor declara uma folha como sensível —, na forma estruturada descrita em aggrega inspect. --unredacted ao lado de --ir-graph imprime-os em vez disso, nos termos que aggrega inspect --unredacted indica: chega ao grafo e a nada mais do que este comando escreve, e tudo aquilo a que a saída chega passa então a transportar esses valores em claro. Passado sem --ir-graph, é recusado, porque não haveria nada para revelar.
Correção de uma única entidade (um caminho de entidade)
aggrega validate <entity-path> verifica um ficheiro de entidade de catálogo. Aplica um conjunto de verificações por níveis, parando na primeira falha bloqueante, para que uma quebra de esquema apareça ruidosamente antes de qualquer trabalho de catálogo:
- Marcadores de posição (todos os tipos) — um valor que o tipo exige e que o ficheiro deixa como cadeia vazia. Todos são reportados de uma só vez, antes das outras verificações, cada um com aquilo que aceita; consulte marcadores de posição ainda em falta.
- Envelope de esquema (todos os tipos) — a verificação exata de JSON Schema por entidade que o carregador do catálogo executa em cada fronteira de análise.
- Forma (todos os tipos) — a validação estrutural específica do tipo. Para um Component ou uma Feature, isto inclui ler cada seletor de etiquetas que o ficheiro declara num socket de dependência ou num slot de anexo face à gramática de seletores; consulte seletores declarados.
- Estrutura de pilares (Component e Feature) — a verificação de pilares
spec.schema:, usando as SchemaLibraries do catálogo para a expansão de$refentre documentos.
Um Component ou Feature fica por aí: envelope de esquema, forma e estrutura de pilares. Um Component isolado não tem values nem infra de autoria para renderizar isoladamente, pelo que não há nada para renderizar — a sua correção é totalmente coberta pelos níveis de esquema e de pilares. Cada palavra-chave x-aggrega-* que o conteúdo do seu esquema escreve inline é reportada entre as notas informativas no erro padrão como uma linha warning: que nomeia a palavra-chave, onde se encontra e a tabela declarativa a escrever em seu lugar; nunca altera o veredicto nem o código de saída.
Uma Recipe é, além disso, renderizada isoladamente. Esta é uma faceta da correção de uma única entidade, não o seu ponto principal: depois de os níveis de esquema e de forma passarem, validate resolve o Component de implements da Recipe a partir do catálogo, sintetiza um Aggregate, um Manifest e uma Release mínimos em torno de uma única instância desse Component associada à Recipe em teste, e conduz o verdadeiro pipeline de compilação sobre eles — primeiro a resolução e as guardas (com a renderização ignorada), depois uma renderização real da saída isolada. Cada valor obrigatório e cada campo de infra obrigatório sem predefinição é preenchido com um marcador de posição do seu tipo declarado — os valores no Aggregate sintetizado, a infra na Release sintetizada — e todos os outros valores e campos de infra recebem a predefinição do seu esquema através do resolvedor; a Release encaminha a instância para uma fronteira predefinida sintetizada e não declara nenhum values: nem nenhuma computação que o Aggregate não tenha declarado. Um marcador de posição é um valor que as restrições declaradas do próprio campo aceitam: a constante ou o primeiro valor que um enum enumera, um número dentro dos seus limites, uma cadeia com o seu comprimento e no seu format, uma versão semântica quando o seu pattern pede uma, tantos itens de lista quantos exige, e todas as propriedades que um objeto exige. Qualquer outro pattern, uma condição validate: ou when:, uma composição de esquemas e uma restrição sobre que itens uma lista contém não são consultados, pelo que um campo que dependa de um deles pode ainda assim recusar o seu marcador de posição; validate reporta então essa recusa nas palavras do próprio esquema. Os artefactos renderizados são impressos para que um autor veja a saída isolada antes de ligar a entidade a um Aggregate completo. Como uma estrutura de teste de entidade única preenche apenas esses campos obrigatórios, não estabelece nenhuma ligação e não anexa nenhuma Feature, uma Recipe cujos templates leem um valor que apenas uma ligação ou uma Feature anexada fornece não pode ser renderizada isoladamente; validate reporta essa renderização como não tentada e não como falhada. Uma asserção que chama fail é reportada como aviso em vez de fazer falhar a verificação — consulte uma asserção falhada é um aviso. Uma renderização que para por qualquer outro motivo não foi concluída, e validate reporta-a com o diagnóstico de renderização subjacente até à frase que nomeia o que a parou.
Uma Recipe cuja source: tem de ser obtida não é de todo renderizada, e uma Recipe cuja renderização para enquanto lê um valor que apenas uma ligação ou uma Feature anexada fornece vê essa renderização posta de parte — consulte o que a correção de uma única entidade não verifica abaixo.
Uma FeatureRecipe é verificada quanto ao esquema e à forma; a sua renderização é ignorada, porque uma FeatureRecipe só é renderizada quando anexada a um componente anfitrião, e não se tenta sintetizar um anfitrião que passe as guardas para uma Feature arbitrária.
Verificar uma entidade nos termos de uma Release
Um espaço de trabalho pode dar a cada Release diretórios de catálogo próprios — consulte Dar a uma Release os seus próprios diretórios de catálogo — e assim manter uma variante de catálogo por Release lado a lado. Um caminho de entidade dado isoladamente é verificado sobre os diretórios de catálogo do próprio espaço de trabalho, onde uma referência para uma dessas variantes — o Component que uma Recipe implementa, uma SchemaLibrary a que um pilar se refere — não é encontrada. Dê --release ao lado do caminho de entidade e as mesmas verificações correm nos termos dessa Release: as referências da entidade resolvem através dos diretórios de catálogo que a configuração do espaço de trabalho dá a essa Release, com qualquer --catalog acrescentado à frente, que são os diretórios que uma compilação dessa Release lê.
O exemplo MariaDB + Adminer mantém quatro dessas variantes. O Component da sua variante synth obtém as suas definições de armazenamento de uma SchemaLibrary que apenas as variantes synth e chart contêm, pelo que é validado nos termos da Release que compila com ele:
$ aggrega validate catalog-helm-synth/component/mariadb.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/component/mariadb.yamlKind: ComponentSchema: validPillars: valide falha, nomeando a biblioteca que não conseguiu resolver, nos termos de uma Release cujos diretórios não a contêm — --release release-compose.yaml, ou nenhum --release num espaço de trabalho que não enumera diretórios de catálogo próprios.
Uma Recipe é verificada da mesma forma. A Recipe da variante synth implementa core/datastore/mariadb, que os diretórios de catálogo do próprio espaço de trabalho não contêm, pelo que, dada isoladamente, falha com render: implements target "core/datastore/mariadb" not found in catalog. Dada a Release que compila com ela, resolve o Component dessa Release e é renderizada isoladamente:
$ aggrega validate catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yaml --release release-helm-synth.yamlEntity: catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: 3 artifact(s)seguido dos três artefactos renderizados. Todas as variantes desse exemplo declaram core/datastore/mariadb, pelo que a Recipe é validada nos termos de cada uma das suas quatro Releases; nos termos de uma Release cujos diretórios de catálogo não contêm tal Component, falha nomeando o destino, tal como acontece sem --release. As linhas Attachments: são explicadas em um slot de anexo obrigatório ou um mandato de presença.
Continua a ser o âmbito de entidade única. As verificações, o relatório e o código de saída são os que esta secção descreve — um Component ou uma Feature com um seletor de socket ou de slot que a gramática recusa falha aqui exatamente como falha sem --release, consulte seletores declarados — e nenhum fecho é validado: --release nomeia a Release através de cujos diretórios de catálogo as referências da entidade são lidas, não um fecho a verificar, e é por isso que --ir-graph é recusado ao lado de um caminho de entidade. Um --release que nomeia um ficheiro que não existe, ou que nomeia um diretório, é recusado antes de qualquer verificação.
Um diretório que a configuração do espaço de trabalho enumera e que não é um diretório — porque nada existe nesse local, por exemplo —, para essa Release, ou para o espaço de trabalho quando não é dado nenhum --release, é recusado antes de qualquer verificação, tal como todos os comandos que leem esse catálogo o recusam (De onde são lidas as entidades locais): a recusa nomeia a entrada, o ficheiro de configuração e a linha que a enumeram e a definição, e não é dado nenhum veredicto. A verificação de entidades do editor através de aggrega serve dá a mesma recusa como a única entrada no ficheiro da entidade, no nível de erro, e a ferramenta validate de aggrega mcp recusa a chamada com ela.
Marcadores de posição ainda em falta
Um valor que o tipo exige e que o ficheiro deixa como cadeia vazia é um marcador de posição, e validate reporta-o antes de tudo o resto. Um documento esboçado por aggrega scaffold contém um sempre que o seu tipo precisa de um valor que só o autor pode fornecer, pelo que é aqui que se fica a saber quais faltam. Eis uma FeatureRecipe esboçada com apenas a versão preenchida:
Entity: my-feature-recipe.yamlKind: FeatureRecipe2 placeholders still owed in my-feature-recipe.yaml; an empty required value is not a value, so each of these needs one before the document validates: 7:3: spec.capability takes what its schema describes: The explicit provider capability this recipe binds to (e.g., 'helm', 'terraform', 'compose') — the provider kind that renders it. 8:3: spec.implements takes what its schema describes: Declares which catalog Feature type this recipe is able to implement (including credential Features labeled feature.aggrega.ai/kind: secret; exact version, major-compatible range '^', or unversioned).Todos os marcadores de posição do ficheiro são nomeados de uma só vez, pela ordem do documento, com a sua linha e coluna e com aquilo que aceitam. Aquilo que aceitam é lido do próprio esquema do tipo: os valores que aceita, quando o esquema os enumera, uma versão semântica como 1.0.0, quando o esquema pede uma, e, caso contrário, a primeira frase da descrição do campo no próprio esquema.
Os valores que contam também são lidos do esquema. Um valor conta quando o tipo o exige no topo do documento, ou dentro de um objeto que o tipo também exige, e o ficheiro o define como cadeia vazia. Uma chave que o ficheiro omite por completo é reportada pela verificação de esquema como propriedade em falta. Um campo opcional deixado vazio não é um marcador de posição, nem o é um campo obrigatório apenas dentro de uma lista ou de um mapa que se tenha optado por escrever. Quando o próprio esquema enumera a cadeia vazia entre os valores que um campo aceita, um campo vazio é um valor e não um marcador de posição.
Um valor está em falta mesmo quando o esquema o aceitaria vazio. O esquema admite uma cadeia vazia para capability e implements de uma Recipe ou de uma FeatureRecipe, mas uma cadeia vazia não nomeia nenhum fornecedor nem nenhum tipo, pelo que validate reporta ambos como marcadores de posição como quaisquer outros. Quando a verificação de esquema também recusa o mesmo ficheiro — uma versão vazia, uma etiqueta de tipo sem valor —, o relatório transporta o código dessa verificação, E0215, como mostra o exemplo em aggrega scaffold; quando a verificação de esquema o aceita, como acima, o relatório não transporta nenhum código. Uma constatação no mesmo ficheiro que não diga respeito a um valor vazio continua a ser reportada, nas palavras da própria verificação de esquema, antes da lista.
Esta leitura pertence à validação de uma única entidade, com ou sem --release ao lado do caminho de entidade. Uma execução de catálogo inteiro que encontre o mesmo documento reporta o que a verificação de esquema reporta, pelo que uma FeatureRecipe com um implements vazio dentro de um diretório de catálogo passa nela; o âmbito da Release e aggrega build também não aplicam esta leitura.
Um tipo que este âmbito não aceita
A validação de uma única entidade aceita Component, Feature, Recipe, FeatureRecipe, Workload e Plugin. Um ficheiro de qualquer outro tipo é recusado, e a recusa nomeia os tipos que aceita e, para um tipo de entidade, o âmbito que verifica efetivamente um documento desse tipo:
kind "Aggregate" in "aggregate.yaml" is not a single-entity validation target; the kinds this scope accepts are Component, Feature, Recipe, FeatureRecipe, Workload and Plugin. An Aggregate is checked by the whole-catalog scope when it sits in a catalog directory, and by the Release scope over a Release that deploys itO âmbito de catálogo inteiro é uma execução sem argumento, e o âmbito da Release é --release sem caminho de entidade:
| Tipo | Verificado por |
|---|---|
| Aggregate | uma execução de catálogo inteiro, quando está num diretório de catálogo; --release sobre uma Release que o implanta |
| Manifest | --release sobre uma Release que o nomeia |
| Release | --release <release-path> |
| SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary | uma execução de catálogo inteiro, quando está num diretório de catálogo |
Uma execução de catálogo inteiro lê apenas o que está dentro dos diretórios de catálogo configurados, pelo que um Aggregate mantido na raiz do espaço de trabalho ao lado da sua Release é verificado através de --release sobre essa Release.
Uma asserção falhada é um aviso
Uma asserção que chama fail — uma que a Recipe declara, ou uma que o Component de implements dela declara — é reportada como aviso, e a verificação não falha por causa dela. A Release sintetizada transporta marcadores de posição e predefinições de esquema em vez dos valores que uma Release real define, pelo que uma asserção sobre um desses valores, uma imagem ou a presença de um pré-requisito, falha aqui quer a Recipe esteja correta quer não, e validate não consegue distinguir uma asserção à espera de uma Release de uma que está danificada. O veredicto sobre a asserção fica a cargo de uma compilação, que tem sempre uma Release.
O aviso é escrito no erro padrão, iniciado por warning:, depois de quaisquer notas informativas. Transporta a mensagem completa da asserção — a entidade, a instância, o nome da asserção e a frase que o seu autor escreveu — rematada por mais uma frase:
A Release must satisfy this assertion before a build of it can pass.O relatório na saída padrão indica onde a execução parou, e o comando termina com 0. A asserção própria de uma Recipe para a renderização, pelo que o relatório indica Render: stopped on a failed assertion, reported as a warning depois de Resolution: valid. A asserção de um Component é avaliada antes de qualquer renderização, pelo que o relatório indica Resolution: stopped on a failed assertion, reported as a warning, seguido de Render: not attempted (the run stopped on that assertion). Em qualquer dos casos nada é renderizado, pelo que nenhum artefacto é impresso.
Só uma asserção que chama fail é um aviso. Uma asserção que para numa chave que lê mas não encontra, ou que não é analisável, é uma falha no próprio texto da asserção e não uma asserção falhada, e é julgada como qualquer outra paragem. Todas as outras falhas mantêm o seu lugar como veredicto da verificação.
aggrega build de uma Release que não satisfaz a asserção para nela com um erro, nomeando a asserção e transportando a frase do seu autor, como sempre faz, e aggrega validate --release sobre essa Release falha nela com o mesmo erro. A verificação de entidades do editor através de aggrega serve dá o mesmo aviso, desenhado na própria chave da asserção quando é a Recipe a declará-la, e a ferramenta validate de aggrega mcp responde valid: true com o aviso entre as suas notices.
O que a correção de uma única entidade não verifica
Quatro verificações de uma compilação real estão fora do alcance de uma compilação de uma só entidade, e validate declina cada uma em vez de reportar uma constatação que não pode sustentar.
Uma origem que tem de ser obtida
Validar uma entidade não lê nenhum lockfile, não lê nem escreve nenhuma cache e não faz nenhum pedido de rede. Uma Recipe cuja source: nomeia algo obtido através de um transporte — um repositório de charts OCI ou HTTPS, um repositório Git — não tem, portanto, código de infraestrutura a partir do qual renderizar: o chart ou módulo não existe em nenhum lugar que a execução possa alcançar, e nada no ficheiro a ser verificado está em falta. Validate di-lo, imprime-o como um resultado distinto de uma renderização e termina com 0:
Entity: catalog/recipe/helm/openbao/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validResolution: validRender: not attempted (this Recipe's source is fetched) Validating one entity on its own reads no lockfile, reads and writes no cache, and makes no network request, so the chart or module this Recipe names is never retrieved and there is nothing to render from. To render it, build a Release that deploys a component this Recipe implements.Tudo o que está acima dessa linha foi verificado e é reportado como válido. O que o código de saída significa para uma Recipe destas é, portanto, mais restrito do que para uma que foi renderizada — esquema, forma e resolução estão corretos; a renderização não está comprovada — e o relatório indica qual dos dois se está a ler.
Uma origem que o espaço de trabalho já contém não é declinada. Uma source: ./module relativa não precisa de ser obtida, pelo que a sua renderização é tentada como qualquer outra, e uma falha nela é uma constatação real reportada como Render: not completed in isolation com um código de saída diferente de zero. A linha acima só aparece para uma origem que tem de ser obtida.
Para renderizar de facto uma Recipe com origem obtida, execute aggrega build sobre uma Release que implanta um componente que a Recipe implementa: uma compilação resolve a origem através do lockfile da Release e da cache local, que é o que fornece os bytes que validate não tem forma de obter.
Um socket uses obrigatório
A segunda é se os sockets uses required: true do Component de implements estão preenchidos.
Um socket obrigatório é preenchido ligando uma aresta a outro componente — a partir do próprio bloco uses do Aggregate, ou de uma Release que liga um socket que o Component declara. A estrutura de teste sintetizada contém uma única instância, pelo que não contém nenhum segundo componente que uma aresta destas possa visar, e nenhuma autoria dos documentos sintetizados consegue produzir um: inventar um par significaria inventar computação que a estrutura de teste nunca declarou. Validate nomeia, portanto, os sockets que não verificou e continua pela resolução e pela renderização:
Sockets: required uses sockets not checked (backend, cache, registry) Validating a Recipe on its own places its Component in a build of one, so no other component exists for a required socket to be wired to. Whether each of these sockets is populated is checked when the Component is deployed in an Aggregate.A linha só aparece quando o Component declara pelo menos um socket obrigatório, e nomeia apenas os obrigatórios — um socket opcional nunca é enumerado, porque deixá-lo por ligar não é uma constatação em nenhum âmbito. Uma Recipe cujo Component não declara nenhum socket obrigatório não produz essa linha, e o seu relatório mantém-se inalterado.
A regra em si não é relaxada nem duplicada; é colocada no âmbito que lhe pode responder. aggrega build aplica-a por completo sobre as superfícies de arestas do Aggregate e da Release em conjunto, e para num socket obrigatório que nada liga. Assim, uma Recipe que passa a validação de entidade única continua a ter de satisfazer a regra dos sockets obrigatórios quando o seu Component é implantado, e o relatório di-lo em vez de deixar uma diferença silenciosa entre o que validate verificou e o que uma compilação verificará.
Um slot de anexo obrigatório ou um mandato de presença
A terceira é se os slots de anexo required: true do Component de implements — os pontos de ligação nomeados que o seu featuresSchema declara — estão preenchidos, e se está presente um anexo de cada tipo de Feature que os seus mandatos de presença exigem.
Um slot obrigatório é preenchido anexando uma Feature com esse nome, no Aggregate ou na Release, no componente ou num âmbito acima dele — onde o Component é implantado, não na Recipe. A estrutura de teste sintetizada não anexa nenhuma Feature, pelo que nada do que constrói pode preencher um slot destes. Validate nomeia, portanto, os slots que não verificou e continua pela resolução e pela renderização, exatamente como faz para os sockets obrigatórios:
Attachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.A linha só aparece quando o Component declara pelo menos um slot obrigatório, e nomeia apenas os obrigatórios; uma Recipe cujo Component não declara nenhum não produz essa linha. Só o requisito é posto de parte: a restrição de etiqueta de um slot e os seus mecanismos de entrega permitidos mantêm-se tal como declarados. Um template que não é analisável continua a fazer falhar a execução, tal como uma falha da própria Recipe, como um Workload que o fornecedor não consegue sintetizar — a menos que a Recipe também leia um valor que apenas uma ligação ou uma Feature anexada fornece, como descreve a secção seguinte.
Um mandato de presença — uma anotação features.aggrega.ai/requiredType.<label> no Component, que exige que algum anexo transporte o tipo de Feature que nomeia — é posto de parte pela mesma razão: a estrutura de teste não anexa nada, pelo que nada do que constrói pode transportar o tipo. Validate nomeia cada mandato que não verificou pela sua etiqueta e pelo tipo que exige, e continua pela resolução e pela renderização. O example/compute/service da biblioteca padrão declara um, pelo que a sua Recipe reporta, antes dos seus dois artefactos renderizados:
$ aggrega validate aggrega-catalog/recipe/helm/service/1.0.0/recipe.yaml --catalog aggrega-catalogEntity: aggrega-catalog/recipe/helm/service/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: presence mandates not checked (monitoring: core/prometheus-exporter) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to carry a type the Component requires. Whether an attachment of each of these types is present is checked when a Release that deploys the Component is built.Resolution: validRender: 2 artifact(s)Um mandato cuja declaração não pode ser avaliada — o prefixo da anotação sem nenhuma etiqueta a seguir, ou um valor que não é um tipo de Feature — não é posto de parte: é uma falha do próprio Component, que nenhum anexo repara, e validate faz falhar a execução por causa dela, tal como uma compilação.
Cada regra é colocada onde pode ser respondida. aggrega pull, aggrega build e aggrega validate --release avaliam ambas sobre os anexos reais da Release, e cada um para num slot obrigatório que nada preenche e num tipo exigido que nenhum anexo transporta.
Um valor que apenas uma ligação ou uma Feature anexada fornece
A quarta é se uma Recipe é renderizada assim que as suas ligações e as suas Features anexadas fornecem o que os seus templates leem.
Os templates de uma Recipe leem o que uma ligação entrega em .context.inject e .context.uses, e o que uma Feature anexada entrega em .features. A estrutura de teste sintetizada não estabelece nenhuma ligação e não anexa nenhuma Feature, pelo que todas essas leituras não encontram nada: uma leitura em .context.inject.env encontra um canal de entrega vazio, e um range sobre .context.uses não encontra nenhuma ligação. Validate renderiza primeiro a Recipe, e uma renderização que é concluída é reportada normalmente. Quando a renderização para e os templates da Recipe — incluindo os ficheiros e as entradas de biblioteca que importam — leem qualquer coisa sob esses três, validate reporta a renderização como não tentada, nomeia os valores que a Recipe lê aí, imprime a frase em que a renderização parou e termina com 0. A variante chart do exemplo MariaDB + Adminer lê as credenciais da base de dados a partir do canal de entrega que os seus dois segredos anexados preenchem:
$ aggrega validate catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml --release release-helm-chart.yamlEntity: catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yamlKind: RecipeSchema: validShape: validAttachments: required attachment slots not checked (root_password) Validating a Recipe on its own places its Component in a build that attaches no Feature, so nothing exists to fill a required slot. Whether each of these slots is filled is checked when a Release that deploys the Component is built.Resolution: validRender: not attempted (this Recipe reads values a build of one cannot supply) Validating a Recipe on its own places its Component in a build that wires no connection and attaches no Feature, so nothing supplies what its templates read under .context.inject, .context.uses or .features. Its render stopped, and whether on one of those values or on a fault of its own is not judged here. To render it, build a Release that deploys a component this Recipe implements. Reads: .context.inject.env.MARIADB_PASSWORD, .context.inject.env.MARIADB_ROOT_PASSWORD The render stopped: rendering: [CATALOG_ERROR] instance instance: rendering node "instance": [CATALOG_ERROR] catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml: recipe "mariadb-chart" valuesMapping: [CATALOG_ERROR] valuesMapping[mariadb-chart]: template "valuesMapping[mariadb-chart]" execute: template: valuesMapping[mariadb-chart]:7:30: executing "valuesMapping[mariadb-chart]" at <.context.inject.env.MARIADB_ROOT_PASSWORD>: nil pointer evaluating interface {}.MARIADB_ROOT_PASSWORDUma leitura que não encontra nada e não para nada não é posta de parte: um range sobre .context.uses que não renderiza nada, numa renderização que é concluída, é reportado como a renderização que foi.
O que decide é o que a Recipe lê, não aquilo em que a renderização parou, e isso tem uma consequência que vale a pena conhecer antes de a encontrar: uma falha da própria Recipe numa Recipe que também lê um valor desses — uma chave mal escrita, por exemplo — é reportada como não tentada juntamente com o resto, e não como falha. A linha The render stopped: transporta a frase própria da renderização para que se possa ver qual foi, e uma compilação de uma Release que implanta o Component julga a renderização por completo.
Duas falhas continuam a fazer falhar a execução seja o que for que a Recipe leia, porque nenhuma ligação ou Feature as altera: um template que não é analisável, e uma referência que a renderização recusa — uma raiz que o contexto de renderização não define, ou uma chave mal escrita sob uma raiz cuja forma é fixa, como .context.instance_idd. Uma asserção que a Recipe declara e que chama fail não é posta de parte nem é uma falha, seja o que for que a Recipe leia: é reportada como o aviso que uma asserção falhada sempre é. Uma Recipe cujos templates não leem nenhum dos três tem a sua renderização julgada na íntegra, e uma renderização que para falha com a frase que nomeia a causa.
A ferramenta validate de aggrega mcp dá o mesmo veredicto sobre a mesma Recipe: uma renderização posta de parte desta forma responde como válida sem nada nos seus diagnósticos, e as linhas acima estão no texto que devolve ao lado deles.
O carregamento do catálogo no modo de entidade única é tolerante: uma entidade danificada não relacionada noutro ponto do catálogo é ignorada em vez de abortar a verificação, pelo que nunca impede a validação isolada do alvo.
Um ficheiro ignorado continua a explicar um Component que desaparece por causa dele. Quando o destino implements de uma Recipe não é encontrado e exatamente um ficheiro ignorado declara esse Component, o relatório começa pela recusa desse próprio ficheiro — o seu caminho, a restrição que viola e o código curto da condição no cabeçalho —, seguida de uma note: a indicar que o ficheiro foi ignorado no carregamento, pelo que o catálogo não contém nada sob a identidade que declara, e depois pela falha implements target … not found in catalog como a razão pela qual o ficheiro era necessário. Quando nenhum ficheiro ignorado declara esse Component, ou mais do que um o declara, a falha de não encontrado vem primeiro e todos os ficheiros ignorados são listados abaixo dela sob note: catalog files skipped at load. Este é o relato que aggrega build dá de um ficheiro que ignorou, e a verificação de entidades do editor através de aggrega serve e a ferramenta validate de aggrega mcp também o dão. Um catálogo do qual nada foi ignorado reporta exatamente como reportaria de outro modo.
Como validate se relaciona com lint e build
Os três comandos cobrem três perguntas diferentes:
aggrega validate— isto está correto? Esquema, pilares, referências,extends, capacidade de tipo de entrada e renderização isolada. Não lê nenhum estado de execução e não emite artefactos.aggrega lint— isto segue as convenções de publicação do catálogo? Nomenclatura, alinhamento com os diretórios de categoria, prefixos de anotações, dimensão do incremento de versão e o resto da disciplina de publicação opcional. O lint espelha os três âmbitos de validate, mas nunca verifica a correção.aggrega build— compilar uma implantação completa. A compilação precisa de um fecho completo Aggregate + Manifest + Release e emite artefactos nativos do fornecedor. Valida o seu próprio fecho de dependências como parte da compilação e depois renderiza.aggrega validate --releaseé essa validação de dependências por si só, sem a renderização; o validate de entidade única isola a renderização de uma única Recipe sem um Aggregate completo.
Exemplos
Validar o catálogo inteiro:
aggrega validate --catalog ./catalogValidar exatamente aquilo de que uma Release depende, antes de a compilar:
aggrega validate --release releases/production.yamlValidar uma entidade e — para uma Recipe — ver a sua saída renderizada isoladamente:
aggrega validate core/datastore/postgres/recipes/helm.yamlValidar uma entidade nos termos de uma Release a que a configuração do espaço de trabalho dá diretórios de catálogo próprios:
aggrega validate core/datastore/postgres/recipes/helm.yaml --release releases/production.yamlVer também
- ./aggrega-lint.md — a contraparte das convenções nos mesmos três âmbitos.
- ./aggrega-build.md — compila um Aggregate + Release completo em artefactos; valida o seu fecho de dependências como parte da compilação.
- ./aggrega-inspect.md — consultar o grafo IR após a resolução sem avançar para a renderização.
- ../errors/warnings.md — as constatações informativas que validate apresenta como linhas
notice:.
Sinopse
aggrega validate [entity-path] [flags]Descrição
Check CORRECTNESS across three symmetric scopes.
With no argument, validate checks the WHOLE catalog: schema-pillarstructure, cross-document library resolution, extends chains, and providerinput-kind capabilities, over every catalog entity. Where the workspaceconfiguration gives its Releases catalog directories of their own underworkspace.releases, it checks the catalog once for each Release, over thedirectories that Release reads, and reports each pass under a line namingits Releases and those directories; Releases reading the same directoriesshare one pass.
With --release, validate checks the entities a Release's dependency closurereaches: closure-scoped pillars, extends, and pre-render authored-valueconformance — the same correctness a build applies, scoped to that Release.It then evaluates the Recipe and FeatureRecipe assertions against the valuesthat Release resolves to, as a build does before it renders, and reports afailing assertion as a build reports it. Nothing is rendered.
With an entity path, validate checks one entity file. The kinds it acceptsas a single-entity target are Component, Feature, Recipe, FeatureRecipe,Workload and Plugin. A value the kind requires that the file leaves empty isreported first, as a placeholder still owed: every one is named at once, withwhat it takes, read from the kind's own schema. That reading is this scope'salone; a whole-catalog run, a Release's closure and a build do not apply it.Each kind then has its schema checked, then the checks its own kind carries:pillar structure for a Component or Feature; shape for a Workload,FeatureRecipe or Plugin; and for a Recipe, shape plus an end-to-end compileagainst a minimal generated harness, so its resolution, its guards and arender of its output are all exercised. Where that Recipe's source is onethat has to be fetched, the render is reported as not attempted instead:validating one entity on its own reads no lockfile, reads and writes no cacheand makes no network request, so the chart or module it names is neverretrieved and there is nothing to render from. A render that stops while theRecipe's templates read what only a connection or an attached Featuresupplies — anything under .context.inject, .context.uses or .features — isreported as not attempted too: the generated harness wires no connection andattaches no Feature, so that render cannot be judged there, and a fault ofthe Recipe's own beside such a read is set aside with it. A template thatdoes not parse and a reference the render refuses still fail. An assertionthat calls fail, the Recipe's own or one its Component declares, is printedas a warning closed by a sentence saying a Release must satisfy it before abuild can pass, and does not fail the check: the generated harness sets noneof a real Release's values, so it cannot tell an assertion waiting on one fromone that is broken, and a build still halts on it. Any other kind is refused heretoday, and the refusal names the scope that checks it instead: a whole-catalogrun reaches an Aggregate and the library kinds when they sit in a catalogdirectory, and --release reaches a Release, the Manifest it names and theAggregate it deploys.
With an entity path and --release together, the entity is checked in thatRelease's terms: its references — the Component a Recipe implements, alibrary a pillar refers to — resolve through the catalog directories theworkspace configuration gives that Release rather than the workspace's own,so a workspace keeping one catalog variant per Release checks an entityagainst the variant that Release builds with. The checks are the entitypath's; no closure is validated.
The command writes nothing to disk.Flags
| Flag | Predefinição | Descrição |
|---|---|---|
--catalog | [] | Diretório de catálogo; repetível. Cada —catalog <dir> é colocado no início da pilha de pesquisa de catálogos (a primeira correspondência prevalece): os catalog_dirs do espaço de trabalho ou, para uma Release à qual a configuração do espaço de trabalho atribui diretórios próprios em workspace.releases, os dessa Release; a pilha termina com o diretório chamado catalog na raiz do espaço de trabalho, quando existe. Uma lista catalog_dirs escrita vazia não lê nenhum catálogo local. |
--ir-graph | false | Escreve também o grafo IR que esta execução calculou no stdout, como JSON, além de tudo o que este comando já produz. Os valores que um autor declarou sensíveis são ocultados nele; passe —unredacted para os imprimir em vez disso. Aplica-se ao âmbito —release, o único âmbito que resolve uma Release num grafo. Seleciona um DOCUMENTO, enquanto —response-format define quanto do relatório próprio deste comando é escrito; nenhum deles afeta o veredicto nem o código de saída |
--no-unsupported-field-warnings | false | Silencia a classe de avisos de campos não suportados: os avisos que um destino levanta para algo de autoria do utilizador que não consegue respeitar — um campo de Workload que não consegue exprimir (como acontece com um destino de menor fidelidade, como compose), ou uma anotação aggrega.ai/ sobre a qual não atua para o tipo de entrada do nó. Os outros avisos de renderização continuam a aparecer. Apenas de apresentação; não altera a saída renderizada. Aplica-se ao âmbito de entidade, o único âmbito que renderiza |
--plugin | — | Caminho para um .wasm em bruto a validar em relação ao seu autorrelato describe() — a verificação de autoria pré-publicação. Sozinho, precisa de —type; com um argumento de entidade Plugin, verifica o binário em relação ao tipo declarado da entidade, à alegação de capacidade, ao espelho de comando e ao registo de funções do anfitrião. |
--release | — | Caminho para um YAML de Release. Sozinho, valida sobre o seu fecho de dependências resolvido; com um argumento de entidade, verifica essa entidade nos termos da Release, com as suas referências resolvidas através dos diretórios de catálogo que a configuração do espaço de trabalho dá a essa Release. Um caminho relativo resolve em relação ao diretório onde o comando é executado, e não em relação à raiz do espaço de trabalho. Quando esse diretório não pertence a nenhum espaço de trabalho e nenhuma raiz é nomeada, um caminho absoluto encontra o espaço de trabalho a partir da pasta da própria Release |
--response-format | detailed | Volume de saída para o âmbito —release, o fecho de uma Release sem argumento de entidade: detailed (predefinição) reporta todos os diagnósticos mais as linhas informativas; concise reporta a contagem de diagnósticos e apenas o primeiro diagnóstico. O veredicto e o código de saída são idênticos em ambos. |
--type | — | Tipo de plugin para uma verificação —plugin apenas do binário, verificado em relação ao tipo autorreportado do binário. Só tem significado com —plugin; quando uma entidade Plugin fornece o tipo, omita-o (um valor discordante interrompe a execução). |
--unredacted | false | Imprime os valores que um autor declarou sensíveis em vez de os ocultar. Tudo aquilo a que a saída chega — um terminal, um pipe, um ficheiro, uma gravação de ecrã — passa então a transportar esses valores em claro. Chega ao grafo que —ir-graph escreve e a nada mais, pelo que requer —ir-graph |