Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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.mod kopii 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 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

Reguł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

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

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

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

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

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

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 czyta moduł gościa i ładunek z podanych ścieżek i nie potrzebuje obszaru roboczego, więc można go uruchomić z dowolnego katalogu.

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"
}
]
}

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 swoimi labels — to ta sama ścieżka, którą Co udostępnia ładunek każdej roli podaje polityce Rego jako input.graph.spec.nodes. Reguła napisana dla tej roli nie czyta niczego w pozostałych: ładunek render-verdict nie 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 settings podłączenia, więc ten sam .wasm obsługuje obszar roboczy, który zabrania devtool, 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

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

Należy ponownie wywołać cztery eksporty na tych samych plikach:

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": []
}

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"
]
}
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"
}
]
}

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"
]
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 [

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

Wygenerowana encja:

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

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

Plik 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/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. 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:
- catalog
auto_pull: true
plugins:
governance:
- uri: governance/category-guard:0.1.0
role: ir-verdict
with:
settings:
forbidden_categories:
- devtool

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

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

Sklep 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: {}
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 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ć programs w Evaluate — sources podłą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 Evaluate obsługuje każdą rolę; odpowiadanie na annotations lub labels sprawia, ż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-verdict usuwa pozostałe pliki ról i ich wpisy w descriptor(). 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.