콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

`assertions:` 블록

Component, Feature, Recipe, FeatureRecipe에는 선택적인 spec.assertions: 필드가 있습니다. 이 필드는 컴파일러가 스키마 검증 후, 렌더링 전에 평가하는 이름이 있는 규칙의 맵입니다. 각 키는 실패 메시지에 나타나는 규칙 식별자이고, 각 값은 Go 템플릿 본문입니다. assertions: 바로 아래에 템플릿 본문 하나를 직접 작성하는 것은 이 필드의 형태가 아니며 엔티티를 읽을 때 거부되므로, 모든 규칙은 각자의 이름 아래에 작성합니다. 이 블록은 JSON Schema로는 간결하게 표현할 수 없는 필드 간 규칙, 즉 어느 한 필드도 “검증 대상”이 아닌, 여러 필드가 관련된 불변 조건을 표현합니다. 이 페이지에서는 작성 문법, 평가 단계, 템플릿 컨텍스트, 그리고 Component / Feature 어서션(계약의 아키텍처 불변 조건)과 Recipe / FeatureRecipe 어서션(특정 provider의 구현 불변 조건) 사이의 책임 분담을 다룹니다.

필드별 제약 조건(범위, 패턴, 열거형, 형식)에는 schema: 안에서 JSON Schema의 기본 키워드를 사용합니다. 필드별 사용자 정의 조건자에는 간결한 형식의 validate: 필드를 사용합니다. 조건부 형태에는 when:을 사용합니다. assertions: 필드는 이들을 보완하며, 진정한 필드 간 규칙을 위한 자리입니다.

필드가 나타나는 위치

assertions:를 가질 수 있는 네 가지 엔터티:

  • Component — Component 계약의 아키텍처 불변 조건.
  • Feature — Feature 계약의 아키텍처 불변 조건.
  • Recipe — Recipe의 기반 차트 또는 모듈의 구현 불변 조건.
  • FeatureRecipe — FeatureRecipe의 기반 메커니즘의 구현 불변 조건.

이 필드는 각 엔터티에서 선택 사항입니다. 필드 간 규칙이 없는 엔터티는 이 필드를 완전히 생략합니다.

assertion이 실행되는 시점

assertion 평가 단계는 컴파일 파이프라인에서 스키마 검증과 렌더링 사이에 위치합니다.

  1. 해석: 매개변수 검증과 보간, 그다음 schema: / usesSchema: / featuresSchema:에 대한 스키마 검증.
  2. 토폴로지 구성과 그래프 확정: 그래프가 조립됩니다.
  3. 정적 분석: 각 uses: 소켓의 셀렉터를 그 연결이 도달하는 컴포넌트의 레이블과 대조하여 검사합니다.
  4. Component / Feature assertion을 각 인스턴스에 대해 평가합니다.
  5. Recipe 바인딩.
  6. Recipe / FeatureRecipe assertion을 바인딩된 인스턴스에 대해 평가합니다.
  7. 렌더링: 매핑 템플릿을 평가하고 출력을 생성합니다.

두 assertion 단계는 어떤 렌더링보다도 먼저 실행됩니다. 차트는 렌더링되지 않고 Compose 파일도 생성되지 않습니다. Recipe assertion이 실행되기 전에 provider에게 요청되는 유일한 것은 바인딩된 각 노드의 리소스에 provider가 부여하는 이름이며, Recipe의 provides가 이를 읽을 수 있습니다. 실패한 assertion은 해당 assertion의 구체적인 오류 메시지와 함께 빌드를 즉시 중단하며, 이후 단계는 실행되지 않습니다.

두 단계의 분리는 책임의 분리를 반영합니다. Component 수준 규칙은 어떤 Recipe가 바인딩되든 적용되므로 바인딩 전에 실행되고, Recipe 수준 규칙은 특정 Recipe 선택을 전제로 적용되므로 바인딩 후에 실행됩니다.

템플릿 컨텍스트

