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

Size ait bir webhook sertifikası: bir chart'ın ürettiği Secret'ı dışarıda bırakmak

Bu ileri düzey bir örnektir. Çoğu Recipes’in hiç ihtiyaç duymadığı Recipe alanı omits:’u öğretir: bu alan, olduğu gibi aldığınız ve Release’inizin dağıtmaması gereken bir belgeyi oluşturan bir kaynak içindir; burada bu kaynak, bir registry’den getirilen bir chart’tır. Bu durumla karşılaştığınızda bu alana başvurun.

Çalışma alanı, Envoy Gateway’in uzantı sunucusu olarak çağırdığı denetleyici olan Envoy AI Gateway denetim düzlemini, standart kütüphanedeki helm/envoy-ai-gateway-operator Recipe’i aracılığıyla, webhook sertifikasının alabileceği her iki modda da oluşturur. Bu modlardan birinde projenin chart’ı, her oluşturmada yeniden ürettiği bir anahtarı ve bir sertifikayı tutan bir Secret oluşturur ve Recipe’in omits: girdisi bu Secret’ı derlemenin dışında bırakır. İki Releases daha, bu alan çevresinde karşılaşabileceğiniz iki durmayı gösterir: girdinin önlemek için var olduğu durma ve artık hiçbir şeyle eşleşmeyen bir girdinin ürettiği durma.

Ne oluşturur

core/gateway/envoy-ai-gateway-operator içindeki tek bir bileşen, ai-controller, Kubernetes manifestlerine derlenir. Aggregate her Release için aynıdır. Her Release denetleyiciyi envoy-ai-gateway-system içine yerleştirir ve sertifika modunu seçer; her Manifest ise Recipe’yi seçer:

ReleaseManifest’inin bağladığısertifika modusonuç
release-cert-manager.yamlhelm/envoy-ai-gateway-operator, standart kütüphanedencert-manageroluşturulur
release-own-certificate.yamlhelm/envoy-ai-gateway-operator, standart kütüphanedenai-gateway-webhook-tls adlı Secretoluşturulur, bir derlemeden diğerine bayt bayt aynı
release-negative-without-omits.yamlhelm/envoy-ai-gateway-operator-without-omits, bu çalışma alanındanai-gateway-webhook-tls adlı Secret--verify-determinism ile derlendiğinde E0058 ile durur
release-negative-stale-omits.yamlhelm/envoy-ai-gateway-operator-stale-omits, bu çalışma alanındanai-gateway-webhook-tls adlı SecretE0334 ile durur

Bu çalışma alanının catalog/ dizinindeki iki Recipe, standart kütüphanedekinin öğretim amaçlı varyantlarıdır. Her biri aynı chart’ı aynı sürümde kaynak olarak alır ve sertifika modunu aynı eşlemeyle seçer: birinde hiç omits: girdisi yoktur, diğerinde ise chart’ın oluşturmadığı bir Secret’ı adlandıran bir girdi vardır. Kendi adlarını taşıdıkları için standart kütüphanedeki Recipe’yi gölgelemek yerine onun yanında dururlar ve bir Release’in adlandırdığı Manifest, hangisiyle derleneceğine karar verir.

Webhook’a sertifika vermenin iki yolu

Denetleyici, kümenin API sunucusunun TLS üzerinden çağırdığı bir mutating webhook çalıştırır; bu nedenle webhook bir sertifika sunar. Component, bunu sağlamak için tek bir infra anahtarıyla, webhook_tls_secret ile seçilen iki yol sunar:

  • Ayarlanmamış, varsayılan. Chart, denetleyicinin Service adı için bir cert-manager Certificate nesnesi ve onu imzalayan kendinden imzalı Issuer nesnesini oluşturur; bu nedenle cert-manager’ın kümede zaten çalışıyor olması gerekir.
  • Ayarlanmış. Webhook, anahtarın adlandırdığı Secret’taki sertifikayı sunar; bu Secret’ı dağıtımı yapan kişi önceden denetleyicinin ad alanında oluşturur ve içinde tls.crt, tls.key ve ca.crt bulunur. Hiçbir Certificate ve hiçbir Issuer oluşturulmaz ve cert-manager gerekmez: denetleyici başladığında, Secret’ın ca.crt değerini, API sunucusunun webhook’u doğrularken kullandığı CA paketi olarak webhook yapılandırmasına yazar.

