`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:
- Çözümleme: parametre doğrulaması ve enterpolasyonu, ardından
schema:/usesSchema:/featuresSchema:karşısında şema doğrulaması. - Topoloji oluşturma ve grafiğin sonlandırılması: grafik birleştirilir.
- Statik analiz: her
uses:soketinin seçicisi, bağlantılarının ulaştığı bileşenlerin etiketlerine karşı denetlenir. - Component / Feature doğrulamaları her örnek karşısında değerlendirilir.
- Recipe bağlama.
- Recipe / FeatureRecipe doğrulamaları bağlanmış örnek karşısında değerlendirilir.
- İş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ştiricininvaluesiçeriği..infra— Opsinfraiç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,aliasgirdinin anahtarlandığı adı yineler,origin_featureise 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, vefeatures, 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;featuresaltındaki bir ek, aşağıda.featuresöğesinin bir eke verdiği biçime sahiptir. Böylece.uses.<socket>.<alias>.targetbir bağlantının çözümlenmiş hedefini,.uses.<socket>.<alias>.labelso 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 girditype(eklenen Feature’ın katalog URI’si),resolved_version(bu derleme için bağlanan sürüm) vevalues(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: onuninstance_iddeğeri,componenttürü veresolved_versiondeğeri,boundary_pathdeğeri ve derlemeninaggregate_name,aggregate_versionverelease_versiondeğ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’innameveversiondeğerleri ilecapabilitydeğ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.5veeq .values.replicas 3.0burada da bir değer şablonundaki gibi yanıt verir, yazılmış bir0.1doğrulamada yazılmış0.1ileeqolur ve bir sayıyı tırnak içindeki metinle karşılaştırmak aynı sözcüklerle durur. - Boşluk. Yazılmış bir
0boştur:ifvewithiçin yanlış,emptyiçin doğrudur vedefaulttarafından değiştirilir. Yazarın bir değer yazıp yazmadığını — bir0dahil — soran bir kural bunu varlık yardımcılarıyla sorar: yazılmış bir0içinhasKey .values "replicas"doğrudur veoptional .values "replicas" 1,0dö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
faililetisinin yazdırdığı sayı, bir değer şablonunun çıktısındaki gibi görünür: tam sayı tam olarak, bu yüzdenprintf "%d"rakamlarını yazdırır; diğer her sayı en kısa kesin ondalık biçiminde, bu yüzden yazılmış bir0.0000001,0.0000001olarak 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/v1beta1kind: Componentmetadata: name: core/datastore/mariadb version: 1.0.0 labels: component.aggrega.ai/type: stateful-server component.aggrega.ai/category: datastorespec: 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/v1beta1kind: Recipemetadata: name: bitnami/datastore/mariadb/k8s version: 1.0.0spec: 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: 1ile birliktearchitecture: replicationyazdığı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.namespacegereksinimi, 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ıyorsavalidate:kullanın; kural, hiçbir tek alanın “doğrulanan alan” olmadığı birden çok alanı içeriyorsaassertions: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çinwhen:kullanın; değerlerin birleşimi, serbest biçimli bir yüklemle daha iyi ifade edilen bir şekilde geçersizseassertions: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. Oradafailç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.Xbaşvurularını vurgular; IDE entegrasyonu yapılandırıldığında üzerine gelme belgeleri şema tanımına çözümlenir.