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

`assertions:` bloğu

Component, Feature, Recipe ve FeatureRecipe isteğe bağlı bir spec.assertions: alanı taşır: derleyicinin şema doğrulamasından sonra ama işlemeden önce değerlendirdiği adlandırılmış kuralların bir eşlemesi. Her anahtar, hata iletisinde görünen bir kural tanımlayıcısıdır; her değer bir Go şablon gövdesidir. Doğrudan assertions: altına yazılan tek bir şablon gövdesi bu alanın biçimine uymaz ve varlık okunurken reddedilir; bu nedenle her kural kendine ait bir ad altında yazılır. Blok, JSON Schema’nın kısa yoldan ifade edemediği alanlar arası kuralları dile getirir: hiçbir tek alanın “doğrulanan alan” olmadığı, birden çok alanı içeren değişmezler. Bu sayfa yazım dilbilgisini, değerlendirme aşamasını, şablon bağlamını ve Component / Feature doğrulamaları (sözleşmenin mimari değişmezleri) ile Recipe / FeatureRecipe doğrulamaları (belirli sağlayıcının uygulama değişmezleri) arasındaki sorumluluk ayrımını ele alır.

Alan başına kısıtlamalar (aralık, desen, enum, biçim) için schema: içinde JSON Schema’nın yerel anahtar sözcüklerini kullanın. Alan başına özel koşullar için kısa biçimin validate: alanını kullanın. Koşullu biçim için when: kullanın. assertions: alanı bunları tamamlar: gerçek alanlar arası kuralların yeridir.

Alanın yer aldığı yerler

assertions: taşıyabilen dört varlık:

  • Component — Component sözleşmesinin mimari değişmezleri.
  • Feature — Feature sözleşmesinin mimari değişmezleri.
  • Recipe — Recipe’nin altında yatan chart’ın veya modülün uygulama değişmezleri.
  • FeatureRecipe — FeatureRecipe’nin altında yatan mekanizmanın uygulama değişmezleri.

Alan her birinde isteğe bağlıdır. Alanlar arası kuralı olmayan varlıklar bu alanı tamamen dışarıda bırakır.

Doğrulamalar ne zaman çalışır

Doğrulama değerlendirme aşamaları, derleme hattında şema doğrulaması ile işleme arasında yer alır:

  1. Çözümleme: parametre doğrulaması ve enterpolasyonu, ardından schema: / usesSchema: / featuresSchema: karşısında şema doğrulaması.
  2. Topoloji oluşturma ve grafiğin sonlandırılması: grafik birleştirilir.
  3. Statik analiz: her uses: soketinin seçicisi, bağlantılarının ulaştığı bileşenlerin etiketlerine karşı denetlenir.
  4. Component / Feature doğrulamaları her örnek karşısında değerlendirilir.
  5. Recipe bağlama.
  6. Recipe / FeatureRecipe doğrulamaları bağlanmış örnek karşısında değerlendirilir.
  7. İşleme: eşleme şablonları değerlendirilir, çıktı üretilir.

İki doğrulama aşaması da herhangi bir işlemeden önce çalışır — hiçbir chart işlenmez, hiçbir Compose dosyası üretilmez. Recipe doğrulamaları çalışmadan önce bir sağlayıcıya sorulan tek şey, bağlanmış her düğümün kaynaklarına verdiği addır; bir Recipe’nin provides alanı bunu okuyabilir. Başarısız olan bir doğrulama, derlemeyi doğrulamanın kendine özgü hata mesajıyla hemen durdurur; sonraki adımlar yürütülmez.

İki aşama arasındaki ayrım, sorumluluk ayrımını yansıtır: Component düzeyindeki kurallar hangi Recipe bağlanırsa bağlansın geçerlidir, bu yüzden bağlamadan önce tetiklenir; Recipe düzeyindeki kurallar belirli bir Recipe seçimi verildiğinde geçerlidir, bu yüzden bağlamadan sonra tetiklenir.

Şablon bağlamı