Component 및 Feature assertions:의 경우, 템플릿 컨텍스트는 해석된 인스턴스 상태를 노출합니다.

  • .values — 개발자의 values 내용입니다.
  • .infra — Ops의 infra 내용입니다(Aggregate 또는 Release에서 가져옴).
  • .uses — 해석된 uses: 연결로, 각각 이미 소켓의 셀렉터와 대조하여 검사되었으며, 작성자가 작성한 형태 그대로입니다. 소켓 이름을 키로 하고, 각 소켓 아래에서는 그 소켓의 모든 연결의 별칭을 키로 합니다. 별칭은 작성자가 소켓 아래에서 연결에 붙인 이름이며, 목록 항목으로 작성된 연결의 경우 그 대상입니다. 각 연결의 항목은 연결을 기술하며, 대상이 게시한 것은 아무것도 담지 않습니다. target은 해석된 대상의 인스턴스 id이고, alias는 키로 쓰인 이름을 반복하며, origin_feature는 Feature 부착이 연결을 만든 경우에 존재합니다. 이와 함께 Recipe 템플릿이 같은 연결의 .context.uses.<alias> 항목에서 읽는 것과 같은 이름으로 세 가지 사실이 있으며, 각각이 담는 내용은 template-context-contract.md에서 설명합니다. labels — 대상의 레이블이며, 어서션이 실행되는 컴포넌트의 레이블은 결코 아닙니다 — values는 연결에 작성된 값이고, features는 연결에 작성된 부착으로, 각각이 채우는 슬롯을 키로 합니다. 세 가지 모두 모든 연결에 존재하며, 연결에 해당 내용이 없으면 비어 있습니다. features 아래의 부착은 아래에서 .features가 제공하는 것과 같은 형태를 가집니다. 따라서 .uses.<socket>.<alias>.target은 한 연결의 해석된 대상을, .uses.<socket>.<alias>.labels는 그 대상의 레이블을 읽으며, 여러 연결을 가진 소켓은 각 연결마다 항목을 가집니다. 대상이 게시한 값을 이 맵을 통해 읽으려는 참조는 항목에 그런 필드가 없으므로 중단됩니다.
  • .features — 해석된 부착이며, 작성자가 각각에 붙인 인스턴스 이름을 키로 합니다. 각 항목은 type(부착된 Feature의 카탈로그 URI), resolved_version(이번 빌드에 바인딩된 버전), values(부착 자체의 개발자 의도 내용)를 담습니다. 컴포넌트의 연결 중 하나에 작성된 부착은 Recipe 템플릿의 .features에 포함되지 않는 것과 마찬가지로 여기에 포함되지 않습니다. 그런 부착은 해당 연결 아래의 .uses.<socket>.<alias>.features.<slot>에서 같은 형태로 읽습니다.
  • .metadata — 평가 중인 인스턴스입니다. 그 instance_id, 그 component 타입과 resolved_version, 그 boundary_path, 그리고 빌드의 aggregate_name, aggregate_version, release_version입니다.

Recipe 및 FeatureRecipe assertions:의 경우, 컨텍스트에 Recipe 전용 필드가 추가됩니다.

  • .provides — 평가 중인 컴포넌트의 해석된 provides: 값이며, 어서션이 실행될 때 이미 계산되어 있습니다. 대상이 게시한 값은 이 표면에 없으며, 대신 렌더 컨텍스트에서 호출자에게 전달됩니다.
  • .locals — Recipe의 로컬 값입니다.
  • .recipe.metadata — Recipe의 name과 version, 그리고 그 capability입니다.
  • .recipe.source — Recipe의 소스 포인터입니다.

필드 접근은 표준 Go 템플릿 구문을 사용합니다(.values.architecture, .uses.databases.primary.target). 중단 구문은 Loud Guardrails 계약에 따라 {{ fail "message" }}이며, 실패한 어서션은 위반된 불변식을 명시하는 명확하고 구체적인 빌드 시점 오류를 생성합니다.

이 표면은 missingkey=error로 평가됩니다. 컨텍스트에 없는 키에 대한 참조는 빈 값으로 렌더링되지 않고 빌드를 중단하며, 엔티티, 인스턴스, 어서션, 없는 키를 명시합니다. 이러한 엄격함이 어서션을 신뢰할 수 있게 합니다. 참조가 빈 값으로 렌더링된 조건식은 아무것도 없는 것과 비교되어 통과하므로, 오타 하나가 어서션이 강제하려던 규칙을 조용히 무력화할 것이기 때문입니다. 또한 대체 값이 적용되기 전에 순수 참조가 먼저 해석되므로, 선택적 필드에는 존재 여부를 확인하는 형태가 필요합니다. errors/fatal-halts.md에 표면별 누락 키 정책과 그 정책에서 동작하는 형태가 정리되어 있습니다.

