Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

aggrega validate

aggrega validate memeriksa kebenaran — skema, struktur pilar, resolusi referensi lintas dokumen, rantai extends, kapabilitas jenis input provider, dan (untuk entitas yang melakukan rendering) bahwa entitas tersebut benar-benar dapat di-render. Perintah ini memiliki tiga mode, yang dipilih melalui argumennya, yang menerapkan disiplin kebenaran yang sama pada tiga cakupan: seluruh katalog (tanpa argumen), closure dependensi satu Release (--release), dan satu berkas entitas (path entitas). Setiap cakupan menjawab pertanyaan yang sama — “apakah konten ini benar?” — atas bagian katalog yang berbeda.

Kebenaran berbeda dari konvensi. aggrega validate menanyakan apakah konten terbentuk dengan baik dan akan dapat dikompilasi; aggrega lint menanyakan apakah konten mengikuti disiplin publikasi katalog (penamaan, keselarasan direktori kategori, besarnya kenaikan versi, dan sebagainya). Kedua perintah ini mencerminkan tiga cakupan satu sama lain sehingga Anda dapat memeriksa salah satu dimensi pada granularitas mana pun yang Anda perlukan.

aggrega validate tidak menulis apa pun ke disk dan tidak membaca state runtime apa pun. Perintah ini menjalankan resolusi dan validasi yang sama dengan yang dijalankan oleh build, berhenti sebelum render (atau, untuk satu entitas, mengisolasi render tersebut).

Path entitas dapat diberikan secara posisional. --release yang diberikan bersama path entitas tidak memilih cakupan Release: entitas tetap diperiksa secara tersendiri, dalam ketentuan Release tersebut — lihat Memeriksa entitas dalam ketentuan sebuah Release.

Kebenaran seluruh katalog (tanpa argumen)

aggrega validate tanpa argumen memuat setiap entitas katalog di bawah direktori katalog yang dikonfigurasi dan memeriksanya secara menyeluruh. Sebelum memuat apa pun, perintah ini membaca setiap file YAML di bawahnya, dan dokumen Aggrega di antaranya yang tidak dapat dimuat akan menghentikan run, seperti dijelaskan di bawah. Kemudian:

  • Struktur pilar skema — blok spec.schema: dari setiap Component dan Feature diekspansi dan divalidasi (pemeriksaan pilar skema yang sama dengan yang diterapkan build), termasuk ekspansi bentuk ringkas.
  • Resolusi referensi lintas dokumen — referensi $ref dan $import ke entri SchemaLibrary berhasil diresolusi, dan SchemaLibrary yang tidak dapat diresolusi atau tidak valid karena alasan lain ditolak.
  • Rantai extends — setiap entitas yang mendeklarasikan extends di-resolve terhadap induknya, dan bentuk gabungan induk+anak diperiksa. Induk yang tidak dimuat oleh direktori katalog dibaca di tempat build membacanya: dari cache artefak, di bawah pin yang dicatat lockfile sebuah Release untuknya — lockfile dari Releases yang menjadi sasaran putaran tersebut, atau dari setiap Release yang dimuat workspace jika workspace divalidasi dalam satu putaran. Jadi, basis yang dipublikasikan ke registry lolos validasi setelah aggrega pull mengambil dan mem-pin-nya, dan induk yang tidak dimuat oleh keduanya menghentikan proses, dengan menyebutkan aggrega pull --release <release>. Tidak ada yang diambil.
  • Selector yang dideklarasikan — setiap selector label yang dideklarasikan dokumen Component atau Feature pada socket dependensi di bawah spec.usesSchema, atau pada slot lampiran di bawah spec.featuresSchema — termasuk, pada Component, slot yang dideklarasikan sebuah socket — dibaca terhadap tata bahasa selector, baik ada maupun tidak ada yang merangkai socket tersebut atau mengisi slot tersebut. Lihat selector yang dideklarasikan.
  • Tabrakan lokasi OCI — dua identitas katalog berbeda yang akan dipublikasikan ke lokasi registri yang sama ditolak secara tegas, sehingga build tidak pernah diam-diam menimpa byte terpublikasi milik satu entitas dengan milik entitas lain.
  • Kapabilitas jenis input Provider — sebuah Recipe atau FeatureRecipe yang mendeklarasikan blok workload: yang terikat pada provider yang tidak dapat melakukan sintesis ditandai sebagai galat, karena entitas tersebut tidak akan pernah dapat di-build.

Ini adalah padanan tingkat katalog dari validasi per-Release pada build — tempat entitas katalog yang rusak seharusnya muncul, sebelum Release mana pun mencapainya. Perintah ini berhenti secara tegas pada dokumen Aggrega yang tidak dapat dimuatnya, dan pada setiap pelanggaran pilar skema, pustaka yang tidak dapat diresolusi atau tidak valid, kegagalan resolusi extends, selector terdeklarasi yang ditolak tata bahasa, tabrakan lokasi, atau galat kapabilitas jenis input. Temuan tumpang-tindih pilar skema dan penyempitan saat extend, serta setiap kata kunci x-aggrega-* yang ditulis langsung oleh Component atau Feature di dalam konten skemanya, berupa baris notice: yang bersifat saran dan tidak pernah mengubah kode keluar.

Dokumen Aggrega yang tidak dapat dimuat menghentikan run. File YAML di bawah direktori katalog adalah dokumen Aggrega jika salah satu barisnya dimulai, tanpa indentasi, dengan apiVersion: dan nilai yang diawali aggrega.ai/, dengan atau tanpa tanda kutip. File seperti itu yang tidak dapat dibaca, yang YAML-nya tidak dapat di-parse, atau yang kind atau metadata-nya tidak berbentuk amplop entitas — misalnya metadata yang ditulis sebagai list — menghentikan run dengan E0175 setelah direktori selesai dibaca, dengan menyebut setiap file tersebut beserta alasan yang diberikan oleh pembacaan atau parser; tidak ada yang diperiksa dan tidak ada baris catalog validation passed yang dicetak. Dokumen yang berhasil dimuat tetapi mendeklarasikan kind yang tidak ada di katalog mana pun — misalnya Componnent yang salah eja, atau tanpa kind sama sekali — menghentikan run yang sama dengan E0371, disebutkan di samping file-file tersebut beserta jenis yang dideklarasikannya; Manifest, Release, dan Workload yang diimpor Recipe dari direktorinya sendiri dilewati. YAML lain apa pun — templat chart Helm, yang tidak dapat di-parse sebelum dirender, nilai chart, definisi workflow — dilewati.

Direktori mana yang dibacanya bergantung pada bentuk workspace:

  • Workspace yang konfigurasinya tidak memberikan direktori katalog Release sendiri divalidasi satu kali, atas tumpukan pencariannya: direktori --catalog, lalu workspace.catalog_dirs, lalu direktori catalog di root workspace bila ada.

  • Workspace yang menamai Releases di bawah workspace.releases dapat menyimpan katalog dalam beberapa varian berdampingan, masing-masing dibaca oleh Release-nya sendiri, dan memuat semuanya sekaligus akan menempatkan setiap varian dalam satu katalog, dengan entitas satu varian membayangi entitas varian lain. Karena itu, workspace tersebut divalidasi satu kali untuk setiap Release yang dimilikinya, atas direktori yang dibaca Release tersebut, dengan direktori --catalog lebih dahulu di setiap putaran; Release yang tidak dinamai konfigurasi membaca daftar milik workspace. Setiap putaran dilaporkan di bawah baris yang menyebutkan Release-nya dan direktori yang dibacanya, diikuti hasil putaran tersebut:

    Release release-compose.yaml reads catalog-compose
    catalog validation passed (schema-pillar + library + extends + oci-location)
    Release release-helm-synth.yaml reads catalog-helm-synth
    catalog validation passed (schema-pillar + library + extends + oci-location)

    Releases yang membaca direktori yang persis sama berbagi satu putaran, yang menyebutkan masing-masing. Release yang tidak membaca direktori apa pun — entrinya menulis catalog_dirs: [] — dilaporkan tidak memiliki apa pun untuk diperiksa, dan putaran lain berjalan seperti biasa. Setiap putaran dilaporkan apa pun yang ditemukan putaran sebelumnya, karena entitas rusak dalam satu varian tidak mengatakan apa pun tentang varian lain, dan perintah gagal bila ada putaran yang gagal, dengan menyebutkan Releases yang direktorinya gagal. Releases yang dimiliki workspace adalah dokumen Release-nya — file YAML yang kind-nya Release, di mana pun di bawah root workspace di luar direktori tersembunyi serta node_modules, vendor, dan dist.

