Visão geral dos erros
O conjunto de capítulos Erros cataloga o que o compilador emite quando algo corre mal. 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 assinalam preocupações de autoria ou de implementação sem bloquear o build. O catálogo está organizado por tipo de sinal e não por passo do pipeline, para que o leitor que chega com uma mensagem de erro possa localizar diretamente a respetiva entrada.
As interrupções fatais abrangem violações de esquema, falhas de composição de esquemas (declarações JSON Schema por pilar que rejeitam a carga escrita), erros de referência em falta (o implements: de uma Recipe a apontar para um Component que não existe, uma Release a apontar para um Manifest a que falta uma Recipe para um tipo de Component declarado) e o punhado de invariantes entre campos que o compilador volta a validar para além do que a validação de esquema deteta. As interrupções fatais incluem também falhas de aquisição remota — uma entidade de catálogo ou artefacto de origem fixado que não pode ser obtido do seu registo ou origem remota (em falta, não autenticado, inacessível ou com digest diferente 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, parâmetros 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 atua).
Referência por tema
- Interrupções fatais — o catálogo de erros que param a compilação, organizado pelo passo do pipeline em que a verificação é acionada. Cada entrada nomeia o que desencadeia o erro, a solução e a superfície de autoria em causa.
- Avisos — avisos não bloqueantes emitidos durante a compilação e as verificações externas do domínio do linter que impõem regras ao estilo de políticas fora do núcleo do compilador.
- Tradução de erros — os prefixos de categoria (
DEVELOPER_ERROR,OPS_ERROR,CATALOG_ERROR,TRANSLATION_ERROR,FETCH_ERROR,POLICY_ERROR,TRUST_ERROR) e os formatos de saída de uma linha e de várias linhas. - Sentinelas de erro — os três identificadores que todas as condições transportam (o sentinela Go que um programa compara com
errors.Is, o código sob o qual está registada 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 versão para outra: um código nunca é renumerado nem atribuído a uma condição diferente.