Skema Render Socket Aggrega Wasm Provider
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json
Bentuk wire yang dikonsumsi dan dikeluarkan oleh socket plugin render Provider. Guest Provider merender satu node IR menjadi file keluaran melalui ekspor render_node-nya (RenderNodeInput ke RenderNodeOutput), dan secara opsional menggabungkan keluaran per node pada satu boundary menjadi satu artefak rakitan melalui ekspor assemble_boundary-nya (AssembleBoundaryInput ke AssembleBoundaryOutput). AssembleBoundaryOutput membawa file rakitan beserta diagnostik apa pun; letak file setiap kontributor dideklarasikan satu kali pada kontrak describe() milik guest, bukan pada balasan ini. Guest juga dapat mendeklarasikan ekspor validate_node_input opsional yang memeriksa secara struktural input node yang telah di-resolve sebelum dispatch render: ekspor ini mengonsumsi proyeksi RenderNodeInput yang sama dengan yang diterima render_node dan mengembalikan ValidateNodeOutput yang hanya membawa diagnostik — diagnostik dengan tingkat keparahan halt menghentikan build secara eksplisit, sedangkan diagnostik dengan tingkat keparahan warn ditampilkan pada hasil build. Guest yang target-nya membatasi atau menyaring nama yang diterimanya juga dapat mendeklarasikan ekspor name_bound opsional, yang ditanyakan host sebelum menetapkan identitas component suatu node: ekspor ini mengonsumsi NameBoundInput yang membawa satu nama yang diusulkan dan mengembalikan NameBoundOutput yang membawa satu putusan untuk setiap jenis nama yang akan diturunkan guest darinya. Sebuah putusan membawa batasan — dapat digunakan, atau dibatasi ke panjang yang lebih pendek — dan tidak pernah membawa nama yang dibuat guest, sehingga pengetahuan tentang apa yang diterima target tetap berada di guest. Secara terpisah, guest yang target-nya menurunkan nama sendiri untuk sumber daya yang direndernya — dari sumber yang diberikan penulis, atau dari workload yang disintesisnya — dapat mendeklarasikan ekspor rendered_name opsional, yang ditanyakan host agar penulis Recipe dapat membaca nama tersebut dan memublikasikan alamat yang dibangun darinya: ekspor ini mengonsumsi RenderedNameInput yang membawa identitas yang menjadi dasar penurunan oleh target serta jenis input yang dideklarasikan Recipe milik node, dan mengembalikan RenderedNameOutput yang membawa nama yang akan digunakan guest sendiri saat merender, atau tanpa nama jika guest tidak menurunkan nama apa pun. Kedua ekspor ini merupakan arah yang berlawanan dari satu pokok yang sama dan tidak ada yang dapat menggantikan yang lain — name_bound meminta guest menilai nama yang diusulkan host, sedangkan rendered_name melaporkan nama yang disusun guest, yang dibawa host tanpa membacanya. Guest juga dapat mendeklarasikan carve dan reassemble, yang memotong keluarannya sendiri menjadi unit-unit yang dapat dialamatkan untuk sebuah langkah pipeline dan menyambungkan kembali unit yang telah di-patch, serta link_publish dan link_resolve, yang menghubungkan edge uses yang ujung-ujungnya dirakit ke dalam grup dispatch yang berbeda. Bentuk setiap payload adalah definisi yang disebutkan oleh ekspornya: tabel x-aggrega-exports memetakan setiap ekspor yang digunakan host untuk memanggil guest — termasuk carve dan reassemble — ke definisi input dan definisi output-nya, masing-masing sebagai JSON Pointer ke $defs dokumen ini, sehingga alat yang memvalidasi payload mencari definisinya di sana. Root dokumen tidak mendeklarasikan bentuknya sendiri, karena satu dokumen dapat menjadi payload yang valid bagi beberapa ekspor (objek kosong adalah jawaban yang valid dari validate_node_input, name_bound, maupun rendered_name). Guest mengembalikan byte hasil serialisasi dari setiap file keluaran; host menuliskannya apa adanya dan tidak menjalankan serializer apa pun, sehingga determinisme menjadi tanggung jawab guest: input yang identik harus menghasilkan byte yang identik. 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.
Ekspor
Tabel x-aggrega-exports pada skema memetakan setiap ekspor yang digunakan host untuk memanggil guest ke definisi input dan definisi output-nya. Bentuk sebuah payload adalah definisi yang disebutkan oleh ekspornya.
| Ekspor | Input | Output |
|---|---|---|
render_node | RenderNodeInput | RenderNodeOutput |
validate_node_input | RenderNodeInput | ValidateNodeOutput |
assemble_boundary | AssembleBoundaryInput | AssembleBoundaryOutput |
carve | CarveInput | CarveOutput |
reassemble | ReassembleInput | ReassembleOutput |
name_bound | NameBoundInput | NameBoundOutput |
rendered_name | RenderedNameInput | RenderedNameOutput |
link_publish | LinkPublishInput | LinkPublishOutput |
link_resolve | LinkResolveInput | LinkResolveOutput |
Definisi
RenderNodeInput
Payload yang diterima guest Provider pada ekspor render_node-nya: proyeksi IR per node yang dirender oleh guest, konteks waktu render, input yang telah dievaluasi sebelumnya yang dideklarasikan oleh Recipe yang terikat pada node — daftar sumber yang diperoleh, sebuah workload, sekumpulan artefak — masing-masing hanya ada jika Recipe tersebut mendeklarasikannya, serta entri yang menamai unit terender yang dihilangkan guest dari render sumber.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node | IRNodeProjection | ya | Data IR per node yang dirender oleh guest Provider — proyeksi terbatas dari node IR lengkap yang membawa identitas per node dan provenans yang dicap guest pada setiap manifest yang dihasilkan: id, jenis, recipe yang telah di-resolve, nilai, apakah sebuah pemetaan nilai menghasilkan nilai tersebut, lampiran fitur, penandaan sensitivitas atas kunci-kunci terendernya dan atas nilai secara keseluruhan, edge uses keluar, jalur boundary, sync wave, identitas Recipe, penimpaan component-id, dasar nama turunan, dan provenans build. Identitas dan dasar nama turunan adalah dua bawaan terpisah karena keduanya menjawab dua pertanyaan — milik siapa sebuah resource, dan terhadap apa sumber milik penulis dirender — dan lampiran Feature yang mengirimkan sumber yang ditulis penulisnya adalah tempat kedua jawaban itu berbeda. Konten file sumber tidak dibawa di sini; konten itu dikirim terpisah dalam proyeksi sumber. Setiap himpunan kunci di sini memiliki urutan tetap — fitur dan uses dalam urutan penulis, nilai dan penandaan sensitivitas dalam urutan kunci yang diurutkan — sehingga payload wire identik per byte di setiap eksekusi dengan input yang identik. |
context | object | ya | Konteks waktu render yang diserahkan host kepada guest, dibawa sebagai byte dokumen JSON-nya; skema ini tidak mendeklarasikan objek tersebut. Konteks ini adalah konteks yang diterima langkah pipeline dari node yang sama, ditambah lebar indentasi: parameters, yaitu nilai parameter Release yang diurutkan berdasarkan nama, tidak ada jika tidak ada parameter; annotations, yaitu anotasi node yang dipisahkan berdasarkan tempat masing-masing ditulis menjadi aggregate, release, dan catalog, masing-masing tidak ada jika kosong; boundary, yaitu boundary tempat node berada: name, path (segmen-segmennya), sync_wave (tidak ada jika 0), directory, sub_directory (tidak ada jika tidak ada) dan annotations (himpunan yang diturunkan secara berjenjang oleh boundary Release ke node, dengan milik entri Release-nya sendiri dilapiskan terakhir; tidak ada jika kosong); dan yaml_indent, yaitu lebar indentasi seluruh render yang digunakan guest untuk menyerialisasi output-nya. Render dari FeatureRecipe berlingkup boundary, yang tidak memiliki komponen host, menerima konteks yang diterima langkah pipeline-nya, ditambah yaml_indent: parameters; annotations yang hanya membawa bucket release, yaitu himpunan anotasi milik boundary itu sendiri; dan boundary yang membawa name, path, serta himpunan yang sama tersebut sebagai annotations. Anotasi aggrega.ai/* yang sudah dikenal dibaca dari bucket aggregate dengan bucket release ditulis di atasnya, sehingga kunci yang dibawa keduanya mengambil nilai milik Release; provider pustaka standar membacanya dari himpunan berlapis tersebut dan tidak pernah dari bucket catalog, sehingga nilai katalog tidak pernah menentukan satu pun darinya, dan FeatureRecipe berlingkup boundary, yang konteksnya tidak membawa bucket aggregate, dirender berdasarkan nilai boundary-nya, bukan nilai komponen mana pun. |
source_listing | SourceListing | tidak | Enumerasi generik atas sumber yang diperoleh, yang diserahkan host kepada guest untuk provider bersumber: root sumber, apakah root tersebut sebuah direktori, dan entri relatif terhadap root yang diurutkan di bawahnya. Host tidak membaca konten file di sini — host hanya mendaftar nama. Guest menerapkan logika resolusinya sendiri atas daftar tersebut dan meminta host mengemas pilihan tertentu melalui fungsi host pack-source, sehingga seluruh kecerdasan resolusi sumber per provider berada di dalam guest. Ada untuk provider bersumber; tidak ada untuk yang lain. |
workload_projection | WorkloadProjection | tidak | Workload yang telah dievaluasi sebelumnya yang diserahkan host kepada guest untuk menyintesis manifest asli provider; ada jika Recipe yang terikat mendeklarasikan workload alih-alih sumber chart, dan tidak ada jika sebaliknya. |
artifacts_projection | ArtifactsProjection | tidak | Kumpulan artefak yang telah dievaluasi sebelumnya yang diserahkan host kepada guest untuk ditempatkan ke dalam output node, ada jika Recipe yang terikat mendeklarasikan artefak. Host telah membaca sumber setiap entri, mengevaluasinya sebagai template Go terhadap konteks render, dan menghitung himpunan kunci provenans build; guest menentukan format output, penempatan provenans, jalur di disk, dan byte akhirnya. Tidak ada jika node tidak mendeklarasikan artefak. |
omits | OmitEntry[] | tidak | Entri yang menamai unit terender yang dihilangkan guest dari output node ini, dalam urutan yang dideklarasikan penulis. Setiap entri tiba dalam keadaan telah di-resolve, dengan field berupa string biasa, dan entri yang tidak berlaku untuk build ini tidak dibawa. Apa yang dipilih oleh kind, name, namespace, dan subchart sebuah entri adalah kontrak terdokumentasi milik provider ini sendiri, bukan milik soket ini: guest mencocokkan setiap entri dengan apa yang direndernya dalam istilah formatnya sendiri, menghilangkan setiap unit yang cocok dengan sebuah entri dari semua yang dikembalikannya — file-filenya, nama yang dideklarasikannya di derived_keys, dan fakta yang dilaporkannya di render_facts — dan melaporkan di omitted pada output berapa banyak unit yang cocok dengan setiap entri. Entri-entri ini menyertai daftar sumber dan bukan input lain: render atas workload yang disintesis atau atas kumpulan artefak tidak pernah membawanya. Tidak ada jika tidak ada entri, dan guest yang tidak menerima entri apa pun merender persis seperti jika field ini tidak ada. |
Properti tambahan tidak diizinkan.
IRNodeProjection
Data IR per node yang dirender oleh guest Provider — proyeksi terbatas dari node IR lengkap yang membawa identitas per node dan provenans yang dicap guest pada setiap manifest yang dihasilkan: id, jenis, recipe yang telah di-resolve, nilai, apakah sebuah pemetaan nilai menghasilkan nilai tersebut, lampiran fitur, penandaan sensitivitas atas kunci-kunci terendernya dan atas nilai secara keseluruhan, edge uses keluar, jalur boundary, sync wave, identitas Recipe, penimpaan component-id, dasar nama turunan, dan provenans build. Identitas dan dasar nama turunan adalah dua bawaan terpisah karena keduanya menjawab dua pertanyaan — milik siapa sebuah resource, dan terhadap apa sumber milik penulis dirender — dan lampiran Feature yang mengirimkan sumber yang ditulis penulisnya adalah tempat kedua jawaban itu berbeda. Konten file sumber tidak dibawa di sini; konten itu dikirim terpisah dalam proyeksi sumber. Setiap himpunan kunci di sini memiliki urutan tetap — fitur dan uses dalam urutan penulis, nilai dan penandaan sensitivitas dalam urutan kunci yang diurutkan — sehingga payload wire identik per byte di setiap eksekusi dengan input yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
id | string | ya | Id absolut node di dalam graf topologi. |
type | string | ya | Dideklarasikan dan sengaja ditahan: host selalu mengirimkannya sebagai string kosong. Label jenis komponen node adalah metadata opak, bukan pengalih perilaku, sehingga membawanya di sini hanya akan mengundang guest untuk bercabang berdasarkan label tersebut. Guest membaca string kosong dan tidak boleh menafsirkannya sebagai node yang jenis komponennya belum ditetapkan. (Bentuk node assembly boundary membawa jenisnya sendiri, untuk tujuan yang berbeda.) |
resolved_recipe | string | ya | Dideklarasikan dan sengaja ditahan: host selalu mengirimkannya sebagai string kosong. Identitas Recipe yang terikat sudah sampai ke guest sebagai nama dan versi recipe yang dicapnya ke dalam provenans, sehingga URI yang telah di-resolve tidak menambahkan apa pun yang menjadi dasar render guest. Guest yang perlu mengatribusikan output kepada sebuah Recipe membaca field provenans tersebut sebagai gantinya. |
values | object | tidak | Kamus nilai terender milik node, yaitu himpunan kunci yang menjadi dasar render guest. Kunci tiba dalam urutan yang diurutkan, bukan urutan penulis, dan pengurutan itulah yang membuat payload identik per byte di setiap eksekusi dengan input yang identik; guest yang memerlukan urutan lain menerapkannya sendiri. |
features | object | tidak | Lampiran fitur node yang dikunci berdasarkan alias fitur, membawa bentuk lampiran fitur per node yang sama dengan yang dibawa IR. Setiap entri membawa values, infra, dan pemetaan inject milik lampiran tersebut bersama penandaan sensitivitas turunannya, sehingga guest dapat mengetahui dari payload saja apakah sebuah lampiran menangani materi yang dideklarasikan sensitif. Mempertahankan urutan penulis sehingga payload identik per byte di setiap eksekusi dengan input yang identik. Opak pada lapisan skema ini; guest membaca bentuk entri fitur melalui kontrak wire IR. |
sensitive_rendered_keys | map of string | tidak | Kunci yang dirender yang identitasnya dipulihkan dari datum yang dinyatakan sensitif oleh penulis, masing-masing dipetakan ke deklarasi asal sensitivitas tersebut diwarisi. Dikirim dari host ke guest pada input render — arah yang berlawanan dengan nama yang dinyatakan guest pada output render. Apa yang dinamai sebuah kunci mengikuti bentuk yang dibawa payload ini: pada payload yang membawa values node, kunci tersebut adalah salah satu kunci map itu; pada payload yang membawa workload, kunci tersebut menamai entri dalam map lampiran milik workload itu sendiri, dengan values node kosong. Sebuah kunci hanya ada jika pemulihannya tepat, yaitu menghubungkan deklarasi ke identitas yang dirender tanpa membaca apa pun dari teks kunci itu sendiri dan tanpa penandaan per node atau per lampiran yang disebarkan ke kunci-kunci individual. Karena itu, kunci yang dibuat oleh templat tidak ada, karena tidak ada deklarasi yang menamainya: kunci output valuesMapping sebuah recipe dan konten sebuah artefak ditulis oleh templat, sehingga keduanya tidak menghasilkan kunci di sini — apakah payload semacam itu dihasilkan dari nilai yang dinyatakan sensitif dibawa oleh sensitive_values, dan oleh sensitive_content milik entri artefak itu sendiri. Karena itu, ketiadaan menyatakan bahwa identitas tidak ada kunci yang dapat dipulihkan, bukan bahwa tidak ada apa pun pada payload ini yang membawa materi sensitif — guest yang membaca ketiadaan kunci sebagai izin untuk menampilkan atau mengeluarkan nilai secara terbuka telah membacanya secara terbalik. Kunci tiba dalam urutan terurut, dan itulah yang membuat payload identik per byte di setiap eksekusi dengan input yang identik. |
sensitive_values | boolean | tidak | True jika values yang dibawa payload ini dihasilkan oleh templat yang membaca nilai yang dinyatakan sensitif oleh penulis, atau nilai yang dilacak ke nilai tersebut: valuesMapping milik sebuah Recipe atau FeatureRecipe, yaitu satu templat yang kunci dan nilai outputnya merupakan buatannya sendiri, sehingga tidak ada kunci output tersebut yang dapat dilacak kembali ke datum asalnya dan seluruh map ditandai sebagai gantinya. Nilai ini dibaca dari referensi templat itu sendiri terhadap deklarasi — referensi yang mencapai nilai yang dideklarasikan, templat yang meneruskan seluruh datanya, atau templat yang tidak dapat di-parse, semuanya terhitung — dan tidak pernah dari konten nilai atau nama kunci. Guest yang menyusun teks yang dibaca manusia, berupa penolakan atau peringatan, menjaga setiap nilai dari values node tetap di luar teks tersebut jika nilai ini true, dan menjaga nilai di bawah kunci apa pun yang dinamai sensitive_rendered_keys tetap di luar teks tersebut, terlepas dari nilai ini: keduanya saling melengkapi, satu menamai kunci yang identitasnya dipulihkan secara tepat dan yang ini mencakup map tempat hal itu tidak mungkin. Tidak ada jika tidak ada templat semacam itu yang membaca nilai semacam itu, termasuk values yang merupakan leaf yang dideklarasikan itu sendiri, yang ditandai per kunci dalam sensitive_rendered_keys, dan tidak ada pada payload yang tidak membawa values. Ketiadaan tidak pernah menyatakan bahwa tidak ada nilai yang sensitif. |
values_mapped | boolean | tidak | True jika values yang dibawa payload ini merupakan output dari valuesMapping milik Recipe atau FeatureRecipe yang terikat, bukan values node yang diteruskan sebagaimana ditulis penulis. Guest yang kontraknya sendiri hanya mengikat values yang dihasilkan mapping ke input yang dideklarasikan sumbernya membaca nilai ini, dan membiarkan values yang ditulis untuk hal lain, seperti artefak Recipe, tidak dibaca; guest yang mengikat values node ke sumbernya bagaimanapun values itu dihasilkan tidak membacanya. Nilai ini mencatat cara values dihasilkan dan tidak pernah diturunkan dari nama kunci atau konten nilai. Tidak ada jika tidak ada valuesMapping yang dijalankan, dan pada payload yang tidak membawa values. |
uses | map of string[] | tidak | Dideklarasikan dan sengaja ditahan: host tidak pernah mengisinya, sehingga map ini tidak ada pada setiap payload render. Edge keluar dikonsumsi sebelum dispatch — values yang dipublikasikan edge dihidrasi ulang ke pipa inject milik node itu sendiri, yang telah dievaluasi oleh Recipe menjadi values dan workload yang diterima guest — dan guest yang merakit boundary menerima daftar edge pada inputnya sendiri. Seandainya diisi, map ini akan memetakan edge uses keluar node berdasarkan alias socket, masing-masing membawa id node target socket tersebut secara berurutan sesuai urutan penulis. |
boundary_path | string | tidak | Path boundary node, dicap sebagai anotasi aggrega.ai/boundary-path pada setiap manifest yang dikeluarkan yang membawa blok metadata. |
sync_wave | integer | tidak | Gelombang deployment yang diwarisi node ini dari boundary yang memuatnya (default 0; nilai negatif diizinkan), membawa nilai yang disimpan node IR sebagai sync_wave. Apa yang dilakukan guest dengannya merupakan pilihan guest sendiri, dan mencatat nilai serta mengurutkan berdasarkan nilai tersebut bersifat independen, bukan alternatif — guest dapat melakukan salah satunya, keduanya, atau tidak keduanya. Di antara provider pustaka standar: helm dan helm-chart mengeluarkannya sebagai anotasi argocd.argoproj.io/sync-wave pada setiap resource yang dirender, dan juga sebagai helm.sh/hook-weight pada resource yang sudah ditandai chart sebagai hook Helm; compose mencatatnya sebagai label service sekaligus mengurutkan service dalam file yang direndernya, melalui depends_on di antara service tersebut; cloudformation mengurutkan provisioning stack yang dirakit, dengan mendeklarasikan setiap resource dalam suatu gelombang bergantung pada resource gelombang sebelumnya; terraform mengurutkan blok module dari konfigurasi root tempat boundary dirakit, dengan mendeklarasikan setiap module dalam suatu gelombang bergantung pada module gelombang sebelumnya, dan juga mencatatnya bersama provenance build node. |
recipe_name | string | tidak | Nama Recipe yang terikat, dipasangkan dengan recipe_version untuk membentuk anotasi aggrega.ai/recipe-uri; jika salah satu bagiannya kosong, anotasi tidak dicap. |
recipe_version | string | tidak | Versi Recipe yang terikat, dipasangkan dengan recipe_name untuk membentuk anotasi aggrega.ai/recipe-uri; jika salah satu bagiannya kosong, anotasi tidak dicap. |
label_component_id | string | tidak | Identitas komponen yang aman untuk Kubernetes — tempat resource yang dikeluarkan node ini BERASAL, yaitu yang dicatat provenance dan yang dikueri selector. Jika tidak kosong, nilai ini menggantikan id node sebagai nilai label app.kubernetes.io/name dan aggrega.ai/component-id; kosong berarti id node sudah valid sebagai label dan digunakan secara langsung. Nilai ini dibawa untuk setiap resource yang dikeluarkan lampiran Feature, apa pun cara lampiran tersebut menyampaikannya, sehingga resource lampiran dapat dibedakan dari resource komponen host-nya hanya melalui label. Asal guest menurunkan namanya sendiri adalah nilai terpisah, derived_name_basis, dan keduanya menjawab pertanyaan yang berbeda. |
derived_name_basis | string | tidak | Identitas yang menjadi dasar guest menurunkan namanya sendiri — nama rilis yang dibaca templat penginstal chart, yang juga dapat digunakan guest semacam itu untuk menamai resource yang disintesisnya bagi sebuah komponen, serta prefiks pada file yang dikeluarkan render sumber. Kosong berarti id node digunakan secara langsung, yang merupakan nilai untuk komponen biasa dan untuk lampiran Feature per komponen: lampiran yang menyampaikan chart atau fragmen yang ditulis penulisnya merendernya terhadap nama komponen HOST, karena templat penulis sendiri menamai resource berdasarkan nama tersebut dan nama yang berbeda akan mengganti nama resource yang sudah di-deploy. Node yang id-nya membawa sintaks penanda yang ditolak oleh alfabet nama target membawa nilai ini secara eksplisit, sehingga nama yang diturunkan guest tetap dapat diterima target. Nilai ini sengaja dipisahkan dari label_component_id: guest yang MEMBANGUN resource untuk lampiran Feature alih-alih merender sumber penulisnya menamainya berdasarkan identitas tersebut, sehingga resource milik lampiran tidak dapat bertabrakan dengan resource host-nya, sementara nama yang menjadi dasar render sumber penulis tetap tidak berubah. Keduanya membawa nilai yang sama di mana pun identitas node juga merupakan dasar render sumbernya. |
output_labels | map of string | tidak | Label keluaran yang dideklarasikan oleh penulis recipe, yang dibubuhkan guest pada setiap manifest yang dihasilkan bersama provenans identitas build, dengan kunci berupa nama label. Dua blok yang ditulis penulis digabungkan ke dalam satu map ini: pasangan kunci-nilai literal yang ditulis recipe dalam outputLabels, dan satu entri untuk setiap kunci yang disebut recipe dalam outputComponentLabels, yang nilainya dibaca dari kunci tersebut pada label milik komponen yang dirender — sehingga nilai yang dipromosikan mengikuti komponen asalnya alih-alih diulang di dalam recipe. Kedua blok dijamin terpisah dari ruang kunci provenans oleh validasi saat pemuatan (tidak ada kunci aggrega.ai/ atau app.kubernetes.io/), sehingga pembubuhan tidak pernah bertabrakan dengan label provenans. Kunci yang dipromosikan tetapi tidak dideklarasikan oleh komponen tidak membubuhkan apa pun dan memunculkan peringatan alih-alih label kosong. Guest yang keluarannya bukan YAML Kubernetes menerjemahkannya ke permukaan labelnya sendiri (label layanan Compose) atau mengabaikannya. |
provenance | NodeProvenance | ya | Provenans identitas build yang dibubuhkan guest pada setiap manifest yang dihasilkan sebagai label aggrega.ai. |
Properti tambahan tidak diizinkan.
NodeProvenance
Provenans identitas build untuk satu node — identitas compiler, aggregate, dan lingkungan yang dibubuhkan guest pada setiap manifest yang dihasilkan sebagai label aggrega.ai. Setiap field dihilangkan jika kosong, sehingga identitas parsial hanya membubuhkan label yang dimilikinya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
compiler_version | string | tidak | Versi compiler, dibubuhkan sebagai label aggrega.ai/compiler-version jika tidak kosong. |
aggregate_name | string | tidak | Nama aggregate, dibubuhkan sebagai label aggrega.ai/aggregate-name jika tidak kosong. |
environment | string | tidak | Nama lingkungan, dibubuhkan sebagai label aggrega.ai/environment jika tidak kosong. |
provider_name | string | tidak | Jenis provider tanpa tambahan, dibubuhkan sebagai label aggrega.ai/provider jika tidak kosong. |
provider_version | string | tidak | Versi plugin perenderan provider yang telah diresolusi, dibubuhkan sebagai label aggrega.ai/provider-version jika tidak kosong. |
Properti tambahan tidak diizinkan.
RenderNodeOutput
Payload yang dikembalikan oleh guest Provider dari ekspor render_node-nya: byte terserialisasi dari setiap file keluaran yang dikeluarkan guest, nama-nama yang diturunkannya ke dalam setiap ruang kuncinya sendiri, fakta yang dilaporkannya tentang apa yang dikeluarkannya, berapa banyak unit ter-render yang dicocokkan oleh setiap entri omit yang diberikan kepadanya, dan diagnostik apa pun yang dimunculkan guest selama rendering. Guest mengembalikan byte terserialisasi setiap file; host menuliskannya apa adanya dan tidak menjalankan serializer. Determinisme adalah tanggung jawab guest: masukan yang identik harus menghasilkan byte yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
files | RenderedFile[] | ya | File keluaran yang dikeluarkan guest, dalam urutan pengeluaran. Masing-masing menyebutkan path-nya di disk dan membawa byte terserialisasi yang ditulis host apa adanya. |
derived_keys | map of string[] | tidak | Nama-nama yang diturunkan guest saat me-render node ini, dengan kunci berupa ruang kunci tempat nama-nama itu diturunkan, dan setiap ruang membawa namanya dalam urutan penurunan. Guest yang menurunkan nama yang digunakan keluarannya untuk merujuk suatu sumber daya telah menempatkan nama itu di dalam byte file yang ditulis host apa adanya, tempat host tidak dapat melihatnya; mendeklarasikannya di sini adalah cara guest meminta host untuk memastikan tidak ada dua penurunan yang menghasilkan satu nama yang sama. Host membandingkan kesamaan nama yang dideklarasikan di dalam satu ruang yang dideklarasikan dan tidak melakukan hal lain — host tidak mengurai nama, tidak mempelajari arti suatu ruang atau nama, dan tidak pernah menurunkan nama sendiri. Dua kontributor pada keluaran rakitan yang sama yang mendeklarasikan nama yang sama di ruang yang sama menghentikan build, dan penghentian itu menyebutkan ruang, nama, dan kedua kontributor. Baik nama ruang maupun nama di dalamnya adalah kosakata guest sendiri: guest yang menginginkan keunikan dalam cakupan yang lebih sempit atau lebih luas daripada satu keluaran rakitan menyatakan cakupan itu dalam nama ruang yang dideklarasikannya. Urutan deklarasi dipertahankan sehingga payload identik byte demi byte di setiap eksekusi dengan masukan identik. Tidak ada jika guest tidak menurunkan nama yang ingin diperiksa, sehingga pemeriksaan tidak aktif untuk guest tersebut. |
render_facts | RenderFact[] | tidak | Fakta yang dilaporkan guest tentang apa yang dikeluarkannya untuk node ini, dalam urutan yang dicantumkan guest. Setiap fakta memasangkan sebuah nama dengan sebuah nilai, dan keduanya adalah kosakata guest sendiri: fakta mana yang dilaporkan suatu provider, arti setiap nama, dan isi entrinya merupakan bagian dari kontrak terdokumentasi provider tersebut, bukan bagian dari socket ini. Nilai setiap fakta adalah sebuah daftar, bahkan jika hanya berisi satu entri: host menolak fakta yang nilainya bukan daftar, dengan menyebutkan provider dan faktanya, lalu menghentikan build. Itulah satu-satunya hal yang dipelajari host tentang suatu nilai. Host mengindeks fakta berdasarkan nama dan menyerahkan setiap daftar kepada template yang membacanya, menggabungkan daftar-daftar dengan satu nama yang dilaporkan oleh lebih dari satu render dari node yang sama sesuai urutan render tersebut dijalankan, dan host tidak pernah mempelajari arti suatu nama atau entri maupun menurunkan fakta sendiri — sehingga provider dapat melaporkan sesuatu yang hanya dapat dilihat oleh pengetahuannya sendiri tentang format, seperti properti dari dokumen yang ditulisnya, tanpa host mempelajari format tersebut. Pelaporan fakta tidak pernah mengubah apa yang ditulis: file yang ditulis host adalah file yang dikembalikan guest, baik disertai fakta maupun tidak. Guest mencantumkan faktanya dalam urutan tetap sehingga payload identik byte demi byte di setiap eksekusi dengan masukan identik. Tidak ada jika guest tidak melaporkan apa pun, yang merupakan jawaban lengkap, bukan jawaban yang hilang. |
omitted | integer[] | tidak | Berapa banyak unit ter-render yang dicocokkan oleh setiap entri omits pada masukan: satu hitungan per entri yang diberikan kepada guest, dalam urutan yang sama, masing-masing berupa jumlah unit yang dicocokkan entri tersebut, baik entri lain juga mencocokkannya maupun tidak. Hitungan nol adalah jawaban lengkap — entri tersebut tidak mencocokkan apa pun yang di-render guest. Hitungan-hitungan ini adalah satu-satunya informasi yang dibawa kembali socket tentang apa yang dihilangkan: unit-unit itu sendiri hanya tidak ada dalam apa yang dikembalikan guest. Tidak ada jika guest tidak diberi entri apa pun. |
diagnostics | Diagnostic[] | tidak | Diagnostik yang dimunculkan guest selama rendering. Setiap elemen memiliki bentuk diagnostik plugin Wasm bersama. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Ini berbeda dari diagnostik apa pun yang dibawa output: diagnostik melaporkan masalah yang ditemukan selama run yang tetap menghasilkan hasil, sedangkan error melaporkan bahwa operasi itu sendiri tidak selesai. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
ValidateNodeOutput
Payload yang dikembalikan guest Provider dari ekspor opsional validate_node_input miliknya: diagnostik yang dimunculkan oleh pemeriksaan struktural terhadap input node yang telah di-resolve. Ekspor ini menerima proyeksi RenderNodeInput yang sama dengan yang diterima render_node dan tidak menghasilkan file — ekspor ini hanya melaporkan diagnostik. Diagnostik dengan tingkat keparahan halt menghentikan build secara tegas, dengan menyebutkan node dan provider-nya; diagnostik dengan tingkat keparahan warn atau info ditampilkan pada hasil build tanpa mengubah output yang di-render. Daftar diagnostik yang kosong berarti input lolos pemeriksaan struktural.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
diagnostics | Diagnostic[] | tidak | Diagnostik yang dimunculkan guest saat memvalidasi input node. Setiap elemen berbentuk diagnostik plugin Wasm bersama. Kosong jika input lolos pemeriksaan struktural. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Ini berbeda dari diagnostik apa pun yang dibawa output: diagnostik melaporkan masalah yang ditemukan selama run yang tetap menghasilkan hasil, sedangkan error melaporkan bahwa operasi itu sendiri tidak selesai. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
RenderedFile
Satu file output yang dihasilkan guest Provider: path-nya di disk relatif terhadap root output node, dan byte terserialisasinya persis seperti yang dihasilkan guest. Host menulis byte ini apa adanya dan tidak menjalankan serializer, sehingga output di disk identik byte demi byte dengan yang dihasilkan guest.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Path file output relatif terhadap root output node (misalnya Chart.yaml atau templates/deployment.yaml). |
content | string | ya | Byte terserialisasi file persis seperti yang dihasilkan guest; host menulis byte ini apa adanya dan tidak menjalankan serializer, sehingga output identik byte demi byte dengan yang dihasilkan guest. Setiap kit membawanya dalam jenis field-nya sendiri — mentah jika jenis tersebut adalah jenis byte, terenkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
format | string | tidak | Format yang dinyatakan guest sebagai format render file yang dihasilkan, sehingga host dapat meneruskan file ke parser yang sesuai. Tidak ada jika guest tidak menyatakan format, dan dalam hal ini host menyimpulkan format dari ekstensi file. |
Properti tambahan tidak diizinkan.
RenderFact
Satu fakta yang dilaporkan guest Provider tentang apa yang dihasilkannya untuk sebuah node: sebuah nama dan daftar entri, keduanya didefinisikan dan didokumentasikan oleh provider. Host membawa fakta tersebut sebagaimana ditulis guest, menolak fakta yang nilainya bukan daftar, dan tidak mempelajari hal lain tentang kedua bagiannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama fakta, dari kosakata provider sendiri yang terdokumentasi. |
value | array | ya | Nilai fakta: sebuah array JSON — selalu berupa daftar, bahkan dengan satu entri atau tanpa entri — yang entrinya berupa nilai JSON apa pun dalam bentuk yang didokumentasikan provider untuk nama tersebut. Daftar inilah yang memungkinkan satu nama dilaporkan oleh lebih dari satu render sebuah node: host menggabungkan daftar-daftar tersebut menjadi satu. Nilai ini dibawa sebagai dokumen JSON yang ditulis guest, byte demi byte, sehingga urutan entri daftar dan urutan kunci setiap objek adalah milik guest sendiri. |
Properti tambahan tidak diizinkan.
OmitEntry
Satu entri yang menyebutkan unit hasil render yang dikecualikan guest Provider dari output sebuah node, dengan field-nya yang sudah di-resolve menjadi string biasa dan ditandai jika salah satunya dihasilkan dari nilai yang dinyatakan sensitif. Socket tidak memberikan makna apa pun padanya: setiap provider mendokumentasikan apa yang dipilih oleh kind, name, namespace, dan subchart dalam formatnya sendiri, dan mencocokkannya sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Jenis unit hasil render yang disebutkan entri, dalam kosakata provider sendiri. |
name | string | ya | Nama unit hasil render yang disebutkan entri, dalam kosakata provider sendiri. |
namespace | string | tidak | Namespace tempat unit yang disebutkan berada, untuk provider yang formatnya menempatkan unit dalam namespace. Tidak ada jika penulis tidak menuliskannya; apa yang dicocokkan oleh entri tanpa namespace adalah kontrak provider sendiri. |
subchart | string | tidak | Sumber bersarang tempat unit yang disebutkan berasal, untuk provider yang sumbernya dirakit dari sumber-sumber bersarang, sebagaimana chart dirakit dari subchart-nya. Tidak ada jika penulis tidak menulisnya; apa yang dicocokkan oleh entri tanpa subchart, dan apa yang dilakukan provider yang sumbernya tidak memiliki sumber bersarang terhadap entri yang menyebutkannya, adalah kontrak milik provider itu sendiri. |
sensitive | boolean | tidak | True jika template yang menghasilkan salah satu dari kind, name, namespace, atau subchart entri membaca nilai yang dinyatakan sensitif oleh penulis, atau nilai yang dilacak berasal darinya. Hal ini dibaca dari template setiap field terhadap deklarasi — referensi yang menjangkau nilai yang dideklarasikan, template yang meneruskan seluruh datanya, atau template yang tidak dapat di-parse semuanya dihitung — dan tidak pernah dari string yang telah di-resolve. Tanda ini mencakup seluruh entri alih-alih menyebutkan field-nya, sehingga guest memperlakukan entri bertanda sebagaimana ia memperlakukan setiap nilai bertanda lain pada inputnya: guest tetap mencocokkan dan menghitung entri berdasarkan field-nya, yang memang menjadi tujuan entri, dan menjauhkan setiap field-nya dari teks apa pun yang dibaca manusia — penolakan, peringatan, atau baris log. Tidak ada jika tidak ada template field yang membaca nilai semacam itu; ketiadaannya tidak pernah menyatakan bahwa tidak ada field yang sensitif. |
Properti tambahan tidak diizinkan.
SourceFile
Satu file dari proyeksi sumber yang telah dipaketkan sebelumnya: path-nya relatif terhadap root sumber dan byte mentahnya, persis seperti yang dibaca host dari sumber lokal pada waktu kompilasi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Path file relatif terhadap root sumber (misalnya Chart.yaml atau templates/deployment.yaml). |
content | string | ya | Byte mentah file persis seperti yang dibaca host dari sumber lokal. Setiap kit membawanya dalam jenis field-nya sendiri — mentah jika jenis tersebut adalah jenis byte, terenkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
Properti tambahan tidak diizinkan.
SourceProjection
Konten sumber yang dikemas (mis. file-file chart Helm, masing-masing dinamai dengan jalurnya relatif terhadap akar sumber, dalam urutan penelusuran) yang dibaca host dan dikembalikan kepada guest sebagai tanggapan atas permintaan pack-source, sehingga guest merekonstruksi sumber yang dipilih di memori dan tidak menyentuh sistem file apa pun. Ini adalah payload keberhasilan dari fungsi host pack-source.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
files | SourceFile[] | ya | File-file sumber, masing-masing dinamai dengan jalurnya relatif terhadap akar sumber, dalam urutan penelusuran host yang deterministik. |
Properti tambahan tidak diizinkan.
SourceEntry
Satu entri dari daftar sumber: jalurnya relatif terhadap akar sumber, dan apakah entri tersebut merupakan direktori. Host hanya mendaftar nama dan tidak membaca konten, sehingga sebuah entri tidak membawa byte.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Jalur entri relatif terhadap akar sumber, dipisahkan garis miring (misalnya Chart.yaml atau templates/deployment.yaml). |
is_dir | boolean | ya | Apakah entri tersebut merupakan direktori. Guest yang menentukan akar chart atau satu file sumber di antara daftar membaca nilai ini untuk membedakan direktori dari file tanpa menyentuh sistem file. |
Properti tambahan tidak diizinkan.
SourceListing
Enumerasi generik atas sumber yang diperoleh, yang diserahkan host kepada guest provider bersumber: akar sumber, apakah akar tersebut merupakan direktori, dan entri-entri relatif terhadap akar yang terurut di bawahnya. Host menelusuri sumber yang diperoleh tanpa pengetahuan domain dan tidak membaca konten file apa pun — host hanya mendaftar nama. Guest menerapkan logika resolusinya sendiri atas daftar tersebut (menemukan akar chart, memilih satu dokumen compose, melakukan vendoring atas pohon modul) dan meminta host mengemas pilihan tertentu melalui fungsi host pack-source. Entri diurutkan berdasarkan jalur sehingga daftar identik byte demi byte di antara eksekusi dengan input yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
root | string | ya | Lokasi sumber yang diperoleh yang dienumerasi host. Guest membawanya ke dalam diagnostiknya sendiri ketika tidak dapat menentukan sumber, sehingga penghentian resolusi menyebutkan sumber yang diberikan penulis. |
root_is_dir | boolean | tidak | Apakah akar sumber yang diperoleh merupakan direktori. Bernilai false untuk sumber berupa satu file (satu dokumen compose, satu file modul, sebuah arsip); dalam hal ini entries kosong dan guest mengemas akar itu sendiri. |
entries | SourceEntry[] | ya | Entri-entri relatif terhadap akar di bawah akar sumber berupa direktori, diurutkan berdasarkan jalur. Kosong untuk akar sumber berupa satu file. |
Properti tambahan tidak diizinkan.
SourcePackRequest
Pilihan yang diminta guest untuk dikemas host dari sumber yang diperoleh melalui fungsi host pack-source. op menyebutkan bentuk pilihan dan path menyebutkannya relatif terhadap akar sumber; host menentukan path di bawah akar sumber, menolak setiap upaya keluar di atasnya, dan mengembalikan byte yang dikemas sebagai SourceProjection.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
op | string (enum) | ya | Bentuk pilihan: file mengemas satu file di path; dir mengemas file-file langsung dari direktori di path; tree mengemas seluruh subpohon yang berakar di path, secara rekursif, dalam urutan penelusuran host yang deterministik. Nilai yang diizinkan: "file", "dir", "tree" |
path | string | ya | Lokasi pilihan relatif terhadap akar sumber, dipisahkan garis miring. String kosong (atau “.”) menyebutkan akar sumber itu sendiri, sehingga sumber berupa satu file dikemas dengan path kosong. |
Properti tambahan tidak diizinkan.
SourcePackResponse
Balasan fungsi host pack-source: jika berhasil, sumber yang dikemas; jika gagal, pesan kesalahan. Tepat satu dari kedua field terisi. Kegagalan disampaikan secara in-band, bukan melalui trap, sehingga guest membawa penolakan sandbox atau kegagalan baca ke dalam diagnostiknya sendiri sebagai kegagalan render yang deterministik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
source_projection | SourceProjection | tidak | Sumber yang dikemas jika berhasil; tidak ada jika gagal. |
error | string | tidak | Pesan kegagalan jika gagal, yang menyebutkan pilihan dan alasannya; tidak ada jika berhasil. |
hostfunc_error_code | string (enum) | tidak | Identitas kegagalan yang dapat dicocokkan mesin jika gagal, diambil dari katalog kode kesalahan fungsi host yang tertutup, ditetapkan di samping pesan kesalahan untuk manusia; tidak ada jika berhasil. Katalog tersebut adalah kosakata tetap yang menyebutkan cara-cara fungsi host dapat gagal, dan merupakan kosakata yang berbeda dari kondisi penghentian yang didaftarkan compiler, yang pengidentifikasinya dilaporkan guest pada output socket sebagai condition_code dan condition_short_code — nama kunci menunjukkan kosakata mana dari keduanya yang memiliki suatu nilai, sehingga keduanya tidak pernah dibaca sebagai satu himpunan. Guest bercabang berdasarkan kode ini tanpa mem-parse pesan, dengan menoleransi kode yang tidak ada (host lama) atau kode yang tidak dikenali (host baru) dengan kembali ke pesan. Nilai yang diizinkan: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Properti tambahan tidak diizinkan.
SourceFileRequest
Pembacaan konten satu file yang diminta guest untuk dilakukan host melalui fungsi host read-source-file, untuk guest yang logika resolusinya harus memeriksa konten sebuah file sebelum memilih apa yang akan dikemas. Host menentukan path di bawah akar sumber, menolak setiap upaya keluar di atasnya, dan mengembalikan byte file tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Lokasi file relatif terhadap akar sumber, dipisahkan garis miring. |
Properti tambahan tidak diizinkan.
SourceFileResponse
Balasan fungsi host read-source-file: jika berhasil, byte file; jika gagal, pesan kesalahan. Tepat satu dari kedua field terisi. Kegagalan disampaikan secara in-band, bukan melalui trap, sehingga guest membawa penolakan sandbox atau kegagalan baca ke dalam diagnostiknya sendiri sebagai kegagalan render yang deterministik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
content | string | tidak | Byte mentah file jika berhasil; tidak ada jika gagal. Setiap kit membawanya dalam jenis field-nya sendiri — mentah jika jenis tersebut adalah jenis byte, dienkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
error | string | tidak | Pesan kegagalan jika gagal, yang menyebutkan file dan alasannya; tidak ada jika berhasil. |
hostfunc_error_code | string (enum) | tidak | Identitas kegagalan yang dapat dicocokkan mesin jika gagal, diambil dari katalog kode kesalahan fungsi host yang tertutup, ditetapkan di samping pesan kesalahan untuk manusia; tidak ada jika berhasil. Katalog tersebut adalah kosakata tetap yang menyebutkan cara-cara fungsi host dapat gagal, dan merupakan kosakata yang berbeda dari kondisi penghentian yang didaftarkan compiler, yang pengidentifikasinya dilaporkan guest pada output socket sebagai condition_code dan condition_short_code — nama kunci menunjukkan kosakata mana dari keduanya yang memiliki suatu nilai, sehingga keduanya tidak pernah dibaca sebagai satu himpunan. Guest bercabang berdasarkan kode ini tanpa mem-parse pesan, dengan menoleransi kode yang tidak ada (host lama) atau kode yang tidak dikenali (host baru) dengan kembali ke pesan. Nilai yang diizinkan: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Properti tambahan tidak diizinkan.
FetchExternalInputResponse
Balasan fungsi host fetch-external-input: jika berhasil, konten yang diambil; jika gagal, pesan galat beserta kodenya. Balasan yang tidak membawa satu pun field kegagalan adalah keberhasilan, sehingga payload berpanjang nol adalah balasan dengan semua field tidak ada. Kegagalan disampaikan secara in-band, bukan melalui trap, sehingga guest membawa URL yang tidak dapat di-resolve atau kegagalan pengambilan ke dalam diagnostiknya sendiri sebagai kegagalan render yang deterministik. Permintaannya berupa string URL polos, bukan payload terstruktur, sehingga hanya balasan yang memiliki bentuk yang dideklarasikan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
content | string | tidak | Byte mentah payload yang diambil jika berhasil; tidak ada jika gagal, dan tidak ada jika payload kosong. Byte tersebut melintasi wire sebagai byte string, tidak pernah sebagai teks base64. Kit Go menyimpannya sebagai byte slice; kit Rust dan TypeScript menyimpannya sebagai string base64, yang didekode oleh wrapper fetch masing-masing kit, sehingga setiap wrapper mengembalikan byte mentah payload. |
error | string | tidak | Pesan kegagalan jika gagal, yang menyebutkan URL dan cara mengatasinya; tidak ada jika berhasil. |
hostfunc_error_code | string (enum) | tidak | Identitas kegagalan yang dapat dicocokkan mesin jika gagal, diambil dari katalog kode kesalahan fungsi host yang tertutup, ditetapkan di samping pesan kesalahan untuk manusia; tidak ada jika berhasil. Katalog tersebut adalah kosakata tetap yang menyebutkan cara-cara fungsi host dapat gagal, dan merupakan kosakata yang berbeda dari kondisi penghentian yang didaftarkan compiler, yang pengidentifikasinya dilaporkan guest pada output socket sebagai condition_code dan condition_short_code — nama kunci menunjukkan kosakata mana dari keduanya yang memiliki suatu nilai, sehingga keduanya tidak pernah dibaca sebagai satu himpunan. Guest bercabang berdasarkan kode ini tanpa mem-parse pesan, dengan menoleransi kode yang tidak ada (host lama) atau kode yang tidak dikenali (host baru) dengan kembali ke pesan. Nilai yang diizinkan: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
Properti tambahan tidak diizinkan.
WorkloadProjection
Konten workload yang telah dievaluasi sebelumnya yang diserahkan host kepada guest Provider agar guest menyintesis manifest native provider darinya di memori, ada ketika Recipe yang terikat mendeklarasikan workload, bukan sumber chart. Determinisme adalah tanggung jawab guest: input yang identik harus menghasilkan byte yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workload | object | ya | Workload hasil evaluasi host dan pascavalidasi yang disintesis guest; buram pada lapisan skema ini agar skema socket tidak mengikat ulang kontrak entitas Workload. |
sensitive_workload | boolean | tidak | True ketika templat yang menghasilkan workload membaca nilai yang dideklarasikan sensitif oleh penulis, atau nilai yang ditelusuri ke nilai tersebut. Hal ini dibaca dari referensi templat itu sendiri terhadap deklarasi — referensi yang mencapai nilai yang dideklarasikan, templat yang meneruskan seluruh datanya, atau templat yang tidak dapat di-parse, semuanya terhitung — dan tidak pernah dari konten field mana pun. Field workload yang telah dirender tidak membawa tautan balik ke data yang dibaca templatnya, sehingga ini menandai seluruh dokumen: guest yang menyusun teks untuk dibaca orang, sebuah penolakan atau peringatan, menjauhkan setiap nilai yang dibawa workload dari teks tersebut ketika ini bernilai true, sementara bentuk dokumen — kuncinya dan letak suatu nilai — tetap dapat dibaca. Entri attachment yang disebutkan oleh sensitive_rendered_keys pada proyeksi node ditandai di sana, terlepas dari diatur atau tidaknya field ini. Tidak ada ketika templat tidak membaca nilai semacam itu; ketiadaannya tidak pernah menyatakan bahwa tidak ada field yang sensitif. |
attachment_provides | object | tidak | Setiap attachment pada node, diproyeksikan ke provides yang telah di-resolve dan dikunci dengan nama instans attachment yang dibawa oleh referensi attachment workload; tidak ada ketika node tidak membawa attachment. Host menyalin string tersebut apa adanya tanpa menafsirkannya, sehingga guest membaca entri provides attachment mana pun yang diperlukannya untuk me-resolve referensi ke resource yang dihasilkan attachment tersebut. Apakah suatu attachment menangani materi yang dideklarasikan sensitif tidak diulang di sini: informasi itu dibawa pada entri feature yang sesuai di proyeksi node, yang dibaca guest dengan nama instans yang sama. |
Properti tambahan tidak diizinkan.
ArtifactsProjection
Kumpulan artefak yang telah dievaluasi sebelumnya yang diserahkan host kepada guest Provider untuk ditempatkan ke dalam output node. Host telah me-resolve sumber setiap entri (konten inline atau file impor yang dibacanya), mengevaluasinya sebagai templat Go terhadap konteks render menggunakan pasangan delimiter templat artefak yang dideklarasikan guest, dan menghitung kumpulan kunci label dan anotasi build-provenance. Guest memegang keputusan format, penempatan provenance, path di disk, dan byte akhir. Entri mempertahankan urutan penulis sehingga output yang ditempatkan identik byte demi byte di antara eksekusi dengan input yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
entries | ArtifactProjectionEntry[] | ya | Entri artefak yang ditempatkan guest, sesuai urutan penulis. |
Properti tambahan tidak diizinkan.
ArtifactProjectionEntry
Satu entri artefak yang telah dievaluasi sebelumnya yang diserahkan host kepada guest Provider untuk ditempatkan: nama output hasil resolusi host, asalnya, byte konten yang sudah dievaluasi templatnya, apakah templat asal byte tersebut membaca nilai yang dideklarasikan sensitif, serta kumpulan kunci label dan anotasi build-provenance yang dihitung host untuk node. Guest menentukan cara menempatkan provenance (menyisipkannya ke metadata manifest, menambahkannya di awal sebagai komentar, atau menghasilkan file pendamping) dan di mana file tersebut diletakkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama output hasil resolusi host untuk entri: kunci map yang dideklarasikan penulis, dengan file yang disediakan oleh bundel library bersarang di bawah kunci tersebut. Guest menempatkan entri pada nama ini atau di bawah sub-path khusus provider yang diturunkan darinya. |
origin | string (enum) | ya | Apakah entri ditulis sebagai konten inline atau sebagai file impor. Guest yang menolak salah satu bentuk (provider umbrella-chart menolak konten inline) membaca ini untuk berhenti secara tegas. Nilai yang diizinkan: "inline", "import" |
content | string | ya | Byte konten yang sudah dievaluasi templatnya yang dihasilkan host dari konten inline atau file impor entri, dievaluasi terhadap konteks render menggunakan pasangan delimiter templat artefak yang dideklarasikan guest. Setiap kit membawanya dalam jenis field-nya sendiri — mentah jika jenis tersebut adalah jenis byte, dienkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field dan bentuk byte yang dibawa wire. |
sensitive_content | boolean | tidak | True ketika templat asal evaluasi konten entri ini membaca nilai yang dideklarasikan sensitif oleh penulis, atau nilai yang ditelusuri ke nilai tersebut. Hal ini dibaca dari referensi templat itu sendiri terhadap deklarasi, dengan pasangan delimiter yang digunakan untuk mengevaluasi konten — referensi yang mencapai nilai yang dideklarasikan, templat yang meneruskan seluruh datanya, atau templat yang tidak dapat di-parse, semuanya terhitung — dan tidak pernah dari konten itu sendiri. Konten tersebut adalah output templat itu, sehingga tidak ada bagiannya yang dapat ditelusuri kembali ke datum asalnya: guest yang menyusun teks untuk dibaca orang, sebuah penolakan atau peringatan, menjauhkan setiap bagian konten dari teks tersebut ketika ini bernilai true, termasuk pesan parser sendiri tentang konten itu. Nilai ini diatur per entri, sehingga templat satu entri yang membaca nilai semacam itu tidak menyatakan apa pun tentang entri lain. Tidak ada ketika templat tidak membaca nilai semacam itu; ketiadaannya tidak pernah menyatakan bahwa konten tidak sensitif. |
labels | object | tidak | Kumpulan kunci build-provenance yang aman sebagai label Kubernetes yang dihitung host untuk node, dikunci dengan nama label. Guest yang mencantumkan provenance ke metadata.labels manifest menyisipkannya; guest yang outputnya bukan YAML Kubernetes mengabaikannya. |
annotations | object | tidak | Kumpulan kunci build-provenance yang dihitung host untuk node yang tidak dapat direpresentasikan oleh label Kubernetes, dikunci dengan nama anotasi. Guest yang mencantumkan provenance ke metadata.annotations manifest menyisipkannya; guest yang outputnya bukan YAML Kubernetes mengabaikannya. |
Properti tambahan tidak diizinkan.
AssembleBoundaryInput
Payload yang diterima guest Provider pada ekspor assemble_boundary-nya — ekspor yang menggabungkan output render per node pada satu grup dispatch menjadi satu artefak terakit (sebuah umbrella chart, sebuah file compose gabungan). Payload ini membawa output render per node beserta anotasi gabungan dan deployment wave-nya, path output grup dispatch tempat artefak terakit ditempatkan, edge uses dari graf untuk inferensi dependensi per layanan, serta konteks waktu render. Tidak setiap provider mendeklarasikan ekspor ini: provider yang hanya menghasilkan output datar per node menghilangkannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
rendered_nodes | RenderedNode[] | ya | Output render per node yang menyuplai grup dispatch ini, dalam urutan node. |
context | object | ya | Konteks waktu render, dibawa sebagai byte dokumen JSON-nya. Pada ekspor ini host hanya menetapkan yaml_indent, yaitu lebar indentasi seluruh render yang digunakan untuk menyerialisasi file rakitan; anggota konteks lainnya tidak membawa apa pun di sini, karena perakitan menggabungkan kontributor yang anotasi dan boundary-nya berbeda, dan anotasi setiap kontributor tiba pada entri rendered_nodes-nya sebagai gantinya. |
boundary_path | string | ya | Path output grup dispatch yang telah dievaluasi tempat artefak terakit ditempatkan; perakit boundary menggunakannya sebagai identitas cadangan tingkat boundary (misalnya nama jaringan compose untuk node yang tidak membawa anotasi namespace). |
edges | RenderEdge[] | tidak | Edge uses berarah dari graf, sehingga perakit boundary dapat menyimpulkan urutan/dependensi per layanan di antara kontributor grup dispatch (misalnya depends_on pada compose). |
sub_charts | SubChart[] | tidak | Payload per sub-chart yang dikonsumsi perakit umbrella chart untuk menghasilkan satu dependensi dan satu cakupan values per kontributor. Setiap entri membawa identitas sub-chart, values per instans, dan, untuk sub-chart yang di-vendor dari sumber chart, byte asli file Chart.yaml milik chart tersebut. Ada untuk perakitan umbrella chart; perakit yang menggabungkan secara datar menghilangkannya. |
chart_name | string | tidak | Nama chart yang digunakan perakit umbrella chart untuk chart terakit ketika sebuah nama disediakan untuk grup dispatch; kosong ketika perakit menurunkan nama dari path output grup dispatch. |
aggregate_name | string | tidak | Nama aggregate tingkat teratas yang dimasukkan perakit umbrella chart ke dalam nama turunan chart terakit; kosong ketika tidak ada identitas aggregate yang berkontribusi pada nama tersebut. |
Properti tambahan tidak diizinkan.
RenderedNode
Keluaran render satu node sebagaimana muncul dalam input assemble_boundary: id node, jenisnya, anotasinya yang telah digabung, sync wave-nya, nilai yang diselesaikan compiler untuknya bila nilai tersebut memang disediakan oleh compiler beserta apakah suatu pemetaan nilai menghasilkannya, dan berkas yang dihasilkan ekspor render_node untuknya — dibawa dalam bentuk keluaran render, dengan setiap anggota bentuk tersebut selain berkasnya dibiarkan tidak ada.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
id | string | ya | Id absolut node di dalam graf topologi. Kontributor yang bukan salah satu node graf — sebuah Feature yang dilampirkan pada boundary alih-alih pada komponen — membawa identitas dispatch milik compiler sendiri untuknya di sini, yaitu identitas yang sama dengan yang dibawa panggilan render_node untuk kontributor tersebut; identitas ini membedakan satu kontributor dari yang lain dan bukan nama yang diterima target mana pun. Sumber yang digunakan kontributor semacam itu untuk menurunkan nama di dalam artefak hasil perakitan merupakan bawaan terpisah, yaitu derived_name_basis. |
type | string | ya | Label jenis komponen node, dibawa pada bentuk ini — berbeda dengan proyeksi render per node, yang tidak menyertakannya. Ini metadata buram, bukan pengalih perilaku: label ini ada agar assembler dapat mengelompokkan dan memberi label pada node yang digabungkannya, bukan agar guest dapat bercabang berdasarkan label tersebut. |
derived_name_basis | string | tidak | Identitas yang digunakan kontributor ini untuk menurunkan namanya sendiri di dalam artefak hasil perakitan — id logis yang dibuat assembler untuk salah satu entri terbitan kontributor, cakupan per kontributor dalam dokumen gabungan, nama unit anak yang ditempatkan pada posisinya sendiri. Kosong berarti id digunakan secara langsung, yang merupakan nilai untuk komponen biasa. Kontributor yang id-nya berupa identitas dispatch yang ditolak alfabet nama target membawa nilai ini secara eksplisit, sehingga artefak hasil perakitan merujuk kontennya dengan nama yang diterima target, dan dua kontributor yang dapat dibedakan oleh penulis tidak dapat tiba dengan satu nama yang sama. Jika konten kontributor dilebur ke dalam dokumen yang digabungkan assembler, ini adalah bawaan yang sama dengan yang diterima panggilan render_node untuk kontributor tersebut, dan membawanya pada keduanya itulah yang menjaga kedua jawaban tetap sama: nama yang dideklarasikan kontributor saat merender dan nama yang digunakan dokumen gabungan untuk merujuk konten tersebut diturunkan dari satu identitas, bukan dari dua identitas yang kebetulan sama. Jika kontributor justru ditempatkan pada posisinya sendiri, ini adalah identitas yang disusun untuk kontributor tersebut — untuk Feature yang dipasang pada komponen, identitasnya sendiri, bukan identitas komponen host yang menjadi dasar render-nya — sehingga unit anak yang ditempatkan di samping host-nya dialamatkan terpisah darinya. |
output_directory | string | tidak | Direktori tempat berkas hasil render kontributor ini berada, relatif terhadap posisi artefak hasil perakitan itu sendiri, tanpa pemisah di akhir. Guest yang harus menamai berkas kontributor dari dalam artefak hasil perakitan — path sumber blok modul, direktif include — membaca posisinya dari sini alih-alih menyusunnya dari identitas kontributor, sehingga path yang dirujuk artefak hasil perakitan adalah path tempat berkas tersebut ditulis. Keduanya tidak selalu berjarak satu direktori: kontributor yang ditempatkan host di dalam posisi kontributor lain berada lebih dalam daripada kontributor yang ditempatkan langsung di bawah rakitan. Hanya ada bila provider yang merakit menempatkan setiap kontributor di bawah posisinya sendiri; provider yang melipat kontributornya ke dalam satu dokumen tidak menempatkan direktori per kontributor dan tidak menerimanya. |
rendered | RenderNodeOutput | ya | Payload yang dikembalikan oleh guest Provider dari ekspor render_node-nya: byte terserialisasi dari setiap file keluaran yang dikeluarkan guest, nama-nama yang diturunkannya ke dalam setiap ruang kuncinya sendiri, fakta yang dilaporkannya tentang apa yang dikeluarkannya, berapa banyak unit ter-render yang dicocokkan oleh setiap entri omit yang diberikan kepadanya, dan diagnostik apa pun yang dimunculkan guest selama rendering. Guest mengembalikan byte terserialisasi setiap file; host menuliskannya apa adanya dan tidak menjalankan serializer. Determinisme adalah tanggung jawab guest: masukan yang identik harus menghasilkan byte yang identik. |
annotations | map of string | tidak | Anotasi node yang telah digabung, sehingga boundary assembler dapat menentukan penempatan per node (mis. jaringan compose yang diturunkan dari anotasi aggrega.ai/namespace). |
sync_wave | integer | tidak | Deployment wave yang diwarisi node ini dari boundary yang memuatnya (default 0; nilai negatif diizinkan), sehingga boundary assembler dapat mengurutkan kontributor yang digabungkannya relatif satu sama lain. Dispatch group dapat menggabungkan kontributor dari beberapa boundary, masing-masing dengan wave-nya sendiri, sehingga wave dibawa bersama setiap node di sini, bukan sekali untuk seluruh payload. Assembler yang bentuk keluarannya tidak menyatakan urutan mengabaikannya. |
values | object | tidak | Nilai yang diselesaikan compiler untuk node ini, hanya ada untuk node yang dirender dari sumber — panggilan render_node yang menghasilkan berkasnya membawa source_listing. Itulah satu-satunya kasus ketika berkas berasal dari tempat lain dan nilai tidak dapat dituliskan ke dalamnya, sehingga posisi di luar berkas tersebut harus menyediakannya: boundary assembler menempatkan kamus yang ada sebagai input kontributor tersebut di dalam artefak hasil perakitan itu sendiri, bukan di samping berkas milik kontributor, dan bila artefak hasil perakitan adalah satu-satunya posisi yang dievaluasi target, hal itulah yang membedakan input yang dibaca target dari input yang tidak pernah dicapainya. Node yang dirender dari workload_projection atau artifacts_projection telah menyelesaikan nilai ini ke dalam berkas yang dihasilkannya, sehingga tidak membawa nilai apa pun di sini dan field ini tidak ada: menyediakannya untuk kedua kalinya akan memberikan input kepada artefak hasil perakitan yang tidak pernah dideklarasikan berkas node itu sendiri, yang bebas ditolak oleh target. Kunci tiba dalam urutan terurut, bukan urutan penulis, dan pengurutan itulah yang membuat payload identik per byte di setiap eksekusi dengan input yang identik; guest yang memerlukan urutan lain menerapkannya sendiri. Assembler yang bentuk keluarannya tidak membawa input per kontributor mengabaikan field ini. |
values_mapped | boolean | tidak | Bernilai true bila nilai yang dibawa node ini merupakan keluaran valuesMapping dari Recipe atau FeatureRecipe yang terikat padanya (Recipe milik komponen, FeatureRecipe milik Feature yang dilampirkan), bukan nilai node yang diteruskan sebagaimana ditulis penulis — tanda yang sama dengan yang dibawa panggilan render_node untuk node ini pada proyeksi node-nya, dibawa di sini di samping nilai yang dijelaskannya. Tidak ada bila tidak ada valuesMapping yang dijalankan, dan setiap kali values tidak ada. Apakah assembler membacanya merupakan kontrak assembler itu sendiri: assembler yang render_node-nya mengikat nilai node yang dipetakan ke input yang dideklarasikan sumbernya dapat mengetahui darinya nama mana yang diisi oleh pengikatan tersebut, sedangkan assembler yang menempatkan nilai node sebagai inputnya bagaimanapun nilai itu dihasilkan tidak membacanya. Field ini mencatat bagaimana nilai dihasilkan dan tidak pernah diturunkan dari nama kunci atau isi nilai. |
Properti tambahan tidak diizinkan.
RenderEdge
Satu edge uses berarah dari graf, dinamai dengan dua id node-nya: source adalah node yang mengonsumsi dan target adalah node yang dikonsumsi. Daftar ini membawa setiap edge uses dari graf, sehingga salah satu ujungnya dapat berupa node di luar grup dispatch ini.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
source | string | ya | Id node yang mengonsumsi — ujung sumber dari edge uses yang berarah. |
target | string | ya | Id node yang dikonsumsi — ujung target yang dituju edge uses yang berarah. |
Properti tambahan tidak diizinkan.
SubChart
Satu sub-chart yang berkontribusi pada umbrella chart: identitas instansnya, versi yang dipatok oleh umbrella, nilai per instans yang dicakup oleh umbrella di bawah alias sub-chart, dan, untuk sub-chart yang di-vendor dari sumber chart, byte asli file Chart.yaml milik chart tersebut. Assembler umbrella chart membangun dependensi dan file nilai umbrella hanya dari tampilan data murni ini dan tidak menyentuh sistem file apa pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
instance_id | string | ya | Identitas instans sub-chart di dalam grup dispatch; umbrella mencakup alias dependensi sub-chart dan nilainya di bawah identitas ini, sehingga beberapa instans dari satu chart sumber tetap terpisah. |
version | string | tidak | Versi yang dipatok oleh umbrella untuk sub-chart. Sub-chart yang di-vendor dari sumber chart justru mengambil nama dan versi dependensinya dari file Chart.yaml chart tersebut agar dependensi terikat; nilai ini berlaku untuk sub-chart generatif yang tidak membawa chart yang di-vendor. |
values | object | tidak | Nilai per instans yang dicakup oleh umbrella di bawah alias sub-chart dalam file values.yaml umbrella. Kunci tiba dalam urutan terurut, bukan urutan penulis, dan pengurutan itulah yang membuat payload identik byte demi byte di setiap eksekusi dengan input yang identik; guest yang memerlukan urutan lain menerapkannya sendiri. |
chart_yaml | string | tidak | Byte asli Chart.yaml milik chart yang di-vendor, dibaca dari sumber lokal pada waktu kompilasi, yang menjadi asal umbrella mengambil nama dan versi dependensi sub-chart. Kosong untuk sub-chart generatif yang tidak membawa chart yang di-vendor. Setiap kit membawanya dalam jenis field miliknya sendiri — mentah jika jenis tersebut adalah jenis byte, ter-encode base64 jika berupa string yang di-decode oleh guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
Properti tambahan tidak diizinkan.
AssembleBoundaryOutput
Payload yang dikembalikan guest Provider dari export assemble_boundary-nya: byte terserialisasi dari setiap file yang dirakit dan diagnostik apa pun yang dimunculkan guest selama perakitan. Letak file per node dari grup yang dirakit bukan bagian dari balasan ini — itu adalah properti statis provider, dideklarasikan sekali pada kontrak describe()-nya dan sudah tersedia sebelum node mana pun dirender. Guest mengembalikan byte terserialisasi setiap file; host menuliskannya apa adanya dan tidak menjalankan serializer. Determinisme adalah tanggung jawab guest: input yang identik harus menghasilkan byte yang identik.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
files | RenderedFile[] | ya | File output hasil perakitan yang dikeluarkan guest, sesuai urutan pengeluarannya. Masing-masing menyebutkan path di disk dan membawa byte terserialisasi yang ditulis host apa adanya. |
diagnostics | Diagnostic[] | tidak | Diagnostik yang dimunculkan guest selama perakitan. Setiap elemen adalah bentuk diagnostik bersama untuk Wasm-plugin. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Ini berbeda dari diagnostik apa pun yang dibawa output: diagnostik melaporkan masalah yang ditemukan selama run yang tetap menghasilkan hasil, sedangkan error melaporkan bahwa operasi itu sendiri tidak selesai. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
CarveInput
Payload yang diterima guest Provider pada export carve opsionalnya: satu file output bernama yang dipotong oleh pipeline menjadi unit-unit yang dapat dialamatkan sebelum langkah FeatureRecipe mengedit sebagian di antaranya. Provider yang bentuk output-nya tidak dapat dipotong langsung oleh codec YAML bawaan (misalnya chart bertemplat) mengiklankan carve dan reassemble sehingga pengetahuannya tentang bentuk output berada di dalam guest; provider yang tidak menyertakan export tersebut meminjam codec YAML bawaan host.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama file output, agar codec dapat menerapkan aturan pemotongan apa pun yang dicakup berdasarkan nama. |
body | string | ya | Byte file output yang akan dipotong menjadi unit-unit yang dapat dialamatkan. Setiap kit membawanya dalam jenis field miliknya sendiri — mentah jika jenis tersebut adalah jenis byte, ter-encode base64 jika berupa string yang di-decode oleh guest untuk memulihkannya — dan encoder yang dihasilkan mengonversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
yaml_indent | integer | tidak | Lebar indentasi yang digunakan codec saat harus menyintesis teks terstruktur baru; dibawa agar pemotongan oleh guest sesuai dengan indentasi seluruh render. |
Properti tambahan tidak diizinkan.
CarveOutput
Payload yang dikembalikan guest Provider dari export carve-nya: unit-unit terurut yang dapat dialamatkan hasil pemotongan file. Unit terstruktur membawa sebuah pohon (target PATCH); unit opak hanya membawa jenis media dan byte-nya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
units | object[] | ya | Unit-unit terurut yang dapat dialamatkan hasil pemotongan file oleh guest. |
Properti tambahan tidak diizinkan.
ReassembleInput
Payload yang diterima guest Provider pada ekspor reassemble opsionalnya: file asli beserta unit hasil pemotongannya dan unit yang telah di-patch oleh sebuah langkah pipeline, sehingga guest menyisipkan kembali perubahan tersebut ke byte asli secara presisi. Token yang tidak ada dalam himpunan yang di-patch digabungkan kembali dari byte aslinya apa adanya; token yang di-patch hanya diedit pada rentang byte yang dialamatkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama file output, sesuai dengan nama yang digunakan saat file yang sama dipotong. |
body | string | ya | Byte file asli yang menjadi tempat reassembly menyisipkan kembali unit yang di-patch. Setiap kit membawanya dalam jenis field miliknya sendiri — mentah jika jenis tersebut adalah jenis byte, dienkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan melakukan konversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
segs | object[] | tidak | Unit hasil pemotongan file, sebagaimana dikembalikan oleh carve. |
patched | object[] | tidak | Unit yang diubah oleh sebuah langkah pipeline, masing-masing membawa tokennya, pohon yang telah di-patch, dan op yang menghasilkan perubahan tersebut. |
yaml_indent | integer | tidak | Lebar indentasi yang digunakan codec ketika sebuah op harus menyintesis teks terstruktur baru; dibawa agar reassembly sesuai dengan indentasi yang berlaku di seluruh render. |
Properti tambahan tidak diizinkan.
ReassembleOutput
Payload yang dikembalikan guest Provider dari ekspor reassemble-nya: byte file dengan unit yang di-patch telah disisipkan kembali. Reassembly setia pada byte — setiap byte yang tidak disentuh op tetap utuh apa adanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
body | string | ya | Byte file hasil reassembly yang ditulis host apa adanya. Setiap kit membawanya dalam jenis field miliknya sendiri — mentah jika jenis tersebut adalah jenis byte, dienkode base64 jika berupa string yang didekode guest untuk memulihkannya — dan encoder yang dihasilkan melakukan konversi antara field tersebut dan bentuk yang digunakan wire untuk membawa byte. |
Properti tambahan tidak diizinkan.
NameBoundInput
Payload yang diterima guest Provider pada ekspor name_bound opsionalnya: satu nama yang diusulkan host untuk digunakan sebagai identitas komponen sebuah node, untuk dinilai guest terhadap setiap nama yang akan diturunkannya dari identitas tersebut bagi targetnya, bersama fakta-fakta dari workload node yang telah diresolusi yang menjadi sandaran sebagian nama tersebut, jika identitas ditetapkan setelah workload itu diresolusi. Guest menjawab dengan sebuah batasan, bukan dengan nama buatannya sendiri — nama turunan yang dikirim kembali akan membuat host harus menyusun nama untuk target yang sama sekali tidak dikenalnya, dan justru itulah yang dihilangkan dengan mengajukan pertanyaan ini. Provider yang targetnya membatasi atau merestriksi nama yang diterimanya mengiklankan ekspor ini; provider yang targetnya menerima nama apa pun menghilangkannya dan tidak pernah ditanya, dan rendering-nya tidak berubah.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
proposed | string | ya | Nama yang diusulkan host sebagai identitas komponen node. Dari nama ini guest menurunkan, di dalam memori, setiap nama yang diturunkannya dari identitas komponen dan melaporkan apakah masing-masing merupakan nama yang diterima targetnya. Sebuah verdict berbicara tentang USULAN, bukan tentang node: host mengajukan satu pertanyaan di mana pun ia menyusun identitas, dan tidak menyebutkan nama node mana yang nantinya akan berbasis pada identitas ini, sehingga guest menjawab seolah-olah identitas itu menjadi basis bagi semuanya. Itulah arah yang konservatif, karena host hanya pernah memendekkan berdasarkan jawaban dan tidak pernah memanjangkan — karena itu, nama yang sebenarnya akan diturunkan node dari sumber lain dinilai terlalu ketat, bukan terlalu longgar. |
authored | boolean | tidak | Apakah nama yang diusulkan ditulis oleh seseorang, bukan disusun oleh compiler dari bagian-bagian yang ditulis. Nilai ini dibawa agar guest dapat merumuskan alasannya bagi pembaca yang mampu menindaklanjutinya. Nilai ini tidak menentukan akibat penolakan: nama yang ditulis akan ditolak dan nama yang disusun akan dipendekkan, dan keputusan itu ada pada host. |
workload_form | string | tidak | Bentuk workload yang menjadi hasil resolusi Recipe atau FeatureRecipe node, sebagaimana dihasilkan oleh template workload-nya, dibawa jika identitas ditetapkan setelah workload itu diresolusi dan workload tersebut menyatakan suatu bentuk. Nilai ini dibawa apa adanya; host tidak menafsirkannya. Guest yang targetnya membatasi nama yang dipancarkannya hanya untuk satu bentuk — job terjadwal, yang namanya dibuat lebih pendek oleh target dibanding nama-nama lainnya karena akhiran ditambahkan padanya untuk setiap eksekusi — membacanya untuk menilai nama tersebut. Tidak ada berarti host tidak membawa bentuk apa pun untuk pertanyaan ini: node tidak mendeklarasikan workload, workload-nya tidak menyatakan bentuk, atau identitas ditetapkan sebelum workload apa pun diresolusi. Guest kemudian tidak menilai nama apa pun yang bergantung pada bentuk, dan menjawab persis seperti jika field ini tidak ada. |
service_keys | string[] | tidak | Kunci Services yang dideklarasikan workload node yang telah diresolusi, dalam urutan workload mendeklarasikannya, dibawa jika identitas ditetapkan setelah workload itu diresolusi dan workload tersebut mendeklarasikan Service. Guest yang targetnya menamai setiap Service yang dipancarkannya untuk node dari identitas komponen dan kunci Service tersebut membacanya untuk menilai setiap nama semacam itu. Kunci ditulis oleh penulis Recipe atau FeatureRecipe, bukan oleh siapa pun yang menulis identitas, sehingga guest merumuskan penolakan yang disebabkan suatu kunci untuk penulis tersebut juga. Tidak ada berarti host tidak membawa kunci apa pun untuk pertanyaan ini: node tidak mendeklarasikan workload, workload-nya tidak mendeklarasikan Service, atau identitas ditetapkan sebelum workload apa pun diresolusi. Guest kemudian tidak menilai nama apa pun yang dibangun dari kunci Service, dan menjawab persis seperti jika field ini tidak ada. |
Properti tambahan tidak diizinkan.
DerivedNameVerdict
Verdict satu jenis nama atas identitas yang diusulkan: apakah nama yang akan diturunkan guest untuk jenis tersebut diterima targetnya, dan — jika identitas yang lebih pendek akan diterima — panjang maksimum yang masih diterima. Verdict membawa batasan dan alasan, tidak pernah nama yang dibangun guest.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
kind | string | ya | Nama yang diberikan guest sendiri untuk jenis nama yang dicakup verdict ini, ditulis dalam kosakata target, bukan kosakata compiler — nama release milik installer chart, nama service milik orkestrator kontainer. Nama ini sampai ke pembaca apa adanya dalam sebuah penolakan, sehingga ditulis untuk seseorang yang mengenal target tersebut. |
usable | boolean | ya | Apakah nama yang akan diturunkan guest untuk jenis ini dari identitas yang diusulkan diterima oleh target. |
bound | integer | tidak | Jumlah karakter maksimum yang boleh dimiliki identitas yang diusulkan agar nama turunan jenis ini diterima target. Hanya ada pada penolakan yang dapat dipenuhi oleh identitas yang lebih pendek. TIDAK ADA berarti panjang bukanlah hal yang ditolak target — entah tidak ada batas panjang sama sekali, atau keberatannya tidak dapat diperbaiki dengan pemendekan apa pun, misalnya karakter yang ditolak tata bahasa target pada posisi tempatnya berada. Karena itu, tidak ada berbeda dengan batas nol, yang memang menyatakan panjang: bahwa tidak ada identitas dengan panjang berapa pun yang menghasilkan nama jenis ini yang dapat diterima. Host memendekkan hingga batas yang ada lalu bertanya lagi; jika batas tidak ada, host berhenti, karena tidak ada lagi yang dapat dicoba. |
reason | string | tidak | Alasan target tidak menerima nama turunan, dalam istilah target sendiri, bagi pembaca yang memutuskan apa yang harus ditulis sebagai gantinya. Kosong jika verdict dapat digunakan. |
Properti tambahan tidak diizinkan.
NameBoundOutput
Payload yang dikembalikan oleh guest Provider dari ekspor name_bound-nya: satu putusan per jenis nama yang akan diturunkannya dari identitas yang diusulkan. Sebuah usulan dapat digunakan jika setiap putusan dapat digunakan; jika ada yang tidak, host memendekkan usulan tersebut ke batas terkecil yang dibawa oleh putusan-putusan yang menolak lalu bertanya lagi, dan berhenti ketika sebuah putusan yang menolak tidak membawa batas. Daftar putusan yang kosong berarti guest tidak menurunkan nama apa pun dari identitas komponen, yang merupakan jawaban yang sama dengan menerima usulan tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
names | DerivedNameVerdict[] | tidak | Satu entri per jenis nama yang diturunkan guest dari identitas komponen, dalam urutan guest sendiri. Guest melaporkan setiap jenis yang akan diturunkannya, bukan hanya jenis yang menolak, sehingga pembaca melihat nama mana saja yang dinilai dan host yang membaca entri tersebut tidak memerlukan panggilan kedua untuk mengetahui sisanya. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Pesan ini berbeda dari putusan yang menolak: putusan melaporkan nama yang tidak akan diterima target, sedangkan error melaporkan bahwa pertanyaan itu sendiri tidak dapat dijawab. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
RenderedNameInput
Payload yang diterima guest Provider pada ekspor opsional rendered_name-nya: dua identitas yang menjadi dasar target menurunkan namanya sendiri, serta jenis input mana yang dideklarasikan oleh Recipe node tersebut — sumber yang disediakan penulis, atau workload yang disintesis guest. Guest menjawab dengan nama yang akan diberikan targetnya kepada sumber daya yang direndernya untuk node tersebut: untuk sumber yang disediakan, nama yang menjadi acuan render templat milik penulis sendiri, seperti nama rilis yang dibaca sebuah chart; untuk workload yang disintesis, nama yang diberikan guest kepada sumber daya yang dibangunnya, jika guest menurunkan nama alih-alih menuliskan identitas node apa adanya. Guest yang tidak menurunkan nama semacam itu tidak melaporkan nama apa pun, yang merupakan jawaban jujur untuk target yang nama sumber dayanya ditulis apa adanya oleh Recipe, dan untuk target yang namanya merupakan fungsi dari lokasi penempatan berkas, bukan dari node. Ekspor ini melaporkan nama yang disusun oleh guest itu sendiri dan bukan pertukaran yang meminta guest menilai nama yang diusulkan host; keduanya adalah pertanyaan yang berbeda dan masing-masing memiliki ekspornya sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node_id | string | ya | Identitas node itu sendiri, sebagaimana ditulis. Identitas ini dibawa tanpa dienkode: target mempersempitnya melalui alfabetnya sendiri, sehingga mengenkodenya terlebih dahulu akan menempatkan satu escape di dalam escape lain dan mengeja nama secara berbeda dari nama yang diperkirakan oleh penulis recipe. |
derived_name_basis | string | tidak | Identitas yang menjadi acuan render sumber milik kontributor ketika identitas tersebut bukan identitas node itu sendiri — diisi untuk kontributor yang identitasnya ditolak oleh alfabet nama target, dan tidak ada jika tidak demikian. Guest menyelesaikan pasangan ini dengan cara yang sama seperti setiap permukaan lain: nilai ini jika ada, dan id node jika tidak ada. |
sourced | boolean | tidak | Apakah Recipe yang terikat pada node mendeklarasikan sumber yang disediakan penulis, dibaca dari teks yang ditulis penulis. Nilai ini dibawa, bersama synthesized, agar pertanyaan dapat diajukan untuk node mana pun dan dijawab dengan benar: guest tidak melaporkan nama untuk node yang tidak mendeklarasikan keduanya, yang keluarannya hanya berupa sekumpulan artefak, karena sumber daya dalam kumpulan semacam itu dinamai oleh artefak yang ditulis penulis, bukan oleh nama apa pun yang diturunkan guest. |
synthesized | boolean | tidak | Apakah Recipe yang terikat pada node mendeklarasikan workload untuk disintesis oleh guest, dibaca dari teks yang ditulis penulis, sama seperti sourced. Guest yang targetnya menamai sumber daya yang disintesisnya berdasarkan nama yang diturunkannya, bukan berdasarkan identitas node sebagaimana ditulis, melaporkan nama tersebut untuk node semacam itu, sehingga alamat yang dipublikasikan Recipe untuk salah satu sumber daya tersebut dapat dibangun dari nama yang dibawa sumber daya itu. |
Properti tambahan tidak diizinkan.
RenderedNameOutput
Payload yang dikembalikan guest Provider dari ekspor rendered_name-nya: nama yang diberikan targetnya kepada sumber daya yang di-render-nya untuk node tersebut — dari sumber yang disediakan penulis node, atau dari workload yang disintesisnya — atau tidak ada nama sama sekali. Nama yang tidak ada atau kosong adalah jawaban positif, bukan kegagalan — jawaban itu menyatakan bahwa target ini tidak menurunkan nama semacam itu — dan host menggunakan apa yang diberitahukan kepadanya tanpa membacanya, sehingga tidak ada pengetahuan tentang penamaan target yang melintasi batas.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | tidak | Nama yang digunakan guest untuk me-render sumber yang disediakan penulis node ini, atau yang diberikannya kepada sumber daya yang disintesisnya untuk node tersebut, yang sudah ditulis dalam alfabet yang diterima targetnya pada posisi itu. Kosong atau tidak ada berarti guest tidak menurunkan nama semacam itu. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Ini berbeda dari melaporkan tidak ada nama: tidak ada nama adalah jawaban tentang target, sedangkan error melaporkan bahwa pertanyaan itu sendiri tidak dapat dijawab. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebut oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama tempat compiler mendaftarkan kondisi penghentiannya sendiri. Diisi di samping pesan error yang dapat dibaca manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebut kondisi semacam itu. Host me-resolve pengenal ini terhadap kondisi yang dideklarasikan compiler dan memublikasikan pengenal milik kondisi yang ter-resolve pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu ter-resolve; pengenal yang tidak menyebut kondisi semacam itu, atau yang sudah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebut sebaliknya menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk tujuan tersebut, dan menaruh detailnya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebut satu kondisi dalam dua bentuk: guest yang mengisi salah satu tanpa yang lain telah menyebut kondisi yang tidak dapat di-resolve host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap memuat seluruh kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
LinkEndpoint
Satu titik akhir dari tautan lintas batas: node, jalur batas tempat keluaran yang di-render-nya dirakit, dan provider yang me-render-nya. Kedua titik akhir tautan menyebut ujung pengonsumsi dan ujung yang dikonsumsi dari edge uses yang ujung-ujungnya dirakit ke dalam grup dispatch yang berbeda.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
node | string | ya | Id absolut node titik akhir di dalam graf topologi. |
boundary | string | ya | Jalur batas titik akhir — grup dispatch tempat keluaran yang di-render-nya dirakit. |
provider | string | ya | Provider yang me-render titik akhir (nama provider polos). Kedua titik akhir dari tautan yang terhubung menyebut provider yang sama; host tidak merutekan tautan yang titik akhirnya menyebut provider berbeda. |
release | string | tidak | Release tempat keluaran yang di-render titik akhir berada — cakupan tempat artefak yang dirakitnya dinamai. Host merakitnya dari Release yang di-resolve build dan meneruskannya apa adanya; host tidak menyimpulkan makna apa pun dari nilai tersebut. Provider membacanya untuk membatasi cakupan nama referensi silang ke Release. Nilai yang tidak ada adalah string kosong, yang diperlakukan provider sebagai nama tanpa cakupan. |
Properti tambahan tidak diizinkan.
LinkEdge
Payload per-edge yang digeneralisasi dan agnostik terhadap domain, yang dirakit host untuk edge uses yang ujung pengonsumsi dan ujung yang dikonsumsinya dirakit ke dalam grup dispatch yang berbeda. Payload ini memuat kedua titik akhir, anotasi penempatan kedua titik akhir sebagai map skalar buram yang tidak ditafsirkan host, keluaran provides dari titik akhir yang dikonsumsi, serta socket dan pemetaan inject yang dihubungkan edge. Provider membacanya untuk menghasilkan penghubungan referensi silang asli provider yang dibutuhkan kedua ujung; host merakitnya dan meneruskan map anotasi sebagai skalar buram, tanpa menyimpulkan makna apa pun dari nilai mana pun.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
source | LinkEndpoint | ya | Titik akhir pengonsumsi — ujung sumber dari edge uses berarah, yang ke dalam keluaran rakitannya penghubungan sisi konsumen diinjeksikan. |
target | LinkEndpoint | ya | Titik akhir yang dikonsumsi — ujung target yang ditunjuk edge uses, yang keluaran rakitannya dipublikasikan oleh penghubungan sisi produsen. |
target_annotations | map of string | tidak | Anotasi penempatan titik akhir yang dikonsumsi (target) sebagai map skalar buram, dengan kunci berupa nama anotasi. Host merakitnya dari anotasi target yang sudah di-resolve dan meneruskannya apa adanya; host tidak menyimpulkan makna apa pun dari nilai mana pun. Provider membacanya untuk memutuskan cara membentuk referensi silang (misalnya apakah kedua ujung berbagi penempatan atau memerlukan referensi lintas penempatan). Kunci diserialisasi dalam urutan terurut sehingga payload identik byte demi byte di setiap eksekusi dengan masukan yang identik. |
source_annotations | map of string | tidak | Anotasi penempatan titik akhir pengonsumsi (sumber) sebagai map skalar buram, dengan kunci berupa nama anotasi. Host merakitnya dari anotasi sumber yang sudah di-resolve dan meneruskannya apa adanya; host tidak menyimpulkan makna apa pun dari nilai mana pun. Provider membacanya untuk membandingkan penempatan kedua ujung — misalnya apakah sumber dan target berbagi penempatan atau berada di penempatan yang berbeda. Kunci diserialisasi dalam urutan terurut sehingga payload identik byte demi byte di setiap eksekusi dengan masukan yang identik. |
socket | string | ya | Alias socket tempat edge uses diikat. |
provides | map of string | ya | Keluaran provides dari titik akhir yang dikonsumsi, himpunan kunci berurutan sesuai penulis yang mengekspos keluaran yang dideklarasikan target. Mempertahankan urutan penulis sehingga payload identik byte demi byte di setiap eksekusi dengan masukan yang identik. |
inject | object | ya | Pemetaan inject dari titik akhir pengonsumsi, dengan kunci berupa mekanisme pengiriman yang dipetakan ke himpunan kunci berurutan sesuai penulis, yang menjelaskan cara ujung pengonsumsi menerima keluaran titik akhir yang dikonsumsi. Mempertahankan urutan penulis sehingga payload identik byte demi byte di setiap eksekusi dengan masukan yang identik. |
read_provides_keys | string[] | tidak | Kunci-kunci output provides dari endpoint yang dikonsumsi yang dibaca langsung oleh templat endpoint pengonsumsi melalui .context.uses, terlepas dari apakah pemetaan inject juga mengirimkannya, dalam urutan penulis provides. Setiap entri adalah salah satu kunci yang dibawa provides. Daftar ini ikut pada edge sehingga publish di sisi produsen dan resolve di sisi konsumen membaca satu daftar yang sama. Tidak ada bila endpoint pengonsumsi tidak membaca kunci provides apa pun secara langsung, dan provider yang tidak diberi daftar ini menghubungkan link persis seperti bila field ini tidak ada. |
Properti tambahan tidak diizinkan.
LinkPatch
Satu patch struktural per file yang dikembalikan provider sebagai penghubungan artefak: file keluaran dan operasi struktural berurutan yang diterapkan padanya. Pass host berikutnya memotong file yang disebut, menerapkan operasi, dan merakitnya kembali secara setia byte demi byte. Bentuk operasi adalah kosakata operasi patch pipeline bersama; bentuk ini buram pada lapisan skema ini, sehingga guest membawa setiap operasi apa adanya sementara host mewujudkan operasi bertipe yang diterapkan pipeline-nya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
file | string | ya | File keluaran tempat operasi diterapkan, dinamai sebagaimana provider mengeluarkannya. |
ops | any[] | ya | Operasi struktural berurutan yang diterapkan pada file, dalam urutan penerapan. |
Properti tambahan tidak diizinkan.
LinkPublishInput
Payload yang diterima provider pada ekspor link_publish miliknya: satu tautan lintas batas yang keluaran endpoint terkonsumsinya dirujuk melintasi batas, beserta berkas-berkas terakit endpoint tersebut. Ekspor ini mengembalikan identitas terpublikasi yang menjadi acuan resolusi bagi konsumen, serta wiring artefak sisi produsen apa pun yang dibutuhkan keluaran endpoint terkonsumsi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
edge | LinkEdge | ya | Tautan lintas batas yang sedang dipublikasikan, dibaca dari sisi endpoint terkonsumsi (target). |
producer_files | RenderedFile[] | tidak | Berkas-berkas terakit milik endpoint terkonsumsi, sehingga provider dapat membaca apa yang sudah dideklarasikan endpoint tersebut dan memeriksa nama-nama yang akan dipublikasikannya terhadap berkas-berkas itu. Masing-masing menyebutkan path-nya di disk dan membawa byte terakit. Tidak ada jika host tidak memiliki keluaran produsen terakit untuk diserahkan ke publikasi; provider yang tidak memerlukan dokumen untuk menyusun wiring-nya mengabaikannya. |
Properti tambahan tidak diizinkan.
LinkPublishOutput
Payload yang dikembalikan provider dari ekspor link_publish miliknya: handle identitas terpublikasi yang menjadi acuan resolusi bagi konsumen, dan wiring artefak sisi produsen yang diterapkan pada keluaran terakit endpoint terkonsumsi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
handle | map of string | ya | Identitas terpublikasi yang diekspos endpoint terkonsumsi sebagai acuan resolusi bagi konsumen, berupa map string pointer deterministik yang opak dengan kunci nama field (misalnya nama ekspor, nama stack, region, referensi role). Nilainya adalah string pointer deterministik yang disalurkan compiler dan tidak pernah di-resolve olehnya; lingkungan runtime me-resolve-nya pada saat deploy. Kunci diserialisasi dalam urutan terurut sehingga payload identik byte demi byte di antara eksekusi dengan masukan yang identik. |
patches | LinkPatch[] | tidak | Wiring artefak sisi produsen, satu patch struktural per berkas keluaran endpoint terkonsumsi yang harus disunting oleh publikasi. Kosong jika keluaran endpoint terkonsumsi tidak memerlukan perubahan untuk tautan tersebut. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat memublikasikan tautan; tidak ada jika berhasil. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. Publikasi yang tidak dapat dilanjutkan — misalnya nama ekspor yang sudah dideklarasikan stack di bawah entri lain — dilaporkan di sini, bukan hanya sebagai crash, sehingga kondisi di baliknya dapat disebutkan. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.
LinkResolveInput
Payload yang diterima provider pada ekspor link_resolve miliknya: satu tautan lintas batas, handle identitas terpublikasi yang diekspos endpoint terkonsumsinya, dan berkas-berkas terakit milik endpoint pengonsumsi. Ekspor ini mengembalikan wiring artefak sisi konsumen yang menyisipkan referensi ke dalam keluaran terakit endpoint pengonsumsi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
edge | LinkEdge | ya | Tautan lintas batas yang sedang di-resolve, dibaca dari sisi endpoint pengonsumsi (sumber). |
handle | map of string | ya | Handle identitas terpublikasi yang dikembalikan link_publish milik endpoint terkonsumsi, yang menjadi acuan bagi konsumen untuk me-resolve referensinya. String pointer deterministik yang opak dengan kunci nama field; compiler menyalurkannya dan tidak pernah me-resolve-nya. Kunci diserialisasi dalam urutan terurut sehingga payload identik byte demi byte di antara eksekusi dengan masukan yang identik. |
consumer_files | RenderedFile[] | tidak | Berkas-berkas terakit milik endpoint pengonsumsi, sehingga provider dapat menemukan placeholder yang dicap host ke dalam keluaran pengonsumsi dan menyusun penggantinya pada path sebenarnya dari placeholder tersebut. Masing-masing menyebutkan path-nya di disk dan membawa byte terakit. Tidak ada jika host tidak memiliki keluaran konsumen terakit untuk diserahkan ke resolusi; provider yang tidak memerlukan dokumen untuk menyusun wiring-nya mengabaikannya. |
Properti tambahan tidak diizinkan.
LinkResolveOutput
Payload yang dikembalikan provider dari ekspor link_resolve-nya: pengkabelan artefak sisi konsumen yang diterapkan pada keluaran terakit endpoint pengonsumsi, yang menyuntikkan referensi ke identitas terpublikasi milik endpoint yang dikonsumsi.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
patches | LinkPatch[] | ya | Pengkabelan artefak sisi konsumen, satu patch struktural per berkas keluaran endpoint pengonsumsi yang harus disunting oleh resolve. |
error | string | tidak | Pesan kegagalan yang ditetapkan ketika guest berjalan tetapi tidak dapat me-resolve link; tidak ada jika berhasil. Host menampilkan error yang ada sebagai invokasi plugin yang gagal. Resolve yang tidak dapat dilanjutkan — misalnya referensi yang hanya dapat dibawa target sebagai skalar utuh, tetapi ditemukan di dalam string yang lebih besar — dilaporkan di sini, bukan hanya sebagai crash, sehingga kondisi di baliknya dapat disebutkan. |
condition_code | string | tidak | Identitas deskriptif yang dapat dicocokkan mesin dari kondisi yang disebutkan oleh kegagalan — kode tempat kondisi tersebut didaftarkan, dalam himpunan terbuka yang sama dengan tempat compiler mendaftarkan kondisi penghentiannya sendiri, dan bukan anggota katalog kode galat fungsi host yang tertutup yang menjadi sumber hostfunc_error_code pada amplop balasan. Ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Guest yang berhenti melaporkan di sini pengenal kondisi yang disebutkan pesannya, sehingga konsumen bercabang berdasarkan pengenal ini alih-alih memulihkan identitas dengan membaca pesan. Host mencocokkan pengenal ini dengan kondisi yang dideklarasikan compiler dan menerbitkan pengenal milik kondisi yang telah dicocokkan pada diagnostik terstruktur, sehingga kode yang sampai ke pembaca selalu dapat dicocokkan; pengenal yang tidak menyebutkan kondisi semacam itu, atau yang telah dipensiunkan oleh penomoran, menghentikan build. Guest yang tidak memiliki kondisi spesifik untuk disebutkan menggunakan salah satu kondisi kegagalan plugin generik yang dideklarasikan compiler untuk keperluan tersebut, dan menuliskan rinciannya dalam pesannya sendiri. Pengenal ini dan condition_short_code dilaporkan bersama, karena keduanya menyebutkan satu kondisi dalam dua bentuk: guest yang menetapkan salah satu tanpa yang lain telah menyebutkan kondisi yang tidak dapat dicocokkan host, dan host kemudian melaporkan kondisi kegagalan plugin generiknya sendiri sebagai gantinya, sementara pesan tetap membawa keseluruhan kegagalan. |
condition_short_code | string | tidak | Pengenal ringkas dari kondisi yang sama — huruf E dan empat digit, bentuk yang dikutip, dicari, dan ditempelkan pembaca ke dalam laporan — ditetapkan di samping pesan galat untuk manusia; tidak ada jika berhasil, dan tidak ada jika guest tidak menyebutkan kondisi semacam itu. Host mencetaknya di bagian kepala dalam kurung siku pada diagnostik yang di-render-nya untuk kegagalan ini, sehingga kondisi yang dimunculkan guest dapat dikutip persis seperti kondisi yang dimunculkan compiler. Host mencocokkan nilai ini dengan kondisi yang dideklarasikan compiler alih-alih menerimanya begitu saja: nilai yang tidak menyebutkan kondisi semacam itu, nilai yang telah dipensiunkan oleh penomoran, atau ejaan yang tidak dimuat oleh pendaftaran menghentikan build dan mengutip nilai yang bermasalah, dengan pesan guest sendiri tetap dilaporkan. Nilai ini dilaporkan bersama condition_code, dengan alasan yang dijelaskan di sana. |
Properti tambahan tidak diizinkan.