Component ve Feature assertions: için şablon bağlamı, çözümlenmiş örnek durumunu sunar:

  • .values — geliştiricinin values içeriği.
  • .infra — Ops infra içeriği (Aggregate’ten veya Release’ten).
  • .uses — her biri soketinin seçicisine karşı zaten denetlenmiş, çözümlenmiş uses: bağlantıları, yazarın onları yazdığı biçimde: soket adına göre anahtarlanır ve her soketin altında, üzerindeki her bağlantının takma adına göre anahtarlanır; bu ad, yazarın bağlantıya soketin altında verdiği addır ya da liste girdisi olarak yazılmış bir bağlantı için onun hedefidir. Her bağlantının girdisi bağlantıyı tanımlar ve hedefinin yayımladığı hiçbir şeyi taşımaz. target çözümlenmiş hedefin örnek kimliğidir, alias girdinin anahtarlandığı adı yineler, origin_feature ise bağlantıyı bir Feature eki çizdiğinde bulunur. Bunların yanında, bir Recipe şablonunun aynı bağlantının .context.uses.<alias> girdisinde onları okuduğu adlar altında üç bilgi yer alır; her birinin ne tuttuğunu template-context-contract.md açıklar: labels — hedefin etiketleri, asla doğrulamanın üzerinde çalıştığı bileşenin etiketleri değil —, values, bağlantı üzerine yazılmış değerler, ve features, bağlantı üzerine yazılmış ekler; bunlar her birinin doldurduğu yuvaya göre anahtarlanır. Üçü de her bağlantıda bulunur, bağlantı hiçbirini taşımıyorsa boştur; features altındaki bir ek, aşağıda .features öğesinin bir eke verdiği biçime sahiptir. Böylece .uses.<socket>.<alias>.target bir bağlantının çözümlenmiş hedefini, .uses.<socket>.<alias>.labels o hedefin etiketlerini okur; birden çok bağlantı tutan bir soket her biri için bir girdi tutar; bu eşlem üzerinden hedefin yayımladığı bir değere ulaşmaya çalışan bir başvuru ise durur, çünkü girdi böyle bir alan taşımaz.
  • .features — yazarın her birine verdiği örnek adına göre anahtarlanmış çözümlenmiş ekler. Her girdi type (eklenen Feature’ın katalog URI’si), resolved_version (bu derleme için bağlanan sürüm) ve values (ekin kendi geliştirici niyeti içeriği) taşır. Bileşenin bağlantılarından birine yazılmış bir ek, bir Recipe şablonunun .features öğesinde olmadığı gibi bunlar arasında da yoktur: bağlantısının altında, .uses.<socket>.<alias>.features.<slot> konumunda, aynı biçimde okunur.
  • .metadata — değerlendirilen örnek: onun instance_id değeri, component türü ve resolved_version değeri, boundary_path değeri ve derlemenin aggregate_name, aggregate_version ve release_version değerleri.

Recipe ve FeatureRecipe assertions: için bağlam, Recipe’e özgü alanlar ekler:

  • .provides — değerlendirilen bileşenin çözümlenmiş provides: değerleri; doğrulama çalıştığında zaten hesaplanmıştır. Bir hedefin yayımladığı değerler bu yüzeyde yer almaz; bunun yerine çağırana işleme bağlamında ulaşır.
  • .locals — Recipe’in yerel değişkenleri.
  • .recipe.metadata — Recipe’in name ve version değerleri ile capability değeri.
  • .recipe.source — Recipe’in kaynak işaretçisi.

Alan erişimi standart Go şablon sözdizimini kullanır (.values.architecture, .uses.databases.primary.target); durdurucu yapı, Loud Guardrails sözleşmesi uyarınca {{ fail "message" }} biçimindedir — başarısız bir doğrulama, ihlal edilen değişmezi adlandıran açık ve belirli bir derleme zamanı hatası üretir.

Bu yüzey missingkey=error ile değerlendirilir. Bağlamın taşımadığı bir anahtara yapılan başvuru, boş olarak işlenmek yerine derlemeyi durdurur ve varlığı, örneği, doğrulamayı ve eksik anahtarı adlandırır. Bir doğrulamayı güvenilir kılan bu katılıktır: başvurusu boş işlenen bir yüklem hiçbir şeyle karşılaştırılıp geçer, böylece tek bir yazım hatası, doğrulamanın uygulatmak için yazıldığı kuralı sessizce devre dışı bırakırdı. Bu aynı zamanda çıplak başvurunun herhangi bir yedek değer çalışmadan önce çözümlendiği anlamına gelir; bu yüzden isteğe bağlı bir alan, varlığı denetleyen bir biçim gerektirir. Yüzey başına eksik anahtar politikası ve bu politika altında çalışan biçimler errors/fatal-halts.md sayfasında yer alır.

