İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Kendi yönetişim eklentinizi yazmak

Bu sayfa, bir yönetişim eklentisini eklenti geliştirme kitinin adaptör iskeletinden reddettiği bir derlemeye kadar adım adım götürür. İskeleti kopyalar, içine bir kural yazar, .wasm dosyasını derler, iskeletle gelen yük dosyaları üzerinde dışa aktarımlarının her birini elle çağırır, onu çalışma alanınızın kendi kataloğunda bir Plugin varlığı olarak bildirir, bir role bağlar ve kuralı çiğneyen bir derlemeyi durdurmasını izlersiniz.

Bu sayfa; dört rolü, her birinin taşıdığı yükü ve ana bilgisayarın uyguladığı hükümleri belgeleyen yönetişim soketinin ve Plugin varlığını ve yaşam döngüsünü belgeleyen eklenti geliştirici kılavuzunun uygulamalı tamamlayıcısıdır. Sağlayıcı yazmak, bir sağlayıcı konuk modülü için aynı türden bir adım adım anlatımdır.

Bu sayfadaki bloklar hakkında. Çıktı gösteren her blok, aşağıdaki adımların göründükleri sırayla gerçek bir çalıştırmasından kopyalanmıştır ve çıktı uzlaşımına uyar: bir blok ya eksiksizdir ya da satırların atlandığı yerleri işaretleyen bir alıntıdır. İki yer tutucu, her makinede farklı olan mutlak yolların yerini tutar: <guest>, iskelet kopyanızın dizinidir; <workspace> ise eklentinin bağlandığı çalışma alanının dizinidir.

Gerekenler

  • Ek bir araç gerektirmeden WebAssembly’ye derleyen Go araç zinciri.
  • İskeleti içeren eklenti geliştirme kitinin ve kitin üzerine kurulduğu ABI paketinin bir checkout’u: kopyanızın go.mod dosyası her ikisini de gösterir.
  • aggrega ikili dosyası.

Kit aynı iskeleti Rust için rust/examples/governance-adapter-skeleton konumunda, TypeScript için typescript/examples/governance-adapter-skeleton konumunda sunar. Her biri aynı dört yük dosyasını taşır ve her birinin değiştirilmemiş bir kopyası bunlara aynı şekilde yanıt verir; bu sayfadaki her aggrega komutu, kendi yapıt adıyla bunlardan herhangi birine uygulanır ve her birinin README dosyası derleme yöntemini verir.

Bitmiş hâlinin yapısı

Bir yönetişim eklentisi, her eklenti gibi iki yapıttır: bir .wasm konuk modülü ve onu bir kataloğa taşıyan bir Plugin varlığı. Onu bağlamak, çalışma alanı yapılandırmasında tek bir girdidir. Derleyicide hiçbir şey değişmez.

Bu anlatımın sonunda ortaya çıkan iki dizin, bir derlemenin çalışma alanına yazdıkları hariç:

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

Eklentinin uyguladığı kural yaygın bir kuraldır: bir çalışma alanı, yayımlamadığı bileşen kategorilerini adlandırır — burada bir yönetim konsolunun kategorisi olan devtool — ve bunlardan birine ait bir bileşen taşıyan bir derleme, o bileşeni adlandırarak durur.

1. İskeleti kopyalayın

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

İskeletin go.mod dosyası kite ve ABI paketine, kit içindeki konumuna göreli yollarla ulaşır; bu nedenle kitin dışındaki bir kopya bunları kendisi adlandırır. Modüle kendi yolunuzu verin ve iki replace satırını checkout’larınıza yönlendirin:

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

İskeletin go.sum dosyası olduğu gibi kalır.

2. Derleyin ve her rolü elle çağırın

Hiçbir şeyi değiştirmeden önce kopyayı derleyin; böylece çalıştırdığınız ilk şey sizin yazmadığınız bağlantı kodu olur:

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