Eksekusi yang tidak memiliki apa pun untuk dibaca di putaran mana pun ditolak alih-alih dilaporkan sebagai katalog yang bersih: letakkan entitas di bawah catalog/, berikan --catalog, atau atur workspace.catalog_dirs — atau, di workspace yang menamai Releases, catalog_dirs milik Release sendiri di bawah workspace.releases. Perintah ini tidak pernah menelusuri direktori kerja saat ini secara implisit, sehingga tidak pernah menarik pohon direktori yang tidak terkait.

Alat validate dari aggrega mcp, bila diminta untuk seluruh katalog, memvalidasi putaran yang sama; di workspace yang menamai Releases, jawabannya memuat masing-masing putaran di bawah passes — Releases, direktori yang dibaca, dan putusan putaran itu sendiri — di samping putusan atas semuanya.

Pustaka yang hanya disimpan di cache artefak

Cache artefak menyimpan apa yang ditaruh di sana oleh sebuah pengambilan, dan SchemaLibrary yang ada di cache dihitung sebagai konten katalog hanya jika sebuah entri di lockfile sebuah Release menjamin digest-nya — lihat Apa itu cache, dan apa yang bukan. Ketika sebuah $ref: tidak ter-resolve ke apa pun sementara cache menyimpan pustaka yang tidak di-pin oleh entri lockfile mana pun dan tidak disediakan oleh direktori katalog mana pun yang dibaca pemeriksaan, laporan diikuti oleh baris remediation: yang menyebutkan setiap pustaka semacam itu dan tindakan yang berlaku untuk cakupan yang gagal:

  • Tanpa argumen, dan dengan path entitas baik --release diberikan maupun tidak, validate membaca pustaka hanya dari direktori katalog, tidak pernah melalui entri lockfile, sehingga entri yang tercatat tidak akan mengubah putusannya. Baris tersebut menyatakan hal itu, dan mengarahkan untuk menulis pustaka di bawah direktori katalog, atau ke aggrega pull --release <release> yang diikuti aggrega validate --release <release>, yang memeriksa Release terhadap pustaka yang di-pin lockfile-nya.
  • Dengan --release saja, validate membaca lockfile milik Release, sehingga baris tersebut menyebutkan aggrega pull --release <release>, yang me-resolve pustaka dan mencatat entrinya, atau menulis pustaka di bawah direktori katalog.

Baris tersebut tidak mengubah putusan maupun kode keluar.

Selector yang dideklarasikan

Component atau Feature membatasi apa yang dapat dirangkai ke socket dependensinya, dan apa yang dapat mengisi slot lampirannya, dengan selector label — selector: dari setiap entri spec.usesSchema dan setiap entri spec.featuresSchema, dan pada Component, selector: dari setiap slot yang dideklarasikan sebuah socket di bawah featuresSchema miliknya sendiri. Build membaca selector hanya di tempat sesuatu mencapainya: edge yang ditarik melalui socket, lampiran yang mengisi slot. Jadi cakupan seluruh katalog dan cakupan entitas tunggal membaca setiap selector yang dideklarasikan dokumen Component atau Feature, baik ada maupun tidak ada yang merangkai socket atau mengisi slot, dan selector yang ditolak tata bahasa — daftar nilai yang tidak memiliki tanda kurung penutup, koma ganda, key yang memuat = atau ! — menggagalkan pemeriksaan. Tata bahasanya adalah yang diajarkan dalam tata bahasa string.

Penolakan tersebut adalah penolakan yang dilaporkan build saat mencapai selector yang sama, dengan kode yang sama dan dalam kata-kata yang sama: E0007 untuk selector socket dan E0008 untuk selector slot, yang menyebutkan selector-nya, socket atau slot yang mendeklarasikannya, dan alasan tata bahasa tidak dapat membacanya. Penolakan ini dicatat sebagai kesalahan katalog pada file entitas:

selector violation ("<selector>", declared on socket "<socket>", which could not be evaluated: "<why it could not be read>"). Correct the selector on the socket’s declaration in the component type’s usesSchema. (pelanggaran selector: selector yang dideklarasikan pada socket tidak dapat dievaluasi. Perbaiki selector pada deklarasi socket di usesSchema tipe komponen.)

Setiap dokumen dibaca sebagaimana penulisnya menuliskannya, sehingga selector yang dideklarasikan entitas dasar dilaporkan sekali, terhadap file milik entitas dasar itu sendiri, bukan sekali untuk setiap entitas yang memperluasnya. appliesTo dan appliesToAnyOf milik Feature tidak dibaca di sini: keduanya dibaca di mana pun lampiran Feature tersebut dievaluasi.

Cakupan seluruh katalog melaporkan setiap selector yang ditolak pada baris selector: miliknya sendiri dan gagal dengan jumlahnya; cakupan entitas tunggal melaporkannya sebagai kegagalan tingkat bentuknya — dengan atau tanpa --release di samping path entitas, karena bentuk itu adalah cakupan entitas tunggal yang dijalankan dalam ketentuan sebuah Release (lihat memeriksa entitas dalam ketentuan sebuah Release). --release saja, yang memvalidasi closure dependensi sebuah Release, dan build membaca selector hanya di tempat edge atau pengisian mencapainya, dan berhenti padanya di sana.

Kebenaran dalam lingkup Release (--release)

aggrega validate --release <release-path> memvalidasi tepat entitas yang dijangkau oleh dependensi terselesaikan dari satu Release, bukan seluruh katalog atau satu entitas. Perintah ini menghitung closure melalui mesin yang sama dengan yang digunakan build, sehingga entitas yang diperiksanya tepat sama dengan entitas yang akan diselesaikan oleh build Release tersebut, dan atas closure itu:

  • menyelesaikan rantai extends dalam lingkup closure, dan gagal pada kesalahan resolusi;
  • memvalidasi pilar skema setiap entitas yang terselesaikan (dalam lingkup closure), dan gagal pada kesalahan pilar skema;
  • menjalankan kesesuaian nilai pra-render yang sama dengan yang dijalankan build — perintah ini menyelesaikan parameter Release ke dalam nilai yang ditulis (sehingga nilai {{ .parameters.* }} diperiksa dalam bentuk terselesaikan, bukan sebagai templat) dan memvalidasi hasilnya terhadap skema gabungan closure, termasuk kesesuaian terhadap skema gabungan induk+anak untuk entitas yang menggunakan extends. Nilai yang melanggar skemanya gagal dengan kode keluar bukan nol;
  • mengevaluasi setiap asersi Recipe dan FeatureRecipe terhadap nilai-nilai hasil resolusi Release, sebagaimana build mengevaluasinya sebelum merender: Recipe setiap komponen diikat sebagaimana Manifest memetakannya, locals dan provides-nya diresolusi, dan asersi pertama yang gagal — yang memanggil fail, atau yang templatnya berhenti pada kunci yang tidak ditemukannya — menggagalkan validasi dengan kondisi dan kalimat yang sama dengan yang membuat build berhenti. Templat locals atau provides yang tidak dapat dievaluasi juga menggagalkan validasi, sebagaimana templat itu menggagalkan build. Provider yang dipakai setiap Recipe untuk merender ditanya nama yang diberikannya pada sumber daya komponen itu, sebagaimana build menanyakannya, karena provides sebuah Recipe dapat membaca nama tersebut; tidak ada yang dirender. Asersi-asersi ini dievaluasi hanya bila tidak ada hal di atas yang sudah gagal, sehingga sebuah Release melaporkan kesalahan paling awal yang akan menghentikan build;
  • menampilkan temuan tumpang-tindih pilar skema dan penyempitan saat extend sebagai baris notice: informasional yang tidak pernah mengubah kode keluar;
  • menampilkan setiap kata kunci x-aggrega-* yang ditulis langsung di dalam konten skema oleh entitas yang dibacanya sebagai baris warning:, sekali per entitas, sebagaimana build menampilkannya — ini juga tidak pernah mengubah kode keluar.