Bir soketteki bağlantıları okumak. Bir soketin girdisi, ne tutarsa tutsun tek bir biçime sahiptir: takma adı altında bağlantı başına bir girdi. Bir doğrulama bir bağlantıyı takma adıyla okur, soketteki her bağlantıyı görmek için soketi sayar veya üzerinde dolaşır ve soketin hiç bağlanıp bağlanmadığını sormak için soketin kendi anahtarını sınar. Aggregate girdisi şunu yazan bir bileşen verildiğinde

uses:
models:
local: { target: llama }
fast: { target: turbo }

bu doğrulamalar onu her bir yoldan okur:

assertions:
# The socket's presence: the socket key alone, however many connections it holds.
models-wired: |
{{- if not (hasKey .uses "models") -}}
{{- fail "wire at least one model to the models socket" -}}
{{- end -}}
# Every connection on the socket: a range visits each one.
every-model-distinct: |
{{- $seen := list -}}
{{- range $alias, $connection := (optional .uses "models" dict) -}}
{{- if has $connection.target $seen -}}
{{- fail (printf "connection %s points at %s, which another models connection already points at" $alias $connection.target) -}}
{{- end -}}
{{- $seen = append $seen $connection.target -}}
{{- end -}}
# One connection, by the alias it was written under; guarded, because the
# connection is optional.
fast-is-not-local: |
{{- with (optional .uses "models" dict) -}}
{{- if and (hasKey . "fast") (hasKey . "local") (eq .fast.target .local.target) -}}
{{- fail (printf "the fast and local connections both point at %s" .local.target) -}}
{{- end -}}
{{- end -}}

Bir dolaşım, bir soketin bağlantılarını Aggregate’in onları yazdığı sırayla değil, takma adlarının alfabetik sırasıyla ziyaret eder — burada fast, local öğesinden önce gelir. Tek bir bağlantı tutan bir soket de aynı şekilde okunur: .uses.models.local.target, yanında fast bağlı olsun ya da olmasın llama değerini okur; .uses.models.target ise hiçbir bağlantıyı adreslemez ve durur.

Bir bileşenin tuttuğu her bağlantının burada kendi girdisi vardır, çünkü bir bileşenin hiçbir iki bağlantısı aynı takma adı paylaşmaz — ister tek sokette ister iki sokette olsun, her birini hangi belge veya ek çizmiş olursa olsun. Derleme, herhangi bir doğrulama çalışmadan önce böyle bir çifti, iki bağlantıyı ve her birinin nerede yazıldığını adlandırarak reddeder. Bir hedefi iki kez adlandıran bir liste böyle bir çifttir, çünkü bir liste girdisinin takma adı onun hedefidir; bir bileşenin kendi local bağlantısının, aynı bileşendeki bir ekin local bağlantısının yanında bulunması da öyledir.

Bir bağlantının taşıdıklarını okumak. Bir bağlantıyla ilgili bir kural, hedefinin ne olduğunu, geliştiricinin bağlantı üzerine ne yazdığını ve ona neyin eklendiğini okuyabilir; böylece hangi Recipe bağlanırsa bağlansın geçerli olur. models soketi bir unauthenticated değeri ve bir credential yuvası bildiren bir Component, kataloğunun barındırılan hizmet olarak etiketlediği bir hedefe giden ve ne bir kimlik bilgisi ne de devre dışı bırakma seçeneği taşıyan bir bağlantıyı reddedebilir:

assertions:
hosted-model-needs-a-credential: |
{{- range $alias, $connection := (optional .uses "models" dict) -}}
{{- $hosted := eq (optional $connection.labels "component.aggrega.ai/hosting" "") "managed" -}}
{{- $optedOut := optional $connection.values "unauthenticated" false -}}
{{- if and $hosted (not (hasKey $connection.features "credential")) (not $optedOut) -}}
{{- fail (printf "the models connection %s reaches a hosted model with no credential: attach one under credential, or set unauthenticated: true on the connection" $alias) -}}
{{- end -}}
{{- end -}}

Etiket, hedefin — modelin — olan ve asla bileşenin kendisine ait olmayan labels üzerinden okunur; devre dışı bırakma seçeneği bağlantının values öğesinden okunur; kimlik bilgisi ise bağlantının features öğesi altındaki bir yuvadır. Her biri optional veya hasKey ile okunur, çünkü bir hedef böyle bir etiket, bir bağlantı da böyle bir değer taşımayabilir. Etiketin ne anlama geldiği kataloğun uzlaşımıdır: derleme dizeyi taşır, ne anlama geldiğine doğrulama karar verir.

Bir doğrulamanın .uses öğesi bir Recipe şablonunun .context.uses öğesi değildir ve biri için yazılmış bir başvuru diğerine aktarılamaz. İşleme bağlamı aynı kenarların daha zengin bir izdüşümünü taşır: yalnızca takma ada göre anahtarlanır, soket adı girdide bir alan olarak bulunur ve her hedefin yayımladığı değerler provides altında iç içe yer alır — böylece bir doğrulamanın .uses.<socket>.<alias>.target okuduğu yerde bir Recipe şablonu .context.uses.<alias>.provides.<name> okur. İki görünümün de taşıdığı bilgiler adlarını paylaşır ama yollarını paylaşmaz: .context.uses.<alias>.labels ve .uses.<socket>.<alias>.labels aynı hedefin etiketleridir; values ve features de benzer şekilde her ikisinde aynı bağlantıyı okur. Her iki doğrulama aşaması da işlemeden önce değerlendirilir; bu yüzden bir doğrulamanın bir kenara bakışı hedefinin yayımladığı hiçbir şeyi taşımaz ve bu yüzden üzerindeki bir ek provides taşımaz.

Daha geniş şablon bağlamı biçimi ve alan başına kullanılabilirlik anlambilimi için bkz. template-context-contract.md.

Bu yüzeydeki sayılar

Bir doğrulama, yazılmış bir sayıyı tam olarak bir değer şablonunun okuduğu gibi okur — bkz. Bir değer şablonundaki sayılar:

  • Karşılaştırmalar. Altı karşılaştırma, her birini hangi tür taşırsa taşısın iki sayıyı değerlerine göre okur: lt .values.replicas 1.5 ve eq .values.replicas 3.0 burada da bir değer şablonundaki gibi yanıt verir, yazılmış bir 0.1 doğrulamada yazılmış 0.1 ile eq olur ve bir sayıyı tırnak içindeki metinle karşılaştırmak aynı sözcüklerle durur.
  • Boşluk. Yazılmış bir 0 boştur: if ve with için yanlış, empty için doğrudur ve default tarafından değiştirilir. Yazarın bir değer yazıp yazmadığını — bir 0 dahil — soran bir kural bunu varlık yardımcılarıyla sorar: yazılmış bir 0 için hasKey .values "replicas" doğrudur ve optional .values "replicas" 1, 0 döndürür. Değerin sıfır olup olmadığını soran bir kural karşılaştırır: eq .values.replicas 0. Varlık ve boşluk bu iki soruyu yan yana koyar.
  • Yazdırma. Bir fail iletisinin yazdırdığı sayı, bir değer şablonunun çıktısındaki gibi görünür: tam sayı tam olarak, bu yüzden printf "%d" rakamlarını yazdırır; diğer her sayı en kısa kesin ondalık biçiminde, bu yüzden yazılmış bir 0.0000001, 0.0000001 olarak görünür.

Component / Feature doğrulamaları — mimari değişmezler

Bunlar, Component’i hangi Recipe bağlarsa bağlasın geçerli olan kuralları ifade eder. Kural, uygulamanın değil sözleşmenin bir özelliğidir.

