콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

오류 개요

오류 장은 문제가 발생했을 때 컴파일러가 내보내는 내용을 정리합니다. 신호는 두 종류입니다. 컴파일을 중단하고 0이 아닌 종료 코드를 내는 치명적 중단과, 빌드를 막지 않고 작성 또는 배포상의 우려를 알리는 중단하지 않는 경고입니다. 카탈로그는 파이프라인 단계가 아니라 신호 종류별로 구성되어 있으므로, 오류 메시지를 보고 찾아온 독자가 해당 항목을 바로 찾을 수 있습니다.

치명적 중단에는 스키마 위반, 스키마 구성 실패(필러별 JSON Schema 선언이 작성된 페이로드를 거부하는 경우), 참조 누락 오류(Recipe의 implements:가 존재하지 않는 Component를 가리키는 경우, Release가 선언된 Component 유형에 대한 Recipe가 없는 Manifest를 가리키는 경우), 그리고 스키마 검증이 잡아내는 범위를 넘어 컴파일러가 다시 검증하는 몇 가지 필드 간 불변 조건이 포함됩니다. 치명적 중단에는 원격 획득 실패도 포함됩니다. 이는 고정된 카탈로그 엔티티나 소스 아티팩트를 레지스트리 또는 원격 소스에서 가져올 수 없는 경우(누락, 인증 실패, 접근 불가, 또는 lockfile과 다이제스트 불일치)로, aggrega pull 중과 aggrega build의 lockfile 검증 중에 FETCH_ERROR 태그와 함께 나타납니다. 중단하지 않는 경고에는 작성상의 문제 징후(사용되지 않는 values 키, Ghost Infrastructure를 나타내는 사용되지 않는 infra 설정값)와 대상이 반영할 수 없는 필드(노드를 렌더링하는 provider가 처리하지 않는 Workload 필드 또는 aggrega.ai/ 어노테이션)가 포함됩니다.

주제별 레퍼런스

  • 치명적 중단 — 컴파일을 중단시키는 오류의 카탈로그로, 검사가 실행되는 파이프라인 단계별로 구성되어 있습니다. 각 항목은 오류의 발생 조건, 해결 방법, 문제가 되는 작성 위치를 명시합니다.
  • 경고 — 컴파일 중에 내보내는 중단하지 않는 경고와, 코어 컴파일러 외부에서 정책 형태의 규칙을 적용하는 외부 린터 영역 검사를 다룹니다.
  • 오류 변환 — 범주 접두사(DEVELOPER_ERROR, OPS_ERROR, CATALOG_ERROR, TRANSLATION_ERROR, FETCH_ERROR, POLICY_ERROR, TRUST_ERROR)와 한 줄 및 여러 줄 출력 형태를 다룹니다.
  • 오류 센티널 — 모든 조건이 갖는 세 가지 식별자(프로그램이 errors.Is로 매칭하는 Go 센티널, 조건이 등록된 코드, 진단이 출력하는 짧은 코드)와 모든 짧은 코드를 해석하는 표입니다.
  • 호환성 — 짧은 코드가 릴리스 간에 약속하는 것: 코드는 번호가 다시 매겨지지 않으며 다른 조건에 할당되지도 않습니다.