release-own-certificate.yaml bunu ayarlar:

components:
ai-controller:
annotations:
aggrega.ai/namespace: envoy-ai-gateway-system
infra:
webhook_tls_secret: ai-gateway-webhook-tls

Kendi sertifikası kipinde chart’ın oluşturdukları

Anahtar ayarlandığında projenin chart’ı o adlı Secret’ı controller’ın pod’una /certs konumunda bağlar; ayrıca aynı adla kendine ait bir Secret da oluşturur. Bu Secret, chart’ın oluşturma sırasında ürettiği bir CA sertifikasını, bir sertifikayı ve bir özel anahtarı içerir. İki derleme iki farklı anahtar üretir; bu nedenle çıktı bir derlemeden diğerine bayt bayt aynı olmaktan çıkar. Çıktının uygulanması da operatörün oluşturduğu Secret’ı chart’ın ürettiğiyle değiştirir.

Chart, projenin kayıt deposundan alınır ve olduğu gibi kullanılır; bir Recipe, alınmış bir chart’ı düzenlemez. Bunun yerine standart kütüphane Recipe’i Secret’ı dışarıda bırakır:

# helm/envoy-ai-gateway-operator:1.0.0, its omits: field
omits:
- kind: Secret
name: "{{ .infra.webhook_tls_secret }}"
when: '{{ ne (optional .infra "webhook_tls_secret" "") "" }}'
  • kind ve name, belgeyi chart’ın oluşturduğu biçimiyle adlandırır: metadata.name değeri Release’in ayarladığı ad olan bir Secret. name şablonu chart’a verilen aynı infra anahtarını okur; böylece giriş, Release ona ne ad verirse versin üretilen Secret’ı adlandırır.
  • when, girişin yalnızca bu kipte uygulanmasını sağlar. cert-manager kipinde chart böyle bir Secret oluşturmaz; koşul orada yanlıştır ve when: değeri yanlış olan bir giriş, herhangi bir denetim yapılmadan önce atılır. Tek bir Recipe her iki kipe de hizmet eder.

Chart’ın geri kalanı yine eksiksiz oluşturulur ve derlemenin yazdıklarından yalnızca eşleşen belge atılır. Burada onu dışarıda bırakmak doğrudur, çünkü controller’ın pod’unun bağladığı Secret operatörün kendisine aittir ve ayrıca oluşturulmuştur. Bu alan bir belgeyi dışarıda bırakır; çıktının geri kalanının dayandığı şeyin başka bir yerde var olup olmadığını denetlemez.

Ö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 ai-gateway-own-webhook-certificate

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

Terminal window
cd ai-gateway-own-webhook-certificate

Derleme

Terminal window
aggrega build --release release-cert-manager.yaml --auto-pull
aggrega build --release release-own-certificate.yaml --auto-pull
aggrega build --release release-negative-without-omits.yaml --auto-pull --verify-determinism # halts; exits 1
aggrega build --release release-negative-stale-omits.yaml --auto-pull # halts; exits 1

.aggrega-config.yaml, çalışma alanının iki öğretici Recipes’i barındıran kendi catalog/ dizinini listeler; Component ve standart kütüphane Recipe’i, bu dosyanın adlandırdığı varsayılan kayıt defteri olan hub.aggrega.ai’den çözümlenir. Standart kütüphane kataloğunun bir çalışma kopyası (nereden edinilir) varsa, onun aggrega-catalog dizinini --catalog ile adlandırın; böylece her varlık bu iki dizinden çözümlenir.