apiVersion: aggrega.ai/v1beta1
kind: Component
metadata:
name: core/datastore/mariadb
version: 1.0.0
labels:
component.aggrega.ai/type: stateful-server
component.aggrega.ai/category: datastore
spec:
schema:
values:
architecture: { type: string, enum: [standalone, replication], default: standalone }
primary:
replicaCount: { type: integer, min: 1, max: 9, default: 1 }
secondary:
replicaCount: { type: integer, min: 0, max: 9, default: 0 }
assertions:
# Replication mode requires at least 2 secondary replicas.
replication-needs-two-secondaries: |
{{- if eq .values.architecture "replication" -}}
{{- if lt .values.secondary.replicaCount 2 -}}
{{- fail "architecture=replication requires secondary.replicaCount >= 2" -}}
{{- end -}}
{{- end -}}
# Total node count limit for safe replication coordination.
total-node-count-within-cap: |
{{- $total := add .values.primary.replicaCount .values.secondary.replicaCount -}}
{{- if gt $total 9 -}}
{{- fail (printf "total node count must not exceed 9; got %d" $total) -}}
{{- end -}}

Her iki kural da MariaDB sözleşmesinin özelliklerini ifade eder. Hangi Recipe bağlanırsa bağlansın — bir Bitnami chart’ı ya da elle yazılmış bir alternatif — kurallar geçerlidir.

{{- ... -}} boşluk denetimi önemlidir: doğrulama şablonları çıktı üretmez, yalnızca {{ fail }} aracılığıyla yan etkiler üretir. Boşluk kırpma, başarı durumunda işlenen şablon gövdesini boş tutar.

Recipe / FeatureRecipe doğrulamaları — uygulama değişmezleri

Bunlar, Recipe’in kaynak olarak kullandığı belirli chart veya modül için geçerli olan kuralları ifade eder. Kural, sözleşmenin değil uygulamanın bir özelliğidir.

apiVersion: aggrega.ai/v1beta1
kind: Recipe
metadata:
name: bitnami/datastore/mariadb/k8s
version: 1.0.0
spec:
capability: helm
implements: core/datastore/mariadb:^1.0.0
source:
# Keys this provider defines for itself; a source the build fetches is written as { kind, url, version } instead.
chart: oci://registry-1.docker.io/bitnamicharts/mariadb
version: "20.0.0"
valuesMapping:
$import: BitnamiHelpers#/mappings/MariaDBBitnamiCore
assertions:
# Bitnami chart 20.x requires an explicit ServiceMonitor namespace when
# replication and metrics scraping are both enabled.
service-monitor-namespace-required: |
{{- if and (eq .values.architecture "replication") .values.metrics.serviceMonitor.enabled -}}
{{- if not .values.metrics.serviceMonitor.namespace -}}
{{- fail "Bitnami MariaDB 20.x requires metrics.serviceMonitor.namespace when architecture=replication and metrics.serviceMonitor.enabled=true" -}}
{{- end -}}
{{- end -}}
# ARM-node incompatibility.
arm-rejects-hard-anti-affinity: |
{{- if and (eq .values.primary.podAntiAffinityPreset "hard") (eq .infra.cpu_arch "arm64") -}}
{{- fail "Bitnami MariaDB 20.x is incompatible with ARM nodes when podAntiAffinityPreset=hard; use 'soft' or omit" -}}
{{- end -}}

Her kural, Bitnami chart 20.x uygulamasına özgüdür. Farklı bir MariaDB Recipe’i bağlanırsa — elle yazılmış bir chart, alternatif bir uygulama — bu kurallar geçerli olmaz. Component düzeyindeki kurallar (replication-needs-two-secondaries, total-node-count-within-cap) ise geçerliliğini korur, çünkü bunlar sözleşmenin özellikleridir.

Component ve Recipe assertion’ları neden ayrıdır

İki rol birbirine benzer görünür (ikisi de alanlar arası kurallarda {{ fail }} durdurmaları çalıştırır), ancak sorumluluk ayrımı taşıyıcı bir işleve sahiptir:

  • Component assertion’ları sözleşmenin parçasıdır. Geliştirici secondary.replicaCount: 1 ile birlikte architecture: replication yazdığında, hangi Recipe bağlanırsa bağlansın derleme reddedilir. İleride gelecek alternatif bir Recipe bunu değiştirmez.
  • Recipe assertion’ları uygulamanın parçasıdır. Mimar Recipe olarak Bitnami chart 20.x’i seçtiğinde, chart’ın kendine özgü tuhaflıkları vardır (serviceMonitor.namespace gereksinimi, ARM düğümü hatası). Bunlar farklı bir chart için geçerli değildir.

