Panoramica degli errori
L’insieme di capitoli sugli errori cataloga ciò che il compilatore emette quando qualcosa va storto. Due tipi di segnale: gli arresti fatali, che fermano la compilazione e producono un codice di uscita diverso da zero, e gli avvisi non bloccanti, che segnalano problemi di authoring o di deployment senza bloccare la build. Il catalogo è organizzato per tipo di segnale invece che per fase della pipeline, così chi arriva da un messaggio di errore può trovarne direttamente la voce.
Gli arresti fatali coprono le violazioni dello schema, i fallimenti di composizione dello schema (dichiarazioni JSON Schema per pilastro che rifiutano il payload scritto), gli errori di riferimento mancante (l’implements: di una Recipe che punta a un Component inesistente, una Release che punta a un Manifest privo di una Recipe per un tipo di Component dichiarato) e la manciata di invarianti tra campi che il compilatore riconvalida oltre a ciò che rileva la validazione dello schema. Gli arresti fatali includono anche i fallimenti di acquisizione remota — un’entità di catalogo o un artifact sorgente fissati che non possono essere recuperati dal loro registry o dalla sorgente remota (mancanti, non autenticati, irraggiungibili o con un digest che non corrisponde al lockfile) — che emergono durante aggrega pull e durante la verifica del lockfile di aggrega build, contrassegnati con FETCH_ERROR. Gli avvisi non bloccanti coprono gli «smell» di authoring (chiavi values inutilizzate, manopole infra inutilizzate che indicano Ghost Infrastructure) e i campi che un target non può onorare (un campo del Workload, o un’annotazione aggrega.ai/, su cui il provider che esegue il rendering di un nodo non agisce).
Riferimento per argomento
- Arresti fatali — il catalogo degli errori che fermano la compilazione, organizzato per fase della pipeline in cui scatta il controllo. Ogni voce indica il trigger dell’errore, il rimedio e la superficie di authoring coinvolta.
- Avvisi — gli avvisi non bloccanti emessi durante la compilazione e i controlli esterni del dominio del linter che applicano regole in stile policy al di fuori del compilatore principale.
- Traduzione degli errori — i prefissi di categoria (
DEVELOPER_ERROR,OPS_ERROR,CATALOG_ERROR,TRANSLATION_ERROR,FETCH_ERROR,POLICY_ERROR,TRUST_ERROR) e le forme di output a riga singola e multiriga. - Sentinel di errore — i tre identificatori che ogni condizione porta (il sentinel Go che un programma confronta con
errors.Is, il codice con cui è registrata e il codice breve che una diagnostica stampa) e la tabella che risolve ogni codice breve. - Compatibilità — che cosa promettono i codici brevi da una release all’altra: un codice non viene mai rinumerato né assegnato a una condizione diversa.