Vue d’ensemble des erreurs
L’ensemble de chapitres sur les erreurs catalogue ce qu’émet le compilateur lorsque quelque chose se passe mal. Deux types de signal : les arrêts fatals, qui stoppent la compilation et produisent un code de sortie non nul, et les avertissements non bloquants, qui signalent des problèmes de rédaction ou de déploiement sans bloquer le build. Le catalogue est organisé par type de signal plutôt que par étape du pipeline, afin que le lecteur qui arrive avec un message d’erreur puisse en trouver directement l’entrée.
Les arrêts fatals couvrent les violations de schéma, les échecs de composition de schéma (des déclarations JSON Schema par pilier qui rejettent la charge utile rédigée), les erreurs de référence manquante (le implements: d’une Recipe pointant vers un Component inexistant, une Release pointant vers un Manifest dépourvu de Recipe pour un type de Component déclaré), et la poignée d’invariants inter-champs que le compilateur revalide au-delà de ce que détecte la validation de schéma. Les arrêts fatals incluent aussi les échecs d’acquisition distante — une entité de catalogue ou un artefact source épinglé qui ne peut pas être récupéré depuis son registre ou sa source distante (absent, non authentifié, inaccessible, ou dont le digest ne correspond pas au fichier de verrouillage) — qui surviennent pendant aggrega pull et pendant la vérification du fichier de verrouillage par aggrega build, marqués FETCH_ERROR. Les avertissements non bloquants couvrent les défauts de rédaction (clés values inutilisées, réglages infra inutilisés révélant une Ghost Infrastructure) et les champs qu’une cible ne peut pas honorer (un champ de Workload, ou une annotation aggrega.ai/, sur lequel le provider qui effectue le rendu d’un nœud n’agit pas).
Référence par thème
- Arrêts fatals — le catalogue des erreurs qui stoppent la compilation, organisé par étape du pipeline où la vérification se déclenche. Chaque entrée indique le déclencheur de l’erreur, le remède et la surface de rédaction en cause.
- Avertissements — les avertissements non bloquants émis pendant la compilation et les vérifications externes du domaine du linter qui appliquent des règles de type politique en dehors du compilateur principal.
- Traduction des erreurs — les préfixes de catégorie (
DEVELOPER_ERROR,OPS_ERROR,CATALOG_ERROR,TRANSLATION_ERROR,FETCH_ERROR,POLICY_ERROR,TRUST_ERROR) et les formes de sortie sur une seule ligne et sur plusieurs lignes. - Sentinelles d’erreur — les trois identifiants que porte chaque condition (la sentinelle Go qu’un programme compare avec
errors.Is, le code sous lequel elle est enregistrée et le code court qu’affiche un diagnostic) et la table qui résout chaque code court. - Compatibilité — ce que les codes courts promettent d’une release à l’autre : un code n’est jamais renuméroté ni attribué à une autre condition.