Hal ini menjadikan --release pemeriksaan pra-build yang sesungguhnya: perintah ini menangkap apa yang akan ditolak build, sebelum build — validasi dependensi build tanpa render. Perintah ini tidak menjalankan render dan tidak memicu penarikan jaringan: closure diselesaikan dari katalog lokal (dan pin lockfile Release, bila ada); kumpulan dependensi yang dipin ke registry dan memerlukan lockfile menampilkan kesalahan referensi tak terselesaikan yang jujur alih-alih mengambilnya. Penyempitan ditampilkan sebagai saran, tidak pernah ditegakkan.

Lockfile yang tidak lagi cocok dengan hasil resolusi Release menolak validasi dengan penghentian yang dicetak aggrega build. Jika ada lockfile di samping Release, --release mencocokkannya dengan hasil resolusi Release, menggunakan perbandingan drift yang dijalankan build sebelum merender, segera setelah dependensi Release di-resolve dan sebelum pemeriksaan apa pun di atas dijalankan. Lockfile yang telah menyimpang dari entitas, pustaka, atau plugin yang di-pin, atau dari file Release itu sendiri, menghentikan validasi dengan penolakan E0130 milik build — setiap entri yang menyimpang, lalu aggrega pull --release <release> yang mengatasinya — dan kode keluar bukan nol, sehingga validasi tidak pernah meloloskan lockfile yang ditolak build karena drift. Tanpa argumen, dan dengan path entitas, validate tidak terikat pada lockfile: pemeriksaan seluruh katalog membaca pin lockfile hanya untuk menemukan induk extends, dan pemeriksaan satu entitas tidak membaca lockfile.

Karena menjalankan pemeriksaan yang sama dengan build, perintah ini juga menjalankan plugin gerbang terlampir yang sama — sehingga perintah ini terikat pada catatan identitas plugin tepercaya yang sama dengan build. Workspace yang melampirkan plugin yang mengembalikan putusan terima-atau-tolak memiliki catatan kepercayaan plugin di samping Release-nya, dan --release membandingkan konfigurasi dengannya sebelum plugin mana pun dijalankan: gerbang tercatat yang tidak lagi dilampirkan konfigurasi menghentikan validasi, dan plugin yang diselesaikan dari cache yang diisi aggrega pull yang artefaknya bukan artefak tercatat ditolak alih-alih dijalankan. Workspace yang tidak mencatat apa pun tidak memiliki catatan, yang tidak mengubah apa pun untuk perbandingan itu. --release juga menyebutkan setiap penarikan yang tercatat terhadap apa yang menjadi dependensi Release, di standard error sebagai baris deprecation: dengan kata-kata yang dicetak aggrega build: baik penanda yang dicatat lockfile terhadap referensi yang di-pin maupun penanda yang dicatat catatan kepercayaan terhadap plugin yang dilampirkan dalam peran putusan. Penarikan tidak mengubah putusan maupun kode keluar, dan catatan kepercayaan yang ada tetapi tidak dapat dibaca menghentikan validasi alih-alih dianggap sebagai catatan yang tidak mencatat apa pun.

Plugin yang dibaca dari cache juga terikat pada tanda tangan yang dicatat entrinya, sebagaimana build mengikatnya, pada saat plugin dimuat. Jika entrinya mencatat tanda tangan terverifikasi, materi tanda tangan yang disebut fakta tersebut di cache diperiksa lagi, dan plugin yang materinya hilang atau berbeda ditolak — demikian pula plugin yang materinya dibuat untuk plugin lain selain yang dibaca, yang merupakan wujud signature yang disalin dari entri lain, apa pun persyaratan penandatanganannya. Jika konfigurasi kepercayaan workspace mewajibkan tanda tangan, plugin yang dibaca dari cache yang entrinya tidak mencatat tanda tangan — atau yang tidak memiliki entri dalam catatan, termasuk catatan yang dihapus — juga ditolak, dengan pengaturan yang sama yang akan membuat aggrega pull menolaknya karena tidak bertanda tangan, sehingga skip_signature_verification dan registry advisory mengizinkannya berjalan. Penolakan menggagalkan validasi dan dilaporkan di antara diagnostiknya, dengan menyebut plugin tersebut dan aggrega pull --release <release>, perintah yang memverifikasi tanda tangannya di registry-nya, mencatatnya, dan menyimpan ke cache bundel yang disebutnya, sambil menulis ulang salinan cache yang tidak lagi cocok dengan digest-nya; plugin yang disajikan dari salah satu direktori katalog Anda, atau dari salinan di dalam biner compiler, tidak pernah terikat pada persyaratan ini. Dua lingkup lainnya tidak terikat pada semua ini: keduanya tidak membaca lampiran plugin workspace, sehingga tidak ada plugin semacam itu yang berjalan di dalamnya.

Hal yang sama berlaku untuk plugin yang mengubah graf alih-alih menilainya. Lampiran label-transform atau annotation-transform membentuk keluaran yang akan dirender, sehingga lockfile mem-pin identitasnya maupun berkas sumber yang dibacanya — dan --release menjalankan lampiran tersebut sebagaimana build menjalankannya: direkonstruksi dari lockfile, mengikat masing-masing pada digest tercatatnya, dan membaca konten sumber yang dibawa lockfile alih-alih berkas di disk. Dua konsekuensi perlu diketahui sebelum Anda menjumpainya:

  • Melampirkan plugin transformasi di .aggrega-config.yaml tidak mengubah apa yang dilakukan --release hingga Anda melakukan pull. Ini adalah aturan yang sama yang diikuti build, dan dengan alasan yang sama: kumpulan lampiran adalah input yang menentukan byte, sehingga diadopsi saat pull, bukan saat diedit.
  • Plugin di cache yang byte-nya tidak lagi cocok dengan digest yang dicatat lockfile ditolak, persis seperti saat build.

Jika Release tidak memiliki lockfile, --release tetap memvalidasi — perintah ini memperingatkan bahwa identitas plugin tidak dapat diperiksa dan menyebutkan apa yang perlu dijalankan, alih-alih menolak. Lihat peringatan.

Mengembalikan graf yang dikompilasi

--ir-graph menulis graf yang diselesaikan validasi ini ke keluaran standar sebagai JSON, sebelum baris putusan. Opsi ini bersifat aditif: pemeriksaan yang sama dijalankan, diagnostik yang sama ditulis, dan kode keluarnya sama seperti tanpanya. Graf yang dikembalikan adalah graf yang menjadi dasar validasi, sehingga graf tersebut tidak dapat menggambarkan resolusi yang berbeda dari yang dilaporkan putusan.

Opsi ini hanya berlaku untuk lingkup ini — lingkup seluruh katalog dan entitas tunggal menjalankan harness sintetis alih-alih Release, dan tidak menyelesaikan graf — dan memintanya di tempat lain ditolak alih-alih diabaikan diam-diam. Jika proses berhenti sebelum graf terselesaikan, tidak ada yang ditulis ke keluaran standar dan diagnostik perintah itu sendiri menyebutkan apa yang menghentikannya.

Perhatikan flag di sebelahnya. --response-format menetapkan seberapa banyak laporan perintah ini sendiri yang ditulis (detailed atau concise); --ir-graph meminta dokumen kedua di samping laporan itu. Yang satu mengatur volume, yang lain mengatur subjek, dan keduanya tidak mengubah putusan.

Nilai yang dinyatakan sensitif oleh penulis ditahan dari graf — termasuk values dan infra sebuah koneksi, jika socket komponen konsumennya mendeklarasikan sebuah leaf sebagai sensitif — dalam bentuk terstruktur yang dijelaskan di aggrega inspect. --unredacted di samping --ir-graph justru mencetaknya, dengan ketentuan yang dinyatakan aggrega inspect --unredacted: opsi ini menjangkau graf dan tidak ada hal lain yang ditulis perintah ini, dan ke mana pun keluaran itu sampai, nilai tersebut terbawa dalam bentuk terbuka. Jika diberikan tanpa --ir-graph, opsi ini ditolak, karena tidak ada yang dapat diungkapkannya.

