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

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

örnekkatalog Component’iburada ne olduğu
assistantlocal/ai-agent/claims-assistanttalep 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
helpdeskcore/ai-agent/langgraphhiçbir sınıf taşımayan yardım masası asistanı
checkpointercore/datastore/valkeyher iki asistanın çalışma durumunu tuttuğu yer
masking-gatewaycore/gateway/litellmtek bir takma ad (chat) sunan ve core/data-masking eklenmiş bir AI ağ geçidi
plain-gatewaycore/gateway/litellmhiçbir şey eklenmemiş aynı ağ geçidi
gptcore/ai-model/openaiOpenAI’ın yönetilen API’si, bir referans olarak erişilir: küme içinde onun için hiçbir şey çalışmaz
analyzer, anonymizercore/security/presidio-analyzer, core/security/presidio-anonymizermaskelemenin ç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:

Releasetalep asistanının trafiğiyardım masası asistanının trafiğiderleme
release-masked.yamlmasking-gateway üzerindenplain-gateway üzerindentamamlanır
release-unmasked.yamlplain-gateway üzerindenplain-gateway üzerindendurur
release-masking-off-route.yamlplain-gateway üzerindenmasking-gateway üzerindendurur

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:

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

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd policy-data-class-route

Derleme

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

Aynı 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 kendi catalog/ 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 --catalog ile 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 eklentiyi default_registry değerinin belirttiği kayıt defterinden, hub.aggrega.ai adresinden ç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 violation

CEL 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 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

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

Maskeleme 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 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]

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

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.yaml içinde talep asistanının rotası üzerinde durur ve derleme tamamlanır;
  • release-unmasked.yaml içinde hiçbir asistanın rotası üzerinde durmaz ve derleme durur;
  • release-masking-off-route.yaml iç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 biri uses kenarlarıyla birleştirilmiş, sıralı bir bileşen listesidir. release-unmasked.yaml üzerinde bunlardan biri assistant → plain-gateway → gpt rotası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_label ayarının adlandırdığı compliance.aggrega.ai/data-class etiketini taşıyorsa bu etiketin değeridir: yalnızca assistant bu etiketi restricted değeriyle taşır. Aksi hâlde, bileşenin etiketini ve değerini taşıdığı ilk classes_by_label girdisinin sınıfıdır.
  • Her bileşenin eklentileri, input.graph.spec.feature_values_mapping. Rotanın kendi attached_features listesi 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: public

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

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

Sı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ı

motorbağlayankural
CLI’ya derlenmiş Rego motorugovernance-rego.yamlwith.sources altında adı verilen policies/data-class-paths.rego
CLI’ya derlenmiş CEL motorugovernance-cel.yamlwith.sources altında adı verilen policies/data-class-paths.cel
Başvuru bağdaştırıcı konuğunun arkasındaki OPAgovernance-opa.yamlKonuğ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.yaml dosyası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 iletilerini concat ile birleştirir, Rego motorunun kopyası ise onları sprintf ile 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.

Terminal window
./check.sh

check.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 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.

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:

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

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

ve $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:

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

Konuğ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 da model soketi 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ğu governance--opa.wasm yanı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 --config dosyası; her biri kuralı aynı ayarlarla ir-verdict noktası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ğer aggrega build komutunu yazdırır.
  • check.sh — dokuz derlemenin tümünü yapar ve her sonucu denetler.