aggrega plugin run-local bir yoldan bir konuk modülü yükler, adlandırdığınız dışa aktarımın konuk modülün describe() öz bildiriminde bildirilmiş olduğunu — ve --type governance ile, konuk modülün kendini bir yönetişim eklentisi olarak bildirdiğini — denetler, onu sağladığınız bir yükle çağırır ve yanıtı yazdırır. İskelet her rol için bir yük dosyası sunar; her biri kendi dışa aktarımı için küçük, geçerli bir girdidir. Yük JSON olarak yazılır; her yönetişim rolünün kablo biçimi ikili bir kodlama taşır, bu nedenle komut, dışa aktarımı çağırmadan önce yükü bu kodlamaya dönüştürür ve dışa aktarımın yanıtını JSON olarak yazdırır.

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, konuk modülünü ve yükünü verdiğiniz yollardan okur ve çalışma alanına ihtiyaç duymaz; bu nedenle herhangi bir dizinden çalıştırılabilir.

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

Her yanıt, rolünün döndürmesine izin verilen biçimdedir: eklenecek açıklamalar, etiket değişiklikleri ve hükümler. İki dönüşüm rolü hiçbir şey döndürmez ve her hüküm rolü bir info hükmü döndürür — bir gözlemi kaydeden ve bir derlemenin sonucunu değiştirmeyen bir not. Bu not, iskeletin bağlantılarının doğru olduğunun kanıtıdır. Her yük dosyası, bir bağlamanın iki girdisini bir derlemenin onları ilettiği biçimde taşır: sources altında bir politika dosyası, rules.policy, ve bir settings nesnesi. Not, ikisinin de dikişe — iskeletin geri kalanının, rolün aldığı her şeyle çağırdığı tek işleve — ulaştığını söyler.

Aşağıdaki kuralın okuyacağı yük, ir-verdict-payload.json, eksiksiz olarak şöyledir:

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

Bu, ir-verdict rolünün girdisidir: içinde bir bileşen bulunan bir derleme grafiği, grafik üzerinde sayılan yönlendirme yolları ve bağlamanın sources ve settings değerleri. Her alan rolün başvuru sayfası olan politika soketi şemasında, grafiğin kendisi ise derleme grafiği şemasında açıklanır; diğer üç dosya annotation-transform şemasına, mutator şemasına ve verdict_render için politika soketi şemasının RenderPolicyInput tanımına uyar.

3. Bir kural yazın

Kural, iskeletin dikişi olan evaluator.go dosyasında bulunur. Her rol yükünü çözer, onu bir JSON belgesi olarak yazar ve Evaluate işlevini bağlamanın politika dosyaları, ayarları, bu belge ve geri almak istediği kararın adıyla çağırır. Hüküm rolleri sırayla üç karar ister — deny, warn ve audit — ve her birinin yanıtlarını halt, warn ve info önem düzeyinde bildirir; iki dönüşüm rolü annotations ve labels ister. Dolayısıyla bir derlemeyi durduran kural deny yanıtını verir.

evaluator.go dosyasını şununla değiştirin:

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 kalır, çünkü rol dosyaları program listelerini onunla oluşturur. Geri kalanı kuraldır ve içindeki dört şey dikkatle okunmaya değer.

  • Yükü, kablo biçiminin ona verdiği adlarla okur. Düğümler graph.spec.nodes altında, düğüm kimliğine göre anahtarlanmış olarak ve her biri labels değerleriyle birlikte bulunur — bu, Her rolün yükünün sunduğu şey bölümünün bir Rego politikasına input.graph.spec.nodes olarak verdiği yolun aynısıdır. Bu rol için yazılmış bir kural diğerlerinde hiçbir şey okumaz: render-verdict yükü grafik taşımaz, bu yüzden orada döngü hiçbir düğüm bulmaz.
  • Neyi yasaklayacağına eklenti değil operatör karar verir. Kategoriler bağlamanın settings değerinden gelir; böylece aynı .wasm, devtool kategorisini yasaklayan bir çalışma alanına da hiçbir şeyi yasaklamayan bir çalışma alanına da hizmet eder.
  • Yanıt vermeden önce sıralar. Bir derlemenin çıktısı aynı girdiyle yapılan çalıştırmalar arasında bayt bayt aynıdır ve bir Go eşleminin sırasıyla yanıt veren bir konuk modül bunu içeriden bozar.
  • Açıkça başarısız olur. Okuyamadığı ayarlar veya yük boş bir liste yerine bir hata döndürür ve rol bu hatayı başarısız bir çağrıya dönüştürür. Boş bir liste, söyleyecek bir şey bulamamış bir politikadır; başarısız bir çağrı ise çalışmamış bir politikadır ve bir derleme ikisini ancak konuk modül ayırt ederse ayırt edebilir.