Kebenaran entitas tunggal (sebuah path entitas)

aggrega validate <entity-path> memeriksa satu file entitas katalog. Perintah ini menerapkan serangkaian pemeriksaan bertingkat dan berhenti pada kegagalan pemblokiran pertama, sehingga kerusakan skema muncul dengan jelas sebelum pekerjaan katalog apa pun:

  • Placeholder (setiap jenis) — nilai yang diwajibkan jenisnya tetapi dibiarkan file sebagai string kosong. Semuanya dilaporkan sekaligus, sebelum pemeriksaan lain, masing-masing dengan apa yang diterimanya; lihat placeholder yang masih harus diisi.
  • Amplop skema (setiap jenis) — pemeriksaan JSON-Schema per entitas yang persis sama dengan yang dijalankan pemuat katalog di setiap batas parsing.
  • Bentuk (setiap jenis) — validasi struktural yang khusus untuk jenisnya. Untuk Component atau Feature, ini mencakup membaca setiap selector label yang dideklarasikan file pada socket dependensi atau slot lampiran terhadap tata bahasa selector; lihat selector yang dideklarasikan.
  • Struktur pilar (Component dan Feature) — pemeriksaan pilar spec.schema:, menggunakan SchemaLibraries katalog untuk ekspansi $ref lintas dokumen.

Sebuah Component atau Feature berhenti di situ: amplop skema, bentuk, dan struktur pilar. Sebuah Component tunggal tidak memiliki values atau infra yang ditulis untuk dirender secara terisolasi, sehingga tidak ada yang dirender — kebenarannya sepenuhnya dicakup oleh tingkat skema dan pilar. Setiap kata kunci x-aggrega-* yang ditulis langsung di dalam konten skemanya dilaporkan di antara catatan saran pada standard error sebagai baris warning: yang menyebutkan kata kunci itu, letaknya, dan tabel deklaratif yang perlu ditulis sebagai gantinya; hal ini tidak pernah mengubah verdict maupun kode keluar.

Sebuah Recipe juga dirender secara terisolasi. Ini adalah satu segi kebenaran entitas tunggal, bukan intinya: setelah tingkat skema dan bentuk lolos, validate me-resolve Component implements milik Recipe dari katalog, menyintesis Aggregate, Manifest, dan Release minimal di sekitar satu instans Component tersebut yang terikat pada Recipe yang diuji, lalu menjalankan pipeline kompilasi yang sebenarnya atasnya — pertama resolusi dan guard (dengan render dilewati), kemudian render nyata dari keluaran terisolasi. Setiap nilai wajib dan setiap field infra wajib yang tidak memiliki default diisi dengan placeholder sesuai tipe yang dideklarasikannya — nilai di Aggregate sintetis, infra di Release sintetis — dan setiap nilai serta field infra lainnya mengambil default skemanya melalui resolver; Release mengarahkan instans ke batas default sintetis dan tidak mendeklarasikan values: maupun compute yang tidak dideklarasikan Aggregate. Placeholder adalah nilai yang diterima oleh batasan yang dideklarasikan field itu sendiri: konstanta atau nilai pertama yang dicantumkan enum, angka dalam batasnya, string dengan panjangnya dan dalam format-nya, versi semantik bila pattern-nya memintanya, item list sebanyak yang diwajibkannya, dan setiap properti yang diwajibkan objek. pattern lainnya, kondisi validate: atau when:, komposisi skema, dan batasan tentang item apa yang dimuat list tidak diperhitungkan, sehingga field yang bergantung padanya mungkin tetap menolak placeholder-nya; validate kemudian melaporkan penolakan itu dengan kata-kata skema itu sendiri. Artefak yang dirender dicetak agar penulis melihat keluaran terisolasi sebelum menghubungkan entitas ke dalam Aggregate lengkap. Karena harness entitas tunggal hanya mengisi field wajib tersebut, tidak menghubungkan koneksi apa pun, dan tidak memasang Feature apa pun, Recipe yang templatnya membaca nilai yang hanya dikirim oleh koneksi atau Feature yang terpasang tidak dapat dirender secara terisolasi; validate melaporkan render seperti itu sebagai tidak dicoba, bukan gagal. Asersi yang memanggil fail dilaporkan sebagai peringatan alih-alih menggagalkan pemeriksaan — lihat asersi yang gagal adalah peringatan. Render yang berhenti karena alasan lain tidak selesai, dan validate melaporkannya dengan diagnostik render yang mendasarinya hingga kalimat yang menyebutkan apa yang menghentikannya.

Recipe yang source:-nya harus diambil sama sekali tidak dirender, dan Recipe yang rendernya berhenti saat membaca nilai yang hanya disediakan oleh koneksi atau Feature yang terpasang akan dikesampingkan rendernya — lihat apa yang tidak diperiksa oleh kebenaran entitas tunggal di bawah.

Sebuah FeatureRecipe diperiksa skema dan bentuknya; rendernya dilewati, karena FeatureRecipe hanya dirender saat dipasang pada komponen host, dan menyintesis host yang lolos guard untuk Feature sembarang tidak dicoba.

Memeriksa entitas dalam konteks sebuah Release

Sebuah workspace dapat memberi setiap Release direktori katalognya sendiri — lihat Memberi Release direktori katalognya sendiri — sehingga menyimpan satu varian katalog per Release berdampingan. Path entitas yang diberikan sendiri diperiksa atas direktori katalog milik workspace, tempat referensi ke salah satu varian tersebut — Component yang diimplementasikan Recipe, SchemaLibrary yang dirujuk pilar — tidak ditemukan. Berikan --release di samping path entitas dan pemeriksaan yang sama berjalan dalam konteks Release tersebut: referensi entitas di-resolve melalui direktori katalog yang diberikan konfigurasi workspace untuk Release itu, dengan --catalog apa pun ditambahkan di depan, yaitu direktori yang dibaca oleh build Release tersebut.

Contoh MariaDB + Adminer menyimpan empat varian seperti itu. Component pada varian synth-nya mengambil pengaturan penyimpanannya dari SchemaLibrary yang hanya dimuat varian synth dan chart, sehingga ia lolos validasi dalam konteks Release yang melakukan build dengannya:

$ aggrega validate catalog-helm-synth/component/mariadb.yaml --release release-helm-synth.yaml
Entity: catalog-helm-synth/component/mariadb.yaml
Kind: Component
Schema: valid
Pillars: valid

dan gagal, dengan menyebutkan library yang tidak dapat di-resolve, dalam konteks Release yang direktorinya tidak memuatnya — --release release-compose.yaml, atau tanpa --release sama sekali di workspace yang tidak mencantumkan direktori katalognya sendiri.

Recipe diperiksa dengan cara yang sama. Recipe varian synth mengimplementasikan core/datastore/mariadb, yang tidak dimuat direktori katalog milik workspace, sehingga bila diberikan sendiri ia gagal dengan render: implements target "core/datastore/mariadb" not found in catalog. Bila diberikan Release yang melakukan build dengannya, ia me-resolve Component milik Release itu dan dirender secara terisolasi:

$ aggrega validate catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yaml --release release-helm-synth.yaml
Entity: catalog-helm-synth/recipe/helm/mariadb-synth/1.0.0/recipe.yaml
Kind: Recipe
Schema: valid
Shape: valid
Attachments: required attachment slots not checked (root_password)
Validating a Recipe on its own places its Component in a build that attaches
no Feature, so nothing exists to fill a required slot. Whether each of these
slots is filled is checked when a Release that deploys the Component is built.
Resolution: valid
Render: 3 artifact(s)

