Kısıtlı veri yönetilen bir modele maskelenmeden ulaştığında derlemeyi durduran bir politika
Bir ortam, kısıtlı müşteri verilerini işleyen bir hasar talebi asistanı ve hiç kısıtlı veri işlemeyen bir yardım masası asistanı çalıştırır. Her ikisi de model trafiğini küme içi bir AI ağ geçidi üzerinden OpenAI’nin yönetilen API’sine gönderir. Ortamın kendi kuralı:
Bir sınıftaki veri, derleme grafiğindeki bir rota boyunca başka bir sınıftaki bir bileşene, o rotaya sınıflandırmayı kaldıran bir Feature eklenmedikçe ulaşmaz.
Bu çalışma alanı, bu kuralı derleme grafiği üzerinde bir politika olarak ekler ve tek bir Aggregate’in üç Releases’ini derler. Birinde hasar talebi asistanının istekleri onları maskeleyen bir ağ geçidinden geçer ve derleme tamamlanır. Diğer ikisinde geçmez ve derleme hiçbir şey işlenmeden durur; politika rotanın iki ucunu da adlandırır.
Kural, üzerinde çalıştığı her politika motoru için bir kez olmak üzere üç kez yazılmıştır — CLI’ya derlenmiş Rego ve CEL motorları ile OPA — ve üç kopya buradaki her derlemede aynı sonuca varır. Releases’in yanındaki bir betik dokuz bileşimin tümünü derler ve her sonucu denetler.
Ne oluşturur
| örnek | katalog Component’i | burada ne olduğu |
|---|---|---|
assistant | local/ai-agent/claims-assistant | talep asistanı: bu çalışma alanının kataloğunda tek bir etiket eklenerek tanımlanmış standart kütüphane LangGraph ajanı — eklenen etiket, işlediği verinin sınıfıdır |
helpdesk | core/ai-agent/langgraph | hiçbir sınıf taşımayan yardım masası asistanı |
checkpointer | core/datastore/valkey | her iki asistanın çalışma durumunu tuttuğu yer |
masking-gateway | core/gateway/litellm | tek bir takma ad (chat) sunan ve core/data-masking eklenmiş bir AI ağ geçidi |
plain-gateway | core/gateway/litellm | hiçbir şey eklenmemiş aynı ağ geçidi |
gpt | core/ai-model/openai | OpenAI’ın yönetilen API’si, bir referans olarak erişilir: küme içinde onun için hiçbir şey çalışmaz |
analyzer, anonymizer | core/security/presidio-analyzer, core/security/presidio-anonymizer | maskelemenin çağırdığı tanıyıcı servisler |
Her iki ağ geçidi de models soketleri üzerinden gpt’ye bağlanır ve her biri bu bağlantıda modelin anahtarını sunar. Maskeleme eki neyin maskeleneceğini listeler: kurumun talep numaraları için bir desen ve PERSON ile
EMAIL_ADDRESS varlık türleri. İki asistan, Component’lerinin tanımladığı model soketini tanımlar; bu soket bir modeli ya da model API’si sunan bir ağ geçidini kabul eder. Asistanlar soketi bağlanmamış bırakır: bağlantıyı her Release kendisi yapar.
Üç Releases
Releases yalnızca her asistanın model trafiğinin hangi ağ geçidinden geçtiği bakımından birbirinden ayrılır:
| Release | talep asistanının trafiği | yardım masası asistanının trafiği | derleme |
|---|---|---|---|
release-masked.yaml | masking-gateway üzerinden | plain-gateway üzerinden | tamamlanır |
release-unmasked.yaml | plain-gateway üzerinden | plain-gateway üzerinden | durur |
release-masking-off-route.yaml | plain-gateway üzerinden | masking-gateway üzerinden | durur |
Her Release, iki asistanın model soketini Aggregate’in bildirdiği bir ağ geçidine
bağlar. Bu, Component’in bildirdiği bir soket içinde kenar bağlantısıdır ve bir
Release bunu yapabilir; hiçbir bileşen eklemez ve hiçbir değeri değiştirmez.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example policy-data-class-routeArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd policy-data-class-routeDerleme
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 1Aynı kuralı başka bir motorda çalıştırmak için governance-rego.yaml yerine governance-cel.yaml ya da governance-opa.yaml kullanın.
--config, o çalıştırma için genel yapılandırma dosyasını belirtir. Bu dosya, makinenin aksi hâlde okuyacağı dosyanın — AGGREGA_CONFIG değişkeninin belirttiği dosya ya da varsayılan konum — yerine okunur ve bu çalışma alanının kendi .aggrega-config.yaml dosyası yine onun üzerine katmanlanır. Dolayısıyla o çalıştırmada kendi genel dosyanızda tuttuğunuz hiçbir şey uygulanmaz: başka bir yönetişim eki, bir default_registry, bir çevrimdışı ayarı. aggrega login ile sakladığınız bir kimlik bilgisi o dosyanın parçası değildir ve yine uygulanır. Çalışma alanı dosyası katalog dizinlerini bildirir ve kendine ait bir yönetişim eki bildirmez; bildirdiği bir liste, belirtilen dosyanın taşıdığı listenin yerini alırdı; bu nedenle çalışan ek, belirtilen dosyadaki ektir.
Bir yönetişim politikası bir Release üzerinden değil, yapılandırma üzerinden eklenir — bir Release’in bunun için bir alanı yoktur —; motorun Release başına değil de derleme başına seçilmesinin nedeni budur.
İlk derlemeden önce iki şeyin hazır olması gerekir:
- Standart kütüphane kataloğu.
.aggrega-config.yaml, bu çalışma alanının talep asistanını ve OPA motorunun Plugin varlığını barındıran kendicatalog/dizinini listeler. Rego ve CEL motorlarının Plugin varlıkları da dahil olmak üzere geri kalan her şey aşağıdaki hub kayıt defterinden ya da--catalogile belirtilen bir katalog çalışma kopyasından çözümlenir. - Hub kayıt defteri. Veri maskeleme gerçekleştirimi, korumalarını ne derleyiciyle ne de katalogla birlikte gelen tek bir eklenti aracılığıyla yazar: ağ geçidi yapılandırma adımı
pipeline-step/litellm-gateway-config. Derleme bu eklentiyidefault_registrydeğerinin belirttiği kayıt defterinden,hub.aggrega.aiadresinden çeker.
--auto-pull, derleme sırasında her Release’in kilit dosyasını doldurur; kilit dosyaları ve işlenmiş çıktı üretilir, birlikte dağıtılmaz.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Workspace klasöründe henüz `policy-data-class-route` klasörü yoksa, `scaffold` aracını `example` değeri `policy-data-class-route` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `policy-data-class-route` klasörüne yazar. Ardından `aggrega build` komutunu çalıştıran ve onun `--config` bayrağını alan `cli-build` aracını her Release için birer kez, şu sırayla çağırın — `release-masked.yaml`, `release-unmasked.yaml` ve `release-masking-off-route.yaml` — her seferinde `workspace_root` değeri `policy-data-class-route`, `release` değeri o dosya, `auto_pull` değeri true ve `config` değeri `governance-rego.yaml` olacak şekilde. İkinci ve üçüncü derlemenin reddedilmesi amaçlanmıştır, bu yüzden her reddi bana okuyun. İlk derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `policy-data-class-route/dist/` altındadır.Durdurma
Her motor altında release-unmasked.yaml. Rego motoru:
[… 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 violationCEL motoru:
[… 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 violationDerleme 1 koduyla çıkar ve hiçbir dist/ yazmaz: politika, herhangi bir şey işlenmeden önce derleme grafiği üzerinde değerlendirilir. E0005, bir politika reddinin taşıdığı tanılamadır; bkz. tanılama başvurusu.
release-masking-off-route.yaml de her motor altında aynı reddi yazdırır.
Cümleyi, bulduğu rota olarak okuyun. assistant restricted veri tutar. Onun
model trafiği, politikanın public olarak sınıflandırdığı gpt’ye
plain-gateway üzerinden ulaşır ve bu rota üzerindeki hiçbir şey (ne asistan, ne ağ geçidi,
ne de model) politikanın sınıf düşürücü saydığı bir Feature taşımaz. Farklı sıralanmış iki sınıf,
aralarında hiçbir şey olmadan tek bir rotada buluşur; bu nedenle politika
derlemeyi reddeder.
Çekme işlemi de, sabitlenmesi gereken harici girdileri bulmak için Release’i işler ve orada da aynı retle karşılaşır; yukarıda atlanan satırların cümleyi ikinci kez taşımasının nedeni budur. Kilit dosyası yine de yazılır.
Koşulu sağlamak: rota üzerindeki maskeleme ağ geçidi
release-masked.yaml, talep asistanını masking-gateway üzerinden yönlendirir ve
her motor derlemenin tamamlanmasına izin verir; burada <workspace> bu örneğin klasörünü temsil eder:
[… 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>/distMaskeleme ağ geçidi artık talep asistanının modele giden tek rotası üzerindedir
ve politika onu orada okur: o rotada, sınıfların farklılaştığı noktada ya da
ondan önce, bir bileşen türü politikanın declassifying_features ayarında
listelenen bir ek taşır. Rota, işlenmiş çıktıdan okunabilir:
dist/helm/assistant-deployment.yaml talep asistanını maskeleme ağ geçidine,
dist/helm/helpdesk-deployment.yaml ise yardım masasını sade ağ geçidine yönlendirir.
# 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]Maskelemenin kendisi, maskeleme ağ geçidinin yapılandırmasında,
dist/helm/masking-gateway/litellm-gateway-config/configmap.yaml dosyasının config.yaml anahtarında yer alır:
[… 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]Sade ağ geçidinin yapılandırmasında hiçbir koruma (guardrail) girdisi yoktur.
Politika, işlenen çıktıda hiçbir şeyi değiştirmez. Her motorun release-masked
ağacı, hiçbir politika eklenmeden derlenen aynı Release ile bayt bayt aynıdır.
Politika, bir karar rolü olan ir-verdict rolüne eklenir: kabul ya da ret döndürür
ve bir kararı ileten yolun onu bir değişiklik olarak uygulama imkânı yoktur; bu
nedenle oradaki bir politika bir derlemeyi durdurabilir, ancak onu uyumlu hâle
getirmek için yeniden yazamaz.
Politika, neyi maskelediğini değil, maskelemenin rota üzerinde ekli olup olmadığını denetler. Hiç kimsenin verisiyle eşleşmeyen bir desen listeleyen bir ek de koşulu bu ek kadar sağlar. Bir maskeleme ekinin neyi listelediği, ekin yazıldığı yerde verilen, ortamın kendi yargısıdır.
Releases neden eki değil de rotayı değiştirir
Bir Release bir Feature ekleyebilir, ancak bir Release içinde yazılan bir ek hiçbir
values taşımaz ve core/data-masking maskelediği şeyi — patterns ve entities
— values içinde tutar; ikisini de listelemeyen bir eki durdurur. Bu yüzden maskeleme
Aggregate içinde, masking-gateway üzerinde eklenir ve üç derlemenin her birinin
grafiğinde yer alır:
release-masked.yamliçinde talep asistanının rotası üzerinde durur ve derleme tamamlanır;release-unmasked.yamliçinde hiçbir asistanın rotası üzerinde durmaz ve derleme durur;release-masking-off-route.yamliçinde yardım masasının rotası üzerinde durur ve derleme yine durur.
İkinci ve üçüncü derlemeler aynı eki taşır ve yalnızca ekin kimin rotası üzerinde olduğu bakımından farklılaşır. İkisi de durur; dolayısıyla politika derlemedeki ekleri saymıyor, rotayı okuyor.
Politikanın okudukları
Bunların tümü, derleyicinin bir ir-verdict
eklentisine verdiği derleme grafiğinden gelir; anlamlarının tümü ise eklentinin ayarlarından gelir:
- Derleyicinin sıraladığı rotalar,
input.precalculated_paths: her biriuseskenarlarıyla birleştirilmiş, sıralı bir bileşen listesidir.release-unmasked.yamlüzerinde bunlardan biriassistant → plain-gateway → gptrotasıdır. Politika her rotayı ilk bileşeninden okur; derleyici her bileşenden çıkan rotaları sıraladığı için bu yeterlidir. Politikanın kendisi hiçbir şey sıralamaz. - Her bileşenin sınıfı. Bir bileşen
class_labelayarının adlandırdığıcompliance.aggrega.ai/data-classetiketini taşıyorsa bu etiketin değeridir: yalnızcaassistantbu etiketirestricteddeğeriyle taşır. Aksi hâlde, bileşenin etiketini ve değerini taşıdığı ilkclasses_by_labelgirdisinin sınıfıdır. - Her bileşenin eklentileri,
input.graph.spec.feature_values_mapping. Rotanın kendiattached_featureslistesi bilerek okunmaz: bu liste rota üzerinde herhangi bir yere eklenmiş her Feature’ı adlandırır, bu yüzden birinin söz konusu iki bileşenin arasında olup olmadığını söyleyemez.
Sınıfı olmayan bir bileşen atlanır. Bir rotanın çizildiği yön (bir bağlantı isteği bir yöne, yanıtını öbür yöne taşır) ve ayarların aynı sırada derecelendirdiği sınıflar da atlanır.
Modelin sınıfı barındırma etiketinden gelir. gpt hiçbir sınıf etiketi taşımaz.
Onun Component’i olan core/ai-model/openai, component.aggrega.ai/hosting: managed etiketini taşır; bu, kataloğun hizmetin sağlayıcısı tarafından, kümenin
dışında çalıştırıldığına dair beyanıdır ve ayarlar bunu bir sınıfa eşler:
classes_by_label: - label: component.aggrega.ai/hosting value: managed class: publicYönetilen bir model kendisine gönderilen her şeyi tutar; bu yapı bunu herkese açık sayar.
core/ai-model/vllm gibi kendi kendine barındırılan bir model ve buradaki her iki ağ geçidi bunun yerine
self-hosted taşır ve bu yüzden sınıfı yoktur.
Rotalar sınırlıdır. Derleyici her başlangıç bileşeninden sınırlı sayıda rota listeler ve sınırın ötesinde hiçbir şey listelemez; bu yüzden bundan daha fazla rotası olan bir grafikte bir rota okunmadan kalabilir ve derleme geçebilir. Politikanın okuduğu bir rota gerçektir; bir rotanın bulunmaması onun var olmadığının kanıtı değildir. Bkz. karar rolleri.
Sınıflar derleyicinin değil, politikanındır
Derleyici compliance.aggrega.ai/data-class etiketini derleme grafiğine bir dize olarak taşır ve ona hiçbir anlam yüklemez. restricted değerinin public değerinden daha hassas olduğunu ya da bu sözcüklerden herhangi birinin bir anlam taşıdığını bilmez. Sınıflar ve sıralamaları politikanın ayarlarıdır ve üç motor dosyasında da aynıdır:
class_label: compliance.aggrega.ai/data-classrank: public: 0 internal: 1 restricted: 2Kendi sözcük dağarcığı olan bir yapı kendi değerlerini koyar: sınıflarını ve sıralarını rank altında, onları tuttuğu etiketi class_label altında, türetmelerini classes_by_label altında ve sınıf düşürücü olarak kabul ettiği Features’ı declassifying_features altında. Üç motor dosyasını da aynı biçimde değiştirin; çünkü aralarındaki bir fark, motorların kararları arasında bir farktır. Bir bileşenin taşıdığı ve rank listesinde bulunmayan bir sınıf, sınıfsız olarak okunmak yerine derlemeyi durdurur; böylece bir yazım hatası geçip gitmek yerine raporlanır. Talep asistanının etiketi Restricted olarak yazıldığında her motor release-masked.yaml dosyasını reddeder;
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull aşağıdaki reddi yazdırır ve diğer her motorun dosyası, başında o motorun adı bulunan aynı reddi yazdırır:
[… 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 violationSınıfı standart kütüphanenin değil, bu çalışma alanının kendi Component’i taşır. Bir asistanın kısıtlı veri işleyip işlemediği, LangGraph hakkında değil, bir yapının onu nasıl kullandığı hakkında bir ifadedir; bu yüzden local/ai-agent/claims-assistant,
core/ai-agent/langgraph’ı genişletir, sözleşmesini devralır ve tek etiketi ekler.
Bir Aggregate, bir bileşen örneğine etiket koyamaz; bu nedenle bir sınıf her zaman bir örneğin bildirildiği Component’in bir özelliğidir. Talep asistanı bunun yerine standart kütüphane ajanı olarak bildirildiğinde hiçbir bileşen sınıf etiketi taşımaz ve release-unmasked.yaml her motor altında derlenir; çıktı, politika olmadan derlendiğindekiyle bayt bayt aynıdır: model yine public türetir, ancak karşılaşacağı ikinci bir sınıf yoktur.
Üç motor, kuralın üç kez yazılması
| motor | bağlayan | kural |
|---|---|---|
| CLI’ya derlenmiş Rego motoru | governance-rego.yaml | with.sources altında adı verilen policies/data-class-paths.rego |
| CLI’ya derlenmiş CEL motoru | governance-cel.yaml | with.sources altında adı verilen policies/data-class-paths.cel |
| Başvuru bağdaştırıcı konuğunun arkasındaki OPA | governance-opa.yaml | Konuğa derlenmiş policies/data-class-paths-opa.rego |
Üç kopya bilinçli olarak neredeyse birbirinin aynısıdır. Her biri kuraldan bağımsız olarak ayrı ayrı yazılmıştır; böylece motorların üzerinde anlaşamadığı bir derleme bu anlaşmazlığı gösterir: aynı derlemenin bir motorda durup diğerinde tamamlanması sinyaldir. Hiçbiri diğerinden üretilmez ve tek bir ortak uygulamada birleştirilmemelidir; bu, motorları yapı gereği anlaştırır ve bu düzenin yakalamak için var olduğu farkı gizler. Her dosya bunu belirterek başlar.
Motorların farklılaştığı yerlerde onlar da farklılaşır:
- CEL kopyası bir değere ad bağlayamaz ya da bir listenin konumlarında dolaşamaz; bu nedenle ayarları bir girdi daha taşır:
positions, yani bir rotanın bileşenlerinin okunduğu 0 ile 15 arasındaki konumlar. Bundan uzun bir rota, kısmen okunmak yerine başladığı yeri belirterek derlemeyi durdurur. - OPA kopyası OPA’nın kendi araç zinciriyle önceden derlenir ve
catalog/plugin/governance/opa/1.0.0/plugin.yamldosyasının yanında konuğa gömülür; bu nedenle bağlanması ayarları sağlar, ilke dosyası sağlamaz. Bağdaştırıcı, OPA’nın ana makinesine bıraktığı yerleşik işlevlerin hiçbirini sağlamaz; bu yüzden bu kopya iletileriniconcatile birleştirir, Rego motorunun kopyası ise onlarısprintfile biçimlendirir. Bu kopyayı düzenlemek, konuk aşağıda anlatıldığı gibi yeniden derlenene kadar hiçbir derlemeyi değiştirmez.
Rego ve CEL bağlamaları, standart kütüphane kataloğunun CLI’ya derlenmiş iki motor için taşıdığı Plugin varlıklarını, governance/rego:0.9.0 ve governance/cel:0.9.0 değerlerini adlandırır ve çalışan motor, derlemeyi çalıştıran ikili dosyaya derlenmiş olandır. OPA’nın catalog/plugin/governance/ içindeki Plugin varlığı, bu çalışma alanının 1.0.0 sürümündeki kendi bildirimidir; bu yüzden bağlaması governance/opa:1.0.0 değerini adlandırır. Bir ret, bağlamanın başvurusunun sürümü atılmış son kesimiyle başlar — policy plugin "rego", "cel" ya da "opa" — ve her derleme tek bir motor bağlar; bu nedenle yazdırdığı ret o motorun adını verir. OPA konuğu her derlemede varlığının yanından okunur ve özetini hiçbir şey kaydetmediğinden, onunla yapılan her derleme konuğun doğrulanmadan çalıştığı uyarısını verir.
Her derlemenin denetlenmesi
Bu öz denetim, kullandığı ortak derleme yardımcı betiğini barındıran belgelendirme deposunun bir çalışma kopyasında çalışır; aggrega scaffold --example tarafından yazılan bir kopya bu yardımcı betiği içermez.
./check.shcheck.sh, üç Release’i üç motor altında ./build-release.sh aracılığıyla derler ve her sonucu bu sayfanın anlattığı sonuçla karşılaştırır. Bir durdurma, mesajı yukarıdaki cümle olan E0005 ile sıfır olmayan bir kodla çıkmalı ve yanında başka bir ret bulunmamalıdır; tamamlanan bir derleme ise 0 ile çıkmalı ve aynı Release’in hiçbir ilke olmadan derlenmiş hâliyle bayt bayt aynı dosyaları yazmalıdır; betik bu hâli başvuru olarak önce derler. Her motor aynı cümleye tabi tutulur. Betik her derleme için bir satır yazdırır ve herhangi bir sonuç farklıysa o derlemenin çıktısını yazdırarak 1 ile çıkar:
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.Tek bir derlemenin gerektirdiklerini gerektirir: standart kütüphane kataloğu ve hub kayıt defteri. ./build-release.sh betiğinin çözümlediği ikili dosyayı kullanır, dolayısıyla bunu AGGREGA_BIN seçer; -- sonrasındaki argümanlar her derlemeye ulaşır, böylece ./check.sh -- --offline, çektiği her şey önbelleğe alındıktan sonra betiği ağ olmadan çalıştırır. Bu dizinde bir dist/ bulunduğu sürece başlamayı reddeder, çünkü derlemelerin yazdığı ağaçları karşılaştırır ve geride hiçbirini bırakmaz. Çıkış durumu kararın tamamıdır; bu nedenle bir işlem hattı, her Release’i ayrı ayrı derlemek yerine bu betiği çalıştırabilir.
OPA konuğunun yeniden derlenmesi
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm, eklenti kitindeki başvuru OPA bağdaştırıcı konuğudur (aggrega-pdk deposundaki rust/examples/policy-opa-wasm); bağdaştırıcının kendi modülü yerine OPA’nın policies/data-class-paths-opa.rego dosyasından derlediği modülü taşır. aggrega-pdk deposunun afd9ac6c6800c34c6c47a2030f580c9681387047 sürümünden ve bağdaştırıcının derlendiği ABI crate’i olan aggrega-abi deposunun 2ececa8d3b598243f023a2a6c80b351c8d1411a1 sürümünden, rustc 1.97.1 ile, OPA 1.21.1’in derlediği modülün çevresinde derlenmiştir.
Önce modül, bu dizinden derlenir. Kuralı buraya göre göreli yoluyla adlandırmak, modülde makineye ait hiçbir şeyi değil yalnızca bu yolu tutar:
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, bu çalışma alanı hangi dizinde bulunursa bulunsun aynı kaynaktan aynı baytları derler.
Ardından konuk, mutlak yol olarak verilen ve iki depoyu yan yana tutan $BUILD adlı geçici bir dizinde derlenir; bağdaştırıcının yol bağımlılığı birinden diğerine uzanır. Üç yol eşlemesi derleme dizinini, cargo ana dizinini ve araç zincirinin kendi kaynaklarını konuğun dışında tutar:
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-wasip1ve $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm dosyasını
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm konumuna kopyalayın.
Konuk, cargo derlemesinin çıktısının olduğu gibi kendisidir. Bağdaştırıcının kendi derleme betiği isteğe bağlı bir boyut geçişi de çalıştırır; bu geçiş burada atlanır: konuğun verisini yeniden yazar ve o olmadan modül konuğun içinde bayt bayt aynı kalır. Bu sayede bir konuğun taşıdığını kuralın derlendiği sonuçla karşılaştırabilirsiniz:
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# TrueKonuğun kendi baytları, crate’lerinin derlendiği dizine ve araç zincirine de bağlıdır; bu nedenle başka bir yerde yapılan yeniden derleme, farklı bir sha256’ya sahip eşdeğer bir konuk üretir. Burada sunulanınki eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93 değeridir.
Derleyicinin yorumlamadığı yerler
Derleyici sınıf etiketini derleme grafiğine bir dize olarak yönlendirir, Aggregate’in ve Releases’in bildirdiği uses kenarları üzerinden rotaları sıralar ve ikisini de politikaya iletir. Bir sınıfı derecelendirmez, managed değerinin verinin bir sağlayıcı için kümeden çıktığı anlamına geldiğini bilmez ve core/data-masking öğesinin herhangi bir şeyi gizlediğini de bilmez. Bu anlamların her biri politikanın ayarlarıdır; başka sınıflara, başka etiketlere ve başka gizlilik derecesini düşüren Features’a sahip bir yapının aynı mekanizmayı değiştirmeden çalıştırabilmesini sağlayan da budur. Politikanın bağlandığı soket (roller, yük, karar önem dereceleri) için politika soketi sayfasına, politikanın üründeki yeri için ise Yönetişim ve uyumluluk sayfasına bakın.
Dosyalar
aggregate.yaml— iki asistan, bunların checkpointer’ı, iki gateway, model ve tanıyıcı çifti;masking-gateway’e eklenmiş maskeleme; iki asistanın damodelsoketi bağlanmamış.manifest.yaml— her bileşen türünü ve iki Feature türünü Kubernetes Recipes’lerine, talep asistanını da temel ajanın Recipe’ine bağlar. Üç Releases tarafından paylaşılır.release-masked.yaml,release-unmasked.yaml,release-masking-off-route.yaml— üç yönlendirme ve her gateway’in anahtarının okunduğu Secret.catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml— talep asistanı; sınıf etiketi eklenmişcore/ai-agent/langgraph.catalog/plugin/governance/opa/1.0.0/plugin.yaml— OPA motorunun Plugin varlığı; konuğugovernance--opa.wasmyanındadır.policies/data-class-paths.rego,policies/data-class-paths.cel,policies/data-class-paths-opa.rego— kural, her motor için bir kez.governance-rego.yaml,governance-cel.yaml,governance-opa.yaml— motor başına bir--configdosyası; her biri kuralı aynı ayarlarlair-verdictnoktasına ekler..aggrega-config.yaml— katalog arama yığını ve kayıt defteri; yönetişim eklemesi yok.build-release.sh— tek bir Release derler ve eşdeğeraggrega buildkomutunu yazdırır.check.sh— dokuz derlemenin tümünü yapar ve her sonucu denetler.