Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Blok `assertions:`

Component, Feature, Recipe, dan FeatureRecipe memiliki field opsional spec.assertions: — sebuah map berisi aturan bernama yang dievaluasi oleh compiler setelah validasi skema tetapi sebelum rendering. Setiap kunci adalah pengenal aturan yang muncul dalam pesan kegagalan; setiap nilai adalah isi templat Go. Satu isi templat yang ditulis langsung di bawah assertions: bukan bentuk field ini dan ditolak saat entitas dibaca, sehingga setiap aturan ditulis dengan namanya sendiri. Blok ini menyatakan aturan lintas field yang tidak dapat diungkapkan secara ringkas oleh JSON Schema: invarian yang melibatkan beberapa field ketika tidak ada satu field pun yang merupakan “field yang sedang divalidasi.” Halaman ini membahas tata bahasa penulisan, fase evaluasi, konteks templat, serta pembagian tanggung jawab antara assertion Component / Feature (invarian arsitektural dari kontrak) dan assertion Recipe / FeatureRecipe (invarian implementasi dari provider tertentu).

Untuk batasan per field (rentang, pola, enum, format), gunakan kata kunci bawaan JSON Schema di dalam schema:. Untuk predikat kustom per field, gunakan field validate: pada bentuk ringkas. Untuk bentuk bersyarat, gunakan when:. Field assertions: melengkapi semua ini — field tersebut adalah tempat bagi aturan lintas field yang sesungguhnya.

Tempat field ini muncul

Empat entitas yang dapat memuat assertions::

  • Component — invarian arsitektural dari kontrak Component.
  • Feature — invarian arsitektural dari kontrak Feature.
  • Recipe — invarian implementasi dari chart atau modul yang mendasari Recipe tersebut.
  • FeatureRecipe — invarian implementasi dari mekanisme yang mendasari FeatureRecipe tersebut.

Field ini bersifat opsional pada masing-masing entitas. Entitas tanpa aturan lintas field sama sekali tidak mencantumkan field ini.

Kapan asersi dijalankan

Fase evaluasi asersi berada di antara validasi skema dan perenderan dalam pipeline kompilasi:

  1. Resolusi: validasi dan interpolasi parameter, kemudian validasi skema terhadap schema: / usesSchema: / featuresSchema:.
  2. Konstruksi topologi dan finalisasi graf: graf dirakit.
  3. Analisis statis: selector setiap socket uses: diperiksa terhadap label komponen-komponen yang dijangkau koneksinya.
  4. Asersi Component / Feature dievaluasi terhadap setiap instans.
  5. Pengikatan Recipe.
  6. Asersi Recipe / FeatureRecipe dievaluasi terhadap instans yang terikat.
  7. Perenderan: templat pemetaan dievaluasi, keluaran dihasilkan.

Kedua fase asersi dijalankan sebelum perenderan apa pun — tidak ada chart yang dirender, tidak ada berkas Compose yang dibuat. Satu-satunya hal yang ditanyakan kepada penyedia sebelum asersi Recipe dijalankan adalah nama yang diberikannya untuk sumber daya setiap node yang terikat, yang dapat dibaca oleh provides milik sebuah Recipe. Asersi yang gagal langsung menghentikan build dengan pesan galat spesifik dari asersi tersebut; langkah-langkah berikutnya tidak dijalankan.

Pemisahan antara kedua fase mencerminkan pemisahan tanggung jawab: aturan tingkat Component berlaku terlepas dari Recipe mana yang terikat, sehingga aturan tersebut dijalankan sebelum pengikatan; aturan tingkat Recipe berlaku untuk pilihan Recipe tertentu, sehingga aturan tersebut dijalankan setelah pengikatan.

Konteks templat