diikuti oleh tiga artefak yang dirender. Setiap varian contoh itu mendeklarasikan core/datastore/mariadb, sehingga Recipe lolos validasi dalam konteks masing-masing dari keempat Releases-nya; dalam konteks Release yang direktori katalognya tidak memuat Component seperti itu, ia gagal dengan menyebutkan targetnya, seperti halnya tanpa --release. Baris Attachments: dijelaskan di slot attachment wajib atau mandat kehadiran.

Ini tetap cakupan entitas tunggal. Pemeriksaan, laporan, dan kode keluar adalah yang dijelaskan bagian ini — Component atau Feature yang membawa selector socket atau slot yang ditolak tata bahasa gagal di sini persis seperti tanpa --release, lihat selector yang dideklarasikan — dan tidak ada closure yang divalidasi: --release menyebutkan Release yang direktori katalognya digunakan untuk membaca referensi entitas, bukan closure untuk diperiksa, itulah sebabnya --ir-graph ditolak di samping path entitas. --release yang menyebutkan file yang tidak ada, atau menyebutkan direktori, ditolak sebelum apa pun diperiksa.

Direktori yang dicantumkan konfigurasi workspace tetapi bukan sebuah direktori — misalnya karena tidak ada apa pun di sana — untuk Release tersebut, atau untuk workspace bila --release tidak diberikan, ditolak sebelum apa pun diperiksa, sebagaimana setiap perintah yang membaca katalog itu menolaknya (Dari mana entitas lokal dibaca): penolakan menyebutkan entri, file konfigurasi dan baris yang mencantumkannya, serta pengaturannya, dan tidak ada putusan yang diberikan. Pemeriksaan entitas editor melalui aggrega serve memberikan penolakan yang sama sebagai satu-satunya entri pada file entitas, pada tingkat galat, dan tool validate dari aggrega mcp menolak panggilan tersebut dengannya.

Placeholder yang masih harus diisi

Nilai yang diwajibkan oleh jenisnya tetapi dibiarkan berupa string kosong oleh file merupakan placeholder, dan validate melaporkannya sebelum hal lain. Dokumen yang dirancang oleh aggrega scaffold memuat placeholder di setiap tempat jenisnya memerlukan nilai yang hanya dapat Anda berikan, sehingga di sinilah Anda mengetahui mana yang masih tersisa. Berikut FeatureRecipe hasil rancangan yang hanya versinya telah diisi:

Entity: my-feature-recipe.yaml
Kind: FeatureRecipe
2 placeholders still owed in my-feature-recipe.yaml; an empty required value is not a value, so each of these needs one before the document validates:
7:3: spec.capability takes what its schema describes: The explicit provider capability this recipe binds to (e.g., 'helm', 'terraform', 'compose') — the provider kind that renders it.
8:3: spec.implements takes what its schema describes: Declares which catalog Feature type this recipe is able to implement (including credential Features labeled feature.aggrega.ai/kind: secret; exact version, major-compatible range '^', or unversioned).

Setiap placeholder dalam file disebutkan sekaligus, sesuai urutan dokumen, beserta baris dan kolomnya serta apa yang diterimanya. Apa yang diterimanya dibaca dari skema jenis itu sendiri: nilai yang diterimanya bila skema mencantumkannya, versi semantik seperti 1.0.0 bila skema memintanya, dan selain itu kalimat pertama dari deskripsi skema sendiri tentang field tersebut.

Nilai mana yang dihitung juga dibaca dari skema. Sebuah nilai dihitung bila jenisnya mewajibkannya di tingkat teratas dokumen, atau di dalam objek yang juga diwajibkan oleh jenisnya, dan file menetapkannya ke string kosong. Kunci yang sama sekali tidak dicantumkan file dilaporkan oleh pemeriksaan skema sebagai properti yang hilang. Field opsional yang dibiarkan kosong bukan placeholder, demikian pula field yang hanya diwajibkan di dalam list atau map yang Anda pilih untuk ditulis. Bila skema sendiri mencantumkan string kosong di antara nilai yang diterima suatu field, nilai kosong adalah nilai, bukan placeholder.

Sebuah nilai tetap harus diisi meskipun skema akan menerimanya kosong. Skema mengizinkan string kosong untuk capability dan implements pada Recipe atau FeatureRecipe, tetapi nilai kosong tidak menyebutkan provider maupun tipe apa pun, sehingga validate melaporkan keduanya sebagai placeholder seperti yang lain. Bila pemeriksaan skema juga menolak file yang sama — versi kosong, label tipe tanpa nilai — laporan memuat kode pemeriksaan itu, E0215, seperti yang ditunjukkan contoh pada aggrega scaffold; bila pemeriksaan skema menerimanya, seperti di atas, laporan tidak memuat kode. Temuan dalam file yang sama yang tidak berkaitan dengan nilai kosong tetap dilaporkan, dengan kata-kata pemeriksaan skema sendiri, sebelum daftar tersebut.

Pembacaan ini termasuk dalam validasi entitas tunggal, dengan atau tanpa --release di samping path entitas. Run seluruh katalog yang menemui dokumen yang sama melaporkan apa yang dilaporkan pemeriksaan skema, sehingga FeatureRecipe dengan implements kosong di dalam direktori katalog lolos; cakupan Release dan aggrega build juga tidak menerapkan pembacaan ini.

Jenis yang tidak diterima cakupan ini

Validasi entitas tunggal menerima Component, Feature, Recipe, FeatureRecipe, Workload, dan Plugin. File dengan jenis lain ditolak, dan penolakan tersebut menyebutkan jenis yang diterima serta, untuk jenis entitas, cakupan yang memang memeriksa dokumen dengan jenis itu:

kind "Aggregate" in "aggregate.yaml" is not a single-entity validation target; the kinds this scope accepts are Component, Feature, Recipe, FeatureRecipe, Workload and Plugin. An Aggregate is checked by the whole-catalog scope when it sits in a catalog directory, and by the Release scope over a Release that deploys it

Cakupan seluruh katalog adalah run tanpa argumen, dan cakupan Release adalah --release tanpa path entitas:

JenisDiperiksa oleh
Aggregaterun seluruh katalog, bila berada di direktori katalog; --release atas Release yang men-deploy-nya
Manifest--release atas Release yang menyebutkannya
Release--release <release-path>
SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibraryrun seluruh katalog, bila berada di direktori katalog

Run seluruh katalog hanya membaca apa yang berada di dalam direktori katalog yang dikonfigurasi, sehingga Aggregate yang disimpan di root workspace di samping Release-nya diperiksa melalui --release atas Release tersebut.

Asersi yang gagal adalah peringatan

Asersi yang memanggil fail — yang dideklarasikan Recipe, atau yang dideklarasikan Component implements-nya — dilaporkan sebagai peringatan, dan pemeriksaan tidak gagal karenanya. Release yang disintesis memuat placeholder dan nilai default skema sebagai pengganti nilai yang ditetapkan Release sungguhan, sehingga asersi atas nilai semacam itu, sebuah image, atau keberadaan prasyarat, gagal di sini terlepas dari benar tidaknya Recipe, dan validate tidak dapat membedakan asersi yang menunggu Release dari asersi yang rusak. Keputusan atas asersi diserahkan kepada build, yang selalu memiliki Release.

Peringatan ditulis ke standard error, diawali dengan warning:, setelah catatan anjuran apa pun. Peringatan memuat pesan lengkap asersi — entitas, instans, nama asersi, dan kalimat yang ditulis pembuatnya — diakhiri dengan satu kalimat lagi:

A Release must satisfy this assertion before a build of it can pass.

Laporan di standard output menyebutkan di mana run berhenti, dan perintah keluar dengan 0. Asersi milik Recipe sendiri menghentikan render, sehingga laporan berbunyi Render: stopped on a failed assertion, reported as a warning setelah Resolution: valid. Asersi Component dievaluasi sebelum apa pun di-render, sehingga laporan berbunyi Resolution: stopped on a failed assertion, reported as a warning, diikuti oleh Render: not attempted (the run stopped on that assertion). Dalam kedua kasus tidak ada yang di-render, sehingga tidak ada artefak yang dicetak.

