Kebijakan yang menghentikan build ketika data terbatas mencapai model terkelola tanpa disamarkan
Sebuah estate menjalankan asisten klaim yang menangani data pelanggan terbatas, dan asisten helpdesk yang tidak menangani data semacam itu. Keduanya mengirim lalu lintas modelnya ke API terkelola OpenAI melalui gateway AI di dalam klaster. Aturan internal estate tersebut:
Data dari satu kelas tidak mencapai komponen dari kelas lain di sepanjang rute graf build kecuali sebuah Feature yang melakukan deklasifikasi dipasang pada rute tersebut.
Workspace ini memasang aturan tersebut sebagai kebijakan atas graf build dan membangun tiga Releases dari satu Aggregate. Pada salah satunya, permintaan asisten klaim melewati gateway yang menyamarkannya, dan build selesai. Pada dua lainnya permintaan tersebut tidak melewatinya, dan build berhenti sebelum apa pun dirender, dengan kebijakan menyebutkan kedua ujung rute.
Aturan ini ditulis tiga kali, sekali untuk setiap mesin kebijakan tempat aturan itu dijalankan — mesin Rego dan CEL yang dikompilasi ke dalam CLI, serta OPA — dan ketiga salinan tersebut sepakat pada setiap build di sini. Sebuah skrip di samping Releases membangun kesembilan kombinasi dan memeriksa setiap hasilnya.
Apa yang dibangunnya
| instans | Component katalog | perannya di sini |
|---|---|---|
assistant | local/ai-agent/claims-assistant | asisten klaim: agen LangGraph dari pustaka standar, dideklarasikan dalam katalog workspace ini dengan satu label tambahan — kelas data yang ditanganinya |
helpdesk | core/ai-agent/langgraph | asisten helpdesk, yang tidak membawa kelas apa pun |
checkpointer | core/datastore/valkey | tempat kedua asisten menyimpan status eksekusinya |
masking-gateway | core/gateway/litellm | AI gateway yang melayani satu alias, chat, dengan core/data-masking terpasang |
plain-gateway | core/gateway/litellm | gateway yang sama tanpa apa pun terpasang |
gpt | core/ai-model/openai | API terkelola OpenAI, dijangkau sebagai referensi: tidak ada yang berjalan untuknya di dalam klaster |
analyzer, anonymizer | core/security/presidio-analyzer, core/security/presidio-anonymizer | layanan pengenal (recognizer) yang dipanggil oleh proses penyamaran |
Kedua gateway terhubung ke gpt melalui soket models masing-masing, dan masing-masing menyajikan
kunci model pada koneksi tersebut. Lampiran penyamaran mencantumkan apa yang harus disamarkan: sebuah
pola untuk nomor klaim milik estate, serta tipe entitas PERSON dan
EMAIL_ADDRESS. Kedua asisten mendeklarasikan soket model yang dideklarasikan oleh Component mereka,
yang menerima model atau gateway yang melayani API model, dan membiarkannya
tidak terikat: setiap Release yang menghubungkannya.
Tiga Releases
Releases tersebut hanya berbeda pada gateway yang dilalui lalu lintas model dari setiap asisten:
| Release | lalu lintas asisten klaim | lalu lintas asisten helpdesk | build |
|---|---|---|---|
release-masked.yaml | melalui masking-gateway | melalui plain-gateway | selesai |
release-unmasked.yaml | melalui plain-gateway | melalui plain-gateway | dihentikan |
release-masking-off-route.yaml | melalui plain-gateway | melalui masking-gateway | dihentikan |
Setiap Release mengikat socket model dari kedua asisten ke gateway yang dideklarasikan oleh
Aggregate. Itu adalah pengabelan edge di dalam socket yang dideklarasikan oleh Component,
yang boleh dilakukan oleh Release; hal ini tidak menambahkan komponen dan tidak mengubah nilai apa pun.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example policy-data-class-routeKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd policy-data-class-routeBuild
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pullaggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1Ganti governance-rego.yaml dengan governance-cel.yaml atau governance-opa.yaml untuk
menjalankan aturan yang sama pada mesin lain.
--config menyebutkan file konfigurasi global untuk eksekusi tersebut. File ini dibaca
sebagai pengganti file yang biasanya dibaca oleh mesin — file yang disebutkan oleh AGGREGA_CONFIG,
atau lokasi default — dan .aggrega-config.yaml milik workspace ini
tetap dilapiskan di atasnya. Jadi, untuk eksekusi tersebut, tidak ada isi file global Anda sendiri
yang berlaku: lampiran tata kelola lain, default_registry, maupun pengaturan
offline. Kredensial yang Anda simpan dengan aggrega login bukan bagian dari file tersebut
dan tetap berlaku. File workspace mendeklarasikan direktori katalog dan tidak memiliki
lampiran tata kelola sendiri; daftar yang dideklarasikannya akan menggantikan daftar yang
dibawa oleh file yang disebutkan, sehingga lampiran dalam file yang disebutkan itulah yang dijalankan.
Kebijakan tata kelola dilampirkan melalui konfigurasi, bukan melalui Release — sebuah Release tidak memiliki field untuknya — itulah sebabnya mesin dipilih per build, bukan per Release.
Dua hal harus tersedia sebelum build pertama:
- Katalog pustaka standar.
.aggrega-config.yamlmencantumkancatalog/milik workspace ini, yang berisi asisten klaim dan entitas Plugin mesin OPA. Semua hal lainnya, termasuk entitas Plugin mesin Rego dan CEL, di-resolve dari registry hub di bawah, atau dari checkout katalog yang disebutkan melalui--catalog. - Registry hub. Realisasi penyamaran data menulis guardrail-nya melalui satu plugin yang tidak disertakan baik dalam compiler maupun katalog, yaitu langkah konfigurasi gateway
pipeline-step/litellm-gateway-config, dan build menariknya dari registry yang disebutkan olehdefault_registry, yaituhub.aggrega.ai.
--auto-pull mengisi lockfile setiap Release selama build; lockfile dan
output yang dirender dihasilkan, bukan dikirimkan.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder Workspace belum berisi folder `policy-data-class-route`, panggil alat `scaffold` sekali dengan `example` diatur ke `policy-data-class-route` dan tanpa `dir`: alat ini menulis contoh ke folder `policy-data-class-route` yang baru. Kemudian panggil alat `cli-build`, yang menjalankan `aggrega build` dan menerima flag `--config`-nya, sekali untuk setiap Release, dengan urutan ini — `release-masked.yaml`, `release-unmasked.yaml`, dan `release-masking-off-route.yaml` — setiap kali dengan `workspace_root` diatur ke `policy-data-class-route`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `config` diatur ke `governance-rego.yaml`. Build kedua dan ketiga memang dimaksudkan untuk ditolak, jadi bacakan setiap penolakannya kepada saya. Beri tahu saya file apa saja yang ditulis build pertama; file-file itu ada di bawah `policy-data-class-route/dist/`.Penghentian
release-unmasked.yaml, di bawah setiap mesin. Mesin Rego:
[… omitted: the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "rego" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violationMesin CEL:
[… omitted: the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "cel" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violationOPA:
[… omitted: a warning that the OPA guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "opa" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violationBuild keluar dengan 1 dan tidak menulis dist/: kebijakan dievaluasi atas
graf build sebelum apa pun di-render. E0005 adalah diagnostik yang dibawa oleh
penolakan kebijakan — lihat referensi diagnostik.
release-masking-off-route.yaml mencetak penolakan yang sama, di bawah setiap mesin.
Bacalah kalimat tersebut sebagai rute yang ditemukannya. assistant menyimpan data restricted. Lalu lintas
modelnya mencapai gpt, yang oleh kebijakan diklasifikasikan sebagai public, melalui
plain-gateway, dan tidak ada apa pun pada rute itu — bukan asisten, bukan gateway,
bukan model — yang membawa Feature yang dihitung kebijakan sebagai deklasifikasi. Dua kelas
dengan peringkat berbeda bertemu pada satu rute tanpa apa pun di antaranya, sehingga kebijakan
menolak build.
Proses pull juga me-render Release, untuk menemukan input eksternal apa pun yang perlu disematkan, dan menemui penolakan yang sama di sana; itulah sebabnya baris yang dihilangkan di atas memuat kalimat tersebut untuk kedua kalinya. Lockfile tetap ditulis.
Memenuhinya: gateway penyamaran pada rute
release-masked.yaml merutekan asisten klaim melalui masking-gateway, dan
setiap mesin mengizinkannya untuk di-build, dengan <workspace> mewakili folder contoh ini:
[… omitted: the pull's lines, a lint notice, under OPA a warning that its guest runs unverified, and the total build time]Build completed: 17 files written to <workspace>/distGateway penyamaran kini berada pada satu-satunya rute asisten klaim menuju model,
dan kebijakan membacanya di sana: pada rute tersebut, sebuah komponen membawa lampiran
yang tipenya tercantum dalam pengaturan declassifying_features kebijakan, pada atau sebelum
titik tempat kelas-kelasnya berbeda. Rute tersebut dapat dibaca dari keluaran yang dirender:
dist/helm/assistant-deployment.yaml mengirim asisten klaim ke gateway penyamaran,
dan dist/helm/helpdesk-deployment.yaml mengirim helpdesk ke gateway
biasa.
# dist/helm/assistant-deployment.yaml, the env of the assistant's containerenv: [… omitted: the recursion limit] - name: OPENAI_BASE_URL value: http://masking-gateway-default:4000/v1 [… omitted: the alias, the checkpointer's address and the graph's entrypoint]# dist/helm/helpdesk-deployment.yaml, the env of the helpdesk's containerenv: [… omitted: the recursion limit] - name: OPENAI_BASE_URL value: http://plain-gateway-default:4000/v1 [… omitted: the alias, the checkpointer's address and the graph's entrypoint]Penyamaran itu sendiri berada dalam konfigurasi gateway penyamaran, yaitu kunci config.yaml
dari dist/helm/masking-gateway/litellm-gateway-config/configmap.yaml:
[… omitted: the routing table]litellm_settings: callbacks: - /etc/litellm-request-guard/request_field_filter.filter turn_off_message_logging: trueguardrails: - guardrail_name: masking-gateway-masking litellm_params: default_on: true guardrail: litellm_content_filter mode: pre_call patterns: - action: MASK name: claim_number pattern: "\\bCLM-[0-9]{8}\\b" pattern_type: regex skip_tool_message_in_guardrail: true [… omitted: three more guardrail entries masking the same pattern and the two entity types, and the request guard's settings]Konfigurasi gateway biasa sama sekali tidak memiliki entri guardrail.
Kebijakan tidak mengubah apa pun dalam hasil yang dirender. Pohon release-masked
dari setiap mesin identik byte demi byte dengan Release yang sama yang di-build tanpa kebijakan terlampir.
Kebijakan dilampirkan pada peran ir-verdict, sebuah peran verdict: kebijakan mengembalikan penerimaan
atau penolakan, dan jalur yang meneruskan verdict tidak memiliki cara untuk menerapkannya sebagai
perubahan, sehingga kebijakan di sana dapat menghentikan build dan tidak dapat menulis ulang build agar
mematuhi kebijakan.
Kebijakan memeriksa bahwa penyamaran terlampir pada rute, bukan apa yang disamarkannya. Lampiran yang mencantumkan pola yang tidak cocok dengan data siapa pun memenuhinya sama baiknya dengan lampiran ini. Apa yang dicantumkan oleh lampiran penyamaran merupakan penilaian estate itu sendiri, yang dibuat di tempat lampiran tersebut ditulis.
Mengapa Releases memindahkan rute, bukan lampirannya
Sebuah Release dapat melampirkan sebuah Feature, tetapi lampiran yang ditulis dalam Release tidak membawa
values, dan core/data-masking menyimpan apa yang disamarkannya — patterns dan entities
— di values, serta menghentikan lampiran yang tidak mencantumkan keduanya. Karena itu, penyamaran
dilampirkan di Aggregate, pada masking-gateway, dan penyamaran itu ada dalam graf ketiga build:
- di
release-masked.yamlpenyamaran berada pada rute asisten klaim, dan build selesai; - di
release-unmasked.yamlpenyamaran tidak berada pada rute asisten mana pun, dan build berhenti; - di
release-masking-off-route.yamlpenyamaran berada pada rute helpdesk, dan build kembali berhenti.
Build kedua dan ketiga membawa lampiran yang sama dan hanya berbeda pada rute siapa lampiran itu berada. Keduanya berhenti, jadi kebijakan membaca rute, bukan menghitung lampiran dalam build.
Apa yang dibaca kebijakan
Semuanya berasal dari graf build yang diserahkan compiler kepada lampiran ir-verdict,
dan seluruh maknanya berasal dari pengaturan lampiran tersebut:
- Rute yang dienumerasi compiler,
input.precalculated_paths: masing-masing berupa daftar komponen berurutan yang dihubungkan oleh sisiuses. Padarelease-unmasked.yamlsalah satunya adalahassistant → plain-gateway → gpt. Kebijakan membaca setiap rute dari komponen pertamanya, dan itu cukup karena compiler mengenumerasi rute yang keluar dari setiap komponen. Kebijakan itu sendiri tidak mengenumerasi apa pun. - Kelas setiap komponen. Nilai label yang dinamai
class_label,compliance.aggrega.ai/data-class, jika komponen membawanya: hanyaassistantyang membawanya, denganrestricted. Jika tidak, kelasnya adalah kelas dari entriclasses_by_labelpertama yang label dan nilainya dibawa oleh komponen tersebut. - Lampiran setiap komponen,
input.graph.spec.feature_values_mapping. Daftarattached_featuresmilik rute itu sendiri sengaja tidak dibaca: daftar itu menyebut setiap Feature yang dilampirkan di mana pun pada rute, sehingga tidak dapat menunjukkan apakah sebuah Feature berada di antara dua komponen yang dimaksud.
Komponen tanpa kelas dilewati. Demikian pula arah penggambaran rute — sebuah koneksi membawa permintaan ke satu arah dan balasannya ke arah sebaliknya — serta kelas-kelas yang diberi peringkat sama oleh pengaturan.
Kelas model berasal dari label hosting-nya. gpt tidak membawa label kelas.
Component-nya, core/ai-model/openai, membawa component.aggrega.ai/hosting: managed, yaitu pernyataan katalog bahwa layanan dijalankan oleh penyedianya,
di luar kluster, dan pengaturan memetakannya ke sebuah kelas:
classes_by_label: - label: component.aggrega.ai/hosting value: managed class: publicModel terkelola menyimpan apa pun yang dikirimkan kepadanya, yang diperlakukan sebagai publik oleh estate ini.
Model yang di-hosting sendiri seperti core/ai-model/vllm, serta kedua gateway di sini, membawa
self-hosted sebagai gantinya, sehingga tidak memiliki kelas.
Rute dibatasi. Compiler mencantumkan rute dalam jumlah terbatas dari setiap komponen awal dan tidak mencantumkan apa pun melewati batas itu, sehingga pada graf dengan rute lebih banyak dari itu, sebuah rute dapat tidak terbaca dan build lolos. Rute yang dibaca kebijakan memang nyata; ketiadaan sebuah rute bukan bukti bahwa rute itu tidak ada. Lihat peran verdict.
Kelas-kelas tersebut milik kebijakan, bukan milik compiler
Compiler membawa compliance.aggrega.ai/data-class ke graf build sebagai
string dan tidak menafsirkan makna apa pun darinya. Compiler tidak tahu bahwa restricted lebih
sensitif daripada public, atau bahwa kedua kata itu bermakna apa pun. Kelas-kelas dan
peringkatnya adalah pengaturan kebijakan, sama di ketiga file mesin:
class_label: compliance.aggrega.ai/data-classrank: public: 0 internal: 1 restricted: 2Sebuah estate dengan kosakatanya sendiri menggantinya dengan miliknya: kelas-kelasnya dan
urutannya di bawah rank, label tempat kelas itu disimpan di bawah class_label,
turunannya di bawah classes_by_label, dan Features yang diterimanya sebagai penurun klasifikasi
di bawah declassifying_features. Ubah ketiga file mesin dengan cara yang sama, karena
perbedaan di antara file tersebut adalah perbedaan di antara putusan mesin-mesinnya. Kelas yang
dibawa sebuah komponen tetapi tidak tercantum di rank menghentikan build alih-alih dibaca
sebagai tanpa kelas, sehingga salah ketik dilaporkan alih-alih lolos. Jika label asisten
klaim ditulis Restricted, setiap mesin menolak release-masked.yaml;
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull mencetak penolakan di bawah ini, dan file setiap mesin lainnya mencetak
penolakan yang sama dengan judul nama mesin tersebut:
[… omitted: under OPA a warning that its guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "rego" rejected the build: assistant carries the data class "Restricted", which the policy's rank setting does not list; correct the class or rank it caused by: policy violationKelas tersebut dibawa oleh Component milik workspace ini sendiri, bukan oleh Component
pustaka standar. Apakah sebuah asisten menangani data terbatas adalah pernyataan tentang cara
sebuah estate menggunakannya, bukan tentang LangGraph, sehingga local/ai-agent/claims-assistant
memperluas core/ai-agent/langgraph, mewarisi kontraknya, dan menambahkan satu label itu.
Sebuah Aggregate tidak dapat memasang label pada instans komponen, sehingga kelas selalu merupakan
properti dari Component yang dideklarasikan untuk instans tersebut. Jika asisten klaim
dideklarasikan sebagai agen pustaka standar, tidak ada komponen yang membawa label
kelas, dan release-unmasked.yaml berhasil di-build di bawah setiap mesin, byte demi byte sama dengan
hasil build tanpa kebijakan: model tetap menurunkan public, tetapi tidak ada
kelas kedua yang dapat ditemuinya.
Tiga mesin, aturan yang ditulis tiga kali
| mesin | dipasang melalui | aturannya |
|---|---|---|
| mesin Rego yang dikompilasi ke dalam CLI | governance-rego.yaml | policies/data-class-paths.rego, disebutkan di bawah with.sources |
| mesin CEL yang dikompilasi ke dalam CLI | governance-cel.yaml | policies/data-class-paths.cel, disebutkan di bawah with.sources |
| OPA, di balik guest adaptor referensi | governance-opa.yaml | policies/data-class-paths-opa.rego, dikompilasi ke dalam guest |
Ketiga salinan ini sengaja dibuat hampir sama. Masing-masing ditulis secara terpisah dari aturannya, sehingga build yang membuat mesin-mesin itu tidak sepakat akan memperlihatkan ketidaksepakatan tersebut: build yang sama berhenti di satu mesin dan selesai di mesin lain adalah sinyalnya. Tidak ada yang dihasilkan dari yang lain, dan ketiganya tidak boleh digabung menjadi satu implementasi bersama, karena hal itu akan membuat mesin-mesin sepakat dengan sendirinya dan menyembunyikan perbedaan yang justru ingin ditangkap. Setiap file diawali dengan pernyataan tersebut.
Ketiganya berbeda di tempat mesin-mesinnya berbeda:
- Salinan CEL tidak dapat mengikat nama ke suatu nilai atau menelusuri posisi-posisi sebuah daftar, sehingga
pengaturannya memuat satu entri tambahan,
positions, yaitu posisi 0 hingga 15 tempat komponen-komponen sebuah rute dibaca. Rute yang lebih panjang dari itu menghentikan build, dengan menyebutkan tempat rute itu dimulai, alih-alih dibaca sebagian. - Salinan OPA dikompilasi secara ahead-of-time dengan toolchain milik OPA sendiri dan ditanamkan
ke dalam guest di samping
catalog/plugin/governance/opa/1.0.0/plugin.yaml, sehingga pemasangannya menyediakan pengaturan tanpa file kebijakan. Adaptor tidak menyediakan satu pun builtin yang diserahkan OPA kepada host-nya, sehingga salinan ini menggabungkan pesannya denganconcat, sedangkan salinan mesin Rego memformatnya dengansprintf. Mengeditnya tidak mengubah build apa pun sampai guest dibangun ulang, seperti dijelaskan di bawah.
Pemasangan Rego dan CEL menyebutkan entitas Plugin yang dimuat katalog pustaka standar untuk dua mesin yang dikompilasi ke dalam CLI, governance/rego:0.9.0 dan governance/cel:0.9.0, dan mesin yang berjalan adalah mesin yang dikompilasi ke dalam biner yang menjalankan build. Entitas Plugin milik OPA, di catalog/plugin/governance/, adalah deklarasi milik workspace ini sendiri pada versi 1.0.0, sehingga pemasangannya menyebutkan governance/opa:1.0.0. Sebuah penolakan diberi judul dengan segmen terakhir referensi pemasangannya, tanpa versinya — policy plugin "rego", "cel" atau "opa" — dan setiap build memasang satu mesin, sehingga penolakan yang dicetaknya menyebutkan mesin tersebut. Guest OPA dibaca dari samping entitasnya pada setiap build, dan karena tidak ada yang mencatat digest-nya, setiap build dengannya memberi peringatan bahwa guest itu berjalan tanpa verifikasi.
Memeriksa setiap build
Pemeriksaan mandiri ini berjalan di checkout repositori dokumentasi, yang memuat skrip pembantu build bersama yang digunakannya; salinan yang ditulis oleh aggrega scaffold --example tidak menyertakan skrip pembantu tersebut.
./check.shcheck.sh membangun ketiga Releases di bawah ketiga mesin melalui
./build-release.sh, dan memeriksa setiap hasil terhadap hasil yang dijelaskan halaman ini. Penghentian harus keluar dengan kode bukan nol dengan E0005 yang pesannya adalah kalimat
di atas, tanpa penolakan lain di sampingnya; build yang selesai harus keluar dengan 0 dan menulis
berkas yang sama, byte demi byte, seperti Release yang sama yang dibangun tanpa kebijakan, yang
dibangunnya terlebih dahulu sebagai acuan. Setiap mesin diuji terhadap kalimat yang sama. Skrip ini mencetak
satu baris per build dan keluar dengan 1 jika ada hasil yang berbeda, sambil mencetak keluaran
build tersebut:
ENGINE RELEASE EXIT EXPECTED VERDICT------------------------------------------------------------------------------------------none release-masked.yaml 0 reference OKrego release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyrego release-unmasked.yaml 1 halt OK: E0005, the expected sentencerego release-masking-off-route.yaml 1 halt OK: E0005, the expected sentencecel release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policycel release-unmasked.yaml 1 halt OK: E0005, the expected sentencecel release-masking-off-route.yaml 1 halt OK: E0005, the expected sentenceopa release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyopa release-unmasked.yaml 1 halt OK: E0005, the expected sentenceopa release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
check: every build ended as expected.Skrip ini membutuhkan apa yang dibutuhkan satu build: katalog pustaka standar dan registry hub. Skrip ini menggunakan biner yang di-resolve oleh ./build-release.sh, sehingga AGGREGA_BIN memilihnya; argumen setelah -- diteruskan ke setiap build, sehingga ./check.sh -- --offline menjalankannya tanpa jaringan setelah semua yang ditariknya tersimpan di cache. Skrip ini menolak berjalan selama ada dist/ di direktori ini, karena skrip ini membandingkan pohon yang ditulis oleh build, dan tidak meninggalkan satu pun. Status keluarnya adalah seluruh putusannya, sehingga sebuah pipeline dapat menjalankannya sebagai pengganti membangun setiap Release satu per satu.
Membangun ulang guest OPA
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm adalah guest adaptor OPA referensi dari kit plugin, rust/examples/policy-opa-wasm di repositori aggrega-pdk, dengan modul yang dikompilasi OPA dari policies/data-class-paths-opa.rego sebagai pengganti modul milik adaptor itu sendiri. Guest ini dibangun dari aggrega-pdk pada afd9ac6c6800c34c6c47a2030f580c9681387047 dan aggrega-abi, crate ABI yang menjadi dasar build adaptor, pada 2ececa8d3b598243f023a2a6c80b351c8d1411a1, dengan rustc 1.97.1, di sekitar modul yang dikompilasi OPA 1.21.1.
Pertama modulnya, dari direktori ini. Menyebut aturan dengan path-nya yang relatif terhadap direktori ini membuat path tersebut, dan tidak ada apa pun dari mesin, tersimpan di dalam modul:
opa build -t wasm -e data_class_paths/deny policies/data-class-paths-opa.rego -o bundle.tar.gztar -xzf bundle.tar.gz -O /policy.wasm > policy.wasmrm bundle.tar.gzsha256sum policy.wasm# 321e8a1f150a7ef7625e174cf636967b6c0e1f7bd39c3b7fa1010838ce35c871 policy.wasmOPA 1.21.1 mengompilasi byte yang sama dari sumber yang sama di direktori mana pun workspace ini berada.
Kemudian guest-nya, dalam direktori sementara $BUILD, yang diberikan sebagai path absolut,
berisi kedua repositori berdampingan, dengan dependensi path adaptor menjangkau
dari satu ke yang lain. Ketiga pemetaan path menjaga direktori build, direktori home cargo,
dan sumber milik toolchain tetap berada di luar guest:
mkdir -p "$BUILD/aggrega-pdk" "$BUILD/aggrega-abi"git -C <aggrega-pdk checkout> archive afd9ac6c6800c34c6c47a2030f580c9681387047 | tar -x -C "$BUILD/aggrega-pdk"git -C <aggrega-abi checkout> archive 2ececa8d3b598243f023a2a6c80b351c8d1411a1 | tar -x -C "$BUILD/aggrega-abi"cp policy.wasm "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm/policy.wasm"cd "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm"SRC="$(rustc +stable --print sysroot)/lib/rustlib/src/rust"HASH="$(rustc +stable -vV | awk '/^commit-hash: /{print $2}')"RUSTFLAGS="--remap-path-prefix=$BUILD=/build --remap-path-prefix=${CARGO_HOME:-$HOME/.cargo}=/cargo --remap-path-prefix=$SRC=/rustc/$HASH" \ CARGO_TARGET_DIR="$BUILD/target" \ cargo +stable build --locked --release --target wasm32-wasip1lalu salin $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm ke
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm.
Guest adalah keluaran build cargo apa adanya. Skrip build milik adaptor juga menjalankan tahap pengecilan ukuran opsional, yang dilewati di sini: tahap itu menulis ulang data guest, dan tanpanya modul tetap berada di dalam guest byte demi byte. Hal ini memungkinkan Anda memeriksa apa yang dibawa sebuah guest terhadap hasil kompilasi aturan:
python3 -c 'import sys; print(open(sys.argv[1], "rb").read() in open(sys.argv[2], "rb").read())' \ policy.wasm catalog/plugin/governance/opa/1.0.0/governance--opa.wasm# TrueByte milik guest itu sendiri juga bergantung pada direktori tempat crate-nya dibangun, dan pada toolchain, sehingga build ulang di tempat lain menghasilkan guest yang setara dengan sha256 yang berbeda. Guest yang disertakan di sini adalah eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93.
Bagian yang tidak ditafsirkan oleh kompiler
Compiler meneruskan label kelas ke graf build sebagai string, menghitung rute di atas edge uses yang dideklarasikan oleh Aggregate dan Releases, lalu menyerahkan keduanya ke kebijakan. Compiler tidak memeringkat kelas, tidak tahu bahwa managed berarti data meninggalkan klaster menuju penyedia, dan tidak tahu bahwa core/data-masking menyembunyikan apa pun. Setiap makna tersebut merupakan pengaturan kebijakan, dan itulah yang memungkinkan sebuah estate dengan kelas lain, label lain, dan Features deklasifikasi lain menjalankan mekanisme yang sama tanpa perubahan. Untuk socket tempat kebijakan dilampirkan — peran, payload, tingkat keparahan verdict — lihat socket kebijakan, dan untuk posisi kebijakan dalam produk, lihat Tata kelola dan kepatuhan.
Berkas
aggregate.yaml— kedua asisten, checkpointer-nya, kedua gateway, model dan pasangan recognizer; masking yang dipasang padamasking-gateway; soketmodelmilik kedua asisten tidak diikat.manifest.yaml— mengikat setiap tipe komponen dan kedua tipe Feature ke Recipes Kubernetes masing-masing, serta asisten klaim ke Recipe milik agen dasar. Digunakan bersama oleh ketiga Releases.release-masked.yaml,release-unmasked.yaml,release-masking-off-route.yaml— ketiga perutean, dan Secret tempat kunci setiap gateway dibaca.catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml— asisten klaim,core/ai-agent/langgraphdengan label kelas yang ditambahkan.catalog/plugin/governance/opa/1.0.0/plugin.yaml— entitas Plugin mesin OPA, dengan guest-nya,governance--opa.wasm, di sampingnya.policies/data-class-paths.rego,policies/data-class-paths.cel,policies/data-class-paths-opa.rego— aturannya, satu kali per mesin.governance-rego.yaml,governance-cel.yaml,governance-opa.yaml— satu file--configper mesin, masing-masing memasang aturan padair-verdictdengan pengaturan yang sama..aggrega-config.yaml— tumpukan pencarian katalog dan registri; tanpa pemasangan tata kelola.build-release.sh— membangun satu Release, sambil menampilkan perintahaggrega buildyang setara.check.sh— membangun kesembilannya dan memeriksa setiap hasilnya.