Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Przegląd błędów

Zestaw rozdziałów o błędach katalogujе to, co kompilator emituje, gdy coś pójdzie nie tak. Istnieją dwa rodzaje sygnałów: błędy krytyczne, które zatrzymują kompilację i zwracają niezerowy kod wyjścia, oraz ostrzeżenia niezatrzymujące, które sygnalizują problemy związane z tworzeniem lub wdrażaniem, nie blokując kompilacji. Katalog jest uporządkowany według rodzaju sygnału, a nie według kroku potoku, dzięki czemu czytelnik, który trafia tu z komunikatem błędu, może bezpośrednio odnaleźć odpowiedni wpis.

Błędy krytyczne obejmują naruszenia schematu, niepowodzenia kompozycji schematów (deklaracje JSON Schema poszczególnych filarów odrzucające utworzony ładunek), błędy brakujących odwołań (implements: encji Recipe wskazujące na encję Component, która nie istnieje, lub encja Release wskazująca na encję Manifest, w której brakuje encji Recipe dla zadeklarowanego typu encji Component) oraz kilka niezmienników między polami, które kompilator ponownie weryfikuje poza tym, co wychwytuje walidacja schematu. Do błędów krytycznych należą także niepowodzenia pozyskiwania zdalnego — przypięta encja katalogu lub artefakt źródłowy, którego nie można pobrać z rejestru lub zdalnego źródła (brak, brak uwierzytelnienia, niedostępność lub niezgodność skrótu z plikiem blokady) — które pojawiają się podczas aggrega pull oraz podczas weryfikacji pliku blokady w aggrega build, oznaczone jako FETCH_ERROR. Ostrzeżenia niezatrzymujące obejmują niepokojące sygnały w tworzonym kodzie (nieużywane klucze values, nieużywane pokrętła infra wskazujące na Ghost Infrastructure) oraz pola, których cel nie może uwzględnić (pole encji Workload lub adnotacja aggrega.ai/, na które provider renderujący węzeł nie reaguje).

Dokumentacja według tematów

  • Błędy krytyczne — katalog błędów zatrzymujących kompilację, uporządkowany według kroku potoku, w którym uruchamia się sprawdzenie. Każdy wpis podaje przyczynę błędu, sposób naprawy oraz miejsce w tworzonym kodzie, które go powoduje.
  • Ostrzeżenia — ostrzeżenia niezatrzymujące emitowane podczas kompilacji oraz zewnętrzne sprawdzenia w domenie lintera, które egzekwują reguły w stylu polityk poza głównym kompilatorem.
  • Tłumaczenie błędów — prefiksy kategorii (DEVELOPER_ERROR, OPS_ERROR, CATALOG_ERROR, TRANSLATION_ERROR, FETCH_ERROR, POLICY_ERROR, TRUST_ERROR) oraz jednowierszowe i wielowierszowe formaty wyjścia.
  • Sentynele błędów — trzy identyfikatory, które niesie każdy warunek (sentynel Go, z którym program dopasowuje błąd przez errors.Is, kod, pod którym jest zarejestrowany, oraz krótki kod wypisywany przez komunikat diagnostyczny), i tabela rozwiązująca każdy krótki kod.
  • Zgodność — co krótkie kody obiecują między wydaniami: kod nigdy nie otrzymuje nowego numeru i nigdy nie zostaje przypisany do innego warunku.