Pisanie własnego pluginu zarządczego
Ta strona prowadzi plugin zarządczy od szkieletu adaptera z zestawu do tworzenia pluginów aż do builda, który odrzuca. Należy skopiować szkielet, wpisać do niego jedną regułę, zbudować .wasm, ręcznie wywołać każdy z jego eksportów na plikach ładunku dostarczanych ze szkieletem, zadeklarować go jako encję Plugin we własnym katalogu obszaru roboczego, podłączyć do roli i obserwować, jak zatrzymuje build łamiący regułę.
Jest to praktyczne uzupełnienie gniazda zarządczego, które dokumentuje cztery role, ładunek każdej z nich i werdykty, na podstawie których działa host, oraz przewodnika dla twórców pluginów, który dokumentuje encję Plugin i jej cykl życia. Tworzenie dostawcy to tego samego rodzaju przewodnik dla modułu gościa dostawcy.
O blokach na tej stronie. Każdy blok z wyjściem został skopiowany z rzeczywistego wykonania poniższych kroków w kolejności, w jakiej występują, zgodnie z konwencją dotyczącą wyjścia: blok jest albo kompletny, albo jest fragmentem oznaczającym miejsca pominięcia wierszy. Dwa symbole zastępcze oznaczają ścieżki bezwzględne, które różnią się na każdej maszynie: <guest> to katalog kopii szkieletu, a <workspace> to katalog obszaru roboczego, w którym podłączono plugin.
Czego potrzeba
- Zestaw narzędzi Go, który kompiluje do WebAssembly bez dodatkowych narzędzi.
- Kopia robocza zestawu do tworzenia pluginów, który zawiera szkielet, oraz pakietu ABI, na którym opiera się zestaw:
go.modkopii wskazuje na oba. - Plik binarny
aggrega.
Zestaw dostarcza ten sam szkielet dla Rust, w rust/examples/governance-adapter-skeleton, i dla TypeScript, w typescript/examples/governance-adapter-skeleton. Każdy zawiera te same cztery pliki ładunku, a niezmodyfikowana kopia każdego odpowiada na nie w ten sam sposób; każde polecenie aggrega na tej stronie ma zastosowanie do każdego z nich z jego własną nazwą artefaktu, a README każdego podaje sposób budowania.
Kształt gotowego rozwiązania
Plugin zarządczy to, jak każdy plugin, dwa artefakty: moduł gościa .wasm oraz encja Plugin, która wnosi go do katalogu. Podłączenie to jeden wpis w konfiguracji obszaru roboczego. W kompilatorze nic się nie zmienia.
Dwa katalogi, którymi kończy się ten przewodnik, bez tego, co build zapisuje w obszarze roboczym:
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.yamlReguła egzekwowana przez plugin jest powszechna: obszar roboczy wskazuje kategorie komponentów, których nie dostarcza — tutaj devtool, kategorię konsoli administracyjnej — a build zawierający komponent jednej z nich zatrzymuje się, wskazując go.
1. Skopiuj szkielet
cp -r /path/to/aggrega-pdk/go/examples/governance-adapter-skeleton category-guardcd category-guardgo.mod szkieletu odwołuje się do zestawu i pakietu ABI przez ścieżki względne wobec swojego położenia wewnątrz zestawu, więc kopia poza zestawem musi wskazać je sama. Należy nadać modułowi własną ścieżkę i skierować dwa wiersze replace na swoje kopie robocze:
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 szkieletu pozostaje bez zmian.
2. Zbuduj go i ręcznie wywołaj każdą rolę
Kopię należy zbudować przed wprowadzeniem jakichkolwiek zmian, tak aby pierwszą uruchomioną rzeczą był kod łączący, którego nie napisało się samodzielnie:
./build.shWrote <guest>/dist/governance-adapter-skeleton-go.wasmaggrega plugin run-local wczytuje moduł gościa ze ścieżki, sprawdza, czy wskazany eksport jest zadeklarowany w samoopisie describe() modułu — a przy --type governance także, czy moduł przedstawia się jako plugin zarządczy — wywołuje go z podanym ładunkiem i wypisuje odpowiedź. Szkielet dostarcza po jednym pliku ładunku na rolę, każdy będący małym, poprawnym wejściem dla swojego eksportu. Ładunek zapisuje się w JSON; protokół każdej roli zarządczej używa kodowania binarnego, więc polecenie konwertuje ładunek na to kodowanie przed wywołaniem eksportu i wypisuje odpowiedź eksportu jako JSON.
aggrega plugin run-local --plugin dist/governance-adapter-skeleton-go.wasm \ --type governance --export transform_annotations --with @annotation-payload.json{ "injections": []}run-local czyta moduł gościa i ładunek z podanych ścieżek i nie potrzebuje obszaru roboczego, więc można go uruchomić z dowolnego katalogu.
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" } ]}Każda odpowiedź ma kształt, jaki jej rola może zwrócić: adnotacje do dodania, zmiany etykiet i werdykty. Dwie role transformacji nie zwracają niczego, a każda rola werdyktu zwraca jeden werdykt info — uwagę, która rejestruje obserwację i nie zmienia wyniku builda. Ta uwaga jest dowodem działania kodu łączącego szkieletu. Każdy plik ładunku zawiera dwa wejścia podłączenia w postaci, w jakiej przekazuje je build: jeden plik polityki, rules.policy, w sources oraz obiekt settings. Uwaga mówi, że oba dotarły do szwu — jedynej funkcji, którą reszta szkieletu wywołuje z tym, co otrzymała rola.
Oto kompletny ładunek, który odczyta poniższa reguła, ir-verdict-payload.json:
{ "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 }}Jest to wejście roli ir-verdict: graf builda z jednym komponentem, ścieżki routingu wyliczone na grafie oraz sources i settings podłączenia. Każde pole jest opisane na stronie referencyjnej roli, schemacie gniazda polityk, a sam graf na schemacie grafu builda; pozostałe trzy pliki są zgodne ze schematem annotation-transform, schematem mutator oraz, dla verdict_render, z RenderPolicyInput schematu gniazda polityk.
3. Napisz jedną regułę
Reguła znajduje się w evaluator.go, szwie szkieletu. Każda rola dekoduje swój ładunek, zapisuje go jako dokument JSON i wywołuje Evaluate z plikami polityk podłączenia, jego ustawieniami, tym dokumentem i nazwą decyzji, którą chce otrzymać. Role werdyktu kolejno proszą o trzy decyzje — deny, warn i audit — i zgłaszają odpowiedzi każdej z nich z ważnością halt, warn i info; dwie role transformacji proszą o annotations i labels. Dlatego reguła zatrzymująca build odpowiada na deny.
Należy zastąpić evaluator.go następującą treścią:
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 pozostaje, ponieważ pliki ról budują z jego pomocą swoją listę programów. Reszta to reguła, a cztery jej elementy warto przeczytać uważnie.
- Czyta ładunek pod nazwami, które nadaje mu protokół. Węzły znajdują się w
graph.spec.nodes, z kluczem według id węzła, każdy ze swoimilabels— to ta sama ścieżka, którą Co udostępnia ładunek każdej roli podaje polityce Rego jakoinput.graph.spec.nodes. Reguła napisana dla tej roli nie czyta niczego w pozostałych: ładunekrender-verdictnie zawiera grafu, więc tam pętla nie znajduje żadnego węzła. - To, czego zabrania, należy do operatora, nie do pluginu. Kategorie pochodzą z
settingspodłączenia, więc ten sam.wasmobsługuje obszar roboczy, który zabraniadevtool, i taki, który nie zabrania niczego. - Sortuje przed udzieleniem odpowiedzi. Wyjście builda jest identyczne bajt w bajt między uruchomieniami o identycznym wejściu, a moduł gościa odpowiadający w kolejności mapy Go złamałby to od środka.
- Zawodzi jawnie. Ustawienia lub ładunek, których nie da się odczytać, zwracają błąd zamiast pustej listy, a rola zamienia ten błąd w nieudane wywołanie. Pusta lista to polityka, która nie znalazła nic do powiedzenia; nieudane wywołanie to polityka, która się nie wykonała, a build rozróżnia te dwa przypadki tylko wtedy, gdy rozróżnia je moduł gościa.
Reguła nigdy nie czyta programs. Reguła tego pluginu jest wkompilowana w moduł gościa, więc podłączenie dostarcza ustawienia i żadnego pliku polityki — ten sam kształt co moduł gościa zbudowany wokół prekompilowanego silnika i odwrotny do takiego, który wczytuje reguły z sources.
Na koniec należy określić, czym jest plugin. W main.go należy zmienić opis w descriptor():
Description: "Refuse a build that carries a component of a category the attachment forbids.",Generator encji z sekcji 6 kopiuje go do encji Plugin.
4. Zbuduj ponownie i odczytaj odpowiedź reguły
./build.shWrote <guest>/dist/governance-adapter-skeleton-go.wasmNależy ponownie wywołać cztery eksporty na tych samych plikach:
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": []}Zastępcza uwaga zniknęła z obu ról werdyktu i żadna nie zwraca werdyktu: settings dostarczonego ładunku nie zabraniają żadnej kategorii, więc reguła go dopuszcza. Pusta lista results to sposób, w jaki rola werdyktu mówi, że build może być kontynuowany.
Aby zobaczyć, jak reguła się uruchamia, należy podać jej ustawienia zabraniające tego, co zawiera ładunek. Należy skopiować ir-verdict-payload.json do my-payload.json i zastąpić jego settings następującymi:
"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" } ]}Decyzja deny przychodzi jako werdykt halt z własnym komunikatem reguły. W buildzie halt zatrzymuje go z tym komunikatem jako przyczyną.
5. Gdy ładunek nie pasuje
Polecenie konwertuje każde pole ładunku na typ deklarowany przez jego kształt i odrzuca pole, którego nie da się skonwertować, zanim moduł gościa zostanie uruchomiony. W kopii o nazwie wrong-payload.json należy zapisać labels węzła jako listę zamiast obiektu:
"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 [Polecenie kończy się z niezerowym kodem, a moduł gościa nie zostaje wywołany.
Konwersja sprawdza typ każdego pola zawartego w ładunku; nie sprawdza, czy ładunek zawiera każde pole wymagane przez kształt. Ładunek, w którym brakuje pola, zostaje mimo to skonwertowany i przekazany modułowi gościa, a moduł, którego reguła czyta to pole, nic tam nie znajduje. Dlatego ładunek napisany ręcznie należy sprawdzić względem strony referencyjnej jego schematu: milczenie polecenia nie oznacza, że ładunek jest kompletny.
6. Zadeklaruj go jako encję Plugin w katalogu obszaru roboczego
Pola kontraktu encji są odczytywane z modułu gościa, a nie pisane ręcznie, więc encja nie może deklarować eksportu, którego plik binarny nie ma. Tożsamość podaje się w małej nakładce, 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.yamlWygenerowana encja:
# 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 to wersja, którą build.sh szkieletu wpisuje do modułu gościa, 0.1.0, o ile AGGREGA_PLUGIN_VERSION nie wskazuje innej; pluginType i cztery eksporty to to, co zgłasza describe(). Plugin zarządczy nie deklaruje żadnych możliwości: to, co może zwrócić, wynika z roli, do której jest podłączony, a nie z encji.
Podczas tworzenia pluginu nie ma nic opublikowanego do pobrania, więc build czyta go z katalogu katalogowego, z .wasm obok jego encji. Plik obok encji jest nazywany według typu pluginu i nazwy encji, w katalogu, w którym znajduje się dokument encji — dla governance/category-guard jest to governance--category-guard.wasm:
cp dist/governance-adapter-skeleton-go.wasm \ ../shop/catalog/plugin/governance/category-guard/0.1.0/governance--category-guard.wasmPlik należy skopiować, a nie tworzyć do niego dowiązania. Dowiązanie w tym miejscu jest śledzone tylko do miejsca wewnątrz obszaru roboczego — lub, dla katalogu katalogowego wskazanego poza obszarem roboczym, do miejsca wewnątrz tego katalogu; dowiązanie prowadzące dalej zatrzymuje build i pull, wskazując dowiązanie, jak opisuje granica obszaru roboczego. Pull, który nie znajduje .wasm pod tą nazwą, zatrzymuje się i wskazuje oczekiwany plik, jak opisuje A plugin’s .wasm is not on this machine (Pliku pluginu nie ma na tej maszynie).
7. Obszar roboczy, którego pilnuje plugin
Obszar roboczy to mały sklep: API oraz dokumenty, które budują go za pomocą Docker Compose. Jego katalog zawiera też konsolę administracyjną, którą reguła odrzuci — encję Component, której kategorią jest 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. Podłącz go i zbuduj
Operator podłącza plugin zarządczy w konfiguracji obszaru roboczego, wskazując rolę i ustawienia podłączenia. .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 wskazuje encję według typu pluginu, nazwy i wersji. Rolą jest ir-verdict, więc host wywołuje verdict_ir z grafem builda po jego zbudowaniu, a przed wyrenderowaniem czegokolwiek. auto_pull pozwala buildowi samodzielnie rozwiązać encję Release, więc pierwszy build nie wymaga osobnego kroku.
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>/distSklep nie zawiera komponentu devtool, więc reguła dopuszcza build, a wyjście Compose trafia do dist/compose/docker-compose.yaml.
Ostrzeżenie jest oczekiwane i pozostaje, dopóki plugin jest lokalny. Mówi, że moduł gościa został uruchomiony bez zapisanego skrótu treści, z którym można by go porównać — co jest prawdą w przypadku modułu zbudowanego minutę temu i czytanego obok jego encji przy każdym buildzie. Plugin podłączony do roli werdyktu nie kształtuje żadnego wyjścia, więc pull nie zapisuje dla niego skrótu z katalogu katalogowego; skrót zapisuje się dopiero po opublikowaniu pluginu i odwołaniu się do opublikowanej encji.
9. Podłóż naruszenie
Należy dodać konsolę administracyjną do encji Aggregate i umieścić ją w encji 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 zatrzymuje się przed wyrenderowaniem czegokolwiek i nie zapisuje dist/. Komunikat to własne zdanie reguły, poprzedzone nazwą pluginu, więc autor, który go czyta, wie, który komponent usunąć i która polityka tego zażądała. Plugin nie usunął konsoli, nie zmienił jej nazwy ani nie wyrenderował builda bez niej: rola werdyktu akceptuje lub odrzuca, a host nigdy nie stosuje jej odpowiedzi jako zmiany.
Co zmienić dalej
- Więcej reguł lub język polityk. Reguła napisana w Go jest wkompilowana w moduł gościa. Aby zamiast tego wczytywać reguły z plików, należy czytać
programswEvaluate—sourcespodłączenia, każde z nazwą bazową i tekstem — i przekazać je silnikowi. ABI należy do Aggrega opisuje moduł gościa opakowujący zewnętrzny silnik polityk. - Inne role. Ten sam
Evaluateobsługuje każdą rolę; odpowiadanie naannotationslublabelssprawia, że plugin kształtuje build w roli transformacji. Kształty decyzji są opisane w README szkieletu, a to, co może zmieniać każda rola, w sekcji cztery role. - Mniej eksportów. Plugin obsługujący tylko
ir-verdictusuwa pozostałe pliki ról i ich wpisy wdescriptor(). Podłączenie, które kieruje rolę na eksport niezadeklarowany przez moduł gościa, jest wtedy odrzucane z podaniem nazwy, zanim moduł zostanie uruchomiony. - Ustawienia typowane. Moduł gościa może zadeklarować JSON Schema dla swoich ustawień w
describe(), a host waliduje wtedy względem niego ustawienia podłączenia przed uruchomieniem modułu; zob. Ustawienia typowane. - Publikowanie, które zamienia układ z katalogiem katalogowym w artefakt przypięty skrótem, który encja Release rozwiązuje i weryfikuje. Ten cykl życia opisuje przewodnik dla twórców pluginów.
Powiązane materiały
- Gniazdo zarządcze — cztery role, ich ładunki, poziomy ważności werdyktów i sposób, w jaki operator podłącza plugin.
- Kontrakt encji Plugin — kształty wejścia i wyjścia każdego gniazda oraz kodowanie, które każdy z nich niesie.
- Przewodnik dla twórców pluginów Wasm — encja
Plugin, zakres możliwości i cykl życia publikacji. - Tworzenie dostawcy — ten sam przewodnik dla modułu gościa dostawcy.
- Odczytywanie wyników na tych stronach — konwencja, której przestrzegają powyższe bloki wyników.