Her iki kural türünü Component üzerinde bir arada tutmak, sözleşmeyi uygulamalarıyla iç içe geçirirdi: Component’in hangi uygulama kurallarını uygulayacağını bilmesi için bağlı Recipe’ine başvurması gerekir ve bu da Component-Recipe ayrımını bozardı. Kuralları doğal konumlarına ayırmak sorumluluk modelini temiz tutar. Ayırmanın çalışma zamanı maliyeti ihmal edilebilir düzeydedir; her iki aşama da render işleminden önce çalışır ve varlığı, örneği ve kuralı belirten aynı Loud Guardrails tanılamasıyla, E0033 ile durur.

fail mesajı uzlaşımı

{{ fail "..." }} argümanı, kullanıcıya gösterilen derleme zamanı hatasıdır. Uzlaşımlar:

  • Kısıtı adlandırın — “architecture=replication requires secondary.replicaCount >= 2”.
  • İlgili olduğunda değeri belirtin — “total node count must not exceed 9; got 12”.
  • Mümkün olduğunda düzeltmeyi önerin — “use ‘soft’ or omit the field”.
  • Jargondan kaçının — okuyucu, doğrulamayı yazan mimar değil, Aggregate’i yazan geliştiricidir.

Uzun ya da değer içeren mesajlar için printf kullanın:

{{- fail (printf "field %s exceeds limit: got %d, max is %d" .field .value .max) -}}

Derleyici mesajı, varlık adı, doğrulamanın kaynak konumu ve başarısız olan mesajla birlikte Loud Guardrails hata biçiminde gösterir. Tanılama, geliştiricinin kök nedeni belirleyip düzeltmesine yetecek kadar belirgindir.

Bir yazarın sensitive: true olarak bildirdiği bir değer, mesaj onu nerede alıntılarsa alıntılasın o mesajda <redacted> olarak görünür; bu nedenle bildirilmiş bir alanın değerini mesajda adlandırmak güvenlidir: tanılama yine kuralı ve alanı adlandırır, yalnızca değer gizlenir. Sonucu böyle bir değerin ne içerdiğine bağlı olan bir doğrulama — bir sabitle karşılaştırma, bir önek testi — mesajı yerine hata metninin gizlendiğini bildirir. Kuralın tamamı vocabulary/compact-form-authoring.md “Bir reddin bildirilmiş bir değer hakkında söyledikleri” bölümündedir.

assertions: alanının yerini tutmadıkları

assertions:, alanlar arası kuralların yeridir. Şunların yerini tutmaz:

  • schema: içindeki JSON Schema kısıtları — alan başına kurallar (aralık, desen, enum, biçim, tür) JSON Schema’nın yerel anahtar sözcüklerine aittir.
  • Kompakt biçimdeki validate: alanı — tek alan kapsamlı, alan başına özel yüklemler. Kural belirli bir alana uygulanıyorsa validate: kullanın; kural, hiçbir tek alanın “doğrulanan alan” olmadığı birden çok alanı içeriyorsa assertions: kullanın.
  • Kompakt biçimdeki when: alanı — koşullu biçim (bir alt ağacın kısıtlarının uygulanıp uygulanmadığı). Biçim farklılıkları için when: kullanın; değerlerin birleşimi, serbest biçimli bir yüklemle daha iyi ifade edilen bir şekilde geçersizse assertions: kullanın.
  • Çalışma zamanı denetimleri — assertions: yalnızca derleme zamanında çalışır. Çalışma zamanındaki küme durumuna bağlı her şey (canlı IP’ler, vault içerikleri, çalışma zamanındaki pod durumu) belirlenimci işaretçi dizeleri olarak ifade edilmelidir (AOT saflığı sözleşmesine bakın).

Uygulamalı örnekler

Minimal — tek bir mimari kural

