Menulis plugin tata kelola sendiri
Halaman ini memandu sebuah plugin tata kelola dari kerangka adapter kit pengembangan plugin hingga ke build yang ditolaknya. Anda menyalin kerangka, menulis satu aturan di dalamnya, membangun .wasm, memanggil setiap ekspornya secara manual pada file payload yang disertakan kerangka, mendeklarasikannya sebagai entitas Plugin dalam katalog milik workspace Anda, memasangnya pada sebuah peran, dan melihatnya menghentikan build yang melanggar aturan.
Halaman ini adalah pendamping praktik untuk soket tata kelola, yang mendokumentasikan empat peran, payload yang dibawa masing-masing, dan verdict yang ditindaklanjuti host, serta untuk panduan pengembang plugin, yang mendokumentasikan entitas Plugin dan siklus hidupnya. Menulis provider adalah panduan serupa untuk guest provider.
Tentang blok di halaman ini. Setiap blok yang menampilkan output disalin dari eksekusi nyata langkah-langkah di bawah, sesuai urutan kemunculannya, mengikuti konvensi output: sebuah blok bisa lengkap, atau berupa kutipan yang menandai tempat baris dihilangkan. Dua placeholder mewakili path absolut yang berbeda di setiap mesin: <guest> adalah direktori salinan kerangka Anda, dan <workspace> adalah direktori workspace tempat plugin dipasang.
Yang Anda perlukan
- Toolchain Go, yang mengompilasi ke WebAssembly tanpa perkakas tambahan.
- Salinan kerja (checkout) dari kit pengembangan plugin, yang memuat kerangka, dan dari paket ABI yang menjadi dasar kit:
go.modsalinan Anda menunjuk ke keduanya. - Biner
aggrega.
Kit menyediakan kerangka yang sama untuk Rust, di rust/examples/governance-adapter-skeleton, dan untuk TypeScript, di typescript/examples/governance-adapter-skeleton. Masing-masing membawa empat file payload yang sama, dan salinan yang tidak dimodifikasi dari masing-masing menjawabnya dengan cara yang sama; setiap perintah aggrega di halaman ini berlaku untuk salah satunya dengan nama artefaknya sendiri, dan README masing-masing menjelaskan cara build-nya.
Bentuk hasil akhirnya
Plugin tata kelola, seperti plugin lainnya, terdiri atas dua artefak: guest .wasm, dan entitas Plugin yang membawanya ke dalam katalog. Memasangnya hanya berupa satu entri dalam konfigurasi workspace. Tidak ada yang berubah di compiler.
Dua direktori yang dihasilkan di akhir panduan ini, tidak termasuk apa yang ditulis build ke dalam workspace:
category-guard/ your copy of the skeleton: the Go module that compiles to the .wasm .gitignore README.md the skeleton's own guide go.mod go.sum main.go the describe() self-report and the shared plumbing evaluator.go the seam, where the rule goes annotations.go the annotation-transform role labels.go the label-transform role verdicts.go the ir-verdict and render-verdict roles build.sh annotation-payload.json label-payload.json ir-verdict-payload.json render-verdict-payload.json my-payload.json a copy you edit in section 4 wrong-payload.json a copy you break in section 5 overlay.yaml the identity you supply to the entity generator dist/governance-adapter-skeleton-go.wasm the compiled guestshop/ the workspace the plugin is attached in catalog/component/example/compute/api/1.0.0/component.yaml catalog/component/example/devtool/db-console/1.0.0/component.yaml catalog/recipe/compose/api/1.0.0/recipe.yaml catalog/recipe/compose/db-console/1.0.0/recipe.yaml catalog/plugin/governance/category-guard/0.1.0/plugin.yaml catalog/plugin/governance/category-guard/0.1.0/governance--category-guard.wasm aggregate.yaml manifest.yaml release.yaml .aggrega-config.yamlAturan yang ditegakkan plugin ini umum: sebuah workspace menyebut kategori komponen yang tidak dikirimkannya — di sini devtool, kategori konsol administrasi — dan build yang membawa komponen dari salah satu kategori itu berhenti, dengan menyebut komponen tersebut.
1. Salin kerangka
cp -r /path/to/aggrega-pdk/go/examples/governance-adapter-skeleton category-guardcd category-guardgo.mod kerangka menjangkau kit dan paket ABI melalui path relatif terhadap posisinya di dalam kit, sehingga salinan di luar kit harus menyebutnya sendiri. Beri modul path milik Anda dan arahkan dua baris replace ke salinan kerja Anda:
module example.com/category-guard
go 1.26.0
require ( github.com/aggrega-ai/aggrega-abi/go v0.0.0 github.com/aggrega-ai/aggrega-pdk/go v0.0.0 github.com/extism/go-pdk v1.1.3)
replace github.com/aggrega-ai/aggrega-pdk/go => /path/to/aggrega-pdk/go
replace github.com/aggrega-ai/aggrega-abi/go => /path/to/aggrega-abi/gogo.sum kerangka dibiarkan apa adanya.
2. Build, lalu panggil setiap peran secara manual
Build salinan sebelum mengubah apa pun, sehingga hal pertama yang Anda jalankan adalah kode penghubung yang tidak Anda tulis:
./build.shWrote <guest>/dist/governance-adapter-skeleton-go.wasmaggrega plugin run-local memuat guest dari sebuah path, memeriksa bahwa ekspor yang Anda sebut dideklarasikan dalam laporan diri describe() milik guest — dan, dengan --type governance, bahwa guest melaporkan dirinya sebagai plugin tata kelola — memanggilnya dengan payload yang Anda berikan, lalu mencetak jawabannya. Kerangka menyertakan satu file payload per peran, masing-masing berupa input kecil yang valid untuk ekspornya. Payload ditulis sebagai JSON; wire setiap peran tata kelola membawa encoding biner, sehingga perintah mengonversi payload ke encoding tersebut sebelum memanggil ekspor dan mencetak jawaban ekspor sebagai JSON.
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export transform_annotations --with @annotation-payload.json{ "injections": []}run-local membaca guest dan payload dari path yang Anda berikan dan tidak memerlukan workspace, sehingga dapat dijalankan dari direktori mana pun.
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export mutate --with @label-payload.json{ "patches": []}aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_ir --with @ir-verdict-payload.json{ "results": [ { "severity": "info", "message": "this adapter has no policy engine yet: the seam received rules.policy (43 bytes) and some settings" } ]}aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_render --with @render-verdict-payload.json{ "results": [ { "severity": "info", "message": "this adapter has no policy engine yet: the seam received rules.policy (43 bytes) and some settings" } ]}Setiap jawaban berbentuk sesuai yang boleh dikembalikan perannya: anotasi yang ditambahkan, perubahan label, dan verdict. Dua peran transformasi tidak mengembalikan apa pun, dan setiap peran verdict mengembalikan satu verdict info — catatan yang merekam sebuah pengamatan dan tidak mengubah hasil build. Catatan itu adalah bukti bahwa penghubung kerangka berfungsi. Setiap file payload membawa dua input sebuah pemasangan sebagaimana build menyerahkannya: satu file kebijakan, rules.policy, di bawah sources, dan sebuah objek settings. Catatan tersebut menyatakan bahwa keduanya mencapai sambungan — satu fungsi yang dipanggil bagian lain kerangka dengan apa pun yang diterima peran.
Berikut payload yang akan dibaca aturan di bawah, ir-verdict-payload.json, secara lengkap:
{ "graph": { "apiVersion": "aggrega.ai/v1beta1", "kind": "IR", "metadata": { "aggregate_name": "shop" }, "spec": { "nodes": { "api": { "component": "example/compute/api", "resolved_version": "1.0.0", "labels": { "component.aggrega.ai/type": "server", "component.aggrega.ai/category": "compute" } } }, "edges": [], "values_mapping": {}, "infra_mapping": {}, "feature_values_mapping": {}, "provenance": { "schema_version": "aggrega.ai/v1beta1", "compiler_version": "0.0.0", "aggregate_version": "1.0.0", "manifest_version": "1.0.0", "release_version": "1.0.0" } } }, "precalculated_paths": [], "sources": [ { "path": "rules.policy", "content": "policy text, handed to the engine verbatim\n" } ], "settings": { "max_nodes": 50 }}Ini adalah input peran ir-verdict: graf build dengan satu komponen di dalamnya, jalur routing yang dienumerasi pada graf, serta sources dan settings milik pemasangan. Setiap field dijelaskan di halaman referensi peran tersebut, skema soket kebijakan, dengan graf itu sendiri di skema graf build; tiga file lainnya mengikuti skema annotation-transform, skema mutator dan, untuk verdict_render, RenderPolicyInput dari skema soket kebijakan.
3. Tulis satu aturan
Aturan berada di evaluator.go, sambungan kerangka. Setiap peran mendekode payload-nya, menuliskannya sebagai dokumen JSON, dan memanggil Evaluate dengan file kebijakan pemasangan, pengaturannya, dokumen tersebut, dan nama keputusan yang ingin diterimanya kembali. Peran verdict meminta tiga keputusan secara bergiliran — deny, warn, dan audit — dan melaporkan jawaban masing-masing pada tingkat keparahan halt, warn, dan info; dua peran transformasi meminta annotations dan labels. Jadi aturan yang menghentikan build menjawab deny.
Ganti evaluator.go dengan:
package main
import ( "encoding/json" "fmt" "slices" "sort")
// Program is one policy program the attachment carried.type Program struct { Path string Text string}
// categoryLabel is the label a catalog Component states its category in.const categoryLabel = "component.aggrega.ai/category"
// Evaluate refuses every component whose category the attachment's settings// list under forbidden_categories.func Evaluate(programs []Program, settings json.RawMessage, payload json.RawMessage, decision string) ([]json.RawMessage, error) { if decision != denyDecision { return nil, nil }
var config struct { ForbiddenCategories []string `json:"forbidden_categories"` } if len(settings) > 0 { if err := json.Unmarshal(settings, &config); err != nil { return nil, fmt.Errorf("reading the settings: %w", err) } }
var input struct { Graph struct { Spec struct { Nodes map[string]struct { Labels map[string]string `json:"labels"` } `json:"nodes"` } `json:"spec"` } `json:"graph"` } if err := json.Unmarshal(payload, &input); err != nil { return nil, fmt.Errorf("reading the build graph: %w", err) }
// A Go map has no order, so the node ids are sorted: identical input must // yield an identical sequence of decisions. ids := make([]string, 0, len(input.Graph.Spec.Nodes)) for id := range input.Graph.Spec.Nodes { ids = append(ids, id) } sort.Strings(ids)
var decisions []json.RawMessage for _, id := range ids { category := input.Graph.Spec.Nodes[id].Labels[categoryLabel] if !slices.Contains(config.ForbiddenCategories, category) { continue } message, err := json.Marshal(fmt.Sprintf( "component %q is a %s component, and this workspace ships none", id, category)) if err != nil { return nil, err } decisions = append(decisions, message) } return decisions, nil}Program tetap ada, karena file peran membangun daftar programnya dengan itu. Sisanya adalah aturan, dan empat hal di dalamnya layak dibaca dengan saksama.
- Aturan membaca payload dengan nama yang diberikan wire. Node berada di
graph.spec.nodes, dengan kunci id node, masing-masing denganlabels-nya — path yang sama yang diberikan Apa yang diekspos payload setiap peran kepada kebijakan Rego sebagaiinput.graph.spec.nodes. Aturan yang ditulis untuk peran ini tidak membaca apa pun di peran lain: payloadrender-verdicttidak membawa graf, sehingga di sana loop tidak menemukan node. - Apa yang dilarangnya ditentukan operator, bukan plugin. Kategori berasal dari
settingspemasangan, sehingga.wasmyang sama melayani workspace yang melarangdevtoolmaupun yang tidak melarang apa pun. - Aturan mengurutkan sebelum menjawab. Output build identik byte demi byte di antara eksekusi dengan input identik, dan guest yang menjawab dalam urutan map Go akan merusaknya dari dalam.
- Aturan gagal secara jelas. Pengaturan atau payload yang tidak dapat dibacanya mengembalikan error, bukan daftar kosong, dan peran mengubah error itu menjadi panggilan yang gagal. Daftar kosong adalah kebijakan yang tidak menemukan apa pun untuk dikatakan; panggilan yang gagal adalah kebijakan yang tidak berjalan, dan build hanya dapat membedakan keduanya jika guest membedakannya.
Aturan tidak pernah membaca programs. Aturan plugin ini dikompilasi ke dalam guest, sehingga pemasangan menyediakan pengaturan dan tanpa file kebijakan — bentuk yang sama dengan guest yang dibangun di sekitar engine yang telah dikompilasi sebelumnya, dan kebalikan dari guest yang memuat aturannya dari sources.
Terakhir, nyatakan apa plugin ini. Di main.go, ubah deskripsi di descriptor():
Description: "Refuse a build that carries a component of a category the attachment forbids.",Generator entitas di bagian 6 menyalinnya ke entitas Plugin.
4. Build lagi, dan baca jawaban aturan
./build.shWrote <guest>/dist/governance-adapter-skeleton-go.wasmPanggil keempat ekspor lagi pada file yang sama:
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export transform_annotations --with @annotation-payload.jsonaggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export mutate --with @label-payload.jsonaggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_ir --with @ir-verdict-payload.jsonaggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_render --with @render-verdict-payload.json{ "injections": []}{ "patches": []}{ "results": []}{ "results": []}Catatan placeholder hilang dari kedua peran verdict, dan tidak ada yang mengembalikan verdict: settings payload bawaan tidak melarang kategori apa pun, sehingga aturan mengizinkannya. Daftar results yang kosong adalah cara peran verdict menyatakan bahwa build boleh dilanjutkan.
Untuk melihat aturan terpicu, beri aturan pengaturan yang melarang apa yang dibawa payload. Salin ir-verdict-payload.json ke my-payload.json dan ganti settings-nya dengan:
"settings": { "forbidden_categories": [ "compute" ] }aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_ir --with @my-payload.json{ "results": [ { "severity": "halt", "message": "component \"api\" is a compute component, and this workspace ships none" } ]}Keputusan deny tiba sebagai verdict halt yang membawa pesan aturan itu sendiri. Dalam sebuah build, halt menghentikannya dengan pesan tersebut sebagai alasan.
5. Bila payload tidak sesuai
Perintah mengonversi setiap field yang dibawa payload ke tipe yang dideklarasikan bentuknya, dan menolak field yang tidak dapat dikonversinya sebelum guest berjalan. Tulis labels sebuah node sebagai list, bukan objek, dalam salinan bernama wrong-payload.json:
"labels": [ "server", "compute" ]aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export verdict_ir --with @wrong-payload.jsonunder key "api": expected JSON object, found [Perintah keluar dengan kode bukan nol, dan guest tidak pernah dipanggil.
Konversi memeriksa tipe setiap field yang dibawa payload; konversi tidak memeriksa bahwa payload membawa setiap field yang diwajibkan bentuknya. Payload yang kehilangan satu field tetap dikonversi dan diserahkan ke guest, dan guest yang aturannya membaca field tersebut tidak menemukan apa pun di sana. Jadi periksa payload yang Anda tulis secara manual terhadap halaman referensi skemanya: diamnya perintah tidak berarti payload sudah lengkap.
6. Deklarasikan sebagai entitas Plugin dalam katalog workspace Anda
Field kontrak entitas dibaca dari guest, bukan ditulis secara manual, sehingga entitas tidak dapat mengklaim ekspor yang tidak dimiliki biner. Anda menyediakan identitas dalam sebuah overlay kecil, overlay.yaml:
apiVersion: aggrega.ai/v1beta1kind: Pluginmetadata: name: category-guardaggrega plugin gen-catalog --plugin dist/governance-adapter-skeleton-go.wasm \ --overlay overlay.yaml --output-dir ../shop/catalog/plugingenerated ../shop/catalog/plugin/governance/category-guard/0.1.0/plugin.yamlEntitas yang dihasilkan:
# Generated from the plugin by `aggrega plugin gen-catalog`. You may narrow its capability lists; edit nothing else here.apiVersion: aggrega.ai/v1beta1kind: Pluginmetadata: name: category-guard version: 0.1.0 pluginType: governance description: Refuse a build that carries a component of a category the attachment forbids.spec: abiVersion: v1beta1 exports: - name: transform_annotations - name: mutate - name: verdict_ir - name: verdict_renderversion adalah versi yang dicap build.sh milik kerangka ke dalam guest, yaitu 0.1.0 kecuali AGGREGA_PLUGIN_VERSION menyebut versi lain; pluginType dan keempat ekspor adalah apa yang dilaporkan describe(). Plugin tata kelola tidak mendeklarasikan kapabilitas: apa yang boleh dikembalikannya berasal dari peran tempat ia dipasang, bukan dari entitas.
Selama Anda mengembangkan plugin, belum ada yang dipublikasikan untuk diambil, sehingga build membacanya dari direktori katalog, dengan .wasm di samping entitasnya. File di samping entitas dinamai berdasarkan tipe plugin dan nama entitas, di direktori tempat dokumen entitas berada — untuk governance/category-guard, governance--category-guard.wasm:
cp dist/governance-adapter-skeleton-go.wasm \ ../shop/catalog/plugin/governance/category-guard/0.1.0/governance--category-guard.wasmSalin file tersebut alih-alih membuat tautan ke sana. Tautan di tempat itu hanya diikuti ke suatu tempat di dalam workspace — atau, untuk direktori katalog yang dicantumkan di luar workspace, ke suatu tempat di dalam direktori itu; tautan yang mengarah lebih jauh menghentikan build dan pull dengan menyebut tautan tersebut, sebagaimana dijelaskan batas workspace. Pull yang tidak menemukan .wasm dengan nama itu berhenti dan menyebut file yang diharapkannya, sebagaimana dijelaskan A plugin’s .wasm is not on this machine (File plugin tidak ada di mesin ini).
7. Workspace yang dijaga plugin
Workspace ini adalah toko kecil: sebuah API, dan dokumen yang membangunnya dengan Docker Compose. Katalognya juga membawa konsol administrasi yang akan ditolak aturan, sebuah Component dengan kategori devtool.
catalog/component/example/compute/api/1.0.0/component.yaml:
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: example/compute/api version: 1.0.0 description: The shop's HTTP API. labels: component.aggrega.ai/type: server component.aggrega.ai/category: computespec: schema: infra: port: type: integer default: 8080 description: The port the API listens on.catalog/component/example/devtool/db-console/1.0.0/component.yaml:
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: example/devtool/db-console version: 1.0.0 description: A database administration console in the browser. labels: component.aggrega.ai/type: server component.aggrega.ai/category: devtoolspec: schema: infra: port: type: integer default: 8081 description: The port the console listens on.catalog/recipe/compose/api/1.0.0/recipe.yaml:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: api version: 1.0.0 description: Runs the API as a Docker Compose service.spec: capability: compose implements: example/compute/api:1.0.0 workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload containers: main: image: "registry.example.com/shop/api:1.0.0" ports: http: {{ .infra.port }}catalog/recipe/compose/db-console/1.0.0/recipe.yaml:
apiVersion: aggrega.ai/v1beta1kind: Recipemetadata: name: db-console version: 1.0.0 description: Runs the database console as a Docker Compose service.spec: capability: compose implements: example/devtool/db-console:1.0.0 workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload containers: main: image: "adminer:4" ports: http: {{ .infra.port }}aggregate.yaml:
apiVersion: aggrega.ai/v1beta1kind: Aggregatemetadata: name: shop version: "1.0.0" description: The shop's API.spec: components: api: type: example/compute/apimanifest.yaml:
apiVersion: aggrega.ai/v1beta1kind: Manifestmetadata: name: shop-manifest version: "1.0.0" description: Binds each component type to its Docker Compose recipe.spec: mappings: components: type: example/compute/api:1.0.0: api:1.0.0 example/devtool/db-console:1.0.0: db-console:1.0.0release.yaml:
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: shop-staging environment: staging version: "1.0.0"spec: aggregate: shop manifest: shop-manifest components: api: {}8. Pasang, lalu build
Operator memasang plugin tata kelola dalam konfigurasi workspace, dengan menyebut peran dan pengaturan pemasangan. .aggrega-config.yaml:
workspace: catalog_dirs: - catalogauto_pull: trueplugins: governance: - uri: governance/category-guard:0.1.0 role: ir-verdict with: settings: forbidden_categories: - devtooluri menyebut entitas berdasarkan tipe plugin, nama, dan versinya. Perannya adalah ir-verdict, sehingga host memanggil verdict_ir dengan graf build setelah graf dibangun dan sebelum apa pun di-render. auto_pull membuat build me-resolve Release sendiri, sehingga build pertama tidak memerlukan langkah terpisah.
cd ../shopaggrega build --release release.yaml warning: plugin "governance/category-guard" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recordedPull complete: release.lock (entities=7, source_artifacts=0, external_inputs=0)[… omitted: a line reporting total build time, which differs on every run]Build completed: 1 file written to <workspace>/distToko ini tidak membawa komponen devtool, sehingga aturan mengizinkan build, dan output Compose ditulis ke dist/compose/docker-compose.yaml.
Peringatan ini memang diharapkan, dan akan tetap muncul selama plugin bersifat lokal. Peringatan menyatakan bahwa guest berjalan tanpa digest konten tercatat untuk dicocokkan — memang demikian halnya bagi guest yang di-build semenit lalu dan dibaca dari samping entitasnya pada setiap build. Plugin yang dipasang pada peran verdict tidak membentuk output, sehingga pull tidak mencatat digest untuknya dari direktori katalog; yang mencatat digest adalah memublikasikan plugin dan mereferensikan entitas yang telah dipublikasikan.
9. Tanamkan pelanggaran
Tambahkan konsol administrasi ke Aggregate, dan tempatkan di Release:
spec: components: api: type: example/compute/api console: type: example/devtool/db-console components: api: {} console: {}aggrega build --release release.yaml[… omitted: the unverified-plugin warning, and the pull's lines saying the Release could not be rendered to discover its external inputs, which carry the refusal below][POLICY_ERROR E0005] policy plugin "category-guard" rejected the build: component "console" is a devtool component, and this workspace ships none caused by: policy violationBuild berhenti sebelum me-render apa pun, dan tidak menulis dist/. Pesannya adalah kalimat aturan itu sendiri, diawali nama plugin, sehingga penulis yang membacanya tahu komponen mana yang harus dihapus dan kebijakan mana yang memintanya. Plugin tidak menghapus konsol, mengganti namanya, atau me-render build tanpanya: peran verdict menerima atau menolak, dan host tidak pernah menerapkan jawabannya sebagai perubahan.
Apa yang diubah berikutnya
- Lebih banyak aturan, atau bahasa kebijakan. Aturan yang ditulis dalam Go dikompilasi ke dalam guest. Untuk memuat aturan dari file sebagai gantinya, baca
programsdiEvaluate—sourcesmilik pemasangan, masing-masing dengan nama dasar dan teksnya — dan serahkan ke sebuah engine. ABI adalah milik Aggrega sendiri menjelaskan guest yang membungkus engine kebijakan asing. - Peran lain.
Evaluateyang sama melayani setiap peran; menjawabannotationsataulabelsmembuat plugin membentuk build pada peran transformasi. Bentuk keputusan ada di README kerangka, dan apa yang boleh diubah setiap peran ada di empat peran. - Lebih sedikit ekspor. Plugin yang hanya melayani
ir-verdictmenghapus file peran lainnya dan entrinya didescriptor(). Pemasangan yang mengarahkan sebuah peran ke ekspor yang tidak dideklarasikan guest kemudian ditolak berdasarkan nama, sebelum guest berjalan. - Pengaturan bertipe. Guest dapat mendeklarasikan JSON Schema untuk pengaturannya di
describe(), lalu host memvalidasi pengaturan pemasangan terhadapnya sebelum guest berjalan; lihat Pengaturan bertipe. - Publikasi, yang mengubah pengaturan direktori katalog menjadi artefak yang dipatok dengan digest yang di-resolve dan diverifikasi sebuah Release. Panduan pengembang plugin membahas siklus hidup tersebut.
Referensi terkait
- Soket tata kelola — empat peran, payload-nya, tingkat keparahan verdict, dan cara operator memasang plugin.
- Kontrak Plugin — bentuk input dan output setiap soket, serta encoding yang dibawa masing-masing.
- Panduan pengembang plugin Wasm — entitas
Plugin, cakupan kapabilitas, dan siklus hidup publikasi. - Menulis provider — panduan yang sama untuk guest provider.
- Membaca output di halaman-halaman ini — konvensi yang diikuti blok output di atas.