Kural programs değerini hiç okumaz. Bu eklentinin kuralı konuk modüle derlenmiştir; bu nedenle bir bağlama ayar sağlar, politika dosyası sağlamaz — önceden derlenmiş bir motor etrafında kurulmuş bir konuk modülle aynı biçim ve kurallarını sources altından yükleyen bir modülün tersi.

Son olarak eklentinin ne olduğunu belirtin. main.go dosyasında descriptor() içindeki açıklamayı değiştirin:

Description: "Refuse a build that carries a component of a category the attachment forbids.",

Bölüm 6’daki varlık oluşturucu bunu Plugin varlığına kopyalar.

4. Yeniden derleyin ve kuralın yanıtını okuyun

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

Dört dışa aktarımı aynı dosyalar üzerinde yeniden çağırın:

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

Yer tutucu not her iki hüküm rolünden de kalktı ve ikisi de hüküm döndürmüyor: gelen yükün settings değeri hiçbir kategoriyi yasaklamadığından kural ona izin verir. Boş bir results listesi, bir hüküm rolünün derlemenin devam edebileceğini söyleme biçimidir.

Kuralın tetiklendiğini görmek için ona yükün taşıdığı şeyi yasaklayan ayarlar verin. ir-verdict-payload.json dosyasını my-payload.json olarak kopyalayın ve settings değerini şununla değiştirin:

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

deny kararı, kuralın kendi iletisini taşıyan bir halt hükmü olarak gelir. Bir derlemede halt, derlemeyi neden olarak bu iletiyle durdurur.

5. Bir yük uymadığında

Komut, yükün taşıdığı her alanı biçiminin bildirdiği türe dönüştürür ve dönüştüremediği bir alanı konuk modül çalışmadan önce reddeder. wrong-payload.json adlı bir kopyada bir düğümün labels değerini nesne yerine liste olarak yazın:

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

Komut sıfır olmayan bir kodla çıkar ve konuk modül hiç çağrılmaz.

Dönüştürme, yükün taşıdığı her alanın türünü denetler; yükün, biçimin gerektirdiği her alanı taşıyıp taşımadığını denetlemez. Bir alanı eksik olan bir yük yine de dönüştürülür ve konuk modüle verilir; kuralı o alanı okuyan bir konuk modül orada hiçbir şey bulmaz. Bu nedenle elle yazdığınız bir yükü şema başvuru sayfasıyla karşılaştırarak denetleyin: komutun sessiz kalması yükün eksiksiz olduğunu söylemez.

6. Çalışma alanınızın kataloğunda bir Plugin varlığı olarak bildirin

Varlığın sözleşme alanları elle yazılmak yerine konuk modülden okunur; bu nedenle varlık, ikili dosyada bulunmayan bir dışa aktarımı iddia edemez. Kimliği küçük bir katman dosyasında, overlay.yaml içinde sağlarsınız:

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

Oluşturulan varlık:

# 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, iskeletin build.sh betiğinin konuk modüle işlediği sürümdür; AGGREGA_PLUGIN_VERSION başka bir sürüm belirtmedikçe 0.1.0 olur. pluginType ve dört dışa aktarım describe() işlevinin bildirdikleridir. Bir yönetişim eklentisi hiçbir yetenek bildirmez: neyi döndürebileceği varlıktan değil, bağlandığı rolden gelir.

Bir eklenti geliştirirken getirilecek yayımlanmış bir şey yoktur; bu nedenle derleme onu, .wasm dosyası varlığının yanında olacak şekilde bir katalog dizininden okur. Varlığın yanındaki dosya, varlık belgesinin bulunduğu dizinde, varlığın eklenti türüne ve adına göre adlandırılır — governance/category-guard için 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

Dosyaya bağlantı vermek yerine dosyayı kopyalayın. O konumdaki bir bağlantı yalnızca çalışma alanının içindeki bir yere — ya da çalışma alanının dışında listelenen bir katalog dizini için o dizinin içindeki bir yere — kadar izlenir; daha öteye giden bir bağlantı, çalışma alanı sınırı bölümünün açıkladığı gibi, bağlantıyı adlandırarak derlemeyi ve pull’u durdurur. O ad altında hiçbir .wasm bulamayan bir pull, A plugin’s .wasm is not on this machine (Bir eklentinin dosyası bu makinede değil) bölümünün açıkladığı gibi, beklediği dosyayı adlandırarak durur.

