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

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.mod salinan 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 guest
shop/ 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.yaml

Aturan 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

Terminal window
cp -r /path/to/aggrega-pdk/go/examples/governance-adapter-skeleton category-guard
cd category-guard

go.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/go

go.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:

Terminal window
./build.sh
Wrote <guest>/dist/governance-adapter-skeleton-go.wasm

aggrega 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.

Terminal window
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.

Terminal window
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \
--type governance --export mutate --with @label-payload.json
{
"patches": []
}
Terminal window
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"
}
]
}
Terminal window
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 dengan labels-nya — path yang sama yang diberikan Apa yang diekspos payload setiap peran kepada kebijakan Rego sebagai input.graph.spec.nodes. Aturan yang ditulis untuk peran ini tidak membaca apa pun di peran lain: payload render-verdict tidak membawa graf, sehingga di sana loop tidak menemukan node.
  • Apa yang dilarangnya ditentukan operator, bukan plugin. Kategori berasal dari settings pemasangan, sehingga .wasm yang sama melayani workspace yang melarang devtool maupun 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

Terminal window
./build.sh
Wrote <guest>/dist/governance-adapter-skeleton-go.wasm

Panggil keempat ekspor lagi pada file yang sama:

Terminal window
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \
--type governance --export transform_annotations --with @annotation-payload.json
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \
--type governance --export mutate --with @label-payload.json
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \
--type governance --export verdict_ir --with @ir-verdict-payload.json
aggrega 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"
]
}
Terminal window
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"
]
Terminal window
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \
--type governance --export verdict_ir --with @wrong-payload.json
under 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/v1beta1
kind: Plugin
metadata:
name: category-guard
Terminal window
aggrega plugin gen-catalog --plugin dist/governance-adapter-skeleton-go.wasm \
--overlay overlay.yaml --output-dir ../shop/catalog/plugin
generated ../shop/catalog/plugin/governance/category-guard/0.1.0/plugin.yaml

Entitas yang dihasilkan:

# Generated from the plugin by `aggrega plugin gen-catalog`. You may narrow its capability lists; edit nothing else here.
apiVersion: aggrega.ai/v1beta1
kind: Plugin
metadata:
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_render

version 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:

Terminal window
cp dist/governance-adapter-skeleton-go.wasm \
../shop/catalog/plugin/governance/category-guard/0.1.0/governance--category-guard.wasm

Salin 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/v1beta1
kind: Component
metadata:
name: example/compute/api
version: 1.0.0
description: The shop's HTTP API.
labels:
component.aggrega.ai/type: server
component.aggrega.ai/category: compute
spec:
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/v1beta1
kind: Component
metadata:
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: devtool
spec:
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/v1beta1
kind: Recipe
metadata:
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/v1beta1
kind: Recipe
metadata:
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/v1beta1
kind: Aggregate
metadata:
name: shop
version: "1.0.0"
description: The shop's API.
spec:
components:
api:
type: example/compute/api

manifest.yaml:

apiVersion: aggrega.ai/v1beta1
kind: Manifest
metadata:
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.0

release.yaml:

apiVersion: aggrega.ai/v1beta1
kind: Release
metadata:
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:
- catalog
auto_pull: true
plugins:
governance:
- uri: governance/category-guard:0.1.0
role: ir-verdict
with:
settings:
forbidden_categories:
- devtool

uri 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.

Terminal window
cd ../shop
aggrega 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 recorded
Pull 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>/dist

Toko 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: {}
Terminal window
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 violation

Build 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 programs di Evaluate — sources milik 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. Evaluate yang sama melayani setiap peran; menjawab annotations atau labels membuat 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-verdict menghapus file peran lainnya dan entrinya di descriptor(). 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.