소켓의 연결 읽기. 소켓의 항목은 무엇을 담든 하나의 형태를 가집니다. 즉 연결마다 별칭 아래에 항목 하나가 있습니다. 어서션은 별칭으로 한 연결을 읽고, 소켓을 count하거나 range하여 그 소켓의 모든 연결을 확인하며, 소켓 자체의 키를 검사하여 연결 여부를 확인합니다. Aggregate 항목이 다음과 같이 작성된 컴포넌트가 있을 때

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

다음 어서션들은 이를 각각의 방식으로 읽습니다.

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는 소켓의 연결을 Aggregate가 작성한 순서가 아니라 별칭의 알파벳 순서로 순회합니다. 여기서는 fast가 local보다 먼저입니다. 연결이 하나뿐인 소켓도 같은 방식으로 읽습니다. .uses.models.local.target은 옆에 fast가 연결되어 있든 없든 llama를 읽으며, .uses.models.target은 어떤 연결도 가리키지 않으므로 중단됩니다.

컴포넌트가 가진 모든 연결은 여기서 각자의 항목을 가집니다. 한 소켓이든 두 소켓이든, 어떤 문서나 부착이 각각을 만들었든, 한 컴포넌트의 두 연결이 같은 별칭을 공유하는 일은 없기 때문입니다. 빌드는 어떤 어서션도 실행되기 전에 그런 쌍을 거부하며, 두 연결과 각각이 작성된 위치를 명시합니다. 목록 항목의 별칭은 그 대상이므로 한 대상을 두 번 나열한 목록이 그런 쌍이며, 같은 컴포넌트에서 컴포넌트 자체의 local 연결과 부착의 local 연결이 함께 있는 경우도 그렇습니다.

연결이 담는 내용 읽기. 연결에 관한 규칙은 대상이 무엇인지, 개발자가 연결에 무엇을 작성했는지, 연결에 무엇이 부착되었는지를 읽을 수 있으므로, 어떤 Recipe가 바인딩되든 성립합니다. models 소켓이 unauthenticated 값과 credential 슬롯을 선언하는 Component는, 카탈로그가 호스팅 서비스로 레이블을 붙인 대상에 대한 연결이 자격 증명도 옵트아웃도 담고 있지 않을 때 그 연결을 거부할 수 있습니다.

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

레이블은 labels에서 읽으며, 이는 컴포넌트 자신이 아니라 대상, 즉 모델의 것입니다. 옵트아웃은 연결의 values에서 읽고, 자격 증명은 연결의 features 아래에 있는 슬롯입니다. 대상에 그런 레이블이 없거나 연결에 그런 값이 없을 수 있으므로, 각각 optional 또는 hasKey로 읽습니다. 레이블이 무엇을 의미하는지는 카탈로그의 관례입니다. 빌드는 문자열을 전달하고, 그 의미는 어서션이 결정합니다.

어서션의 .uses는 Recipe 템플릿의 .context.uses가 아니며, 한쪽을 위해 작성한 참조는 다른 쪽으로 옮겨지지 않습니다. 렌더 컨텍스트는 같은 엣지에 대해 더 풍부한 투영을 담습니다. 별칭만을 키로 하고, 소켓 이름은 항목의 필드로 두며, 각 대상이 게시한 값은 provides 아래에 중첩됩니다. 따라서 어서션이 .uses.<socket>.<alias>.target을 읽는 곳에서 Recipe 템플릿은 .context.uses.<alias>.provides.<name>을 읽습니다. 두 뷰가 모두 담는 사실은 이름은 같지만 경로는 다릅니다. .context.uses.<alias>.labels와 .uses.<socket>.<alias>.labels는 같은 대상의 레이블이며, values와 features도 마찬가지로 어느 쪽에서든 같은 연결을 읽습니다. 두 어서션 단계 모두 렌더링 전에 평가되며, 그 때문에 어서션이 보는 엣지에는 대상이 게시한 것이 없고, 그 엣지의 부착에도 provides가 없습니다.

더 넓은 템플릿 컨텍스트의 형태와 필드별 가용성 의미론은 template-context-contract.md를 참조하십시오.

이 표면에서의 숫자