Untuk assertions: pada Component dan Feature, konteks templat menyediakan status instans yang telah di-resolve:

  • .values — konten values dari developer.
  • .infra — konten infra dari Ops (dari Aggregate atau Release).
  • .uses — koneksi uses: yang telah di-resolve, masing-masing sudah diperiksa terhadap selector socket-nya, dalam bentuk yang ditulis penulis: dikunci berdasarkan nama socket, dan di bawah setiap socket berdasarkan alias dari setiap koneksi padanya — nama yang diberikan penulis untuk koneksi tersebut di bawah socket, atau, untuk koneksi yang ditulis sebagai entri daftar, targetnya. Entri setiap koneksi menjelaskan koneksi tersebut dan tidak membawa apa pun yang dipublikasikan targetnya. target adalah id instans dari target yang telah di-resolve, alias mengulang nama yang menjadi kuncinya, dan origin_feature ada ketika sebuah lampiran Feature yang membentuk koneksi tersebut. Di sampingnya terdapat tiga fakta dengan nama yang sama seperti yang dibaca templat Recipe pada entri .context.uses.<alias> dari koneksi yang sama, dengan template-context-contract.md menjelaskan isi masing-masing: labels — label milik target, tidak pernah label komponen tempat asersi dijalankan — values, nilai yang ditulis pada koneksi, dan features, lampiran yang ditulis pada koneksi, dikunci berdasarkan slot yang diisi masing-masing. Ketiganya ada pada setiap koneksi, kosong bila koneksi tidak membawa apa pun, dan sebuah lampiran di bawah features memiliki bentuk yang diberikan .features di bawah. Jadi .uses.<socket>.<alias>.target membaca target yang telah di-resolve dari satu koneksi, .uses.<socket>.<alias>.labels membaca label target tersebut, socket yang memuat beberapa koneksi memuat satu entri untuk masing-masing, dan referensi yang menjangkau melalui map ini untuk mencari nilai yang dipublikasikan target akan menghentikan build, karena entri tersebut tidak membawa field seperti itu.
  • .features — lampiran yang telah di-resolve, dikunci berdasarkan nama instans yang diberikan penulis untuk masing-masing. Setiap entri membawa type (URI katalog dari Feature yang dilampirkan), resolved_version (versi yang terikat untuk build ini), dan values (konten niat developer milik lampiran itu sendiri). Lampiran yang ditulis pada salah satu koneksi komponen tidak termasuk di antaranya, persis seperti ia tidak termasuk dalam .features milik templat Recipe: lampiran tersebut dibaca di bawah koneksinya, pada .uses.<socket>.<alias>.features.<slot>, dalam bentuk yang sama.
  • .metadata — instans yang sedang dievaluasi: instance_id-nya, tipe component dan resolved_version-nya, boundary_path-nya, serta aggregate_name, aggregate_version dan release_version milik build.

Untuk assertions: pada Recipe dan FeatureRecipe, konteks menambahkan field khusus Recipe:

  • .provides — nilai provides: yang telah di-resolve dari komponen yang sedang dievaluasi, yang sudah dihitung saat asersi dijalankan. Nilai yang dipublikasikan oleh target tidak ada pada permukaan ini; nilai tersebut mencapai pemanggil melalui konteks render.
  • .locals — locals milik Recipe.
  • .recipe.metadata — name dan version Recipe, serta capability-nya.
  • .recipe.source — penunjuk sumber Recipe.

Akses field menggunakan sintaks templat Go standar (.values.architecture, .uses.databases.primary.target); konstruksi penghenti adalah {{ fail "message" }} sesuai kontrak Loud Guardrails — asersi yang gagal menghasilkan error build-time yang jelas dan spesifik yang menyebutkan invarian yang dilanggar.

Permukaan ini dievaluasi dengan missingkey=error. Referensi ke kunci yang tidak dibawa konteks akan menghentikan build — dengan menyebutkan entitas, instans, asersi, dan kunci yang tidak ada — alih-alih dirender sebagai kosong. Ketegasan inilah yang membuat asersi dapat dipercaya: predikat yang referensinya dirender kosong akan membandingkan dengan kekosongan dan lolos, sehingga satu salah ketik saja akan diam-diam menonaktifkan aturan yang ingin ditegakkan oleh asersi tersebut. Hal ini juga berarti referensi polos di-resolve sebelum fallback apa pun dapat berjalan, sehingga field opsional memerlukan bentuk yang memperhatikan keberadaannya; errors/fatal-halts.md memuat kebijakan kunci hilang per permukaan dan bentuk-bentuk yang berfungsi di bawahnya.

