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

Skema Aggrega Wasm Mutator Socket

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

ID skema: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json

Bentuk wire yang dikonsumsi (MutatorInput) dan dihasilkan (MutatorOutput) oleh plugin tata kelola yang dipasang pada peran label-transform. Peran ini berjalan saat konstruksi topologi, setelah graf dibangun dan sebelum graf dinilai: plugin mengembalikan dokumen JSON Patch, dan host menerapkannya pada label node dan tidak pada hal lain, serta menghentikan build pada patch yang menjangkau bagian lain mana pun dari graf. Tipe payload Go, Rust, dan TypeScript dihasilkan dari skema ini ke dalam paket plugin-ABI, sehingga ketiga bahasa membaca dan menulis satu wire yang sama; guest mengimpornya dari paket tersebut, atau melalui kit plugin-nya jika kit tersebut mengekspor ulang tipe-tipe itu.

Salah satu dari bentuk berikut

  • MutatorInput
  • MutatorOutput

Definisi

MutatorInput

Payload yang diserahkan host kepada plugin mutator pada setiap pemanggilan: konteks kompilasi tingkat rilis ditambah proyeksi graf topologi yang membawa label setiap node dan nilai yang dideklarasikan instance-nya.

PropertiJenisWajibDeskripsi
compilation_contextCompilationContextyaMetadata tingkat Release yang dibaca oleh mutator saat menentukan aturan kepatuhan, FinOps, atau tata kelola mana yang berlaku untuk build.
graphMutatorGraphyaProyeksi graf topologi yang diekspos ke plugin mutator: Component setiap node, versinya yang telah di-resolve, labelnya, dan nilai yang dideklarasikan instance-nya. Sengaja dibuat lebih sempit daripada hasil topologi lengkap: edge dan payload fitur tidak diekspos karena tugas mutator adalah pelabelan, bukan pembentukan ulang topologi. Nilai-nilai tersebut ada untuk dibaca, sehingga konfigurasi yang dideklarasikan developer dapat menentukan label; patch hanya menjangkau label dan tidak yang lain, sehingga plugin tidak dapat mengubah nilai tersebut.
sourcesMutatorSource[]tidakBerkas definisi yang dibaca host dan diserahkan kepada plugin apa adanya, sebagai daftar berurutan yang diurutkan menurut path. Host membaca byte tersebut sebagai konten buram dan tidak mem-parse-nya. Tidak ada jika lampiran tidak mendeklarasikan sumber.
settingsobjecttidakObjek pengaturan bebas yang diserahkan host kepada plugin apa adanya. Host tidak mem-parse atau menindaklanjuti isinya. Tidak ada jika lampiran tidak mendeklarasikan pengaturan.

Properti tambahan tidak diizinkan.

MutatorOutput

Bentuk respons yang dihasilkan plugin mutator: daftar dokumen JSON Patch opak yang diterapkan host pada graf topologi. Patch tetap opak di lapisan skema sehingga host tidak perlu menduplikasi parser JSON Patch yang sudah diimplementasikan oleh guest.

PropertiJenisWajibDeskripsi
patchesany[]yaDokumen JSON Patch opak yang diterapkan pada graf topologi, secara berurutan.
errorstringtidakPesan kegagalan yang ditetapkan ketika guest berjalan tetapi tidak dapat menyelesaikan operasinya; tidak ada jika berhasil. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal.

Properti tambahan tidak diizinkan.

CompilationContext

Metadata tingkat Release yang dibaca oleh mutator saat menentukan aturan kepatuhan, FinOps, atau tata kelola mana yang berlaku untuk build.

PropertiJenisWajibDeskripsi
release_namestringyametadata.name dari Release.
environmentstringyaLabel lingkungan tempat Release berjalan (misalnya, dev, staging, prod).

Properti tambahan tidak diizinkan.

MutatorGraph

Proyeksi graf topologi yang diekspos ke plugin mutator: Component setiap node, versinya yang telah di-resolve, labelnya, dan nilai yang dideklarasikan instance-nya. Sengaja dibuat lebih sempit daripada hasil topologi lengkap: edge dan payload fitur tidak diekspos karena tugas mutator adalah pelabelan, bukan pembentukan ulang topologi. Nilai-nilai tersebut ada untuk dibaca, sehingga konfigurasi yang dideklarasikan developer dapat menentukan label; patch hanya menjangkau label dan tidak yang lain, sehingga plugin tidak dapat mengubah nilai tersebut.

PropertiJenisWajibDeskripsi
nodesmap of MutatorNodeyaNode dengan kunci berupa ID node absolut.

Properti tambahan tidak diizinkan.

MutatorNode

Proyeksi per node yang menjadi dasar plugin mutator mengevaluasi aturannya: Component mana yang diimplementasikan node, versi Component tersebut yang di-resolve, label apa saja yang dimiliki node, dan nilai apa saja yang dideklarasikan instance-nya.

PropertiJenisWajibDeskripsi
componentstringyaNama Component dasar yang diinstansiasi oleh node.
resolved_versionstringyaSemantic Version yang persis dari Component yang dipatok resolver untuk node ini.
labelsmap of stringyaLabel duck-typing dan ontologi milik node.
valuesobjecttidakNilai yang dideklarasikan instance komponen node dalam Aggregate, dengan kunci sebagaimana ditulis penulis dan dalam urutan penulis. Setiap template dalam Aggregate telah dievaluasi terhadap parameternya, sehingga nilai yang diangkat menjadi parameter tiba sebagai nilai yang diberikan Release, atau sebagai default parameter tersebut. Hanya nilai milik instance itu sendiri yang ada di sini: default yang dideklarasikan skema Component, dan apa pun yang dikontribusikan Recipe atau Feature, tidak termasuk. Nilai yang dideklarasikan sensitif oleh Component tiba dalam keadaan ditahan, persis seperti putusan tata kelola atas seluruh graf menerimanya: di tempatnya terdapat objek penanda penahanan berkunci tunggal yang sama dengan yang dibawa putusan tersebut, yang menyebutkan alasan yang dideklarasikan, sedangkan nilai sejajar yang tidak dijangkau deklarasi apa pun tiba sebagaimana ditulis. Plugin membacanya untuk memutuskan label mana yang ditambahkan; patch tidak dapat menjangkaunya. Tidak ada jika instance tidak mendeklarasikan nilai.

Properti tambahan tidak diizinkan.

MutatorSource

Satu berkas definisi yang diserahkan kepada plugin: path nama dasarnya dan isi berkas. Keduanya dibawa apa adanya; host tidak mem-parse isinya.

PropertiJenisWajibDeskripsi
pathstringyaNama dasar berkas sumber. Host hanya menyediakan nama dasar, tidak pernah path host absolut, sehingga wire bersifat portabel dan deterministik.
contentstringyaIsi berkas sumber, dibawa apa adanya sebagai string buram.

Properti tambahan tidak diizinkan.