Tata kelola dan kepatuhan
Bab ini mendefinisikan cara tim platform menegakkan kepatuhan korporat di setiap build — melalui soket tata kelola, baseline dan skema katalog, serta konvensi yang diikuti penulis katalog — tanpa meng-hardcode kebijakan ke dalam compiler. Peristiwa siklus hidup Day-2 adalah pokok bahasan Siklus hidup Day-2.
Pola tata kelola dan kepatuhan perusahaan
Tantangan inti dalam rekayasa platform adalah menegakkan tata kelola korporat (seperti kepatuhan SOC 2, pelacakan pusat biaya FinOps, dan pemetaan kepemilikan yang ketat) tanpa mencemari katalog sumber terbuka.
Jika Aggrega menanamkan logika khusus domain secara hardcode ke dalam komponen resminya, Aggrega tidak lagi menjadi kompiler tanpa opini sendiri dan merosot menjadi framework yang memaksakan opininya. Sebaliknya, jika kepatuhan sepenuhnya diserahkan kepada pengembang, tag penting akan salah ketik, terlupakan, atau dilewati.
Untuk mengatasinya, Aggrega menyediakan mekanisme soket Wasm untuk kepatuhan, sementara perusahaan menentukan kebijakannya. Perusahaan mencapai tata kelola zero-trust dengan mengadopsi dua kontrak sosial yang berbeda dalam ekosistem mereka.
1. “Bring Your Own Baseline” (BYOB) + gerbang validasi Wasm
Untuk data statis yang disediakan pengembang (seperti kepemilikan tim atau klasifikasi data), perusahaan tidak boleh bergantung langsung pada katalog sumber terbuka mentah. Sebaliknya, Arsitek Platform menulis baseline korporat — field yang wajib dibawa setiap komponen internal, dideklarasikan sekali dalam entri SchemaLibrary — dan menggunakan peran putusan tata kelola untuk mewajibkan penggunaannya.
Kontrak katalog: Perusahaan membuat baseline yang mewajibkan tag tertentu tetapi tidak menyediakan infrastruktur apa pun.
apiVersion: aggrega.ai/v1beta1kind: SchemaLibrarymetadata: name: CorporateBaseline version: 1.0.0spec: schemas: Ownership: type: object properties: owner: { type: string } cost_center: { type: string } # The developer MUST provide these, or the schema validator halts the build required: [owner, cost_center]Setiap komponen internal (misalnya acme/datastore/postgres) merujuk entri tersebut dari schema: miliknya sendiri dan menambahkan nilai-nilai miliknya sendiri, sehingga field bersama dan field milik komponen itu sendiri divalidasi bersama:
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: acme/datastore/postgres version: 1.0.0 labels: component.aggrega.ai/type: stateful-serverspec: schema: values: $ref: "CorporateBaseline#/schemas/Ownership" properties: database: { type: string } required: [database]Baseline adalah entri pustaka, bukan Component dasar, karena Component yang menulis extends: menerima schema: dasarnya secara utuh dan tidak mendeklarasikan nilai miliknya sendiri (lihat Pewarisan dan disiplin publikasi).
Pengaman validasi Wasm: Untuk mencegah pengembang melewati katalog internal dan menarik komponen core/postgres polos langsung dari hub publik, perusahaan mendaftarkan plugin validasi topologis. Plugin ini dievaluasi selama analisis statis — setelah graf dirakit dan sebelum artefak apa pun dirender — itulah sebabnya plugin ini melihat seluruh topologi, bukan satu komponen pada satu waktu.
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some id, _ in input.graph.spec.nodes not input.graph.spec.values_mapping[id].owner msg := sprintf("node %v declares no owner; use a component whose schema references 'CorporateBaseline#/schemas/Ownership'.", [id])}Keputusan yang dikumpulkan kebijakan di bawah kunci penolakannya adalah penolakan, dan build berhenti karenanya.
Melarang koneksi bebas: Pengembang dapat menyambungkan edge melalui soket yang tidak dideklarasikan katalog — soket ad hoc (lihat dependency-resolution). Keterbukaan ini disengaja, begitu pula kenyataan bahwa kompiler tidak memiliki pendapat tentangnya: organisasi yang ingin setiap koneksi melewati soket yang dideklarasikan oleh Arsiteknya menyatakannya sebagai kebijakan alih-alih mengandalkan kompiler. Setiap edge dalam graf membawa socket_declaration, yang bernilai declared atau ad-hoc, sehingga aturannya hanya satu baris:
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some e in input.graph.spec.edges e.socket_declaration == "ad-hoc" msg := sprintf("%v connects to %v through the free-form socket %v; declare the socket in the component type's usesSchema.", [e.source, e.target, e.socket])}Nilai ini selalu ada pada setiap edge, bagaimanapun edge itu ditulis, sehingga kebijakan tidak pernah perlu membaca field yang tidak ada sebagai “declared”. Nilai ini juga merupakan sumbu tersendiri: nilai ini menyatakan dari mana soket berasal, bukan siapa yang menggambar edge, sehingga dapat dikombinasikan dengan origin_feature dan origin_release alih-alih tumpang tindih dengannya — kebijakan dapat melarang koneksi bebas sambil tetap mengizinkan Release menyambungkan koneksi yang dideklarasikan.
Tata kelola perusahaan terpusat (mengevaluasi realitas lengkap): Mekanisme di luar jalur (seperti CODEOWNERS pada repositori git) meninjau file yang berubah, bukan arsitektur hasil kompilasinya. Peran putusan tata kelola menilai arsitektur itu sendiri. Karena kompiler AOT membangun Graf IR dengan meratakan baik Aggregate milik pengembang maupun Release milik Operator Platform, kebijakan pada peran ir-verdict mengevaluasi realitas lengkap sebelum artefak fisik dihasilkan, dan kebijakan pada peran render-verdict mengevaluasi artefak itu sendiri. Kebijakan dapat menghentikan build secara fatal jika pengembang meminta Component yang tidak disetujui, atau — dengan membaca provenans aggrega.ai/recipe-uri yang dicap pada setiap objek hasil render — jika Manifest memetakan komponen ke Recipe yang tidak disetujui.
2. Gerbang mutator Wasm (kepatuhan dinamis)
Pengembang tidak boleh dipaksa mengetik secara manual tag kepatuhan lingkungan (misalnya environment: production atau soc2_in_scope: true) ke dalam Aggregate mereka, karena tag ini berubah tergantung pada target GitOps.
Untuk metadata dinamis, perusahaan memanfaatkan Mutation Gate — peran label-transform dari soket tata kelola, yang berjalan selama konstruksi topologi. Setelah graf diekspansi, dan sebelum analisis statis mengevaluasinya, kompiler mengeksekusi plugin Wasm yang dilampirkan perusahaan. Plugin itu membaca lingkungan Release, label yang sudah dideklarasikan node, dan nilai yang dideklarasikan instance setiap node, lalu menyebut label yang harus dibawa node-node build — sehingga metadata yang diperlukan sampai ke komponen tanpa diketik pengembang (misalnya label compliance.aggrega.ai/data-class: restricted yang ditentukan dari lingkungan Release, atau datastore.aggrega.ai/engine: vector yang ditentukan dari ekstensi yang dideklarasikan sebuah database). Nilai-nilai itu hanya-baca: plugin menentukan label dan tidak ada yang lain.
Kebijakan pada peran ini menyebut labelnya — node, kunci, dan nilai yang diambilnya — alih-alih menulis instruksi edit yang diterapkan build. Alasannya penting bagi siapa pun yang menulisnya: instruksi menunjuk label melalui jalur, dan kunci label Aggrega lazimnya berisi /, yang merupakan pemisah jalur, sehingga jalur yang ditulis manual akan menunjuk lokasi bertingkat alih-alih satu label. Build menunjuk label yang disebut oleh keputusan, dan proyeksi node yang diterima peran ini menempatkan node-node itu satu tingkat lebih dangkal daripada putusan atas seluruh graf.
# Evaluated by the governance label-transform role, during topology constructionpackage acme.tagging
import rego.v1
labels contains {"node": id, "key": "acme.com/soc2-scope", "value": "true"} if { input.compilation_context.environment == "production" some id, node in input.graph.nodes node.labels["component.aggrega.ai/type"] == "stateful-server"}Karena tag ini disuntikkan di memori ke dalam kamus metadata standar sebelum rendering dimulai, plugin rendering Wasm dapat membacanya untuk menghasilkan konfigurasi fisik tertentu secara kondisional — misalnya sumber daya AWS atau Kubernetes yang diperkeras — saat artefak dirender.
Menyatakan aturan sekali: lampiran tata kelola bercakupan workspace. Kedua pola di atas ditulis per komponen dan per Feature, tetapi lampiran tata kelola yang menegakkannya tidak. Plugin tata kelola dilampirkan pada kunci plugins.governance di konfigurasi workspace, dan lampiran itu mengikat setiap build di workspace. Karena itu, aturan korporat dinyatakan tepat di satu tempat: tim platform melampirkan plugin sekali, dan tidak ada komponen, Aggregate, atau Release yang perlu ikut serta, menyebutnya, atau diedit agar aturan itu berlaku. Inilah yang membuat pengaman validasi pada pola 1 menjadi jawaban lengkap alih-alih konvensi per proyek — pengembang yang melewati katalog internal dan meminta core/postgres polos dievaluasi oleh kebijakan terlampir yang sama dengan semua orang lainnya, karena kebijakan adalah properti workspace, bukan properti komponen yang mereka pilih.
Aturan workspace menolak; aturan itu tidak menulis ulang kontrak pengembang. Cakupannya universal, dan efeknya sengaja dibatasi pada putusan. Aturan yang berlaku di mana-mana menghentikan build yang melanggarnya sambil menyebut apa yang harus diperbaiki, dan tidak dapat justru mengubah komponen yang melanggar agar menjadi patuh. Batas inilah yang menjaga mekanisme tetap dapat di-debug pada skala seluruh lingkungan: build sesuai dengan aturan yang dideklarasikan workspace atau berhenti dengan pesan yang menunjuk baris yang ditulis, dan output yang dirender tidak pernah berisi batasan atau sumber daya yang tidak diminta oleh file tertulis mana pun. Bila perusahaan memang ingin graf diubah alih-alih dinilai, perusahaan melampirkan peran transformasi — pola 2 di atas — dan perubahan itu dibatasi pada apa yang menjadi tujuan operator melampirkannya, itulah sebabnya perubahan itu merupakan tindakan eksplisit tim platform, bukan penulisan ulang yang tak terlihat.
Konsekuensi praktis bagi tim platform yang menutup lingkaran kepatuhan: nyatakan bentuk yang harus dimiliki payload sebagai batasan skema pada baseline korporat, nyatakan aturan lintas entitas yang diwajibkan lingkungan sebagai peran putusan terlampir, dan nyatakan metadata turunan yang tidak boleh diketik pengembang sebagai peran transformasi terlampir. Ketiganya dideklarasikan sekali dan berlaku untuk setiap build, dan tidak satu pun mengharuskan pengembang mengetahui keberadaannya.
3. Mempertahankan kecerdasan domain (konfigurasi dan keselamatan)
Karena kompiler Aggrega tanpa opini sendiri, kompiler ini sama sekali tidak memiliki pengetahuan hardcode tentang framework AI, anggaran token, atau partisi memori. Sebaliknya, skema cloud-native generik berfungsi sebagai wadah kosong. Alih-alih di-hardcode ke dalam inti kompiler, kecerdasan domain yang sangat terspesialisasi didistribusikan ke seluruh ekosistem Aggrega yang dapat diperluas. Kecerdasan itu dienkapsulasi di dalam katalog platform melalui components, features, dan recipes yang terspesialisasi. Pengembang mempertahankan maksud aplikasi spesifik mereka di dalam blok values dan uses — yang diatur ketat oleh deklarasi schema: milik Arsitek (bentuk ringkas atau JSON Schema 2020-12 lengkap) dan soket usesSchema — sementara terjemahan fisik dari kecerdasan itu dieksekusi oleh plugin WebAssembly khusus target.
A. Memodelkan implementasi khusus domain (divalidasi melalui skema terpisah)
Arsitek Platform dapat memanfaatkan pipeline skema terpisah untuk memodelkan arsitektur kompleks apa pun, sepenuhnya independen dari inti kompiler:
- Logika eksekusi opak (
values): Jika perusahaan men-deploy AI Gateway, pengembang mengonfigurasi perilaku gateway itu sendiri — pada AI gateway pustaka standar, mapmodelsyang menerbitkan setiap alias yang dapat diminta pemanggil dan upstream tujuan resolusi masing-masing. Inti kompiler tidak mem-parse konsep-konsep ini. Konsep tersebut berada dengan aman di dalam payloadvaluesyang opak, yang divalidasi ketat oleh deklarasischema:komponen. Kompiler cukup meneruskan payload ini ke plugin Wasm untuk menghasilkan konfigurasi gateway. Kontrol yang dimiliki bersama oleh beberapa produk gateway, seperti rantai fallback, jumlah percobaan ulang, atau pilihan di antara entri yang menerbitkan alias yang sama, adalah Features yang dilampirkan ke gateway, bukan nilai di dalamnya, masing-masing diwujudkan untuk suatu gateway dalam istilah gateway itu sendiri. - Pemetaan dependensi topologis (
uses): Ketika framework AI menghubungkan agen ke alat-alatnya atau ke penyimpanan data vektor, koneksi itu menentukan siapa berbicara dengan siapa, sehingga dideklarasikan dalam pilaruses; daftar nama yang disimpan dalamvalues, sepertitools_allowedmilik pustaka standar, adalah konvensi yang tidak menggambar edge. Kompiler menggambar edge eksplisit ini apa adanya di Graf IR. Hal ini memungkinkan plugin rendering Wasm di hilir menghasilkan secara terprogram kebijakan jaringan dan batas fisik yang diperlukan untuk mengamankan koneksi, tanpa kompiler memahami framework AI yang mendasarinya. - Struktur data kompleks (misalnya CoALA): Alih-alih terbatas pada satu daftar target datar, Arsitek mendeklarasikan di
usesSchemasoket sebanyak yang dibutuhkan suatu struktur, masing-masing dengan selector sendiri danvalueSchemaper edge sendiri. Misalnya, untuk mengimplementasikan framework CoALA, Arsitek dapat mendeklarasikansemantic_memory,episodic_memory, danworking_memorysebagai soket yang berbeda, sehingga setiap penyimpanan memori menjadi target topologis yang berbeda. Mesin kebijakan generik mengevaluasi edge terstruktur ini untuk mewajibkan pagar pembatas kontrol akses yang granular bagi setiap lobus kognitif yang berbeda.
B. Mekanisme inti keamanan dan indireksi
Meskipun payload tetap tanpa opini sendiri, skema generik menegakkan mekanisme struktural yang ketat yang mendukung pembuatan artefak yang aman:
- Pola lampiran-bukan-nilai: konvensi pustaka standar adalah bahwa kredensial diminta sebagai lampiran, tidak pernah ditulis ke dalam blok
valuestempat kredensial itu akan menjadi literal inline yang dibawa kompiler apa adanya. Lampiran kredensial menyebuttypeFeature kredensial (yang berlabelfeature.aggrega.ai/kind: secret) dan menggunakanvaluesmiliknya sendiri untuk mendeskripsikan kueri ke penyimpanan rahasia. Perutean kredensial kemudian menjadi late binding yang agnostik terhadap kapabilitas, dan inti kompiler tidak pernah meresolusi atau mengekspos materialnya — inti kompiler menyalurkan pointer yang diberikan Recipe milik Ops. Ini adalah konvensi yang didorong oleh katalog dan skema, bukan pemeriksaan kompiler: kompiler tidak menafsirkan makna sebuah daunvalues, sehingga penulis yang menuliskan material secara inline memang menuliskannya secara inline. Yang benar-benar dijamin skema adalah bahwa permukaan lampiran ada dan bertipe. - Verifikasi kepercayaan abstrak: Karena blok
valuesdapat diperluas secara luas, Arsitek dapat mewajibkan direktif abstrak sepertitls_pinningataurequired_signatures: 2(untuk konsensus kuorum). Inti kompiler meneruskan objek yang telah divalidasi skema ini ke graf IR datar apa adanya. Plugin rendering Wasm kustom kemudian dapat membaca nilai-nilai ini untuk menghasilkan artefak bagi gerbang persetujuan Human-in-the-Loop (HITL) tingkat perangkat keras. Jika aplikasi mencoba melewati aturan konsensus, proxy yang di-deploy secara fisik memblokir eksekusi hingga persetujuan webhook diterima.
C. Keselamatan operasional tingkat lanjut (spec.interoperability)
Untuk melindungi beban kerja yang rentan dari mutasi infrastruktur yang saling bertentangan, skema Feature generik mendefinisikan kontrol interoperabilitas:
spec.interoperability.conflictsWith— daftar Features yang tidak boleh mencapai komponen yang sama dengan Feature ini. Kompiler menghentikan build sebelum rendering ketika lampiran yang akhirnya dimiliki sebuah komponen — dikumpulkan dari setiap cakupan yang menjangkaunya: komponen itu sendiri, subsistem atau batas yang memuatnya, entri komponennya di Release, dan ekspansi berbasis anotasi — memuat Feature ini dan salah satu yang disebutnya. Ini adalah perbandingan antara nama-nama yang dideklarasikan penulis Feature dengan Features yang dibawa komponen, tanpa makna yang ditafsirkan ke dalam keduanya: ketidakcocokan adalah penilaian penulis, dan kompiler menahan build pada penilaian itu. Satu deklarasi sudah cukup, nama dicocokkan apa pun versinya, dan dua Features yang dilampirkan ke batas bersaudara yang tidak berbagi komponen tidak pernah bertemu.
4. Tata kelola batas jaringan (konvensi tolak secara default)
Pengembang tidak menulis kebijakan jaringan secara langsung; batas jaringan yang diperlukan dipetakan oleh graf representasi perantara (IR) milik kompilator, yang membawa setiap sisi topologis antara komponen yang dideklarasikan dalam Aggregate.
- Batas internal. Kompilator menggambar graf IR datar dan tidak membatasi apa pun dengan sendirinya: tanpa kebijakan, setiap koneksi yang diizinkan jaringan klaster tetap dapat dijangkau. Konvensinya adalah bahwa kebijakan yang ditulis untuk sebuah komponen mengizinkan koneksi hanya di tempat Aggregate mendeklarasikan sisi untuknya, di samping apa yang disebutkan oleh lampiran milik kebijakan itu sendiri, dan menolak setiap koneksi lain pada arah yang diatur kebijakan tersebut.
- Realisasi pustaka standar. Katalog pustaka standar merealisasikan konvensi ini sebagai dua Features yang dilampirkan operator ke sebuah komponen di dalam Release, satu untuk setiap arah koneksi:
core/caller-allowlisthanya menerima koneksi dari komponen yang sisiuses-nya menunjuk ke komponen tersebut, dancore/egress-allowlisthanya mengizinkan komponen terhubung ke komponen yang ditunjuk oleh sisi-sisinya sendiri dan ke DNS klaster. Pada target helm, masing-masing direalisasikan oleh sebuah FeatureRecipe yang menulis NetworkPolicy Kubernetes dari sisi-sisi yang diserahkan kompilator kepadanya, dengan menyebut pod setiap komponen berdasarkan apa yang dihasilkan oleh render komponen itu sendiri — selector dan label yang dibawa workload-nya, namespace tempat workload itu dihasilkan, dan port yang dideklarasikan kontainernya — sehingga tidak ada label atau port yang dinyatakan ulang secara manual. Masing-masing juga menerima pod milik komponen itu sendiri dan apa yang disebutkan Release pada lampiran: sumber di luar Aggregate di sisi masuk, dan di sisi keluar rentang alamat untuk target yang tidak dijalankan klaster, yang tidak merender pod untuk dipilih dan hanya diterima berdasarkan rentang, pada port mana pun. Kompilator tidak dapat memeriksa klaster, sehingga masing-masing menghentikan build sampai Release menegaskan bahwa plugin jaringan klaster menegakkan kebijakan jaringan; compose tidak memiliki kebijakan jaringan, dan build yang melampirkan salah satunya di sana akan berhenti. - Ingress publik (kontrol perimeter yang agnostik). Ingress publik diatur oleh aturan khusus perusahaan pada peran putusan tata kelola. Tim keamanan perusahaan dapat menulis kebijakan yang mengevaluasi tipe ontologi cloud-native suatu node dan menolak build jika pengembang mencoba melampirkan fitur
public-ingresske nodeworkeratautask. Kompilator tidak menafsirkan apa arti “publik”; kompilator menegakkan keluaran Boolean dari gerbang validasi Wasm.
5. Pencapan asal-usul pada waktu kompilasi
Kompilator membangun catatan asal-usul selama kompilasi, yang merekam versi kompilator dan versi Aggregate, Manifest, dan Release yang dikompilasinya — tanpa stempel waktu, sehingga catatan itu tidak pernah merusak output yang identik byte demi byte. Renderer helm memancarkan versi kompilator sebagai label aggrega.ai/compiler-version pada manifest Kubernetes yang dihasilkan, dan renderer helm-chart pada file templat yang ditambahkan sebuah Recipe ke chart, karena renderer itu menyalin templat milik chart tanpa perubahan; tim keamanan perusahaan menggunakannya untuk mengidentifikasi artefak hasil render mana yang dibangun oleh versi kompilator mana — penting ketika kerentanan ditemukan dalam rilis kompilator tertentu dan artefak yang terdampak perlu diaudit.
Penyedia compose mencap kunci provenans yang sama sebagai label layanan, penyedia terraform sebagai file provenans di setiap modul yang dirakitnya, dan penyedia cloudformation di bawah Metadata setiap sumber daya; catatan provenans dalam memori ada untuk setiap kompilasi.
6. Metadata dan anotasi sebagai permukaan ekstensi
Kompilator Go agnostik terhadap konsep yang spesifik domain — framework AI, mesin basis data, idiom Kubernetes — dan hanya bekerja pada operasi datar tingkat graf terhadap IR. Untuk menggerakkan ekosistem tanpa menanamkan logika spesifik domain secara permanen ke dalam biner Go, platform menggunakan label dan anotasi metadata standar sebagai permukaan ekstensi untuk kecerdasan domain.
Kompilator tidak membaca anotasi spesifik domain apa pun. Kompilator menggabungkan semua anotasi yang diberikan pengembang dan label duck typing ke dalam graf IR datar serta meneruskan metadata ini apa adanya ke plugin tata kelola dan rendering. Ekosistem WebAssembly menafsirkan metadata dan menjalankan logika yang diperlukan — mengevaluasi kebijakan kepatuhan, menyisipkan tag ke artefak cloud-native, atau memicu ekspansi fitur — secara independen dari inti kompilator.
Hal ini menjaga permukaan ekstensibilitas tetap luas (siapa pun dapat menulis plugin Wasm yang membaca prefiks anotasi baru) sekaligus menjaga inti kompilator tetap stabil: tidak diperlukan rilis inti agar ekosistem dapat menambahkan anotasi spesifik domain yang baru.
Apa yang dibaca kebijakan tentang lampiran
Peran putusan yang mengevaluasi graf IR menerima graf secara utuh — dengan setiap nilai yang dideklarasikan sensitif oleh penulis ditahan, seperti dijelaskan di bawah — dan itu mencakup setiap lampiran yang dibawa setiap node, dengan kunci berupa nama yang diberikan penulis kepadanya — atau, untuk lampiran yang ditulis pada salah satu koneksi node, berupa alias koneksi dan slot yang digabungkan dengan titik. Alasan membawa detail lampiran alih-alih ringkasan adalah bahwa Aggrega tidak memiliki opini untuk diringkas: kompilator merutekan lampiran tanpa menilai isinya, sehingga fakta yang dibutuhkan kebijakan untuk menilainya adalah fakta yang diberikan kepada kebijakan.
Per lampiran, graf membawa:
- Tipe Feature yang dimintanya, dan versi katalog yang di-resolve untuknya. Tipe adalah string yang ditulis penulis, apa adanya — referensi dengan versi yang dipatok dan referensi tanpa versi adalah string yang berbeda untuk satu rujukan yang sama, sehingga kebijakan yang membandingkan tipe sebaiknya mengharapkan salah satu dari kedua penulisan itu.
- Label katalog Feature yang dilampirkan, apa adanya. Tanpa difilter, tanpa dinormalisasi, dalam urutan yang dideklarasikan entitas katalog. Kebijakan membaca persis apa yang ditulis penulis katalog, termasuk label ciptaan penulis sendiri yang sama sekali tidak diketahui Aggrega.
- Anotasi katalog Feature yang dilampirkan, apa adanya.
metadata.annotationsmilik entitas Feature itu sendiri, dibawa dengan ketentuan yang persis sama dengan labelnya — tanpa difilter, tanpa dinormalisasi, dalam urutan yang dideklarasikan entitas — sehingga kunci anotasi di namespace milik penulis tiba sebagaimana ditulis. Ini adalah hal yang berbeda dari anotasi yang menyebabkan lampiran hasil ekspansi anotasi ada sejak awal: graf melaporkan asal-usul itu secara terpisah, dan lampiran yang ditulis dalam blokfeatures:membawa anotasi entitas tanpa melaporkan asal ekspansi sama sekali. - Slot lampiran terdeklarasi mana yang diisinya. Slot
featuresSchemadiisi dengan melampirkan Feature di bawah nama slot, sehingga lampiran yang menyebut slot yang dideklarasikan Component-nya melaporkan nama slot itu, dan lampiran yang tidak mengisi slot mana pun melaporkanfree. Lampiran yang ditulis pada koneksi mengisi slot yang dideklarasikan soket koneksi itu, dan melaporkan nama slot tersebut; karena soket tidak menerima nama lain, lampiran itu tidak pernah melaporkanfree. Nilainya adalah nama slot alih-alih flag, karena titik binding mana yang terisi biasanya merupakan separuh jawaban yang lebih berguna. - Pada koneksi mana lampiran ditulis, jika ada. Lampiran yang ditulis pada salah satu koneksi komponen membawa soket dan alias koneksi tersebut, yang menyebut sisi graf tempat lampiran itu disajikan — dan melalui sisi itu, komponen yang menjadi tujuan penyajiannya. Lampiran dari blok milik komponen itu sendiri tidak membawa keduanya. Koneksi dibawa sebagai data alih-alih dibiarkan untuk dibaca dari nama lampiran, yang memuat alias dan bukan soket.
- Apakah lampiran menangani materi yang dideklarasikan sensitif oleh penulis, dan kunci pengiriman mana yang membawa materi itu. Keduanya diturunkan dari deklarasi — leaf
sensitivepada skema sebuah Feature, slotsensitivepada Component yang mengonsumsi, baik slot yang dideklarasikannya untuk lampirannya sendiri maupun slot pada soket yang dilalui koneksi — tidak pernah dari pemeriksaan nilai. values,infra, dan pemetaan pengirimannya, serta apakah lampiran ditulis dalam blokfeatures:atau disumbangkan oleh ekspansi berbasis anotasi — dengan setiap nilai yang dideklarasikan sensitif oleh penulis ditahan, seperti dijelaskan paragraf berikutnya.
Kebijakan diberi tahu di mana materi yang dideklarasikan sensitif berada, dan tidak pernah diserahi materi itu. Setiap leaf yang ditandai graf sebagai dideklarasikan sensitif — dalam values atau infra lampiran mana pun, pada cakupan atau koneksi mana pun lampiran itu ditulis, dalam infra lampiran batas, dalam values serta infra milik node itu sendiri, dan dalam values serta infra milik koneksi itu sendiri — mencapai kebijakan sebagai penanda satu kunci, {"aggrega_withheld": "declared"}, menggantikan nilainya. Kuncinya tetap ada, sehingga kebijakan tetap melihat leaf mana yang dibawa payload; penandaan yang menyebut leaf tersebut tetap ada, sehingga kebijakan tetap melihat mana di antaranya yang membawa materi terdeklarasi; dan setiap fakta yang tercantum di atas tiba seperti sebelumnya, bersama setiap nilai yang tidak ditandai deklarasi apa pun. Tidak satu pun fakta yang menjadi dasar penalaran kebijakan — apa itu lampiran, apa yang diisinya, kepada apa ia disajikan, apa yang dikatakan entitas katalognya tentang dirinya, dan ke mana materi rahasianya berpindah — merupakan nilai yang dapat dideklarasikan sensitif oleh penulis, dan materi itu sendiri adalah satu-satunya hal yang tidak dibutuhkan kebijakan untuk menilai ke mana materi itu pergi. Ini adalah penahanan yang sama yang diterapkan baris perintah saat mencetak graf dan yang diterapkan daemon saat menjawab permintaan editor atas graf itu. Permukaan-permukaan itu mengembalikan nilainya kepada orang yang secara eksplisit memintanya; salinan milik kebijakan tidak menawarkan permintaan semacam itu. Penahanan ini hanya berlaku untuk salinan milik kebijakan: graf yang menjadi sumber render build tidak tersentuh, sehingga tidak ada byte hasil render yang berubah.
Label sebuah lampiran mengikat kompilator di tepat satu tempat, dan itu bukan keputusan kebijakan: slot dapat mendeklarasikan selector, dan pengisian yang labelnya tidak memenuhinya akan menghentikan build. Selepas gerbang itu, label tidak mengarahkan apa pun — cara nilai dirutekan dan dikirim sama saja apa pun label yang dibawa sebuah Feature. Jadi kebijakan yang membaca label sedang membaca metadata yang dibawa kompilator tanpa ditafsirkan, bukan menebak-nebak percabangan di dalamnya.
Anotasi katalog sebuah Feature tidak mengikatnya di tempat mana pun: tidak ada perilaku kompilator yang bercabang berdasarkan anotasi itu, dan slot tidak mendeklarasikan batasan atasnya seperti yang dapat dilakukannya atas label. Anotasi itu dibawa dan tidak lebih.
Aturan yang dapat ditulis berkat hal ini, tidak satu pun dibuat kompilator untuk Anda:
- Larang lampiran bebas. Organisasi yang mewajibkan setiap lampiran mengisi titik binding yang dideklarasikan menolak setiap lampiran yang melaporkan
free. Ini adalah pasangan dari permukaan lampiran yang tetap terbuka: komposisi bebas secara default, dan operator yang tidak menginginkannya bebas menyatakannya. - Tolak pengiriman materi sensitif berdasarkan nilai. Aggrega memberi peringatan ketika datum yang dideklarasikan sensitif berpindah melalui kunci pengiriman sebagai literal, dan tidak pernah menghentikan build — keluarga kredensial berdasarkan nilai memang disengaja. Operator yang ingin peringatan itu menjadi penolakan menyatakannya di sini.
- Tentukan sendiri apa yang dianggap kredensial. Pustaka standar menandai Features kredensialnya dengan label keluarga, dan membaca label itu adalah salah satu cara untuk bernalar tentangnya. Predikat yang lebih luas atau lebih sempit — label internal, aturan penamaan, sekumpulan tipe yang disetujui — sama-sama tersedia, karena yang tiba adalah labelnya, bukan putusan tentangnya.
- Terapkan gerbang pada apa pun yang dicatat katalog Anda dalam metadatanya sendiri. Organisasi yang menyimpan status tinjauan, residensi data, atau kepemilikan sebagai anotasi pada entitas Feature-nya dapat mewajibkannya pada setiap lampiran. Aturan yang berbasis anotasi yang belum pernah dikenal Aggrega bekerja sama baiknya dengan aturan yang berbasis kunci yang disertakannya, karena anotasi tiba sebagaimana ditulis — yang juga berarti bahwa sebuah Feature dan sebuah Component dinilai dengan pijakan yang sama, masing-masing berdasarkan metadata katalog yang dideklarasikan entitasnya sendiri.
- Atur apa yang disajikan komponen kepada siapa. Kredensial yang ditulis pada sebuah koneksi menyebut koneksi itu, dan sisi koneksi tersebut menyebut targetnya, sehingga organisasi dapat menolak kredensial yang disajikan kepada komponen di luar zona kepercayaan yang ditandainya dengan labelnya sendiri — penilaian yang membutuhkan kedua ujung koneksi, yang tidak dapat diberikan oleh fakta apa pun pada komponen pengonsumsi saja.
Peran putusan menerima atau menolak; peran itu tidak pernah menulis ulang. Build berlanjut tanpa perubahan atau berhenti dengan pesan putusan, sehingga kebijakan tidak dapat diam-diam membuat graf yang tidak patuh menjadi patuh.
Detail lampiran mencapai kebijakan yang mengevaluasi graf IR. Kebijakan yang mengevaluasi artefak hasil render menerima artefak tersebut dan tidak menerima graf, yang merupakan sifat dari masukan itu, bukan pembatasan yang diterapkan padanya: kedua tahap menjawab pertanyaan yang berbeda, dan topologi lampiran tidak termasuk pertanyaan yang dapat diajukan kepada keluaran hasil render.
Menyatakan aturan organisasi dalam bahasa kebijakan
Pola di atas menjelaskan apa yang dilakukan lampiran tata kelola; bagian ini membahas apa yang ditulis perusahaan untuk mendapatkannya. Tim platform dengan lima puluh aturan untuk dinyatakan tidak menginginkan lima puluh plugin. Tim itu menginginkan aturannya sebagai konten — file yang ditinjau, diberi versi, dan dirilis seperti artefak lainnya — dengan satu mesin terlampir yang mengevaluasinya.
Itulah yang disediakan oleh mesin bahasa kebijakan yang dilampirkan ke soket, dan dua di antaranya disertakan di dalam kompilator tepat untuk tujuan ini: mesin Rego dan mesin CEL. Operator melampirkan salah satunya, mendeklarasikan file kebijakan yang harus dimuatnya, dan aturan pun berjalan: tanpa toolchain eksternal, tanpa apa pun yang diambil pada waktu build, dan tanpa logika kebijakan di dalam kompilator. Evaluasi terjadi di dalam guest WebAssembly, tempat seluruh kecerdasan domain berada.
Mesin yang sama melayani setiap peran tata kelola, sehingga organisasi mencakup seluruh permukaannya dengan satu plugin terlampir dan beberapa lampirannya:
- Menilai arsitektur. Ketika dilampirkan pada graf build, kebijakan membaca setiap node, sisi, dan lampiran yang dimiliki kompilator, ditambah jalur perutean yang dienumerasi di sampingnya, dan melaporkan apa yang harus menghentikan build. Di sinilah invarian topologi, aturan otorisasi lintas batas, atau aturan aliran kredensial berada.
- Menilai keluaran. Ketika dilampirkan pada artefak hasil render, kebijakan membaca file yang dihasilkan build — sebagai teks, dan sebagai dokumen yang telah di-parse jika formatnya di-parse sebelum kebijakan — dan melaporkan hasil konkretnya.
- Menyediakan metadata turunan. Ketika dilampirkan untuk membentuk label, kebijakan memutuskan label mana yang dibawa node build, berdasarkan lingkungan Release dan apa yang sudah dideklarasikan node. Inilah mekanisme yang dijelaskan pola 2 di atas, dengan aturan yang dinyatakan sebagai konten kebijakan alih-alih sebagai plugin yang dibuat khusus.
- Menambahkan kemampuan yang tidak diketik pengembang. Ketika dilampirkan untuk menyisipkan anotasi, kebijakan menambahkan anotasi ke komponen build; anotasi di bawah kunci yang binding-nya didaftarkan Manifest akan berekspansi menjadi lampiran Feature, sehingga aturan perusahaan dapat menyediakan pembungkus yang dibutuhkan komponen alih-alih sekadar menolak ketiadaannya. Sebuah keputusan menulis nilai apa pun yang dapat ditulis operator pada anotasi itu — string, atau objek subkunci untuk binding yang merutekan beberapa nilai — dan build membacanya persis seperti membaca nilai yang sama yang ditulis dalam Release. Keputusan hanya dapat menambahkan: nilai yang akan menghapus atau keluar dari (opt out) sebuah anotasi ditolak, dan nilai sisipan yang tidak dapat dirutekan build atau tidak diterima Feature yang terikat ditolak dengan menyebutkan plugin yang menyisipkannya.
Aturan membaca apa yang dibawa payload dan melaporkan keputusannya di bawah kunci bernama:
# Evaluated by a governance verdict role over the assembled graphpackage acme.security
import rego.v1
deny contains msg if { some id, node in input.graph.spec.nodes node.labels["compliance.aggrega.ai/data-class"] == "restricted" not node.labels["acme.com/owner"] msg := sprintf("node %v holds restricted data and declares no owner.", [id])}Aturan yang mengikuti data di sepanjang graf membaca rute yang dienumerasi payload. language-reference/examples/policy-data-class-route/ adalah salah satunya, dari awal hingga akhir: aturan itu menghentikan build tempat komponen yang menyimpan data dari satu kelas menjangkau komponen dari kelas lain melalui rute yang tidak memiliki Feature deklasifikasi yang terlampir padanya, dan Aggregate yang sama selesai ketika Release merutekan lalu lintas itu melalui gateway yang membawa core/data-masking. Kompilator membawa label kelas sebagai string dan tidak memeringkat apa pun — kelas-kelas itu, urutannya, dan Features yang dianggap mendeklasifikasi adalah pengaturan lampiran. Aturan ini ditulis sekali untuk masing-masing dari tiga mesin — dua yang dikompilasi ke dalam CLI, dan OPA di balik guest adaptor referensi — tiap salinan berdiri sendiri, sehingga build yang tidak disepakati dua mesin menunjukkan ketidaksepakatan itu.
Kosakata milik kebijakan dipertahankan. Tingkat keparahan yang ditanggapi soket adalah himpunan tertutup, tetapi nama-nama tempat kebijakan mengumpulkan keputusannya adalah milik kebijakan. Nama default adalah nama konvensional yang sudah digunakan korpus Rego, dan operator yang kebijakannya menamai keputusannya secara berbeda mendeklarasikan pemetaannya dalam pengaturan lampiran — sehingga organisasi yang sudah memelihara pustaka kebijakan dapat mengadopsi soket tanpa menulis ulang pustakanya. Pemetaan itu bertipe menurut skema yang dideklarasikan plugin untuk pengaturannya, sehingga pemetaan yang salah bentuk menghentikan build sebelum kebijakan apa pun berjalan alih-alih salah merutekan putusan.
Seluruh pustaka kebijakan berpindah sebagai satu lampiran. Satu set kebijakan dapat dilampirkan file demi file, atau sebagai satu arsip yang memuat file kebijakan dan dokumen datanya sekaligus, yang dibuka oleh guest. Arsip yang tidak dapat dibaca dilaporkan sebagai demikian, dengan menyebut file-nya — tidak pernah sebagai set kebijakan yang tidak mencapai keputusan, karena “pustaka tidak dapat dibaca” tidak boleh sampai tidak dapat dibedakan dari “pustaka mengizinkan build”.
Kebijakan yang tidak dapat dievaluasi menghentikan build. Ketika kebijakan tidak dapat dievaluasi, lampiran gagal dan build berhenti dengan galat yang menyebut plugin tersebut, yang sengaja dibedakan dari putusan yang menghentikan build. Kedua kasus ini tidak boleh tertukar, dan tidak satu pun dari keduanya merupakan izin.
Permukaan penulisan lengkapnya — payload yang diekspos setiap peran, kunci keputusan, pemetaan ke tingkat keparahan, dan cara melampirkan arsip — ada di language-reference/plugins/policy-socket.md.
Pewarisan dan disiplin penerbitan
Pewarisan melalui extends: adalah mekanisme katalog yang memungkinkan arsitek platform membangun entitas turunan yang terspesialisasi di atas baseline bersama. Kedua jenis katalog berpisah jalan pada pilar datanya. Skema induk dan turunan dari sebuah Feature disusun pada waktu pemuatan workspace, menghasilkan skema terpadu dengan asal-usul per leaf. Component yang memperluas tidak menulis konten pilar apa pun: ia menulis penanda literal schema: inherited dan menerima blok schema: milik basisnya persis seperti yang ditulis basis tersebut, pada kedalaman rantai mana pun.
Itulah yang menyelesaikan pertanyaan tata kelola yang dimunculkan baseline bersama — batasan apa yang boleh dideklarasikan turunan relatif terhadap basisnya. Untuk sebuah Component, jawabannya struktural, bukan diawasi: kontrak terdeklarasi milik turunan memang adalah kontrak basis, sehingga batasan basis tidak dapat dilonggarkan, dihapus, atau diubah tipenya oleh turunan, dan tidak diperlukan pemeriksaan pada waktu penerbitan untuk menjaga baseline tetap utuh. Turunan yang secara sah membutuhkan aturan yang lebih ketat daripada yang dideklarasikan basisnya menyatakannya sebagai entri tambahan dalam blok assertions:-nya, yang disusun berdampingan dengan aturan basis alih-alih menggantikannya.
Yang memang disusun oleh Component turunan adalah struktur: slot lampirannya (featuresSchema), soket topologi (usesSchema), allowlist self-inject (inject), dan assertions bernama semuanya digabungkan di sepanjang rantai, dengan entri yang dideklarasikan ulang menggantikan entri basis sepenuhnya.
Penempatan aturan: aturan mana yang berada di plugin kebijakan dan mana yang di skema per Component
Plugin disiplin penerbitan adalah tempat bagi aturan menyeluruh yang berlaku di seluruh katalog: aturan rantai pasok (mis., “setiap Recipe harus implements: sebuah Component yang ada di katalog”), aturan kepatuhan perusahaan (mis., “setiap Component dengan compliance.aggrega.ai/scope: pci-dss harus extends: baseline pci perusahaan”). Aturan-aturan ini melintasi banyak entitas, mengevaluasi workspace sebagai satu kesatuan, atau menegakkan konvensi pada waktu penerbitan alih-alih pada waktu build.
Deklarasi schema: per Component / per Feature adalah tempat bagi batasan per entitas: tipe, rentang, pola, dan enum per kolom; aturan antarkolom yang dinyatakan dalam blok assertions: khusus. Batasan ini bersifat lokal untuk satu entitas dan ikut berpindah bersamanya di seluruh katalog.
Pembagian ini tidak sembarangan. Aturan seperti “setiap kolom wajib harus ada” adalah batasan per entitas yang tempatnya di array required:. Aturan seperti “setiap entitas turunan yang memperluas induk pci-dss harus mendeklarasikan label tata kelola tingkat workspace” adalah aturan lintas entitas yang ditegakkan plugin kebijakan. Kedua kelas aturan ini tidak pernah tumpang tindih karena menjawab pertanyaan yang berbeda: skema memvalidasi “apakah instans ini cocok dengan kontraknya”; plugin kebijakan memvalidasi “apakah katalog ini memenuhi aturan menyeluruh yang diwajibkan workspace”.
Saat menulis aturan tata kelola baru, pertanyaan penempatannya adalah: apakah aturan itu hanya bergantung pada konten satu entitas (→ skema atau blok assertions) atau bergantung pada hubungan antara beberapa entitas atau konfigurasi tingkat workspace (→ plugin kebijakan). Pola Wasm-linter adalah mekanisme kanonis untuk kasus menyeluruh; katalog perusahaan dapat mendistribusikan plugin kebijakan khusus yang mengonsumsi antarmuka kontrak plugin yang sama dengan plugin disiplin penerbitan standar.
Disiplin prefiks anotasi
Namespace anotasi membawa semantik asal — prefiks yang berbeda menandakan audiens yang berbeda dan otoritas tata kelola yang berbeda. Penulis katalog, tim platform perusahaan, dan platform Aggrega sendiri semuanya menulis anotasi ke dalam kamus datar yang sama; prefikslah yang menjaga audiens tetap terpisah.
| Prefiks | Asal | Audiens | Mutabilitas |
|---|---|---|---|
aggrega.ai/ (tanpa subdomain) | Dicadangkan: hanya dikeluarkan oleh compiler Aggrega | Perangkat internal, pencapan provenans | Tidak dapat ditulis pengguna; anotasi berprefiks tanpa subdomain yang dideklarasikan dalam konten pengguna ditolak pada saat publikasi |
<sub-domain>.aggrega.ai/ (mis., component.aggrega.ai/, feature.aggrega.ai/, compliance.aggrega.ai/) | Konvensi katalog | Arsitek yang menulis entitas katalog; plugin kebijakan Wasm yang mengonsumsi label | Penerbit katalog menulis; konsumen membaca |
<enterprise-domain>/ (mis., acme.com/, my-org.io/) | Lapisan perusahaan | Tim platform perusahaan; plugin Wasm perusahaan | Penulis perusahaan menulis; compiler platform mengabaikannya sebagai metadata buram |
<community-domain>/ (mis., cncf.io/, kubernetes.io/) | Ekosistem eksternal | Perangkat lintas ekosistem yang membaca label yang sudah dikenal luas | Dikelola komunitas |
Prefiks aggrega.ai/ tanpa subdomain membawa disiplin paling ketat: prefiks ini dicadangkan hanya untuk anotasi yang dikeluarkan platform. Compiler mengeluarkan aggrega.ai/compiler-version, aggrega.ai/component-id, aggrega.ai/recipe-uri, aggrega.ai/boundary-path, dan kunci provenans terkait pada keluaran yang dirender; konten pengguna yang secara langsung mendeklarasikan anotasi aggrega.ai/<key> ditolak pada saat publikasi. Disiplin ini mencegah anotasi yang ditulis pengguna bertabrakan dengan provenans yang dikeluarkan platform.
Prefiks subdomain di bawah <sub-domain>.aggrega.ai/ adalah ruang konvensi katalog. Pustaka standar menggunakan component.aggrega.ai/type (label ontologi cloud-native), feature.aggrega.ai/kind (partisi Feature menjadi operasional dan kredensial), compliance.aggrega.ai/* (label sumbu kepatuhan), dan sub-namespace bercakupan serupa. Setiap subdomain dikelola oleh audiens katalog tertentu: component.aggrega.ai/* oleh penulis entitas Component, feature.aggrega.ai/* oleh penulis entitas Feature, compliance.aggrega.ai/* oleh audiens kebijakan kepatuhan. Pembacaan lintas subdomain (plugin Wasm yang membaca dari beberapa sub-namespace) diizinkan tetapi jarang; setiap plugin biasanya membatasi dirinya pada satu sub-namespace.
Prefiks domain perusahaan (acme.com/..., my-org.io/...) adalah permukaan ekstensi platform. Compiler Aggrega memperlakukannya sebagai metadata buram; plugin Wasm perusahaan mengonsumsinya. Perusahaan menulis struktur prefiks apa pun yang sesuai dengan tata kelola mereka — datar (acme.com/owner: team-payments), subdomain (security.acme.com/scope: pii), atau hierarkis (org.acme.com/billing-center: finance). Platform tidak membatasi tata letak prefiks perusahaan; satu-satunya aturan adalah prefiks perusahaan tidak boleh bertabrakan dengan aggrega.ai/ atau subdomainnya.
Disiplin ini penting karena anotasi mengalir berjenjang — anotasi yang ditulis pada subsistem sebuah Aggregate merambat ke setiap komponen dalam subsistem tersebut, anotasi milik instans komponen itu sendiri menimpa anotasi subsistemnya, dan anotasi sebuah modul mencapai komponen milik modul itu sendiri; anotasi pada batas sebuah Release merambat ke setiap komponen dalam batas tersebut. Anotasi penyedia mencapai keluaran yang dirender dari sisi mana pun, dan jika kedua sisi menulis kunci yang sama, nilai dari Release yang diterapkan. Tanpa disiplin prefiks, anotasi di sisi Aggregate dapat diam-diam menimpa kunci provenans yang dikeluarkan platform, atau anotasi perusahaan dapat bertabrakan dengan kunci konvensi katalog. Tabel prefiks membuat audiens menjadi eksplisit dan membuat aturan pencegahan tabrakan dapat ditegakkan pada saat publikasi.
Lihat language-reference/vocabulary/labels-and-annotations.md untuk enumerasi permukaan anotasi per entitas dan semantik kaskade tiga wadah (.context.annotations.release / .context.annotations.catalog / .context.annotations.aggregate).