Membaca koneksi pada sebuah socket. Entri sebuah socket memiliki satu bentuk apa pun isinya: satu entri per koneksi, di bawah aliasnya. Sebuah asersi membaca satu koneksi berdasarkan aliasnya, menghitung atau melakukan range atas socket untuk melihat setiap koneksi padanya, dan menguji kunci socket itu sendiri untuk menanyakan apakah socket tersebut terhubung sama sekali. Misalkan sebuah komponen yang entri Aggregate-nya menulis

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

asersi berikut membacanya dengan masing-masing cara:

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

Range mengunjungi koneksi sebuah socket dalam urutan alfabetis aliasnya — fast sebelum local di sini — bukan dalam urutan penulisannya oleh Aggregate. Socket yang memuat satu koneksi dibaca dengan cara yang sama: .uses.models.local.target membaca llama baik fast terhubung di sampingnya maupun tidak, dan .uses.models.target tidak menunjuk koneksi apa pun dan menghentikan build.

Setiap koneksi yang dimiliki komponen memiliki entri sendiri di sini, karena tidak ada dua koneksi dari satu komponen yang berbagi alias — pada satu socket atau dua, dokumen atau lampiran mana pun yang membentuk masing-masing. Build menolak pasangan seperti itu, dengan menyebutkan kedua koneksi dan tempat masing-masing ditulis, sebelum asersi apa pun dijalankan. Daftar yang menyebutkan satu target dua kali adalah pasangan seperti itu, karena alias entri daftar adalah targetnya; demikian pula koneksi local milik komponen itu sendiri di samping koneksi local milik sebuah lampiran pada komponen yang sama.

Membaca apa yang dibawa sebuah koneksi. Aturan tentang sebuah koneksi dapat membaca apa targetnya, apa yang ditulis developer pada koneksi tersebut, dan apa yang dilampirkan padanya, sehingga aturan itu berlaku Recipe mana pun yang terikat. Sebuah Component yang socket models-nya mendeklarasikan nilai unauthenticated dan slot credential dapat menolak koneksi ke target yang dilabeli katalognya sebagai layanan terkelola bila koneksi tersebut tidak membawa kredensial maupun opt-out:

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

Label dibaca dari labels, yang merupakan milik target — milik model — dan tidak pernah milik komponen itu sendiri; opt-out dibaca dari values milik koneksi; dan kredensial adalah slot di bawah features milik koneksi. Masing-masing dibaca dengan optional atau hasKey, karena target mungkin tidak membawa label seperti itu dan koneksi tidak membawa nilai seperti itu. Makna label tersebut adalah konvensi katalog: build membawa string tersebut dan asersi yang menentukan maknanya.

.uses milik asersi bukanlah .context.uses milik templat Recipe, dan referensi yang ditulis untuk salah satunya tidak berlaku untuk yang lain. Konteks render membawa proyeksi yang lebih kaya dari edge yang sama: dikunci hanya berdasarkan alias, dengan nama socket sebagai field pada entri, dan dengan nilai yang dipublikasikan setiap target bersarang di bawah provides — sehingga templat Recipe membaca .context.uses.<alias>.provides.<name> sedangkan asersi membaca .uses.<socket>.<alias>.target. Fakta yang dibawa kedua tampilan berbagi nama tetapi tidak berbagi path: .context.uses.<alias>.labels dan .uses.<socket>.<alias>.labels adalah label target yang sama, dan values serta features juga membaca koneksi yang sama pada keduanya. Kedua fase asersi dievaluasi sebelum rendering, itulah sebabnya tampilan asersi atas sebuah edge tidak membawa apa pun yang dipublikasikan targetnya, dan mengapa lampiran padanya tidak membawa provides.

Untuk bentuk konteks templat yang lebih luas dan semantik ketersediaan per field, lihat template-context-contract.md.

Angka pada permukaan ini