--auto-pull, derleme sırasında her Release’in lockfile’ını doldurur; lockfile’lar ve oluşturulan çıktı üretilir, dağıtılmaz. Bir lockfile’ı çözümlemek, controller’ın chart’ını Docker Hub’dan getirir; bu nedenle her Release’in ilk derlemesi ağ bağlantısı gerektirir.

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. Çalışma alanı klasöründe henüz `ai-gateway-own-webhook-certificate` klasörü yoksa `scaffold` aracını `example` değeri `ai-gateway-own-webhook-certificate` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `ai-gateway-own-webhook-certificate` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla çağırın — `release-cert-manager.yaml`, `release-own-certificate.yaml` — her seferinde `workspace_root` değeri `ai-gateway-own-webhook-certificate`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olarak ayarlanmış şekilde. Ardından `aggrega build` komutunu çalıştıran ve onun `--verify-determinism` bayrağını alan `cli-build` aracını `workspace_root` değeri `ai-gateway-own-webhook-certificate`, `release` değeri `release-negative-without-omits.yaml`, `auto_pull` değeri true ve `verify_determinism` değeri true olarak ayarlanmış şekilde çağırın: bunun reddedilmesi amaçlanmıştır, bu yüzden reddi bana okuyun. Ardından `build` aracını ilk iki derlemedeki gibi, `release` değeri `release-negative-stale-omits.yaml` olarak ayarlanmış şekilde çağırın: bunun da reddedilmesi amaçlanmıştır, bu yüzden o reddi de bana okuyun. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `ai-gateway-own-webhook-certificate/dist/` altındadır.

İki sertifika modu, oluşturulduğu hâliyle

--auto-pull ile derlenen release-cert-manager.yaml, bu örneğin klasörünü <workspace> temsil edecek şekilde şunu yazdırır:

Pull complete: release-cert-manager.lock (entities=5, source_artifacts=1, external_inputs=0)
[… omitted: the total build time, which differs per run]
Build completed: 16 files written to <workspace>/dist

ve ardından ls dist/helm şunları listeler:

ai-controller
ai-controller-certificate-envoy-ai-gateway-system-self-signed-cert-for-mutating-webhook.yaml
ai-controller-clusterrole-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrole-envoy-ai-gateway-inference-pool-reader-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-envoy-ai-gateway-inference-pool-reader-binding-envoy-ai-gateway-system.yaml
ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-issuer-envoy-ai-gateway-system-self-signed-issuer-for-mutating-webhook.yaml
ai-controller-mutatingwebhookconfiguration-envoy-ai-gateway-gateway-pod-mutator-envoy-ai-gateway-system.yaml
ai-controller-service-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-serviceaccount-envoy-ai-gateway-system-ai-controller.yaml

ai-controller dizini, Recipe’in chart’ın yanında ürettiği altı AI Gateway kaynak tanımını içerir. Aynı şekilde derlenen release-own-certificate.yaml şunu yazdırır:

Pull complete: release-own-certificate.lock (entities=5, source_artifacts=1, external_inputs=0)
[… omitted: the total build time, which differs per run]
Build completed: 14 files written to <workspace>/dist

ve ls dist/helm şunları listeler:

ai-controller
ai-controller-clusterrole-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrole-envoy-ai-gateway-inference-pool-reader-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-ai-controller-envoy-ai-gateway-system.yaml
ai-controller-clusterrolebinding-envoy-ai-gateway-inference-pool-reader-binding-envoy-ai-gateway-system.yaml
ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-mutatingwebhookconfiguration-envoy-ai-gateway-gateway-pod-mutator-envoy-ai-gateway-system.yaml
ai-controller-service-envoy-ai-gateway-system-ai-controller.yaml
ai-controller-serviceaccount-envoy-ai-gateway-system-ai-controller.yaml

cert-manager modunun ağacı bir Certificate ve bir Issuer içerir, Secret içermez. Kendi sertifika modunun ağacı ise üçünden hiçbirini içermez: chart bu modda ikisini de oluşturmadığı için ne Certificate ne de Issuer vardır; Recipe’in girdisi chart’ın oluşturduğunu dışarıda bıraktığı için de Secret yoktur. Denetleyicinin bunun yerine bağladığı, Release’in adını verdiği Secret’tır:

dist/helm/ai-controller-deployment-envoy-ai-gateway-system-ai-controller.yaml
[… omitted: the chart's licence header, four comment lines]
apiVersion: apps/v1
kind: Deployment
metadata:
name: ai-controller
namespace: envoy-ai-gateway-system
[… omitted: the labels and annotations every rendered document carries]
spec:
[… omitted: the replica count, the selector, and the pod template's labels, service account, host-network setting and security settings]
containers:
- name: ai-gateway-helm
[… omitted: the container's security settings, its image and pull policy, and its ports]
args:
[… omitted: the controller's logging, external-processor, gateway-namespace and endpoint arguments]
- --tlsCertDir=/certs
- --tlsCertName=tls.crt
- --tlsKeyName=tls.key
[… omitted: the controller's webhook-port, leader-election, prefix, cache, namespace, quota and session-encryption arguments]
[… omitted: the probes, the environment and the resources]
volumeMounts:
- mountPath: /certs
name: certs
readOnly: true
volumes:
- name: certs
secret:
secretName: ai-gateway-webhook-tls

Denetleyici sertifikasını /certs yolundan, yani certs biriminden okur; bu birim ai-gateway-webhook-tls Secret’ıdır: derlemenin yazıldığı gibi aktardığı ve küme tarafından pod başlarken çözümlenen bir ad.

Bir derlemeden ötekine aynı baytlar

--verify-determinism ile ikinci kez derlendiğinde release-own-certificate.yaml şunu yazdırır:

[… omitted: the total build time, which differs per run]
Build completed: 14 files written to <workspace>/dist

--verify-determinism, her bileşeni aynı girdiden iki kez işler ve iki işleme birbirinden farklıysa durur. Burada geçer ve yazdığı ağaç, ilk derlemenin yazdığı ağaçla bayt bayt aynıdır. Her ikisi de, chart’ın her seferinde yeniden ürettiği tek belge çıktıya hiç ulaşmadığı için geçerlidir.

Girdi olmadan: determinizmi denetleyen derleme durur

release-negative-without-omits.yaml, öğretici Recipe’i hiçbir omits: girdisi olmadan bağlayan manifest-without-omits.yaml üzerinden dağıtılan kendi sertifikalı Release’dir. --verify-determinism ile derlendiğinde:

[… omitted: the pull's lines]
[TRANSLATION_ERROR E0058] instance ai-controller
rendering node "ai-controller"
caused by: wasmengine: node "ai-controller" (provider "helm"): two renders of identical input produced different output: provider render is not deterministic

Derleme 1 ile çıkar. Denetleyicinin iki işlemesi birbirinden farklıdır, çünkü chart her seferinde farklı bir anahtar ve sertifika üretmiştir. Pull işlemi de sabitlenmesi gereken dış girdileri bulmak için Release’i işler ve orada da aynı durmayla karşılaşır; atlanan pull satırlarının cümleyi ikinci kez taşımasının nedeni budur. Kilit dosyası yine de yazılır.

Bayrak olmadan derlendiğinde aynı Release tamamlanır. Ağacı, kendi sertifikalı Release’in ağacının içerdiği chart belgelerini içerir (öğretici Recipe’in üretmediği kaynak tanımları hariç) ve bir belge daha, chart’ın ürettiği Secret’ı:

dist/helm/ai-controller-secret-envoy-ai-gateway-system-ai-gateway-webhook-tls.yaml
apiVersion: v1
kind: Secret
metadata:
name: ai-gateway-webhook-tls
namespace: envoy-ai-gateway-system
[… omitted: the labels and annotations every rendered document carries]
data:
[… omitted: the three base64-encoded entries ca.crt, tls.crt and tls.key]

İki kez derlediğinizde iki ağaç tam olarak bu üç değerde farklılaşır. Sıradan bir derleme her bileşeni bir kez işler; bu nedenle hangi anahtarı ürettiyse onu yazar ve farkı fark etmez; farkı görünür kılan denetimdir. Uygulandığında bu dosya, operatörün oluşturduğu Secret’ın yerini alırdı.

Durma şu başlık altında açıklanır: A provider rendered the same input twice and produced different output (Bir sağlayıcı aynı girdiyi iki kez işledi ve farklı çıktı üretti). Buradaki düzeltme, fark kaynak olarak kullandığınız bir chart’ın ürettiği bir değer olduğunda iki çıkış yolunu adlandırır: değeri chart’ın sunduğu bir ayar aracılığıyla sağlamak ya da üretilen belge Release’in yayımlamaması gereken bir belgeyse onu bir omits: girdisiyle dışarıda bırakmak; standart kütüphane Recipe’inin benimsediği yanıt budur.

Hiçbir şeyle eşleşmeyen bir girdi

release-negative-stale-omits.yaml, manifest-stale-omits.yaml üzerinden dağıtılan kendi sertifikalı Release’tir; bu Manifest, girdisi Secret’ı anahtara göre değil, denetleyicinin işlenmiş adına göre adlandıran öğretici Recipe’yi bağlar:

# catalog/recipe/helm/envoy-ai-gateway-operator-stale-omits/1.0.0/recipe.yaml, its omits: field
omits:
- kind: Secret
name: "{{ .context.rendered_name }}-webhook-tls"
when: '{{ ne (optional .infra "webhook_tls_secret" "") "" }}'

Derlendiğinde:

[… omitted: the pull's lines]
[TRANSLATION_ERROR E0334] instance ai-controller
rendering node "ai-controller"
caused by: [CATALOG_ERROR] instance ai-controller
an omits entry left out nothing the source rendered (node "ai-controller", provider "provider/helm:0.8.8-75-g9e6ef4e0", "envoy-ai-gateway-operator-stale-omits" omits[0], kind "Secret", name "ai-controller-webhook-tls"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause

Sağlayıcı, derlemeyi çalıştıran ikili dosyanın sürümüyle adlandırılır; bu nedenle kendi çalıştırmanızda orada kendi ikili dosyanızın sürümü görünür.

Derleme 1 ile çıkar ve çekme işleminin satırları, yukarıdakiyle aynı nedenle aynı cümleyi taşır. Mesaj soldan sağa, nereye bakılacağını gösterecek şekilde okunur: bileşen, onu işleyen sağlayıcı, girdiyi bildiren Recipe ve girdinin omits: listesindeki 0’dan başlayarak sayılan konumu, ardından girdinin çözümlendiği tür ve ad. when: koşulu bu kipte doğrudur, dolayısıyla girdi uygulanır; girdinin adı ai-controller-webhook-tls olarak işlenir, chart ise Secret’ını ai-gateway-webhook-tls olarak adlandırmıştır ve girdi hiçbir şeyi dışarıda bırakmamıştır.

Uygulanan her girdi bir şeyi dışarıda bırakmalıdır ve derleme, bırakmayan bir girdide durur; çünkü hiçbir şeyle eşleşmeyen bir girdi, kaynak hakkında artık doğru olmayan bir ifadedir. Olağan neden, belgeyi yeniden adlandıran bir kaynak yükseltmesidir. Yeniden adlandırılan belge bu durumda çıktıda yeni adıyla yer alır — girdinin dışarıda tutmak için yazıldığı belgenin ta kendisi — ve durma, onun fark edilmeden yayımlanmasını engelleyen şeydir. Bu derlemede chart’ın ürettiği Secret böyle bir belgedir: girdi onu dışarıda tutmak için yazılmıştır ve başka bir şeyi adlandırır. Bir girdiyi düzeltmek için onu kaynağın şu anda işlediği şeyle karşılaştırın: release-negative-without-omits.yaml dosyasının denetim olmadan yaptığı gibi girdi kaldırılmış olarak derleyin ve adı chart’ın yazdığı dosyadan okuyun.

E0334, tanılama başvurusunda omit-matched-nothing olarak listelenir ve An omits entry left out nothing the source rendered (Bir omits girdisi kaynağın işlediği hiçbir şeyi dışarıda bırakmadı) altında açıklanır. Alanın kendisi — her girdi alanı, şablon bağlamı, bir Release’in bir girdi hakkında neye karar verebileceği ve hangi sağlayıcıların onu dikkate aldığı — Recipe → omits: alanı bölümündedir.

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, dört Release’i ./build-release.sh üzerinden derler ve her sonucu bu sayfanın anlattığı sonuçla karşılaştırır. Başarılı olan her Release’i iki kez derler, ikincisinde --verify-determinism ile: iki derleme de 0 ile çıkmalı ve aynı dosyaları bayt bayt aynı biçimde yazmalıdır; ağaç da, işlenen her belgenin türüne göre sayıldığında, cert-manager kipinde bir Certificate ve bir Issuer içermeli ve hiç Secret içermemeli, kendi sertifikası kipinde ise bu üçünden hiçbirini içermemeli ve denetleyici Deployment’ının certs birimi ai-gateway-webhook-tls adını vermelidir. Bir koruma Release’i sıfırdan farklı bir kodla çıkmalı ve bu sayfanın onun için gösterdiği kısa kodu ve cümleyi taşıyan tam olarak bir durdurma üretmelidir; eskimiş girdinin durdurması da girdiyi adlandırmalıdır. Betik her Release için bir satır yazdırır ve herhangi bir sonuç farklıysa o derlemenin çıktısını yazdırarak 1 ile çıkar:

RELEASE EXIT EXPECTED VERDICT
------------------------------------------------------------------------------------------------
release-cert-manager.yaml 0/0 pass OK: byte-identical twice; Certificate=1 Issuer=1 Secret=0
release-own-certificate.yaml 0/0 pass OK: byte-identical twice; Certificate=0 Issuer=0 Secret=0; certs volume: ai-gateway-webhook-tls
release-negative-without-omits.yaml 1 halt OK: E0058, the expected sentence
release-negative-stale-omits.yaml 1 halt OK: E0334, the expected sentence, naming "envoy-ai-gateway-operator-stale-omits" omits[0]
check: every build ended as expected.

Tek bir derlemenin gerektirdiklerini gerektirir: standart kütüphane kataloğu ve chart için ağ. ./build-release.sh betiğinin çözümlediği ikili dosyayı kullanır, dolayısıyla onu AGGREGA_BIN seçer; -- sonrasındaki argümanlar her derlemeye ulaşı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.

Derleyicinin yorumlamadığı yerler

Derleyici bir Secret’in ne olduğunu, controller’ın onunla ne yaptığını ya da bir chart’ın neden bir tane ürettiğini bilmez. Girdinin şablonlarını herhangi bir Recipe şablonunu değerlendirdiği gibi değerlendirir, bunların çözümlendiği tür ve adı bileşenin girdisiyle birlikte helm sağlayıcısına iletir; sağlayıcı da eşleşen işlenmiş belgeleri çıkarır ve her girdinin kaç belge çıkardığını bildirir. Derleyici ai-gateway-webhook-tls adlı nesneyi hiçbir zaman bir kümede aramaz, hiçbir zaman oluşturmaz ve controller’ın okuduğu üç girdiyi içerip içermediğini hiçbir zaman denetlemez: ad, Release’in sağladığı, chart’ın değerlerine ve girdiye aktarılan bir dizedir. Secret’in controller başlamadan önce var olmasını sağlamak, dağıtımı yapan tarafın işidir.

Dosyalar

  • aggregate.yaml — AI ağ geçidi denetleyicisi, tek bileşen; her Release için aynıdır.
  • manifest.yaml — denetleyiciyi standart kütüphanedeki Recipe’e bağlar; başarılı iki Release tarafından paylaşılır.
  • manifest-without-omits.yaml, manifest-stale-omits.yaml — onu iki öğretici Recipe’ten birine bağlar.
  • release-cert-manager.yaml, release-own-certificate.yaml — iki sertifika modu.
  • release-negative-without-omits.yaml, release-negative-stale-omits.yaml — her bir öğretici Recipe üzerinden kendi sertifikası modu; ikisi de durur.
  • catalog/recipe/helm/envoy-ai-gateway-operator-without-omits/1.0.0/ — hiçbir omits: girdisi olmayan öğretici Recipe ve onun chart’ını sabitleyen entity.lock.
  • catalog/recipe/helm/envoy-ai-gateway-operator-stale-omits/1.0.0/ — girdisi hiçbir şeyle eşleşmeyen öğretici Recipe ve onun entity.lock dosyası.
  • .aggrega-config.yaml — katalog arama yığını ve kayıt defteri.
  • build-release.sh — tek bir Release derler ve eşdeğer aggrega build komutunu yazdırır.
  • check.sh — dördünü de derler ve her birinin sonucunu denetler.