Hanya asersi yang memanggil fail yang menjadi peringatan. Asersi yang berhenti pada kunci yang dibacanya tetapi tidak ditemukan, atau yang tidak dapat di-parse, merupakan kesalahan dalam teks asersi itu sendiri, bukan asersi yang gagal, dan dinilai seperti penghentian lainnya. Setiap kesalahan lain tetap menjadi keputusan pemeriksaan.

aggrega build atas Release yang tidak memenuhi asersi berhenti karenanya dengan error, menyebutkan asersi tersebut dan memuat kalimat pembuatnya, seperti biasanya, dan aggrega validate --release atas Release tersebut gagal karenanya dengan error yang sama. Pemeriksaan entitas di editor melalui aggrega serve memberikan peringatan yang sama, ditandai pada kunci asersi itu sendiri bila Recipe yang mendeklarasikannya, dan tool validate dari aggrega mcp menjawab valid: true dengan peringatan tersebut di antara notices-nya.

Apa yang tidak diperiksa oleh kebenaran entitas tunggal

Empat pemeriksaan build sungguhan berada di luar jangkauan build satu entitas, dan validate menolak masing-masing alih-alih melaporkan temuan yang tidak dapat dipertanggungjawabkannya.

Sumber yang harus diambil

Validasi satu entitas tidak membaca lockfile, tidak membaca maupun menulis cache, dan tidak membuat permintaan jaringan. Recipe yang source:-nya menyebutkan sesuatu yang diambil melalui transport — repositori chart OCI atau HTTPS, repositori Git — karenanya tidak memiliki kode infrastruktur untuk di-render: chart atau modul tersebut tidak ada di mana pun yang dapat dijangkau run, dan tidak ada yang salah dalam file yang diperiksa. Validate menyatakan hal itu, mencetaknya sebagai hasil yang berbeda dari render, dan keluar dengan 0:

