Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Descripción general de los errores

El conjunto de capítulos sobre errores cataloga lo que emite el compilador cuando algo sale mal. Hay dos tipos de señal: las detenciones fatales, que paran la compilación y producen un código de salida distinto de cero, y las advertencias no bloqueantes, que señalan problemas de autoría o de despliegue sin bloquear el build. El catálogo está organizado por tipo de señal y no por paso del pipeline, para que quien llega desde un mensaje de error pueda localizar su entrada directamente.

Las detenciones fatales abarcan las violaciones del esquema, los fallos de composición del esquema (declaraciones JSON Schema por pilar que rechazan el payload escrito), los errores de referencia ausente (el implements: de una Recipe que apunta a un Component inexistente, una Release que apunta a un Manifest que carece de una Recipe para un tipo de Component declarado) y el puñado de invariantes entre campos que el compilador vuelve a validar más allá de lo que detecta la validación del esquema. Las detenciones fatales incluyen también los fallos de adquisición remota — una entidad de catálogo o un artefacto de origen fijados que no se pueden obtener de su registry o de su origen remoto (ausentes, sin autenticar, inaccesibles o con un digest que no coincide con el lockfile) — que aparecen durante aggrega pull y durante la verificación del lockfile de aggrega build, marcados con FETCH_ERROR. Las advertencias no bloqueantes abarcan los indicios de problemas de autoría (claves values sin usar, ajustes infra sin usar que indican Ghost Infrastructure) y los campos que un destino no puede respetar (un campo del Workload, o una anotación aggrega.ai/, sobre los que no actúa el provider que renderiza un nodo).

Referencia por tema

  • Detenciones fatales — el catálogo de los errores que detienen la compilación, organizado por el paso del pipeline en el que se dispara la comprobación. Cada entrada indica el desencadenante del error, la solución y la superficie de autoría implicada.
  • Advertencias — las advertencias no bloqueantes emitidas durante la compilación y las comprobaciones externas del dominio del linter que aplican reglas de tipo política fuera del compilador principal.
  • Traducción de errores — los prefijos de categoría (DEVELOPER_ERROR, OPS_ERROR, CATALOG_ERROR, TRANSLATION_ERROR, FETCH_ERROR, POLICY_ERROR, TRUST_ERROR) y las formas de salida de una sola línea y de varias líneas.
  • Centinelas de error — los tres identificadores que lleva cada condición (el centinela de Go que un programa compara con errors.Is, el código con el que está registrada y el código corto que imprime un diagnóstico) y la tabla que resuelve cada código corto.
  • Compatibilidad — lo que prometen los códigos cortos de una release a otra: un código nunca se renumera ni se asigna a una condición distinta.