7. Eklentinin koruduğu çalışma alanı

Çalışma alanı küçük bir mağazadır: bir API ve onu Docker Compose ile derleyen belgeler. Kataloğu ayrıca kuralın reddedeceği yönetim konsolunu, kategorisi devtool olan bir Component’i de taşır.

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. Bağlayın ve derleyin

Bir operatör, rolü ve bağlamanın ayarlarını belirterek bir yönetişim eklentisini çalışma alanı yapılandırmasında bağlar. .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, varlığı eklenti türü, adı ve sürümüyle belirtir. Rol ir-verdict olduğundan ana bilgisayar, grafik oluşturulduktan sonra ve herhangi bir şey render edilmeden önce verdict_ir işlevini derleme grafiğiyle çağırır. auto_pull, derlemenin Release’i kendisinin çözümlemesini sağlar; böylece ilk derleme ayrı bir adım gerektirmez.

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

Mağaza hiçbir devtool bileşeni taşımadığından kural derlemeye izin verir ve Compose çıktısı dist/compose/docker-compose.yaml konumuna yazılır.

Uyarı beklenen bir durumdur ve eklenti yerel olduğu sürece kalır. Konuk modülün, karşılaştırılacak kayıtlı bir içerik özeti olmadan çalıştığını söyler — bu, bir dakika önce derlenmiş ve her derlemede varlığının yanından okunan bir konuk modül için gerçeğin ta kendisidir. Bir hüküm rolüne bağlanan eklenti hiçbir çıktıyı şekillendirmez; bu nedenle pull, bir katalog dizininden onun için özet kaydetmez. Bir özeti kaydeden şey, eklentiyi yayımlamak ve yayımlanmış varlığa başvurmaktır.

9. Bir ihlal yerleştirin

Yönetim konsolunu Aggregate’e ekleyin ve Release’e yerleştirin:

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

Derleme herhangi bir şey render edilmeden önce durur ve dist/ yazmaz. İleti, başında eklentinin adı bulunan, kuralın kendi cümlesidir; böylece onu okuyan bir yazar hangi bileşeni kaldıracağını ve bunu hangi politikanın istediğini bilir. Eklenti konsolu kaldırmadı, yeniden adlandırmadı ya da derlemeyi onsuz render etmedi: bir hüküm rolü kabul eder ya da reddeder ve ana bilgisayar onun yanıtını hiçbir zaman bir değişiklik olarak uygulamaz.

Sırada neyi değiştirmeli

  • Daha fazla kural ya da bir politika dili. Go ile yazılmış bir kural konuk modüle derlenir. Kuralları bunun yerine dosyalardan yüklemek için Evaluate içinde programs değerini — bağlamanın her biri temel adı ve metniyle birlikte gelen sources dosyalarını — okuyun ve bunları bir motora verin. ABI, Aggrega’nın kendisine aittir bölümü, yabancı bir politika motorunu saran bir konuk modülü açıklar.
  • Diğer roller. Aynı Evaluate her role hizmet eder; annotations veya labels yanıtını vermek, eklentinin bir dönüşüm rolünde derlemeyi şekillendirmesini sağlar. Karar biçimleri iskeletin README dosyasında, her rolün neyi değiştirebileceği ise dört rol bölümündedir.
  • Daha az dışa aktarım. Yalnızca ir-verdict rolüne hizmet eden bir eklenti diğer rol dosyalarını ve bunların descriptor() içindeki girdilerini siler. Bir rolü konuk modülün bildirmediği bir dışa aktarıma yönlendiren bir bağlama bu durumda, konuk modül çalışmadan önce adıyla reddedilir.
  • Türlü ayarlar. Bir konuk modül, describe() içinde ayarları için bir JSON Schema bildirebilir; ana bilgisayar da bu durumda konuk modül çalışmadan önce bir bağlamanın ayarlarını buna göre doğrular; bkz. Türlü ayarlar.
  • Yayımlama, katalog dizini düzenini bir Release’in çözümleyip doğruladığı, özetle sabitlenmiş bir yapıta dönüştürür. Bu yaşam döngüsünü eklenti geliştirici kılavuzu ele alır.