Ikhtisar galat
Kumpulan bab tentang galat mengatalogkan apa yang dikeluarkan kompiler ketika terjadi kesalahan. Ada dua jenis sinyal: penghentian fatal yang menghentikan kompilasi dan menghasilkan kode keluar bukan nol, dan peringatan yang tidak menghentikan yang menandai masalah penulisan atau deployment tanpa memblokir build. Katalog disusun berdasarkan jenis sinyal, bukan berdasarkan langkah pipeline, sehingga pembaca yang datang dari sebuah pesan galat dapat langsung menemukan entrinya.
Penghentian fatal mencakup pelanggaran skema, kegagalan komposisi skema (deklarasi JSON Schema per pilar yang menolak payload yang ditulis), galat referensi yang hilang (implements: sebuah Recipe yang menunjuk ke Component yang tidak ada, sebuah Release yang menunjuk ke Manifest yang tidak memiliki Recipe untuk tipe Component yang dideklarasikan), dan segelintir invarian lintas bidang yang divalidasi ulang oleh kompiler di luar apa yang ditangkap validasi skema. Penghentian fatal juga mencakup kegagalan akuisisi jarak jauh — entitas katalog atau artefak sumber yang disematkan dan tidak dapat diambil dari registry atau sumber jarak jauhnya (hilang, tidak terautentikasi, tidak dapat dijangkau, atau digest-nya tidak cocok dengan lockfile) — yang muncul selama aggrega pull dan selama verifikasi lockfile oleh aggrega build, dengan tanda FETCH_ERROR. Peringatan yang tidak menghentikan mencakup gejala masalah penulisan (kunci values yang tidak digunakan, pengaturan infra yang tidak digunakan yang menandakan Ghost Infrastructure) dan bidang yang tidak dapat dihormati target (bidang Workload, atau anotasi aggrega.ai/, yang tidak ditindaklanjuti oleh provider yang merender sebuah node).
Referensi per topik
- Penghentian fatal — katalog galat yang menghentikan kompilasi, disusun berdasarkan langkah pipeline tempat pemeriksaan dijalankan. Setiap entri menyebutkan pemicu galat, solusinya, dan permukaan penulisan yang bermasalah.
- Peringatan — peringatan yang tidak menghentikan yang dikeluarkan selama kompilasi dan pemeriksaan domain linter eksternal yang menegakkan aturan bergaya kebijakan di luar kompiler inti.
- Penerjemahan galat — prefiks kategori (
DEVELOPER_ERROR,OPS_ERROR,CATALOG_ERROR,TRANSLATION_ERROR,FETCH_ERROR,POLICY_ERROR,TRUST_ERROR) serta bentuk output satu baris dan multibaris. - Sentinel galat — tiga pengenal yang dibawa setiap kondisi (sentinel Go yang dicocokkan program dengan
errors.Is, kode tempat kondisi itu didaftarkan, dan kode pendek yang dicetak diagnostik) serta tabel yang meresolusi setiap kode pendek. - Kompatibilitas — apa yang dijanjikan kode pendek dari satu rilis ke rilis berikutnya: sebuah kode tidak pernah diberi nomor baru dan tidak pernah diberikan ke kondisi yang berbeda.