Khối `assertions:`
Component, Feature, Recipe và FeatureRecipe có một trường spec.assertions: tùy chọn — một map các quy tắc có tên mà trình biên dịch đánh giá sau bước xác thực schema nhưng trước bước kết xuất. Mỗi khóa là một định danh quy tắc xuất hiện trong thông báo lỗi; mỗi giá trị là phần thân của một Go template. Một phần thân template duy nhất viết trực tiếp dưới assertions: không đúng cấu trúc của trường và bị từ chối khi đọc thực thể, vì vậy mỗi quy tắc đều được viết dưới một tên riêng. Khối này biểu đạt các quy tắc liên trường mà JSON Schema không thể diễn đạt gọn gàng: các bất biến liên quan đến nhiều trường, nơi không có trường nào là “trường đang được xác thực.” Trang này trình bày ngữ pháp viết, giai đoạn đánh giá, ngữ cảnh template, và sự phân chia trách nhiệm giữa assertion của Component / Feature (các bất biến kiến trúc của hợp đồng) và assertion của Recipe / FeatureRecipe (các bất biến triển khai của provider cụ thể).
Với các ràng buộc trên từng trường (khoảng giá trị, mẫu, enum, định dạng), hãy dùng các từ khóa gốc của JSON Schema bên trong schema:. Với các vị từ tùy chỉnh trên từng trường, hãy dùng trường validate: của dạng rút gọn. Với cấu trúc có điều kiện, hãy dùng when:. Trường assertions: bổ sung cho các cơ chế này — đây là nơi dành cho các quy tắc liên trường thực sự.
Nơi trường này xuất hiện
Bốn thực thể có thể mang assertions::
- Component — các bất biến kiến trúc của hợp đồng Component.
- Feature — các bất biến kiến trúc của hợp đồng Feature.
- Recipe — các bất biến triển khai của chart hoặc module nền tảng của Recipe.
- FeatureRecipe — các bất biến triển khai của cơ chế nền tảng của FeatureRecipe.
Trường này là tùy chọn trên mỗi thực thể. Các thực thể không có quy tắc liên trường thì bỏ hẳn trường này.
Khi nào các assertion chạy
Các giai đoạn đánh giá assertion nằm giữa bước xác thực schema và bước kết xuất trong quy trình biên dịch:
- Phân giải: xác thực và nội suy tham số, sau đó xác thực schema theo
schema:/usesSchema:/featuresSchema:. - Xây dựng cấu trúc liên kết và hoàn tất đồ thị: đồ thị được lắp ráp.
- Phân tích tĩnh: selector của mỗi socket
uses:được kiểm tra đối chiếu với các label của những component mà các kết nối của nó đi tới. - Các assertion của Component / Feature được đánh giá trên từng instance.
- Ràng buộc Recipe.
- Các assertion của Recipe / FeatureRecipe được đánh giá trên instance đã được ràng buộc.
- Kết xuất: các template ánh xạ được đánh giá, đầu ra được tạo ra.
Hai giai đoạn assertion chạy trước mọi bước kết xuất — không chart nào được kết xuất, không tệp Compose nào được tạo. Điều duy nhất được hỏi từ một provider trước khi các assertion của Recipe chạy là tên mà provider đặt cho tài nguyên của từng node đã được ràng buộc, tên mà provides của một Recipe có thể đọc. Một assertion thất bại sẽ dừng bản build ngay lập tức với thông báo lỗi cụ thể của assertion đó; các bước tiếp theo không được thực thi.
Việc tách thành hai giai đoạn phản ánh sự phân chia trách nhiệm: các quy tắc ở cấp Component áp dụng bất kể Recipe nào được ràng buộc, nên chúng kích hoạt trước khi ràng buộc; các quy tắc ở cấp Recipe áp dụng khi đã chọn một Recipe cụ thể, nên chúng kích hoạt sau khi ràng buộc.
Ngữ cảnh template
Với assertions: của Component và Feature, ngữ cảnh template cung cấp trạng thái instance đã được phân giải:
.values— nội dungvaluescủa nhà phát triển..infra— nội dunginfracủa Ops (từ Aggregate hoặc Release)..uses— các kết nốiuses:đã được phân giải, mỗi kết nối đã được kiểm tra đối chiếu với selector của socket của nó, theo đúng dạng mà tác giả viết chúng: được đánh khóa theo tên socket, và dưới mỗi socket theo alias của từng kết nối trên socket đó — tên mà tác giả đặt cho kết nối dưới socket, hoặc, với kết nối được viết dưới dạng một mục danh sách, là target của nó. Mục của mỗi kết nối mô tả kết nối đó và không mang bất cứ thứ gì mà target của nó đã công bố.targetlà id instance của target đã phân giải,aliaslặp lại tên dùng làm khóa, vàorigin_featurecó mặt khi một attachment Feature đã tạo ra kết nối. Bên cạnh chúng là ba dữ kiện mang đúng tên mà một template Recipe dùng để đọc chúng trên mục.context.uses.<alias>của cùng kết nối, nơi template-context-contract.md mô tả nội dung của từng dữ kiện:labels— các label của target, không bao giờ là label của component mà assertion chạy trên đó —values, các giá trị được viết trên kết nối, vàfeatures, các attachment được viết trên kết nối, được đánh khóa theo slot mà mỗi attachment lấp vào. Cả ba đều có mặt trên mọi kết nối, rỗng khi kết nối không mang gì, và một attachment dướifeaturescó dạng mà.featuresmô tả bên dưới. Vì vậy.uses.<socket>.<alias>.targetđọc target đã phân giải của một kết nối,.uses.<socket>.<alias>.labelsđọc các label của target đó, một socket chứa nhiều kết nối sẽ có một mục cho mỗi kết nối, và một tham chiếu đi qua map này để tìm một giá trị mà target đã công bố sẽ dừng build, vì mục đó không có trường như vậy..features— các attachment đã được phân giải, được đánh khóa theo tên instance mà tác giả đặt cho từng attachment. Mỗi mục mangtype(URI danh mục của Feature được gắn),resolved_version(phiên bản được gắn cho lần build này), vàvalues(nội dung ý định của nhà phát triển dành riêng cho attachment). Một attachment được viết trên một trong các kết nối của component không nằm trong số đó, đúng như nó không nằm trong.featurescủa một template Recipe: nó được đọc dưới kết nối của nó, tại.uses.<socket>.<alias>.features.<slot>, theo cùng dạng này..metadata— instance đang được đánh giá:instance_idcủa nó, kiểucomponentvàresolved_versioncủa nó,boundary_pathcủa nó, cùngaggregate_name,aggregate_versionvàrelease_versioncủa bản build.
Với assertions: của Recipe và FeatureRecipe, ngữ cảnh bổ sung các trường dành riêng cho Recipe:
.provides— các giá trịprovides:đã được phân giải của component đang được đánh giá, đã được tính xong vào lúc assertion chạy. Các giá trị đã công bố của một target không nằm trên bề mặt này; thay vào đó chúng đến với bên gọi trong ngữ cảnh render..locals— các local của Recipe..recipe.metadata—namevàversioncủa Recipe, cùngcapabilitycủa nó..recipe.source— con trỏ nguồn của Recipe.
Truy cập trường dùng cú pháp template Go tiêu chuẩn (.values.architecture, .uses.databases.primary.target); cấu trúc dừng build là {{ fail "message" }} theo hợp đồng Loud Guardrails — một assertion thất bại tạo ra lỗi rõ ràng, cụ thể tại thời điểm build, nêu tên bất biến bị vi phạm.
Bề mặt này được đánh giá với missingkey=error. Một tham chiếu tới khóa mà ngữ cảnh không có sẽ dừng build — nêu tên thực thể, instance, assertion và khóa bị thiếu — thay vì render thành rỗng. Chính sự nghiêm ngặt đó làm cho assertion đáng tin cậy: một vị từ có tham chiếu render ra rỗng sẽ so sánh với hư không và vượt qua, nên chỉ một lỗi chính tả cũng âm thầm vô hiệu hóa quy tắc mà assertion được viết ra để thực thi. Điều đó cũng có nghĩa là tham chiếu trần được phân giải trước khi bất kỳ giá trị dự phòng nào kịp chạy, nên một trường tùy chọn cần một dạng có kiểm tra sự tồn tại; errors/fatal-halts.md trình bày chính sách khóa thiếu theo từng bề mặt và các dạng hoạt động được dưới chính sách đó.
Đọc các kết nối trên một socket. Mục của một socket có cùng một dạng bất kể nó chứa gì: một mục cho mỗi kết nối, dưới alias của kết nối đó. Một assertion đọc một kết nối theo alias của nó, đếm hoặc duyệt socket để thấy mọi kết nối trên đó, và kiểm tra khóa của chính socket để hỏi xem nó có được nối hay không. Cho một component có mục Aggregate viết
uses: models: local: { target: llama } fast: { target: turbo }các assertion sau đọc nó theo từng cách:
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 -}}Một vòng range duyệt các kết nối của socket theo thứ tự bảng chữ cái của alias — ở đây fast trước local — chứ không theo thứ tự mà Aggregate đã viết. Một socket chỉ chứa một kết nối cũng được đọc theo cùng cách: .uses.models.local.target đọc ra llama dù fast có được nối bên cạnh hay không, còn .uses.models.target không trỏ tới kết nối nào và dừng build.
Mỗi kết nối mà một component có đều có mục riêng ở đây, vì không có hai kết nối nào của cùng một component dùng chung một alias — dù trên một socket hay hai socket, bất kể tài liệu hay attachment nào đã tạo ra từng kết nối. Build từ chối một cặp như vậy, nêu tên cả hai kết nối và nơi mỗi kết nối được viết, trước khi bất kỳ assertion nào chạy. Một danh sách nêu cùng một target hai lần là một cặp như vậy, vì alias của một mục danh sách chính là target của nó; kết nối local của chính một component đặt cạnh kết nối local của một attachment trên cùng component đó cũng vậy.
Đọc những gì một kết nối mang theo. Một quy tắc về kết nối có thể đọc target của nó là gì, nhà phát triển đã viết gì trên kết nối, và thứ gì được gắn vào nó, nên quy tắc đó đúng bất kể Recipe nào được gắn. Một Component có socket models khai báo giá trị unauthenticated và slot credential có thể từ chối một kết nối tới target mà danh mục của nó gắn label là dịch vụ được lưu trữ khi kết nối đó không mang credential cũng không mang lựa chọn từ chối:
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 được đọc từ labels, vốn là của target — của model — và không bao giờ là của chính component; lựa chọn từ chối được đọc từ values của kết nối; và credential là một slot dưới features của kết nối. Mỗi thứ được đọc bằng optional hoặc hasKey, vì một target có thể không mang label như vậy và một kết nối có thể không mang giá trị như vậy. Ý nghĩa của label là quy ước của danh mục: build mang chuỗi đó đi và assertion quyết định nó có nghĩa là gì.
.uses của một assertion không phải là .context.uses của một template Recipe, và một tham chiếu viết cho bên này không dùng được cho bên kia. Ngữ cảnh render mang một phép chiếu phong phú hơn của cùng các cạnh: chỉ được đánh khóa theo alias, với tên socket là một trường trên mục, và với các giá trị đã công bố của mỗi target lồng dưới provides — nên một template Recipe đọc .context.uses.<alias>.provides.<name> trong khi một assertion đọc .uses.<socket>.<alias>.target. Các dữ kiện mà cả hai góc nhìn cùng mang có chung tên nhưng không chung đường dẫn: .context.uses.<alias>.labels và .uses.<socket>.<alias>.labels là các label của cùng một target, và values và features cũng đọc cùng một kết nối ở cả hai bên. Cả hai giai đoạn assertion đều được đánh giá trước khi render, đó là lý do góc nhìn của assertion về một cạnh không mang gì mà target của nó đã công bố, và lý do một attachment trên cạnh đó không mang provides.
Để biết dạng tổng quát hơn của ngữ cảnh template và ngữ nghĩa về tính khả dụng theo từng trường, xem template-context-contract.md.
Số trên bề mặt này
Một assertion đọc một số do tác giả viết đúng như cách một value template đọc — xem Số trong một value template:
- So sánh. Sáu phép so sánh đọc hai số theo giá trị, bất kể kiểu nào mang mỗi số:
lt .values.replicas 1.5vàeq .values.replicas 3.0cho kết quả ở đây giống như trên một value template, một0.1do tác giả viết làeqvới0.1được viết trong assertion, và việc so sánh một số với văn bản trong dấu ngoặc kép sẽ dừng với cùng một thông báo. - Tính rỗng. Một
0do tác giả viết là rỗng: sai đối vớiifvàwith, đúng đối vớiempty, và bịdefaultthay thế. Một quy tắc hỏi liệu tác giả có viết một giá trị hay không — kể cả0— sẽ hỏi bằng các helper kiểm tra sự hiện diện: với một0do tác giả viết,hasKey .values "replicas"là đúng vàoptional .values "replicas" 1trả về0. Một quy tắc hỏi liệu giá trị có bằng không hay không thì so sánh:eq .values.replicas 0. Sự hiện diện và tính rỗng đặt hai câu hỏi này cạnh nhau. - In ra. Một số mà thông báo
failin ra trông giống như trong đầu ra của một value template: số nguyên in nguyên, nênprintf "%d"in các chữ số của nó, và mọi số khác in ở dạng thập phân chính xác ngắn nhất, nên một0.0000001do tác giả viết hiển thị là0.0000001.
Assertions của Component / Feature — các bất biến kiến trúc
Các assertion này biểu đạt những quy tắc luôn đúng bất kể Recipe nào ràng buộc Component. Quy tắc là một thuộc tính của hợp đồng, không phải của phần hiện thực.
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 -}}Cả hai quy tắc đều biểu đạt các thuộc tính của hợp đồng MariaDB. Dù Recipe nào được ràng buộc — một chart Bitnami hay một phương án thay thế tự viết — các quy tắc vẫn được áp dụng.
Cơ chế kiểm soát khoảng trắng {{- ... -}} là quan trọng: các template assertions không tạo ra đầu ra, chỉ tạo hiệu ứng phụ thông qua {{ fail }}. Việc cắt khoảng trắng giữ cho phần thân template sau khi render luôn rỗng trong trường hợp thành công.
Assertion của Recipe / FeatureRecipe — bất biến về triển khai
Các assertion này biểu đạt những quy tắc đúng với chart hoặc module cụ thể mà Recipe lấy nguồn. Quy tắc là một thuộc tính của phần triển khai, không phải của hợp đồng.
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 -}}Mỗi quy tắc chỉ áp dụng riêng cho phần triển khai chart Bitnami 20.x. Nếu một Recipe MariaDB khác được liên kết — một chart tự viết, một phần triển khai thay thế — thì các quy tắc này không áp dụng. Các quy tắc ở cấp Component (replication-needs-two-secondaries, total-node-count-within-cap) vẫn áp dụng vì chúng là thuộc tính của hợp đồng.
Vì sao assertion của Component và Recipe được tách riêng
Hai vai trò trông giống nhau (cả hai đều chạy các lệnh dừng {{ fail }} trên các quy tắc liên trường), nhưng sự phân chia trách nhiệm này mang tính nền tảng:
- Assertion của Component là một phần của hợp đồng. Khi nhà phát triển viết
architecture: replicationvớisecondary.replicaCount: 1, bản build sẽ bị từ chối bất kể Recipe nào được gắn kết. Một Recipe thay thế trong tương lai cũng không thay đổi điều đó. - Assertion của Recipe là một phần của phần triển khai. Khi kiến trúc sư chọn chart Bitnami 20.x làm Recipe, chart đó có những đặc điểm riêng (yêu cầu
serviceMonitor.namespace, lỗi trên node ARM). Những điều này không áp dụng cho một chart khác.
Đặt cả hai loại quy tắc cùng trên Component sẽ làm hợp đồng bị ràng buộc rối với các phần triển khai của nó: Component sẽ phải tham chiếu Recipe được gắn kết với nó để biết cần áp dụng những quy tắc triển khai nào, phá vỡ sự tách biệt Component-Recipe. Tách các quy tắc về đúng vị trí tự nhiên của chúng giúp mô hình trách nhiệm luôn rõ ràng. Chi phí thời gian chạy của việc tách là không đáng kể; cả hai giai đoạn đều chạy trước khi render và dừng với cùng một chẩn đoán Loud Guardrails, E0033, nêu tên thực thể, instance và quy tắc.
Quy ước thông điệp fail
Đối số của {{ fail "..." }} là lỗi lúc build hiển thị cho người dùng. Các quy ước:
- Nêu tên ràng buộc — “architecture=replication requires secondary.replicaCount >= 2”.
- Nêu giá trị khi có liên quan — “total node count must not exceed 9; got 12”.
- Gợi ý cách sửa khi có thể — “use ‘soft’ or omit the field”.
- Tránh biệt ngữ — người đọc là nhà phát triển đã viết Aggregate, không phải kiến trúc sư đã viết assertion.
Với thông điệp dài hoặc có chứa giá trị, hãy dùng printf:
{{- fail (printf "field %s exceeds limit: got %d, max is %d" .field .value .max) -}}Trình biên dịch hiển thị thông điệp theo định dạng lỗi Loud Guardrails, kèm tên thực thể, vị trí nguồn của assertion và thông điệp thất bại. Chẩn đoán này đủ cụ thể để nhà phát triển xác định và sửa nguyên nhân gốc.
Một giá trị mà tác giả đã khai báo sensitive: true sẽ hiển thị là <redacted> trong thông điệp đó ở bất cứ chỗ nào thông điệp trích dẫn nó, vì vậy nêu giá trị của một trường đã khai báo trong thông điệp là an toàn: chẩn đoán vẫn nêu tên quy tắc và trường, chỉ giá trị bị giữ lại. Một assertion mà kết quả phụ thuộc vào nội dung của giá trị như vậy — một phép so sánh với một literal, một phép kiểm tra tiền tố — sẽ báo rằng văn bản thất bại của nó bị giữ lại thay vì thông điệp của nó. vocabulary/compact-form-authoring.md “Một lời từ chối nói gì về một giá trị đã khai báo” trình bày toàn bộ quy tắc.
Những gì assertions: không thay thế
assertions: là nơi đặt các quy tắc liên trường. Nó không thay thế:
- Các ràng buộc JSON Schema bên trong
schema:— các quy tắc theo từng trường (phạm vi, mẫu, enum, định dạng, kiểu) thuộc về các từ khóa gốc của JSON Schema. - Trường
validate:của dạng rút gọn — các vị từ tùy chỉnh theo từng trường với phạm vi một trường. Dùngvalidate:khi quy tắc áp dụng cho một trường cụ thể; dùngassertions:khi quy tắc liên quan đến nhiều trường mà không có trường đơn lẻ nào là “trường đang được kiểm tra.” - Trường
when:của dạng rút gọn — hình dạng có điều kiện (các ràng buộc của một cây con có được áp dụng hay không). Dùngwhen:cho sự biến đổi về hình dạng; dùngassertions:khi tổ hợp các giá trị không hợp lệ theo cách được diễn đạt tốt hơn bằng một vị từ dạng tự do. - Kiểm tra lúc chạy —
assertions:chỉ chạy lúc biên dịch. Mọi thứ phụ thuộc vào trạng thái cluster lúc chạy (IP đang hoạt động, nội dung vault, trạng thái pod lúc chạy) phải được biểu diễn dưới dạng các chuỗi con trỏ tất định (xem hợp đồng AOT-purity).
Ví dụ minh họa
Tối giản — một quy tắc kiến trúc duy nhất
spec: assertions: replication-needs-two-secondaries: | {{- if and (eq .values.architecture "replication") (lt .values.secondary.replicaCount 2) -}} {{- fail "replication requires secondary.replicaCount >= 2" -}} {{- end -}}Cỡ trung — hợp đồng Component nhiều quy tắc
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 -}}Thực tế — Recipe với các quy tắc triển khai
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 -}}Tích hợp công cụ
aggrega buildđánh giá các assertion giữa bước xác thực schema và bước kết xuất; một assertion thất bại sẽ dừng bản build với thông báo{{ fail }}của assertion đó.aggrega validateáp dụng cùng mức kiểm tra tính đúng đắn trước khi kết xuất mà không ghi ra artifact — với một Recipe có nguồn không được tải về, lệnh này chạy pipeline biên dịch thực quanh một Aggregate, Manifest và Release tối thiểu được tổng hợp, nên một template assertion sai định dạng hoặc một assertion tham chiếu đến trường không xác định sẽ hiện ra dưới dạng lỗi tính đúng đắn; các assertion của một Recipe có nguồn được tải về thì được đánh giá bởi một bản build. Một assertion ở đó gọifailđược báo cáo là cảnh báo kèm thông báo của nó, và bước kiểm tra vẫn đạt: Release được tổng hợp chứa các giá trị giữ chỗ và mặc định thay vì các giá trị mà một Release thực đặt, nên kết luận về assertion được để lại cho một bản build — xem một assertion thất bại là một cảnh báo. (aggrega lintbao quát các quy ước xuất bản, không phải tính đúng đắn của assertion.)- Các IDE hỗ trợ template Sprig sẽ tô sáng các tham chiếu
.values.X; tài liệu khi di chuột sẽ trỏ đến định nghĩa schema khi tích hợp IDE được cấu hình.