Asersi membaca angka yang ditulis penulis persis seperti templat nilai — lihat Angka dalam templat nilai:

  • Perbandingan. Keenam perbandingan membaca dua angka berdasarkan nilai, apa pun jenis yang membawa masing-masing: lt .values.replicas 1.5 dan eq .values.replicas 3.0 menjawab di sini sama seperti pada templat nilai, 0.1 yang ditulis penulis eq dengan 0.1 yang ditulis dalam asersi, dan membandingkan angka dengan teks berkutip akan berhenti dengan kata-kata yang sama.
  • Kekosongan. 0 yang ditulis penulis adalah kosong: false bagi if dan with, true bagi empty, dan diganti oleh default. Aturan yang menanyakan apakah penulis menulis suatu nilai — termasuk 0 — bertanya dengan helper keberadaan: untuk 0 yang ditulis penulis, hasKey .values "replicas" bernilai true dan optional .values "replicas" 1 mengembalikan 0. Aturan yang menanyakan apakah nilainya nol melakukan perbandingan: eq .values.replicas 0. Keberadaan dan kekosongan menyandingkan kedua pertanyaan itu.
  • Pencetakan. Angka yang dicetak pesan fail terbaca seperti dalam output templat nilai: bilangan bulat tetap utuh, sehingga printf "%d" mencetak digit-digitnya, dan angka lainnya dalam bentuk desimal eksak terpendek, sehingga 0.0000001 yang ditulis penulis terbaca 0.0000001.

Asersi Component / Feature — invarian arsitektural

Asersi ini menyatakan aturan yang berlaku terlepas dari Recipe mana yang mengikat Component. Aturan tersebut merupakan properti dari kontrak, bukan implementasi.

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

Kedua aturan menyatakan properti dari kontrak MariaDB. Recipe apa pun yang mengikat — chart Bitnami, alternatif buatan sendiri — aturan tersebut tetap berlaku.

Kontrol spasi {{- ... -}} itu penting: template asersi tidak menghasilkan keluaran, hanya efek samping melalui {{ fail }}. Pemangkasan spasi menjaga isi template yang dirender tetap kosong jika asersi berhasil.

Assertion Recipe / FeatureRecipe — invarian implementasi

Assertion ini menyatakan aturan yang berlaku untuk chart atau modul spesifik yang menjadi sumber Recipe. Aturan tersebut merupakan properti implementasi, bukan kontrak.

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

Setiap aturan bersifat spesifik untuk implementasi chart Bitnami 20.x. Jika Recipe MariaDB lain yang terikat — chart yang dibuat sendiri, implementasi alternatif — aturan-aturan ini tidak berlaku. Aturan tingkat Component (replication-needs-two-secondaries, total-node-count-within-cap) tetap berlaku karena aturan tersebut merupakan properti kontrak.

Mengapa assertion Component dan Recipe dipisahkan

Kedua peran tersebut tampak serupa (keduanya menjalankan penghentian {{ fail }} pada aturan lintas bidang), tetapi pembagian tanggung jawabnya bersifat menentukan:

  • Assertion Component adalah bagian dari kontrak. Ketika pengembang menulis architecture: replication dengan secondary.replicaCount: 1, build akan menolak terlepas dari Recipe mana yang terikat. Recipe alternatif di masa mendatang tidak mengubah hal tersebut.
  • Assertion Recipe adalah bagian dari implementasi. Ketika arsitek memilih chart Bitnami 20.x sebagai Recipe, chart tersebut memiliki kekhasan tertentu (persyaratan serviceMonitor.namespace, bug node ARM). Hal-hal ini tidak berlaku untuk chart lain.

Menempatkan kedua jenis aturan bersama-sama pada Component akan menjalin kontrak dengan implementasinya: Component perlu merujuk Recipe yang terikat padanya untuk mengetahui aturan implementasi mana yang harus ditegakkan, sehingga merusak pemisahan Component-Recipe. Memisahkan aturan ke lokasi alaminya menjaga model tanggung jawab tetap bersih. Biaya runtime dari pemisahan ini dapat diabaikan; kedua fase dijalankan sebelum rendering dan berhenti dengan diagnostik Loud Guardrails yang sama, E0033, yang menyebutkan entitas, instans, dan aturannya.

Konvensi pesan fail

