Огляд помилок
Розділи про помилки описують, що видає компілятор, коли щось іде не так. Є два види сигналів: фатальні зупинки, які зупиняють компіляцію й повертають ненульовий код виходу, і попередження без зупинки, які вказують на проблеми авторингу або розгортання, не блокуючи збірку. Каталог упорядковано за видом сигналу, а не за кроком конвеєра, тож читач, який натрапив на повідомлення про помилку, може одразу знайти відповідний запис.
Фатальні зупинки охоплюють порушення схеми, збої композиції схем (коли оголошення 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, код, під яким її зареєстровано, і короткий код, який друкує діагностика), і таблиця, що розв’язує кожен короткий код. - Сумісність — що короткі коди обіцяють від релізу до релізу: код ніколи не перенумеровується і ніколи не призначається іншій умові.