Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

instansComponent katalogperannya di sini
assistantlocal/ai-agent/claims-assistantasisten klaim: agen LangGraph dari pustaka standar, dideklarasikan dalam katalog workspace ini dengan satu label tambahan — kelas data yang ditanganinya
helpdeskcore/ai-agent/langgraphasisten helpdesk, yang tidak membawa kelas apa pun
checkpointercore/datastore/valkeytempat kedua asisten menyimpan status eksekusinya
masking-gatewaycore/gateway/litellmAI gateway yang melayani satu alias, chat, dengan core/data-masking terpasang
plain-gatewaycore/gateway/litellmgateway yang sama tanpa apa pun terpasang
gptcore/ai-model/openaiAPI terkelola OpenAI, dijangkau sebagai referensi: tidak ada yang berjalan untuknya di dalam klaster
analyzer, anonymizercore/security/presidio-analyzer, core/security/presidio-anonymizerlayanan 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:

Releaselalu lintas asisten klaimlalu lintas asisten helpdeskbuild
release-masked.yamlmelalui masking-gatewaymelalui plain-gatewayselesai
release-unmasked.yamlmelalui plain-gatewaymelalui plain-gatewaydihentikan
release-masking-off-route.yamlmelalui plain-gatewaymelalui masking-gatewaydihentikan

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:

Terminal window
aggrega scaffold --example policy-data-class-route

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd policy-data-class-route

Build

Terminal window
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull
aggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1
aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1

Ganti 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.yaml mencantumkan catalog/ 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 oleh default_registry, yaitu hub.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 violation

Mesin 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 violation

OPA:

[… 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 violation

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

Gateway 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 container
env:
[… 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 container
env:
[… 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: true
guardrails:
-
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.yaml penyamaran berada pada rute asisten klaim, dan build selesai;
  • di release-unmasked.yaml penyamaran tidak berada pada rute asisten mana pun, dan build berhenti;
  • di release-masking-off-route.yaml penyamaran 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 sisi uses. Pada release-unmasked.yaml salah satunya adalah assistant → 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: hanya assistant yang membawanya, dengan restricted. Jika tidak, kelasnya adalah kelas dari entri classes_by_label pertama yang label dan nilainya dibawa oleh komponen tersebut.
  • Lampiran setiap komponen, input.graph.spec.feature_values_mapping. Daftar attached_features milik 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: public

Model 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-class
rank:
public: 0
internal: 1
restricted: 2

Sebuah 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 violation

Kelas 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

mesindipasang melaluiaturannya
mesin Rego yang dikompilasi ke dalam CLIgovernance-rego.yamlpolicies/data-class-paths.rego, disebutkan di bawah with.sources
mesin CEL yang dikompilasi ke dalam CLIgovernance-cel.yamlpolicies/data-class-paths.cel, disebutkan di bawah with.sources
OPA, di balik guest adaptor referensigovernance-opa.yamlpolicies/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 dengan concat, sedangkan salinan mesin Rego memformatnya dengan sprintf. 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.

Terminal window
./check.sh

check.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 OK
rego release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
rego release-unmasked.yaml 1 halt OK: E0005, the expected sentence
rego release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
cel release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
cel release-unmasked.yaml 1 halt OK: E0005, the expected sentence
cel release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
opa release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
opa release-unmasked.yaml 1 halt OK: E0005, the expected sentence
opa 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:

Terminal window
opa build -t wasm -e data_class_paths/deny policies/data-class-paths-opa.rego -o bundle.tar.gz
tar -xzf bundle.tar.gz -O /policy.wasm > policy.wasm
rm bundle.tar.gz
sha256sum policy.wasm
# 321e8a1f150a7ef7625e174cf636967b6c0e1f7bd39c3b7fa1010838ce35c871 policy.wasm

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

Terminal window
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-wasip1

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

Terminal window
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
# True

Byte 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 pada masking-gateway; soket model milik 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/langgraph dengan 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 --config per mesin, masing-masing memasang aturan pada ir-verdict dengan pengaturan yang sama.
  • .aggrega-config.yaml — tumpukan pencarian katalog dan registri; tanpa pemasangan tata kelola.
  • build-release.sh — membangun satu Release, sambil menampilkan perintah aggrega build yang setara.
  • check.sh — membangun kesembilannya dan memeriksa setiap hasilnya.