Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Обзор ошибок

Глава об ошибках каталогизирует то, что выдаёт компилятор, когда что-то идёт не так. Сигналы бывают двух видов: фатальные остановки, которые прерывают компиляцию и дают ненулевой код выхода, и неостанавливающие предупреждения, которые указывают на проблемы авторинга или развёртывания, не блокируя сборку. Каталог упорядочен по виду сигнала, а не по шагу конвейера, чтобы читатель, пришедший с сообщением об ошибке, мог сразу найти нужную запись.

Фатальные остановки охватывают нарушения схемы, сбои композиции схем (объявления JSON Schema отдельных столпов отвергают написанные данные), ошибки отсутствующих ссылок (implements: сущности Recipe указывает на несуществующую сущность Component, сущность Release указывает на сущность Manifest, в которой нет сущности Recipe для объявленного типа сущности Component), а также небольшое число межполевых инвариантов, которые компилятор перепроверяет сверх того, что выявляет проверка по схеме. К фатальным остановкам относятся и сбои удалённого получения — закреплённую сущность каталога или исходный артефакт невозможно получить из реестра или удалённого источника (отсутствует, нет аутентификации, недоступен или дайджест не совпадает с lock-файлом); они возникают во время aggrega pull и при проверке lock-файла в aggrega build и помечаются как FETCH_ERROR. Неостанавливающие предупреждения охватывают признаки проблем авторинга (неиспользуемые ключи values, неиспользуемые параметры infra, указывающие на призрачную инфраструктуру) и поля, которые цель не может учесть (поле сущности Workload или аннотация aggrega.ai/, на которые не реагирует провайдер, рендерящий узел).

Справочник по темам

  • Фатальные остановки — каталог ошибок, прерывающих компиляцию, упорядоченный по шагу конвейера, на котором срабатывает проверка. Для каждой записи указаны причина ошибки, способ устранения и место в авторском коде, вызвавшее её.
  • Предупреждения — неостанавливающие предупреждения, выдаваемые во время компиляции, и внешние проверки линтера, которые применяют правила политик за пределами ядра компилятора.
  • Трансляция ошибок — префиксы категорий (DEVELOPER_ERROR, OPS_ERROR, CATALOG_ERROR, TRANSLATION_ERROR, FETCH_ERROR, POLICY_ERROR, TRUST_ERROR) и однострочный и многострочный форматы вывода.
  • Сигнальные ошибки — три идентификатора, которые несёт каждое условие (сигнальная ошибка Go, с которой программа сопоставляет через errors.Is, код, под которым она зарегистрирована, и короткий код, который печатает диагностика), и таблица, по которой разрешается каждый короткий код.
  • Совместимость — что короткие коды обещают от выпуска к выпуску: код никогда не перенумеровывается и никогда не присваивается другому условию.