Argumen untuk {{ fail "..." }} adalah galat waktu build yang ditampilkan kepada pengguna. Konvensi:

  • Sebutkan batasannya — “architecture=replication requires secondary.replicaCount >= 2”.
  • Sebutkan nilainya bila relevan — “total node count must not exceed 9; got 12”.
  • Sarankan perbaikannya bila memungkinkan — “use ‘soft’ or omit the field”.
  • Hindari jargon — pembacanya adalah developer yang menulis Aggregate, bukan arsitek yang menulis asersi tersebut.

Untuk pesan yang panjang atau yang memuat nilai, gunakan printf:

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

Compiler menampilkan pesan tersebut dalam format galat Loud Guardrails beserta nama entitas, lokasi sumber asersi, dan pesan yang gagal. Diagnostiknya cukup spesifik bagi developer untuk mengidentifikasi dan memperbaiki akar masalahnya.

Nilai yang dideklarasikan penulis sebagai sensitive: true terbaca <redacted> dalam pesan tersebut di mana pun pesan itu mengutipnya, sehingga menyebutkan nilai suatu field yang dideklarasikan dalam pesan itu aman: diagnostik tetap menyebutkan aturan dan field-nya, dan hanya nilainya yang ditahan. Asersi yang hasilnya bergantung pada isi nilai semacam itu — perbandingan dengan sebuah literal, uji prefiks — melaporkan bahwa teks kegagalannya ditahan, alih-alih menampilkan pesannya. vocabulary/compact-form-authoring.md “What a refusal says about a declared value” memuat aturan selengkapnya.

Hal yang tidak digantikan oleh assertions:

assertions: adalah tempat aturan lintas-field. Blok ini tidak menggantikan:

  • Batasan JSON Schema di dalam schema: — aturan per field (rentang, pola, enum, format, tipe) ditempatkan pada kata kunci bawaan JSON Schema.
  • Field validate: bentuk ringkas — predikat kustom per field dengan cakupan satu field. Gunakan validate: jika aturan berlaku untuk field tertentu; gunakan assertions: jika aturan melibatkan beberapa field dan tidak ada satu field pun yang merupakan “field yang sedang divalidasi.”
  • Field when: bentuk ringkas — bentuk kondisional (apakah batasan suatu subtree berlaku). Gunakan when: untuk variasi bentuk; gunakan assertions: jika kombinasi nilai tidak valid dengan cara yang lebih tepat dinyatakan sebagai predikat bebas.
  • Pemeriksaan runtime — assertions: hanya dijalankan pada waktu kompilasi. Apa pun yang bergantung pada status klaster saat runtime (IP aktif, isi vault, status pod saat runtime) harus dinyatakan sebagai string penunjuk yang deterministik (lihat kontrak kemurnian AOT).

Contoh lengkap

Minimal — satu aturan arsitektural

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

Menengah — kontrak Component dengan beberapa aturan

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

Produksi — Recipe dengan aturan implementasi

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

Integrasi perkakas

  • aggrega build mengevaluasi asersi di antara validasi skema dan rendering; asersi yang gagal menghentikan build dengan pesan {{ fail }} dari asersi tersebut.
  • aggrega validate menerapkan pemeriksaan kebenaran yang sama sebelum render tanpa menulis artefak — untuk Recipe yang sumbernya tidak diambil, perintah ini menjalankan pipeline kompilasi yang sebenarnya di sekitar Aggregate, Manifest, dan Release minimal yang disintesis, sehingga templat asersi yang salah bentuk atau asersi yang merujuk ke field yang tidak dikenal muncul sebagai galat kebenaran; asersi dari Recipe yang sumbernya diambil dievaluasi oleh build. Asersi di sana yang memanggil fail dilaporkan sebagai peringatan yang membawa pesannya, dan pemeriksaan tetap lolos: Release yang disintesis berisi placeholder dan nilai default, bukan nilai yang ditetapkan oleh Release sebenarnya, sehingga keputusan atas asersi tersebut diserahkan kepada build — lihat asersi yang gagal adalah peringatan. (aggrega lint mencakup konvensi publikasi, bukan kebenaran asersi.)
  • IDE yang mendukung templat Sprig menyorot referensi .values.X; dokumentasi hover mengarah ke definisi skema bila integrasi IDE telah dikonfigurasi.