어서션은 작성된 숫자를 값 템플릿과 정확히 같은 방식으로 읽습니다. 값 템플릿에서의 숫자를 참조하십시오.

  • 비교. 여섯 가지 비교는 각 숫자를 어떤 종류가 담고 있든 두 숫자를 값으로 읽습니다. lt .values.replicas 1.5와 eq .values.replicas 3.0은 여기서도 값 템플릿에서와 같은 결과를 내고, 작성된 0.1은 어서션에 쓴 0.1과 eq이며, 숫자를 따옴표로 묶인 텍스트와 비교하면 같은 문구로 중단됩니다.
  • 비어 있음. 작성된 0은 비어 있습니다. if와 with에는 거짓, empty에는 참이며, default에 의해 대체됩니다. 작성자가 값을 썼는지(0 포함)를 묻는 규칙은 존재 확인 헬퍼로 묻습니다. 작성된 0에 대해 hasKey .values "replicas"는 참이고 optional .values "replicas" 1은 0을 반환합니다. 값이 0인지를 묻는 규칙은 비교합니다: eq .values.replicas 0. 존재와 비어 있음에서 두 질문을 나란히 설명합니다.
  • 출력. fail 메시지가 출력하는 숫자는 값 템플릿의 출력에서와 같이 읽힙니다. 정수는 정수 그대로이므로 printf "%d"는 그 자릿수를 출력하고, 그 밖의 숫자는 가장 짧은 정확한 십진 형식으로 출력되므로 작성된 0.0000001은 0.0000001로 읽힙니다.

Component / Feature 어서션 — 아키텍처 불변 조건

이 어서션은 어떤 Recipe가 Component를 바인딩하든 관계없이 성립하는 규칙을 표현합니다. 규칙은 구현이 아니라 계약의 속성입니다.

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

두 규칙 모두 MariaDB 계약의 속성을 표현합니다. 어떤 Recipe가 바인딩되든 — Bitnami 차트든, 직접 작성한 대안이든 — 규칙이 적용됩니다.

{{- ... -}} 공백 제어가 중요합니다. 어서션 템플릿은 출력을 생성하지 않고 {{ fail }}을 통한 부수 효과만 냅니다. 공백 제거는 성공한 경우 렌더링된 템플릿 본문을 비어 있게 유지합니다.

Recipe / FeatureRecipe assertions — 구현 불변 조건

이 assertions는 Recipe가 가져오는 특정 차트나 모듈에 대해 성립하는 규칙을 표현합니다. 이 규칙은 계약이 아니라 구현의 속성입니다.

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

각 규칙은 Bitnami 차트 20.x 구현에만 해당합니다. 다른 MariaDB Recipe가 바인딩되면(직접 작성한 차트, 대체 구현 등) 이 규칙들은 적용되지 않습니다. Component 수준의 규칙(replication-needs-two-secondaries, total-node-count-within-cap)은 계약의 속성이므로 여전히 적용됩니다.

Component assertion과 Recipe assertion이 분리된 이유

두 역할은 비슷해 보이지만(둘 다 필드 간 규칙에 대해 {{ fail }} 중단을 실행합니다), 책임의 분리는 구조적으로 중요한 의미를 가집니다:

  • Component assertion은 계약의 일부입니다. 개발자가 secondary.replicaCount: 1과 함께 architecture: replication을 작성하면, 어떤 Recipe가 바인딩되든 빌드는 거부됩니다. 향후 다른 대안 Recipe가 나오더라도 이는 바뀌지 않습니다.
  • Recipe assertion은 구현의 일부입니다. 아키텍트가 Bitnami 차트 20.x를 Recipe로 선택하면, 그 차트에는 고유한 특이 사항(serviceMonitor.namespace 요구 사항, ARM 노드 버그)이 있습니다. 이는 다른 차트에는 적용되지 않습니다.

두 유형의 규칙을 모두 Component에 두면 계약이 그 구현들과 얽히게 됩니다. Component는 어떤 구현 규칙을 적용할지 알기 위해 바인딩된 Recipe를 참조해야 하므로 Component-Recipe 분리가 깨집니다. 규칙을 각자의 본래 위치로 나누면 책임 모델이 깔끔하게 유지됩니다. 분리에 따른 런타임 비용은 무시할 수 있는 수준이며, 두 단계 모두 렌더링 전에 실행되고 엔터티, 인스턴스, 규칙을 명시하는 동일한 Loud Guardrails 진단 E0033으로 중단됩니다.

fail 메시지 관례

