Visão geral dos erros
O conjunto de capítulos sobre erros cataloga o que o compilador emite quando algo dá errado. Há dois tipos de sinal: interrupções fatais, que param a compilação e produzem um código de saída diferente de zero, e avisos não bloqueantes, que apontam problemas de autoria ou de implantação sem bloquear o build. O catálogo é organizado por tipo de sinal em vez de por etapa do pipeline, para que quem chega de uma mensagem de erro possa localizar a entrada correspondente diretamente.
As interrupções fatais abrangem violações de esquema, falhas de composição de esquema (declarações JSON Schema por pilar que rejeitam o payload escrito), erros de referência ausente (o implements: de uma Recipe apontando para um Component que não existe, uma Release apontando para um Manifest sem uma Recipe para um tipo de Component declarado) e o punhado de invariantes entre campos que o compilador revalida além do que a validação de esquema detecta. As interrupções fatais incluem também falhas de aquisição remota — uma entidade de catálogo ou um artefato de origem fixados que não podem ser obtidos de seu registry ou de sua origem remota (ausentes, não autenticados, inacessíveis ou com digest divergente do lockfile) — que surgem durante aggrega pull e durante a verificação do lockfile de aggrega build, marcadas com FETCH_ERROR. Os avisos não bloqueantes abrangem indícios de problemas de autoria (chaves values não usadas, ajustes infra não usados que indicam Ghost Infrastructure) e campos que um destino não consegue respeitar (um campo do Workload, ou uma anotação aggrega.ai/, sobre os quais o provider que renderiza um nó não age).
Referência por tópico
- Interrupções fatais — o catálogo dos erros que interrompem a compilação, organizado pela etapa do pipeline em que a verificação é disparada. Cada entrada indica o gatilho do erro, a solução e a superfície de autoria envolvida.
- Avisos — os avisos não bloqueantes emitidos durante a compilação e as verificações externas do domínio do linter que aplicam regras no estilo de políticas fora do compilador principal.
- Tradução de erros — os prefixos de categoria (
DEVELOPER_ERROR,OPS_ERROR,CATALOG_ERROR,TRANSLATION_ERROR,FETCH_ERROR,POLICY_ERROR,TRUST_ERROR) e as formas de saída de linha única e de várias linhas. - Sentinelas de erro — os três identificadores que toda condição carrega (o sentinela Go que um programa compara com
errors.Is, o código sob o qual ela está registrada e o código curto que um diagnóstico imprime) e a tabela que resolve cada código curto. - Compatibilidade — o que os códigos curtos prometem de uma release para outra: um código nunca é renumerado nem atribuído a uma condição diferente.