spec:
assertions:
replication-needs-two-secondaries: |
{{- if and (eq .values.architecture "replication") (lt .values.secondary.replicaCount 2) -}}
{{- fail "replication requires secondary.replicaCount >= 2" -}}
{{- end -}}

Orta ölçekli — çok kurallı Component sözleşmesi

spec:
assertions:
# Replication minimum.
replication-needs-two-secondaries: |
{{- if eq .values.architecture "replication" -}}
{{- if lt .values.secondary.replicaCount 2 -}}
{{- fail "architecture=replication requires secondary.replicaCount >= 2" -}}
{{- end -}}
{{- end -}}
# Total node limit.
total-node-count-within-cap: |
{{- $total := add .values.primary.replicaCount .values.secondary.replicaCount -}}
{{- if gt $total 9 -}}
{{- fail (printf "total node count exceeds 9: got %d (primary=%d, secondary=%d)"
$total .values.primary.replicaCount .values.secondary.replicaCount) -}}
{{- end -}}
# A ServiceMonitor scrapes the metrics exporter, so it needs one.
service-monitor-needs-metrics: |
{{- if and .values.metrics.serviceMonitor.enabled (not .values.metrics.enabled) -}}
{{- fail "metrics.serviceMonitor.enabled=true requires metrics.enabled=true" -}}
{{- end -}}

Üretim — uygulama kurallarına sahip Recipe

spec:
assertions:
# Bitnami 20.x: serviceMonitor namespace requirement.
service-monitor-namespace-required: |
{{- if and (eq .values.architecture "replication") .values.metrics.serviceMonitor.enabled -}}
{{- if not .values.metrics.serviceMonitor.namespace -}}
{{- fail "Bitnami MariaDB 20.x requires metrics.serviceMonitor.namespace when architecture=replication and metrics.serviceMonitor.enabled=true" -}}
{{- end -}}
{{- end -}}
# TLS certificate consistency.
tls-needs-both-certificate-files: |
{{- if .values.tls.enabled -}}
{{- if not (and .values.tls.certFilename .values.tls.certKeyFilename) -}}
{{- fail "tls.enabled=true requires both tls.certFilename and tls.certKeyFilename" -}}
{{- end -}}
{{- end -}}
# Replication-mode storage class consistency.
replication-needs-one-storage-class: |
{{- if eq .values.architecture "replication" -}}
{{- $primaryClass := .values.primary.persistence.storageClass -}}
{{- $secondaryClass := .values.secondary.persistence.storageClass -}}
{{- if and $primaryClass $secondaryClass (ne $primaryClass $secondaryClass) -}}
{{- fail "replication mode requires primary and secondary to use the same storageClass" -}}
{{- end -}}
{{- end -}}

Araç entegrasyonu

  • aggrega build, assertion’ları şema doğrulaması ile render arasında değerlendirir; başarısız olan bir assertion, derlemeyi assertion’ın {{ fail }} mesajıyla durdurur.
  • aggrega validate, aynı doğruluk denetimini render öncesinde, artifact yazmadan uygular — kaynağı getirilmeyen bir Recipe için gerçek derleme hattını sentezlenmiş asgari bir Aggregate, Manifest ve Release etrafında çalıştırır; böylece hatalı biçimlendirilmiş bir assertion şablonu ya da bilinmeyen bir alana başvuran bir assertion, bir doğruluk hatası olarak ortaya çıkar; kaynağı getirilen bir Recipe’nin assertion’ları ise bir derleme tarafından değerlendirilir. Orada fail çağıran bir assertion, mesajını taşıyan bir uyarı olarak raporlanır ve denetim geçer: sentezlenmiş Release, gerçek bir Release’in belirlediği değerler yerine yer tutucular ve varsayılanlar içerir; bu nedenle assertion hakkındaki karar bir derlemeye bırakılır — bkz. başarısız bir assertion bir uyarıdır. (aggrega lint, assertion doğruluğunu değil, yayımlama uzlaşımlarını kapsar.)
  • Sprig şablon desteğine sahip IDE’ler .values.X başvurularını vurgular; IDE entegrasyonu yapılandırıldığında üzerine gelme belgeleri şema tanımına çözümlenir.