{{ fail "..." }}의 인수는 사용자에게 표시되는 빌드 시점 오류입니다. 관례는 다음과 같습니다.

  • 제약 조건을 명시합니다 — “architecture=replication requires secondary.replicaCount >= 2”.
  • 관련이 있으면 값을 명시합니다 — “total node count must not exceed 9; got 12”.
  • 가능하면 해결 방법을 제안합니다 — “use ‘soft’ or omit the field”.
  • 전문 용어를 피합니다 — 메시지를 읽는 사람은 assertion을 작성한 아키텍트가 아니라 Aggregate를 작성한 개발자입니다.

길거나 값을 포함하는 메시지에는 printf를 사용합니다.

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

컴파일러는 이 메시지를 엔티티 이름, assertion 소스 위치, 실패 메시지와 함께 Loud Guardrails 오류 형식으로 표시합니다. 이 진단은 개발자가 근본 원인을 파악하고 수정할 수 있을 만큼 구체적입니다.

작성자가 sensitive: true로 선언한 값은 메시지가 그 값을 인용하는 모든 곳에서 <redacted>로 표시되므로, 선언된 필드의 값을 메시지에 명시해도 안전합니다. 진단은 여전히 규칙과 필드를 명시하며 값만 숨겨집니다. 결과가 그러한 값의 내용에 따라 달라지는 assertion — 리터럴과의 비교, 접두사 검사 — 은 메시지 대신 실패 텍스트가 숨겨졌다고 보고합니다. 전체 규칙은 vocabulary/compact-form-authoring.md “What a refusal says about a declared value(거부가 선언된 값에 대해 말하는 내용)”를 참고하십시오.

assertions:가 대체하지 않는 것

assertions:는 여러 필드에 걸친 규칙을 두는 곳입니다. 다음을 대체하지 않습니다.

  • schema: 안의 JSON Schema 제약 조건 — 필드별 규칙(범위, 패턴, 열거형, 형식, 타입)은 JSON Schema의 기본 키워드로 작성합니다.
  • 축약형 validate: 필드 — 단일 필드 범위의 필드별 사용자 정의 조건식입니다. 규칙이 특정 필드에 적용되면 validate:를 사용하고, 규칙이 여러 필드에 관련되어 어느 한 필드도 “검증 대상”이 아닌 경우에는 assertions:를 사용합니다.
  • 축약형 when: 필드 — 조건부 형태(하위 트리의 제약 조건이 적용되는지 여부)입니다. 형태의 변형에는 when:을 사용하고, 값의 조합이 자유 형식 조건식으로 더 잘 표현되는 방식으로 유효하지 않은 경우에는 assertions:를 사용합니다.
  • 런타임 검사 — assertions:는 컴파일 시점에만 실행됩니다. 런타임 클러스터 상태(실제 IP, vault 내용, 런타임 pod 상태)에 의존하는 것은 모두 결정적인 포인터 문자열로 표현해야 합니다(AOT 순수성 계약 참조).

실습 예제

최소 예제 — 단일 아키텍처 규칙

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

중간 규모 예제 — 여러 규칙으로 이루어진 Component 계약

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

프로덕션 예제 — 구현 규칙을 갖춘 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 -}}

도구 통합

  • aggrega build는 스키마 검증과 렌더링 사이에 어서션을 평가합니다. 실패한 어서션은 해당 어서션의 {{ fail }} 메시지와 함께 빌드를 중단합니다.
  • aggrega validate는 아티팩트를 쓰지 않고 렌더링 전에 동일한 정확성 검사를 적용합니다. 소스를 가져오지 않는 Recipe의 경우 합성된 최소한의 Aggregate, Manifest, Release를 중심으로 실제 컴파일 파이프라인을 구동하므로, 잘못된 형식의 어서션 템플릿이나 알 수 없는 필드를 참조하는 어서션은 정확성 오류로 드러납니다. 소스를 가져오는 Recipe의 어서션은 빌드에서 평가됩니다. 이때 fail을 호출하는 어서션은 해당 메시지를 담은 경고로 보고되며 검사는 통과합니다. 합성된 Release는 실제 Release가 설정하는 값 대신 플레이스홀더와 기본값을 담고 있으므로 어서션에 대한 판정은 빌드에 맡겨집니다. 실패한 어서션은 경고입니다를 참조하십시오. (aggrega lint는 어서션의 정확성이 아니라 게시 관례를 다룹니다.)
  • Sprig 템플릿을 지원하는 IDE는 .values.X 참조를 강조 표시합니다. IDE 통합이 구성되어 있으면 호버 문서가 스키마 정의로 연결됩니다.