Entity: catalog/recipe/helm/openbao/1.0.0/recipe.yaml
Kind: Recipe
Schema: valid
Shape: valid
Resolution: valid
Render: not attempted (this Recipe's source is fetched)
Validating one entity on its own reads no lockfile, reads and writes no
cache, and makes no network request, so the chart or module this Recipe
names is never retrieved and there is nothing to render from. To render
it, build a Release that deploys a component this Recipe implements.

Semua yang berada di atas baris itu telah diperiksa dan dilaporkan valid. Arti kode keluar untuk Recipe semacam itu karenanya lebih sempit daripada untuk Recipe yang berhasil di-render — skema, bentuk, dan resolusi terpenuhi; render belum terbukti — dan laporan menyatakan mana dari keduanya yang sedang Anda baca.

Sumber yang sudah dimiliki workspace tidak ditolak. source: ./module yang relatif tidak memerlukan pengambilan, sehingga render-nya dicoba seperti yang lain, dan kegagalan di dalamnya merupakan temuan nyata yang dilaporkan sebagai Render: not completed in isolation dengan kode keluar bukan nol. Baris di atas hanya muncul untuk sumber yang harus diambil.

Untuk me-render Recipe bersumber ambilan secara sungguhan, jalankan aggrega build atas Release yang men-deploy komponen yang diimplementasikan Recipe tersebut: build me-resolve sumber melalui lockfile Release dan cache lokal, yang menyediakan byte yang tidak dapat diperoleh validate.

Soket uses yang wajib

Yang kedua adalah apakah soket uses dengan required: true pada Component implements sudah terisi.

Soket yang wajib diisi dengan menghubungkan sebuah edge ke komponen lain — dari blok uses milik Aggregate itu sendiri, atau dari Release yang menghubungkan soket yang dideklarasikan Component. Harness sintetis hanya memuat satu instans, sehingga tidak ada komponen kedua yang dapat dituju edge semacam itu, dan tidak ada penulisan dokumen sintetis yang dapat menghasilkannya: menciptakan rekan berarti menciptakan komputasi yang tidak pernah dideklarasikan harness. Karena itu, validate menyebutkan soket yang tidak diperiksanya dan melanjutkan melalui resolusi dan render:

Sockets: required uses sockets not checked (backend, cache, registry)
Validating a Recipe on its own places its Component in a build of one,
so no other component exists for a required socket to be wired to. Whether
each of these sockets is populated is checked when the Component is deployed
in an Aggregate.

Baris ini hanya muncul ketika Component mendeklarasikan setidaknya satu soket wajib, dan hanya menyebutkan soket yang wajib — soket opsional tidak pernah dicantumkan, karena membiarkannya tidak terhubung bukanlah temuan pada cakupan mana pun. Recipe yang Component-nya tidak mendeklarasikan soket wajib tidak menghasilkan baris semacam itu, dan laporannya tidak berubah.

Aturan itu sendiri tidak dilonggarkan maupun diduplikasi; aturan itu diajukan pada cakupan yang dapat menjawabnya. aggrega build menerapkannya sepenuhnya atas permukaan edge Aggregate dan Release bersama-sama, dan berhenti pada soket wajib yang tidak dihubungkan apa pun. Jadi, Recipe yang lolos validasi entitas tunggal tetap harus memenuhi aturan soket wajib ketika Component-nya di-deploy, dan laporan menyatakan hal itu alih-alih membiarkan perbedaan diam-diam antara apa yang diperiksa validate dan apa yang akan diperiksa build.

Slot lampiran yang wajib atau mandat keberadaan

Yang ketiga adalah apakah slot lampiran dengan required: true pada Component implements — titik pengikatan bernama yang dideklarasikan featuresSchema-nya — sudah terisi, dan apakah lampiran dari setiap tipe Feature yang dituntut mandat keberadaannya ada.

Slot yang wajib diisi dengan melampirkan sebuah Feature pada nama tersebut, di Aggregate atau di Release, pada komponen atau pada cakupan di atasnya — tempat Component di-deploy, bukan di Recipe. Harness sintetis tidak melampirkan Feature apa pun, sehingga tidak ada yang dibangunnya yang dapat mengisi slot semacam itu. Karena itu, validate menyebutkan slot yang tidak diperiksanya dan melanjutkan melalui resolusi dan render, persis seperti yang dilakukannya untuk soket wajib:

Attachments: required attachment slots not checked (root_password)
Validating a Recipe on its own places its Component in a build that attaches
no Feature, so nothing exists to fill a required slot. Whether each of these
slots is filled is checked when a Release that deploys the Component is built.

Baris ini hanya muncul ketika Component mendeklarasikan setidaknya satu slot wajib, dan hanya menyebutkan slot yang wajib; Recipe yang Component-nya tidak mendeklarasikan slot wajib tidak menghasilkan baris semacam itu. Hanya persyaratannya yang dikesampingkan: batasan label slot dan mekanisme pengiriman yang diizinkan tetap seperti yang dideklarasikan. Templat yang tidak dapat di-parse tetap menggagalkan run, demikian pula kesalahan milik Recipe itu sendiri seperti Workload yang tidak dapat disintesis oleh provider — kecuali Recipe juga membaca nilai yang hanya disediakan oleh koneksi atau Feature yang dilampirkan, seperti dijelaskan bagian berikutnya.

Mandat keberadaan — anotasi features.aggrega.ai/requiredType.<label> pada Component, yang menuntut agar suatu lampiran membawa tipe Feature yang disebutkannya — dikesampingkan karena alasan yang sama: harness tidak melampirkan apa pun, sehingga tidak ada yang dibangunnya yang dapat membawa tipe tersebut. Validate menyebutkan setiap mandat yang tidak diperiksanya berdasarkan labelnya dan tipe yang dituntutnya, lalu melanjutkan melalui resolusi dan render. example/compute/service dari pustaka standar mendeklarasikan satu mandat, sehingga Recipe-nya melaporkan, sebelum kedua artefaknya yang dirender:

$ aggrega validate aggrega-catalog/recipe/helm/service/1.0.0/recipe.yaml --catalog aggrega-catalog
Entity: aggrega-catalog/recipe/helm/service/1.0.0/recipe.yaml
Kind: Recipe
Schema: valid
Shape: valid
Attachments: presence mandates not checked (monitoring: core/prometheus-exporter)
Validating a Recipe on its own places its Component in a build that attaches
no Feature, so nothing exists to carry a type the Component requires. Whether
an attachment of each of these types is present is checked when a Release
that deploys the Component is built.
Resolution: valid
Render: 2 artifact(s)

Mandat yang deklarasinya tidak dapat dievaluasi — prefiks anotasi tanpa label setelahnya, atau nilai yang bukan tipe Feature — tidak dikesampingkan: itu adalah kesalahan milik Component itu sendiri, yang tidak dapat diperbaiki oleh lampiran apa pun, dan validate menggagalkan run karenanya seperti yang dilakukan build.

Setiap aturan diajukan di tempat aturan itu dapat dijawab. aggrega pull, aggrega build, dan aggrega validate --release mengevaluasi keduanya atas lampiran nyata Release, dan masing-masing berhenti pada slot wajib yang tidak diisi apa pun dan pada tipe yang dimandatkan yang tidak dibawa lampiran mana pun.

Nilai yang hanya disediakan oleh koneksi atau Feature yang dilampirkan

Yang keempat adalah apakah sebuah Recipe dapat dirender setelah koneksinya dan Features yang dilampirkan menyediakan apa yang dibaca templatnya.

Templat sebuah Recipe membaca apa yang dikirimkan koneksi di bawah .context.inject dan .context.uses, serta apa yang dikirimkan Feature yang dilampirkan di bawah .features. Harness sintetis tidak menghubungkan koneksi apa pun dan tidak melampirkan Feature apa pun, sehingga setiap pembacaan semacam itu tidak menemukan apa-apa: pembacaan di bawah .context.inject.env menemui pipa pengiriman yang kosong, dan range atas .context.uses tidak menemui koneksi apa pun. Validate merender Recipe terlebih dahulu, dan render yang selesai dilaporkan seperti biasa. Ketika render berhenti dan templat Recipe — termasuk file dan entri pustaka yang diimpornya — membaca apa pun di bawah ketiganya, validate melaporkan render sebagai tidak dicoba, menyebutkan nilai yang dibaca Recipe di sana, mencetak kalimat tempat render berhenti, dan keluar dengan 0. Varian chart dari contoh MariaDB + Adminer membaca kredensial basis datanya dari pipa pengiriman yang diisi oleh dua secret yang dilampirkannya:

$ aggrega validate catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml --release release-helm-chart.yaml
Entity: catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml
Kind: Recipe
Schema: valid
Shape: valid
Attachments: required attachment slots not checked (root_password)
Validating a Recipe on its own places its Component in a build that attaches
no Feature, so nothing exists to fill a required slot. Whether each of these
slots is filled is checked when a Release that deploys the Component is built.
Resolution: valid
Render: not attempted (this Recipe reads values a build of one cannot supply)
Validating a Recipe on its own places its Component in a build that wires
no connection and attaches no Feature, so nothing supplies what its
templates read under .context.inject, .context.uses or .features. Its
render stopped, and whether on one of those values or on a fault of its
own is not judged here. To render it, build a Release that deploys a
component this Recipe implements.
Reads: .context.inject.env.MARIADB_PASSWORD, .context.inject.env.MARIADB_ROOT_PASSWORD
The render stopped: rendering: [CATALOG_ERROR] instance instance: rendering node "instance": [CATALOG_ERROR] catalog-helm-chart/recipe/helm-chart/mariadb-chart/1.0.0/recipe.yaml: recipe "mariadb-chart" valuesMapping: [CATALOG_ERROR] valuesMapping[mariadb-chart]: template "valuesMapping[mariadb-chart]" execute: template: valuesMapping[mariadb-chart]:7:30: executing "valuesMapping[mariadb-chart]" at <.context.inject.env.MARIADB_ROOT_PASSWORD>: nil pointer evaluating interface {}.MARIADB_ROOT_PASSWORD

Pembacaan yang tidak menemukan apa-apa dan tidak menghentikan apa pun tidak dikesampingkan: range atas .context.uses yang tidak merender apa pun, dalam render yang selesai, dilaporkan sebagaimana render itu adanya.

Yang menentukan adalah apa yang dibaca Recipe, bukan tempat render berhenti, dan hal itu memiliki konsekuensi yang perlu Anda ketahui sebelum menjumpainya: kesalahan milik Recipe itu sendiri dalam Recipe yang juga membaca nilai semacam itu — misalnya kunci yang salah eja — dilaporkan sebagai tidak dicoba bersama yang lain, bukan sebagai kegagalan. Baris The render stopped: memuat kalimat render itu sendiri sehingga Anda dapat melihat yang mana yang terjadi, dan build dari Release yang men-deploy Component tersebut menilai render secara penuh.

Dua kesalahan tetap menggagalkan run apa pun yang dibaca Recipe, karena tidak ada koneksi atau Feature yang mengubahnya: templat yang tidak dapat di-parse, dan referensi yang ditolak render — root yang tidak didefinisikan oleh konteks render, atau kunci yang salah ketik di bawah root yang bentuknya tetap, seperti .context.instance_idd. Asersi yang dideklarasikan Recipe yang memanggil fail tidak dikesampingkan dan bukan pula kegagalan, apa pun yang dibaca Recipe: asersi itu dilaporkan sebagai peringatan, sebagaimana asersi yang gagal selalu dilaporkan. Recipe yang templatnya tidak membaca satu pun dari ketiganya rendernya dinilai secara penuh, dan render yang berhenti gagal dengan kalimat yang menyebutkan penyebabnya.

Alat validate dari aggrega mcp memberikan putusan yang sama atas Recipe yang sama: render yang dikesampingkan dengan cara ini dijawab sebagai valid tanpa apa pun dalam diagnostiknya, dan baris-baris di atas terdapat dalam teks yang dikembalikannya di samping diagnostik tersebut.

Pemuatan katalog dalam mode entitas tunggal bersifat toleran: entitas rusak yang tidak terkait di tempat lain dalam katalog dilewati alih-alih membatalkan pemeriksaan, sehingga tidak pernah menghalangi validasi target secara terisolasi.

File yang dilewati tetap menjelaskan Component yang hilang karenanya. Jika target implements sebuah Recipe tidak ditemukan dan tepat satu file yang dilewati mendeklarasikan Component tersebut, laporan diawali dengan penolakan file itu sendiri — path-nya, batasan yang dilanggarnya, dan kode singkat kondisi di bagian kepala — diikuti oleh note: yang menyatakan bahwa file tersebut dilewati saat pemuatan, sehingga katalog tidak memuat apa pun di bawah identitas yang dideklarasikannya, lalu oleh kegagalan implements target … not found in catalog sebagai alasan file itu dibutuhkan. Jika tidak ada file yang dilewati yang mendeklarasikan Component tersebut, atau lebih dari satu yang mendeklarasikannya, kegagalan tidak ditemukan itulah yang tampil lebih dulu dan setiap file yang dilewati dicantumkan di bawahnya di bawah note: catalog files skipped at load. Inilah penjelasan yang diberikan aggrega build tentang file yang dilewatinya, dan pemeriksaan entitas editor melalui aggrega serve serta alat validate dari aggrega mcp juga memberikannya. Katalog yang tidak melewati apa pun melapor persis seperti biasanya.

Hubungan validate dengan lint dan build

Ketiga perintah ini menjawab tiga pertanyaan yang berbeda:

  • aggrega validate — apakah ini benar? Skema, pilar, referensi, extends, kapabilitas jenis input, dan render terisolasi. Perintah ini tidak membaca status runtime apa pun dan tidak menghasilkan artefak.
  • aggrega lint — apakah ini mengikuti konvensi publikasi katalog? Penamaan, keselarasan direktori kategori, prefiks anotasi, besaran kenaikan versi, dan bagian lain dari disiplin publikasi yang bersifat opsional. Lint mencerminkan tiga cakupan validate, tetapi tidak pernah memeriksa kebenaran.
  • aggrega build — mengompilasi deployment yang lengkap. Build memerlukan closure Aggregate + Manifest + Release yang lengkap dan menghasilkan artefak native provider. Perintah ini memvalidasi closure dependensinya sendiri sebagai bagian dari kompilasi, lalu melakukan render. aggrega validate --release adalah validasi dependensi tersebut secara tersendiri, tanpa render; validate entitas tunggal mengisolasi render satu Recipe tanpa Aggregate yang lengkap.

Contoh

Validasi seluruh katalog:

aggrega validate --catalog ./catalog

Validasi tepat apa yang menjadi dependensi satu Release, sebelum membangunnya:

aggrega validate --release releases/production.yaml

Validasi satu entitas, dan — untuk Recipe — lihat output render terisolasinya:

aggrega validate core/datastore/postgres/recipes/helm.yaml

Validasi satu entitas dalam konteks Release yang diberi direktori katalog sendiri oleh konfigurasi workspace:

aggrega validate core/datastore/postgres/recipes/helm.yaml --release releases/production.yaml

Lihat juga

  • ./aggrega-lint.md — padanan untuk konvensi di tiga cakupan yang sama.
  • ./aggrega-build.md — mengompilasi Aggregate + Release yang lengkap menjadi artefak; memvalidasi penutupan dependensinya sebagai bagian dari kompilasi.
  • ./aggrega-inspect.md — mengkueri graf IR setelah resolusi tanpa melanjutkan ke render.
  • ../errors/warnings.md — temuan bersifat saran yang ditampilkan validate sebagai baris notice:.

Sinopsis

aggrega validate [entity-path] [flags]

Deskripsi

Check CORRECTNESS across three symmetric scopes.
With no argument, validate checks the WHOLE catalog: schema-pillar
structure, cross-document library resolution, extends chains, and provider
input-kind capabilities, over every catalog entity. Where the workspace
configuration gives its Releases catalog directories of their own under
workspace.releases, it checks the catalog once for each Release, over the
directories that Release reads, and reports each pass under a line naming
its Releases and those directories; Releases reading the same directories
share one pass.
With --release, validate checks the entities a Release's dependency closure
reaches: closure-scoped pillars, extends, and pre-render authored-value
conformance — the same correctness a build applies, scoped to that Release.
It then evaluates the Recipe and FeatureRecipe assertions against the values
that Release resolves to, as a build does before it renders, and reports a
failing assertion as a build reports it. Nothing is rendered.
With an entity path, validate checks one entity file. The kinds it accepts
as a single-entity target are Component, Feature, Recipe, FeatureRecipe,
Workload and Plugin. A value the kind requires that the file leaves empty is
reported first, as a placeholder still owed: every one is named at once, with
what it takes, read from the kind's own schema. That reading is this scope's
alone; a whole-catalog run, a Release's closure and a build do not apply it.
Each kind then has its schema checked, then the checks its own kind carries:
pillar structure for a Component or Feature; shape for a Workload,
FeatureRecipe or Plugin; and for a Recipe, shape plus an end-to-end compile
against a minimal generated harness, so its resolution, its guards and a
render of its output are all exercised. Where that Recipe's source is one
that has to be fetched, the render is reported as not attempted instead:
validating one entity on its own reads no lockfile, reads and writes no cache
and makes no network request, so the chart or module it names is never
retrieved and there is nothing to render from. A render that stops while the
Recipe's templates read what only a connection or an attached Feature
supplies — anything under .context.inject, .context.uses or .features — is
reported as not attempted too: the generated harness wires no connection and
attaches no Feature, so that render cannot be judged there, and a fault of
the Recipe's own beside such a read is set aside with it. A template that
does not parse and a reference the render refuses still fail. An assertion
that calls fail, the Recipe's own or one its Component declares, is printed
as a warning closed by a sentence saying a Release must satisfy it before a
build can pass, and does not fail the check: the generated harness sets none
of a real Release's values, so it cannot tell an assertion waiting on one from
one that is broken, and a build still halts on it. Any other kind is refused here
today, and the refusal names the scope that checks it instead: a whole-catalog
run reaches an Aggregate and the library kinds when they sit in a catalog
directory, and --release reaches a Release, the Manifest it names and the
Aggregate it deploys.
With an entity path and --release together, the entity is checked in that
Release's terms: its references — the Component a Recipe implements, a
library a pillar refers to — resolve through the catalog directories the
workspace configuration gives that Release rather than the workspace's own,
so a workspace keeping one catalog variant per Release checks an entity
against the variant that Release builds with. The checks are the entity
path's; no closure is validated.
The command writes nothing to disk.

Flag

FlagDefaultDeskripsi
--catalog[]Direktori katalog; dapat diulang. Setiap —catalog <dir> ditambahkan di awal tumpukan pencarian katalog (kecocokan pertama yang menang): catalog_dirs milik workspace, atau, untuk Release yang diberi direktori sendiri oleh konfigurasi workspace di bawah workspace.releases, milik Release tersebut; tumpukan diakhiri dengan direktori bernama catalog di root workspace jika ada. Daftar catalog_dirs yang ditulis kosong tidak membaca katalog lokal sama sekali.
--ir-graphfalseJuga menulis graf IR yang dihitung oleh eksekusi ini ke stdout, sebagai JSON, selain semua yang sudah dihasilkan perintah ini. Nilai yang dinyatakan sensitif oleh penulis tidak disertakan di dalamnya; berikan —unredacted untuk mencetaknya. Berlaku untuk cakupan —release, satu-satunya cakupan yang meresolusi Release menjadi graf. Flag ini memilih sebuah DOKUMEN, sedangkan —response-format menentukan seberapa banyak laporan perintah ini sendiri yang ditulis; keduanya tidak memengaruhi putusan maupun kode keluar
--no-unsupported-field-warningsfalseMembungkam kelas peringatan unsupported-field: pemberitahuan yang dimunculkan target untuk sesuatu yang Anda tulis tetapi tidak dapat dipenuhinya — field Workload yang tidak dapat diekspresikannya (seperti pada target berfidelitas lebih rendah, misalnya compose), atau anotasi aggrega.ai/ yang tidak ditindaklanjutinya untuk jenis input node tersebut. Peringatan render lainnya tetap ditampilkan. Hanya untuk tampilan; tidak mengubah output yang di-render. Berlaku untuk cakupan entitas, satu-satunya cakupan yang melakukan render
--plugin—Path ke .wasm mentah untuk divalidasi terhadap laporan diri describe()-nya — pemeriksaan penulisan sebelum publikasi. Jika berdiri sendiri, memerlukan —type; dengan argumen entitas Plugin, memeriksa silang biner terhadap tipe yang dideklarasikan entitas, klaim kapabilitas, cermin perintah, dan catatan fungsi host.
--release—Path ke YAML Release. Jika berdiri sendiri, memvalidasi seluruh penutupan dependensinya yang telah diresolusi; dengan argumen entitas, memeriksa entitas tersebut dalam konteks Release itu, dengan referensinya diresolusi melalui direktori katalog yang diberikan konfigurasi workspace kepada Release tersebut. Path relatif diresolusi terhadap direktori tempat Anda menjalankan perintah, bukan terhadap root workspace. Jika direktori tersebut tidak berada di workspace mana pun dan tidak ada root yang disebutkan, path absolut menemukan workspace dari folder Release itu sendiri
--response-formatdetailedVolume output untuk cakupan —release, yaitu penutupan Release tanpa argumen entitas: detailed (default) melaporkan setiap diagnostik beserta baris saran; concise melaporkan jumlah diagnostik dan hanya diagnostik pertama. Putusan dan kode keluar identik untuk keduanya.
--type—Tipe Plugin untuk pemeriksaan —plugin yang hanya berupa biner, diverifikasi terhadap tipe yang dilaporkan sendiri oleh biner. Hanya bermakna bersama —plugin; jika entitas Plugin menyediakan tipe, hilangkan flag ini (nilai yang tidak sesuai akan menghentikan proses).
--unredactedfalseMencetak nilai yang dinyatakan sensitif oleh penulis alih-alih menyembunyikannya. Apa pun yang dijangkau output — terminal, pipe, file, rekaman layar — kemudian memuat nilai tersebut dalam bentuk terbuka. Hanya menjangkau graf yang ditulis —ir-graph dan tidak yang lain, sehingga memerlukan —ir-graph