데이터 필러
다섯 가지 DSL 구조 키워드인 parameters, values, uses, infra, inject의 개념적 틀은 architecture/06-data-taxonomy-and-composition.md에서 다룹니다. 이 페이지에서는 정식 데이터 필러 목록, 필러별 작성 의미론, 필러 간 메커니즘, 그리고 작성자가 여러 필러에 걸쳐 접하는 기본값 어휘를 다룹니다. 이를 보완하는 토폴로지 3요소(provides, inject, uses — 그래프 간선을 연결하는 키워드)는 topology-triad.md에 설명되어 있으며, 데이터 필러와 구별되는 메타데이터 어휘(레이블, 어노테이션, 게시 표면 필드)는 labels-and-annotations.md와 publishing-surface.md에서 다룹니다.
표준 필러 목록
Aggrega 엔티티는 이름이 있는 일곱 개의 데이터 필러를 가집니다. 다섯 개는 렌더링이 끝날 때까지 살아 있는 상태로 IR 데이터 흐름에 참여하고, 두 개는 일시적이거나 비공개이며 특정 컴파일 단계에서만 존재합니다.
| 필러 | 위치 | 수명 주기 | 역할 |
|---|---|---|---|
values | Aggregate 컴포넌트 / 어태치먼트 인스턴스 | 렌더링이 끝날 때까지 유지 | 개발자가 작성하는 인지적 페이로드 |
infra | Release 컴포넌트, 어태치먼트 및 연결 항목 | 렌더링이 끝날 때까지 유지 | 운영자가 작성하는 물리적 크기 지정 |
provides | Recipe provides: 블록 | 렌더링이 끝날 때까지 유지(파생 필러 — 아래 참조) | 토폴로지 파이프가 소비하는, Recipe가 계산한 공개 출력 문자열 |
uses | Aggregate 컴포넌트 / 피처 인스턴스 | 렌더링이 끝날 때까지 유지 | 다른 컴포넌트 / 피처로 향하는 토폴로지 엣지 |
features | Aggregate + Release 컴포넌트 인스턴스. 슬롯은 카탈로그 엔티티의 featuresSchema에 선언됩니다 — 아래 “Features 필러” 참조 | 렌더링이 끝날 때까지 유지 | 어태치먼트 필러 — 모든 어태치먼트 계열에 하나의 형태 |
parameters | Aggregate + Release 루트 | 파이프라인 끝까지, 즉 모든 렌더 단계가 완료될 때까지 읽을 수 있습니다. 렌더링 중에는 비대칭 권한 부여를 통해 경로 템플릿에서 접근할 수 있으며, 값 템플릿 컨텍스트는 .parameters를 직접 사용하지 않고 보간 후의 리터럴을 소비합니다 | Release가 채우는 환경별 슬롯 |
locals | Recipe locals: 블록 | Recipe 비공개 — 해당 Recipe 자체의 템플릿 안에서만 보임 | Recipes가 locals 프리앰블에서 도출하는 계산된 문자열 상태 |
values / infra / provides / uses / features는 런타임 템플릿 컨텍스트가 각각 .values, .infra, .provides, .context.uses, .features로 노출하는 다섯 개의 라이브 필러입니다. parameters와 locals는 라이브 필러 목록에 포함되지 않습니다. parameters는 해석 단계 이후 남지 않기 때문이고, locals는 Recipe 비공개이며 엔티티 경계를 넘지 않기 때문입니다.
필러는 벽이 아니라 표지판입니다. 템플릿 엔진은 자기 완결성 규칙(Recipe provides: 및 Recipe source: 블록에서 .context.inject / .context.uses를 읽는 경우. templates/expansion-matrix.md에 문서화됨)으로 명시적으로 금지되지 않는 한 모든 위치에서 필러 간 읽기를 허용합니다. 필러 경계는 작성 규율이지 언어 차원의 강제가 아닙니다.
필러 경계와 작성 규율
Recipe 템플릿에서의 필러 간 읽기는 전체 템플릿 컨텍스트를 허용하는 모든 위치에서 제한되지 않습니다. 작성 규율은 작성자에게 다음을 기대합니다.
- 인지적 페이로드(Developer가 작성한 의도)는
.values에서 읽습니다. - 물리적 크기 설정(Operator가 작성한 크기 설정)은
.infra에서 읽습니다. - 컴포넌트 간 포인터 문자열(토폴로지 삼원 구조의 데이터 흐름)은
.context.uses[].provides.<key>에서 읽습니다. - 하이드레이션 이후의 전달 파이프(
component.inject,uses[].inject, FeatureRecipeinjectMapping가로채기에 걸친 inject 소스로부터 조립됨)는.context.inject에서 읽습니다.
이 규율은 벽이 아니라 표지판입니다. .infra.replicas를 읽어 values: 필드를 구동하는 Recipe 템플릿은 동작하며, 템플릿 엔진은 그 읽기를 막지 않습니다. 아키텍처의 관점에서 필러 경계는 런타임 제한이 아니라 작성 의도, 즉 누가 데이터를 소유하는지를 설명합니다. 관례는 네 도메인 분할에 맞춰집니다. Developer가 작성한 값은 .values에서, Operator가 작성한 크기 설정은 .infra에서, 컴포넌트 간 좌표는 토폴로지 파이프에서 옵니다.
의도적인 필러 간 브리지가 필요한 경우(예: vocabulary/inheritance-and-interface.md에 따라 Component의 schema:가 개발자 대상 다이얼을 노출하고, Recipe의 valuesMapping: 템플릿이 이를 Ops 측 infra: 형태의 출력으로 전달하는 경우), 아키텍처는 그 브리지를 표지판이 붙은 예외로 취급합니다. 아래의 “필러 간 메커니즘”을 참조하십시오.
Values
values: 필러는 Developer가 작성하는 인지적 페이로드, 즉 Developer가 컴포넌트 인스턴스마다 지정하는 애플리케이션 형태의 파라미터를 담습니다. Component의 schema:가 values의 형태를 선언하고, Developer의 Aggregate가 인스턴스마다 구체적인 값을 채웁니다. 이것은 Developer의 영역입니다.
작성 위치:
- Aggregate
components.<id>.values:— 컴포넌트 인스턴스별 인지적 페이로드. - Aggregate
subsystems.<name>.components.<id>.values:— 동일하며, 서브시스템으로 그룹화된 컴포넌트 내부에 해당합니다. - Aggregate
components.<id>.features.<name>.values:및 서브시스템의features.<name>.values:— 연결된 Feature가 어느 계열에 속하든 연결(attachment)의 values 페이로드입니다(자격 증명 연결의 vault 쿼리 파라미터도 다른 것과 마찬가지로 여기에 작성합니다).
금지 위치:
- Release 엔터티(Release 스키마는 모든 중첩 수준에서
values:블록을 금지합니다. 환경별 변형을 위해 지원되는 경로는 Parameter Hoisting입니다. 아래 Parameters를 참조하십시오).
검증 주체: Component schema의 values: 블록(Feature 연결의 경우 Feature schema의 values: 블록)이며, vocabulary/validation-surface.md Layer 2에 따라 Component / Feature 로드 시점에 JSON Schema 2020-12로 해석됩니다.
소비 주체: .values를 통한 Recipe valuesMapping: 템플릿. 전체 템플릿 컨텍스트는 모든 기본 렌더링 템플릿 위치에서 해석된 values 딕셔너리를 노출합니다.
Infra
infra: 기둥은 Operator가 작성하는 물리적 규모 설정, 즉 레플리카 수, 리소스 요청, IOPS 한도, 리전 고정, 머신 클래스를 담습니다. values가 무엇이며 어떻게 동작하는가를 표현하는 것을 보완하여, 이 기둥은 어디에서 얼마나 크게를 표현합니다. 이는 Operator의 영역입니다.
네 가지 작성 위치
작성자는 infra:를 네 가지 서로 다른 위치에서 접하며, 각 위치는 범위와 캐스케이드 동작이 서로 다릅니다.
| # | 보고 위치 | 범위 | 병합 우선순위 |
|---|---|---|---|
| 1 | Release 경계 components.<id>.infra:(경계가 없는 Release에서는 spec.components.<id>.infra:) | 하나의 컴포넌트 인스턴스 | 컴포넌트 자체의 규모 설정이며, 다른 위치는 이를 작성하지 않음 |
| 2 | Release 경계 features.<name>.infra: | 경계 전체에 걸친 어태치먼트로, 경계 안의 모든 컴포넌트에 적용 | 해당 어태치먼트에 대해 가장 낮음 — 위치 3이 필드별로 재정의 |
| 3 | Release 경계 components.<id>.features.<name>.infra: | 하나의 컴포넌트에 있는 하나의 어태치먼트 | 해당 어태치먼트에 대해 위치 2를 필드별로 재정의 |
| 4 | Release components.<id>.uses.<socket>.<alias>.infra: | 하나의 연결 | 소켓의 infraSchema에 대해 검증되며, 소비하는 컴포넌트의 렌더링에만 전달됨 |
위치 1이 가장 많이 작성됩니다. Operator는 Release가 배치하는 각 컴포넌트의 규모를 설정합니다. 경계는 자체 infra:를 갖지 않으므로(Release 스키마가 이를 거부합니다), 여러 컴포넌트가 공유하는 규모 설정은 각 컴포넌트에 작성하거나 extends:를 통해 상위 Release에서 상속합니다(아래 참조). 위치 2와 3은 Feature 연결의 규모 설정을 다룹니다. Features는 자체 infra 페이로드를 가지며, FeatureRecipe는 사이드카나 Feature별 리소스를 합성할 때 이를 소비합니다. 경계 전체에 걸친 어태치먼트는 한 번만 규모가 설정되고, 하나의 컴포넌트가 그중 단일 필드를 조정합니다.
“Infra는 주로 국소화됨” — 예외가 있는 규칙
infra:의 아키텍처상 목표는 컴포넌트 국소성입니다. 컴포넌트의 규모 설정은 해당 컴포넌트 인스턴스에만 적용되며 다른 컴포넌트로 번지지 않습니다. 이 메커니즘 덕분에 Ops는 API 서버의 CPU 요청에 영향을 주지 않고 데이터베이스 IOPS를 늘릴 수 있습니다.
규칙: infra:는 그것을 작성한 위치에 주로 국소화됩니다. 설계상 다음과 같은 캐스케이드 예외가 존재합니다.
- 경계 어노테이션 캐스케이드. 경계
annotations:는 중첩된 경계를 거쳐 내부 컴포넌트까지 캐스케이드됩니다(labels-and-annotations.md의 어노테이션 매트릭스 위치 5). Recipes가 라우팅 입력으로 소비하는 어노테이션은 간접적인infra도달 경로가 됩니다. 경계 수준 어노테이션이.context.annotations.release를 통해 노드별 Recipe의 렌더링 출력으로 흘러듭니다. extends:를 통한 Release 상속. 부모 Release를extends:하는 Release는, 자식이 키별로 재정의하지 않는 한, 부모의infra선언을 그것을 담는 모든 위치에서 상속합니다. 자식의 값이 키 단위로 우선하며, 이는 더 나눌 수 없는 첫 값(스칼라, 리스트, 템플릿)까지 내려가고 그 값은 통째로 대체됩니다. 자식이null로 작성한 키는 빈 값으로 설정되는 것이 아니라 제거됩니다. 상속은 의도적으로 Release별 경계를 넘습니다. 전체 병합 규칙과 함께 전달되는 다른 항목은entities/release.md를 참고하십시오.- 스키마 브리지 교차 기둥 파이핑. Component의
schema:는 개발자용values:다이얼을 노출할 수 있으며, Recipe의valuesMapping:템플릿이 이를 프로바이더의infra:형태 출력으로 파이핑합니다(아래 “교차 기둥 메커니즘 — 스키마 브리지 교차 기둥 파이핑” 참고). 엄밀히 말하면 값은values:에서 시작되어 렌더링 출력으로 흘러가므로, 이 캐스케이드는 인스턴스 내부이지만 기둥을 넘나듭니다.
국소화는 설계 의도이지 엔진이 강제하는 벽이 아닙니다. 위의 캐스케이드는 의도적 예외이며, 각각 그것을 담는 위치에 문서화되어 있습니다.
어노테이션 기반 Feature 확장을 위한 측면 대 기둥 분할. 작성 위치로서의 Aggregate 불변 조건은 어노테이션 기반 Feature 확장 경로에도 이어집니다. Aggregate 측 어노테이션(서브시스템 및 컴포넌트 인스턴스 범위)은 maps.values 하위 키만 발동할 수 있고, Release 측 어노테이션(경계 및 컴포넌트 인스턴스 범위)은 maps.infra 하위 키만 발동할 수 있습니다. Manifest 바인딩은 두 기둥 모두에 경로를 선언할 수 있으며, 각 측은 호환되는 부분 집합만 발동하고, 측면 간 합성은 IR 빌드 시점에 필드별로 기여분을 병합합니다. 이 분할은 어노테이션 위치에서 values-개발자 / infra-운영자 작성 분리를 유지합니다. 이는 명시적 연결 위치에서 values:와 infra:가 강제하는 것과 같은 분리입니다. 하위 키별 설명과 측면 간 합성 패턴은 providers/well-known-annotations.md §“Side-vs-pillar partition per subkey”를 참고하십시오.
Provides
provides: 필러는 파생됩니다. Recipe가 이를 선언하지만, values / infra와 달리 개발자가 직접 작성하지 않습니다. Recipes는 토폴로지 파이프가 소비할 공개 출력 문자열을 계산합니다.
Recipe의 provides: 블록은 <key>: <template> 쌍의 맵입니다. 각 템플릿은 provides 평가 중에 Recipe 자체의 자기 완결적 표면(.values, .infra, .context.instance_id, 노드의 provider가 보고하는 경우의 .context.rendered_name, 노드의 해석된 .locals)에 대해 평가됩니다. 결과 문자열은 .provides를 통해 노출되며, 호출자의 uses[].inject 블록이 from: "<key>" 참조로 소비합니다. .locals를 사용할 수 있는 이유는 노드의 locals가 해당 단계의 프리앰블에서 provides보다 먼저 해석되기 때문입니다(아래 Locals 참조). locals 블록이 선언하지 않은 키를 지정하면 중단됩니다.
자기 완결성 불변식. Recipe의 provides: 템플릿은 .context.inject나 .context.uses를 참조해서는 안 됩니다. provides 평가는 이 템플릿들을 임의의 순서로 실행합니다. 템플릿은 노드 자신의 데이터만 닫아 두므로 순서는 중요하지 않습니다. 노드 간 참조는 이 평가를 토폴로지 반복 순서에 결합시키게 되며, 설계는 이를 의도적으로 피합니다. 규칙과 그 근거는 templates/expansion-matrix.md의 6행을 참조하십시오.
provides:가 필러인 이유. 출력 문자열은 모든 Recipe의 정식 공개 표면입니다. 다운스트림 소비자(호출자의 uses[].inject, .context.uses를 통해 대상의 해석된 provides를 읽는 FeatureRecipe의 injectMapping 블록)는 이 딕셔너리를 타입이 지정된 계약으로 취급합니다. provides:를 필러로 명명하는 것은 values / infra / uses / features와 나란히 일급 지위를 인정하는 것입니다. 이를 “단지 Recipe 내부 요소”로 취급하면 토폴로지 파이프의 주요 데이터 소스로서의 역할을 과소평가하게 됩니다.
Uses
uses: 필라는 토폴로지 엣지 선언입니다. 컴포넌트 인스턴스의 uses: 블록은 해당 컴포넌트가 참여하는 엣지, 즉 컴포넌트가 대상을 소비하는 소켓을 지정합니다. 전체 문법은 topology-triad.md에 문서화되어 있으며, 이 섹션에서는 완전성을 위해 uses:를 필라로 명시합니다.
uses:는 Aggregate 컴포넌트 인스턴스와 피처 어태치먼트에 위치하며, 런타임 템플릿 컨텍스트는 아웃바운드 연결마다 하나의 항목을 별칭을 키로 하여 .context.uses로 노출합니다. 이 프로젝션은 각 엣지의 확인된 대상 메타데이터(대상의 provides, 레이블, 어노테이션)를 담고 있어, 호출자의 Recipes가 기본 렌더링 템플릿 평가 시 컴포넌트 간 포인터 문자열을 읽을 수 있고, 해당 연결에 작성된 어태치먼트도 .context.uses.<alias>.features.<slot>에서 읽을 수 있습니다.
Features 필러
features:는 attachment 필러입니다. 하나의 키워드, 하나의 형태로 모든 attachment를 다룹니다. 운영 Feature, 자격 증명 Feature, 아이덴티티 Feature 모두 작성자가 정한 인스턴스 이름으로 여기에 선언됩니다. 런타임 템플릿 컨텍스트는 노드의 attachment를 .features.<name>으로 노출하며, 각각은 type, values, infra와 attachment의 해석된 provides를 담습니다. 컴포넌트의 연결 중 하나에 작성된 attachment는 대신 그 연결 아래 .context.uses.<alias>.features.<slot>에 같은 형태로 노출되며, .features 아래에는 절대 노출되지 않습니다. 따라서 .features를 순회하는 Recipe는 컴포넌트 자신의 attachment만 만납니다(템플릿 컨텍스트 계약 참조).
인스턴스 이름이 엔티티가 featuresSchema에 선언한 슬롯과 일치하는 attachment는 그 슬롯을 채웁니다. 그 외의 인스턴스 이름은 자유 attachment입니다. 슬롯을 채우는 것이 슬롯 기반 자격 증명이 거쳐 가는 네 가지 표면을 연결합니다.
| 보고 위치 | 작성 위치 | 역할 |
|---|---|---|
Component / Feature featuresSchema: | 카탈로그 엔티티 | 엔티티가 기대하는 슬롯을 선언합니다. 슬롯별로 전달 허용 목록(env / file / blackbox)과, 선택적으로 채움이 만족해야 하는 레이블 셀렉터를 제한합니다 |
Aggregate components.<id>.features.<slot>: | Aggregate 컴포넌트 인스턴스 | 슬롯을 attachment로 채웁니다. attachment 자체의 values:와, 투명 슬롯의 경우 inject: 매핑을 제공합니다 |
Workload containers.<name>.attachments.<KEY>.from/as: | Recipe의 Workload 본문 | 선언된 슬롯을 참조하거나, connection: <alias>와 함께 쓰면 그 연결의 소켓이 선언한 슬롯을 참조하며, 그 슬롯을 채운 것의 컨테이너별 전달 방식을 지정합니다 |
FeatureRecipe (source / workload / artifacts / valuesMapping, injectMapping, pipeline:) | 바인딩된 FeatureRecipe | attachment의 출력을 생성합니다. 출력은 내보낸 리소스, 전달 재작성 또는 둘 다입니다 |
슬롯 이름은 네 표면 모두에 걸쳐 핵심 역할을 하는 식별자입니다. 표면 1이 이를 선언하고, 표면 2–4가 이를 참조하며, 데이터 흐름은 단방향(선언 → 채움 → 참조 → 생성)입니다.
작성 체크리스트는 examples/04-secrets.md의 “The secret-delivery checklist”를 참조하십시오.
Locals
locals: 필러는 Recipe 전용(private) 상태입니다. 블록 전체가 locals 프리앰블에서 해당 노드의 provides:보다 먼저 해석되며, 그 결과 문자열은 Recipe 자신의 이후 모든 템플릿(provides:, source:, valuesMapping:, workload:, artifacts:, assertions:, pipeline[].with)에서 볼 수 있습니다. 블록에 선언되지 않은 키를 지정하는 provides: 템플릿은 중단됩니다.
작성 위치: Recipe spec.locals: 블록 — <key>: <template> 쌍의 맵으로, 자체 완결된 노드 로컬 표면에 대해 평가됩니다. 이 표면에는 .context.instance_id, .values, .infra, 그리고 같은 블록에서 이미 해석된 항목들이 있습니다. 그 밖의 것은 없습니다. .provides, .metadata 및 나머지 .context.*는 포함되지 않으며, 이를 참조하면 중단됩니다.
순서가 핵심입니다. 항목은 작성된 순서대로 해석되며, 항목은 자신보다 위에 정의된 형제 항목을 읽어 그 해석된 값을 받을 수 있습니다. 연쇄는 아래 방향으로만 진행됩니다. 한 항목이 다른 항목을 읽는 경우 정의를 그 읽는 항목 아래로 옮기면 거부되며, 컴파일러는 참조가 해석되도록 블록을 재정렬하지 않습니다. 뒤에 오는 항목을 참조하면 순서 오류를 명시하며 중단되고, 선언되지 않은 키를 참조하면 해당 키를 명시하며 중단됩니다. source:가 구조화된 블록인 Recipe에서는 그것이 지정하는 아티팩트가 고정(pin)되는 동안에도 두 오류가 모두 거부되므로, aggrega pull이 빌드가 출력을 렌더링하기 전에 이를 보고합니다. 이 검사는 입력된 문자 그대로가 아니라 참조가 해석되는 경로를 읽으므로, 직접 형식, with .locals 블록, .locals에 바인딩된 변수, 그리고 괄호로 묶은 블록인 (.locals).<key> 또는 ($.locals).<key> 모두에 똑같이 적용됩니다. 검사가 다루지 않는 표기가 한 가지 있습니다. index .locals나 (default dict .locals).<key>처럼 함수를 통해 접근하는 키입니다. 이 방식으로 접근한 키가 없으면 중단되지 않고, 아무것도 출력하지 않는 대신 리터럴 텍스트 <no value>를 렌더링합니다. 단, index 자체를 통한 경우는 예외로, 읽는 맵에 해당 키가 없으면 모든 템플릿 표면에서 키를 명시하며 중단됩니다.
가시성: Recipe 전용. .context.uses[].locals 필드는 없으므로 호출자는 엣지를 통해 대상의 locals를 읽을 수 없습니다. 호출자가 읽을 수 있는 것은 대상의 provides:입니다.
사용 사례:
- Recipe의
valuesMapping:과provides:가 모두 사용하고, 같은 component에 연결된 자격 증명 FeatureRecipe가.locals.secret_target_admin_password로 읽는 Recipe 내부 포인터 문자열(예: Secret 이름의 접미사인secret_target_admin_password: "redis-auth")을 계산합니다. 연결의 템플릿은 호스트 Recipe의 해석된 locals와 연결 자체의 locals가 병합된 결과를 봅니다.helm대상에서는 각각이 전체 이름을{{ .context.rendered_name }}-{{ .locals.secret_target_admin_password }}로 작성합니다. 렌더링된 이름은 component의 이름을 Kubernetes 이름에 허용되는 문자로 표기한 것이며 local은 이를 읽을 수 없으므로, local이 접미사를 담고 각 읽는 쪽이 둘을 결합합니다. - 하나의 Recipe 안에서 반복되는 계산 값의 중복 제거(한 번 계산한 호스트 이름을 여러
valuesMapping:필드에서 참조). - 인라인으로 쓰면 읽기 어려운 복잡한 템플릿 로직을 위한 중간 값.
provides:와 locals: — 공개 면과 비공개 면
Recipe 쪽의 두 필러에는 작성자가 염두에 두어야 할 의도적인 가시성 분리가 있습니다.
provides:는 공개 면입니다. 모든 키는 표준 토폴로지 파이프 표면이며, 다운스트림 호출자의uses[].inject블록이from: "<key>"참조를 통해 이를 사용합니다.provides:딕셔너리는 호출자가 의존하는 타입이 지정된 계약이므로, 키의 이름을 바꾸거나 제거하면uses[].inject선언이 그 키를 참조하는 모든 Recipe에 대한 호환성을 깨는 변경이 됩니다.locals:는 비공개 면입니다. 모든 키는 Recipe 자신의 이후 템플릿 안에서만 보이는 Recipe 내부 상태입니다. 어떤 호출자도 Recipe의 locals를 읽을 수 없습니다.locals:의 이름은 어떤 공개 인터페이스에도 속하지 않으며, 이름을 바꾸는 것은 다운스트림에 영향이 없는 Recipe 내부 리팩터링입니다.
두 필러에는 순서도 있습니다. locals:가 먼저 해석되므로 provides:는 .locals를 읽을 수 있지만 locals:는 .provides를 읽을 수 없습니다. 따라서 local의 값을 provides:를 통해 공개하려면 그 local을 읽는 provides 항목을 추가하면 되며, 표현식은 한곳에 유지됩니다.
이 분리는 Recipe 내부(비공개)와 Recipe 인터페이스(공개)를 구분하는 아키텍처상의 분리에 따른 의도적인 것입니다. provides:와 locals:를 하나의 네임스페이스로 취급하는 작성자는 가시성 구분을 잃고 토폴로지 파이프를 통해 내부 상태를 노출할 위험이 있습니다. provides:에 선언된 모든 키는 작성자의 의도와 관계없이 Recipe의 계약 표면의 일부가 됩니다. 지향할 작성 원칙은 다음과 같습니다. 키를 먼저 locals:에 선언하고, 다운스트림 호출자가 실제로 필요로 할 때에만 provides:로 승격합니다.
가시성은 키가 선언된 필러에 의해 정해집니다. 키별 가시성 표시는 없으므로, 비공개이면서 게시되기도 하는 값은 locals: 항목과 그것을 읽는 provides: 항목으로 표현됩니다.
Parameters
Aggregate와 Release 스키마는 모두 루트에 parameters 딕셔너리를 가집니다. 개발자는 Aggregate가 기대하는 키를 선언하고, 운영 담당자는 환경별 Release 파일에서 값을 채웁니다. 이러한 분리가 GitOps 승격의 메커니즘입니다. 변경 불가능한 단일 Aggregate.yaml이 Dev, Staging, Production 환경을 거쳐 이동하며, 각 환경의 Release가 자체 파라미터 값을 제공합니다.
spec: parameters: corp_db_name: type: string required: true env_workers: type: integer required: true region: type: string required: true enable_debug: type: boolean required: true components: my-backend: type: core/python-worker:1.0.0 values: workers: {{ .parameters.env_workers }} region: "{{ .parameters.region }}"# release-prod.yaml — inline parameter valuesspec: aggregate: my-app manifest: prod-manifest parameters: corp_db_name: "enterprise_data" env_workers: 10 region: "eu-west-1" enable_debug: false파라미터 값을 별도 파일(예: Release와 함께 체크인된 환경별 .yaml)에 두는 CI/CD 흐름에서는 Release가 $import: 형식을 사용합니다: parameters: { $import: ./prod-values.yaml }. 파일의 내용이 Release 표면에서 인라인 맵을 대체합니다. 경로는 명령을 어디에서 실행하든 Release가 있는 디렉터리를 기준으로 해석되며, 워크스페이스 안의 파일을 가리켜야 합니다. 워크스페이스 밖에 있는 Release의 경우에는 그 Release가 있는 디렉터리 안의 파일이어야 합니다. 다중 파일 계층화(기본 파일과 환경별 오버레이의 결합)는 Release extends: 체인으로 표현합니다. 부모 Release가 기본 파라미터를 제공하고, 자식 Release가 이를 확장하여 키별로 재정의합니다.
파라미터 수명 주기. 컴파일러는 세 단계에 걸쳐 파라미터를 해석합니다. (1) 기본값 채우기 — default:가 정의되어 있고 Release 값이 없는 슬롯은 기본값을 받습니다. (2) 파라미터 계약 검증 — 타입이 지정된 parameters: 계약이 각 값을 선언된 type / enum / min / max / pattern 제약 조건에 대해 검증하며, 채워진 기본값도 포함되므로 자체 계약을 위반하는 기본값은 빌드를 중단시킵니다. (3) 보간 — 컴파일러가 Aggregate의 전체 텍스트를 템플릿으로 평가하여 모든 {{ .parameters.<slot> }} 참조를 해석된 값으로 대체합니다. 병합된 맵은 이후 렌더링 내내 읽을 수 있는 상태로 유지되므로, 경로 템플릿(Release 경계의 directory: / subDirectory:)은 ../path-template-variables.md에 문서화된 닫힌 허용 목록에 따라 .parameters.<slot>을 직접 읽을 수 있습니다. 값 템플릿 표면(Recipe valuesMapping, FeatureRecipe injectMapping / provides / pipeline.with, Workload 본문)은 템플릿 컨텍스트에서 .parameters를 받지 않습니다. 이들은 3단계 보간에 의해 주변 values: 문자열에 기록된 해석된 값을 사용합니다.
파라미터 호이스팅 체크리스트
환경에 따라 달라지는 모든 값은 네 개의 작성 접점을 순서대로 거칩니다. 작성자가 갖춰야 할 멘탈 모델은 다음과 같습니다. Dev / Staging / Production 사이에서 달라지는 값이라면 Aggregate(선언), values 템플릿(참조), Release(이행), Recipe 템플릿(사용)을 모두 수정해야 한다고 예상하십시오.
| 단계 | 보고 위치 | 작업 |
|---|---|---|
| 1 | Aggregate spec.parameters.<name> | 파라미터를 Aggregate의 타입이 지정된 작성 계약의 일부로 선언합니다. 각 파라미터 슬롯은 선언된 type(string, integer, number, boolean, array, object), 선택적 description, 선택적 default, 선택적 값 공간 제약 조건(enum, min, max, pattern, minLength, maxLength), 그리고 객체 타입 슬롯의 경우 선택적 중첩 구조를 가집니다. 계약은 보간 전에 Release가 제공한 각 값을 검증합니다. |
| 2 | 같은 Aggregate 안의 Component values: 템플릿 | 파라미터를 사용하는 component(또는 feature, 하위 aggregate)의 values: 블록 안에서 {{ .parameters.<name> }}로 파라미터를 참조합니다. 참조는 Go 템플릿 표현식이며, 컴파일러는 해석의 보간 단계에서 이를 평가합니다. |
| 3 | Release spec.parameters.<name>(인라인 또는 parameters: { $import: ./path.yaml }) | Release 표면에서 환경별 값으로 파라미터를 이행합니다. 환경별 Release 파일은 Aggregate를 수정하지 않고도 같은 파라미터 키에 서로 다른 값을 제공합니다. |
| 4 | Recipe valuesMapping: 템플릿 | 해석된 값을 {{ .values.<key> }}로 사용합니다. Recipe는 값 템플릿 표면이므로 템플릿 컨텍스트가 .parameters를 직접 담지 않습니다. 환경별 차이는 위의 보간 단계가 기록한 보간 후 values: 딕셔너리를 통해 Recipe에 도달합니다. (Release 경계의 경로 템플릿은 예외입니다. 비대칭 허용에 따라 렌더링 중에 .parameters.<slot>을 직접 읽습니다.) |
네 접점은 순차적이며 모두 핵심입니다. Aggregate 선언을 건너뛰면 Release가 이행할 슬롯이 없고, values 참조를 건너뛰면 Recipe가 사용할 값이 없으며, Release 이행을 건너뛰면 파라미터가 비게 됩니다. 컴파일러는 해석 중에 이 체인을 검증합니다(타입이 지정된 parameters: 선언에 대한 파라미터 계약 검증, 이어서 주변 values: 문자열로의 보간, 이어서 결과 values: 딕셔너리를 Component 또는 Feature schema:에 대해 검증하는 JSON Schema 검증). 불일치는 파라미터 계약 위반(타입이 지정된 parameters: 선언에 대해 감지), 채워지지 않은 템플릿 오류(보간 시 감지), 또는 values: 스키마에 대한 JSON Schema 제약 조건 위반(스키마 검증 시 감지) 중 하나로 드러납니다.
이 패턴은 GitOps 승격의 표준 메커니즘입니다. 변경 불가능한 단일 Aggregate가 환경을 거쳐 이동하고, 각 환경의 Release가 자체 파라미터 값을 제공합니다. 작성자가 환경별로 달리하려는 모든 값은 Aggregate에 직접 넣지 말고 파라미터 체인에 두어야 합니다.
필러별 extends: 병합 의미론
카탈로그 엔터티가 extends:를 선언하고 컴파일러가 상속 체인을 따라가면, 각 필러의 내용은 필러별 규칙에 따라 병합됩니다. 의미론은 필러마다 다르며, 아래 표가 필러별 표준 참조입니다.
| 필러 | extends: 체인에서의 병합 동작 |
|---|---|
values (JSON Schema 2020-12) | Feature 체인에서는 스키마가 JSON Schema 2020-12 합성을 통해 합성됩니다. 확장하는 Component는 필러 내용을 작성하지 않으며, 체인의 모든 깊이에서 기반이 작성한 블록을 그대로 받습니다. |
infra (JSON Schema 2020-12 조각) | values와 같습니다. Feature 체인에서는 합성되고, 확장하는 Component에는 통째로 상속됩니다. |
provides (Recipe 템플릿 맵) | 최상위 얕은 대체: 같은 이름에 대해 자식 키가 부모 키를 완전히 대체하고, 형제 키는 부모에서 유지됩니다. 템플릿은 합성되지 않으며, 자식의 템플릿이 해당 슬롯을 완전히 소유합니다. |
uses (usesSchema) | 소켓 이름 기준의 소켓별 전체 항목 오버레이입니다. 자식은 기반이 선언하지 않은 소켓을 추가할 수 있으며, 기존 이름으로 다시 선언한 소켓은 해당 항목을 통째로 대체합니다. 값 스키마와 infra 스키마, selector가 함께 대체됩니다. 소켓 항목은 합성되지 않으며, 다시 선언된 selector를 기반의 것과 비교하는 과정도 없습니다. |
features (featuresSchema 슬롯별 스키마) | 슬롯 이름 기준의 슬롯별 전체 항목 오버레이로, usesSchema와 같은 방식입니다. 자식은 슬롯을 자유롭게 추가할 수 있으며, 다시 선언한 슬롯은 기반의 항목과 합성되지 않고 통째로 대체합니다. |
locals (Recipe 템플릿 맵) | 최상위 얕은 대체 — provides와 같습니다. |
parameters (Aggregate 루트 맵) | Aggregate에는 extends: 필드가 없으므로 파라미터를 병합하는 Aggregate 체인은 없습니다. Release extends: 체인에서는 맵 값 파라미터가 자식 키 우선으로 깊은 병합되고, 스칼라 값 파라미터는 자식으로 대체되며, 자식이 null로 작성한 키는 제거됩니다. |
일반적인 패턴은 종류와 표면에 따라 갈립니다. Feature의 스키마 검증 필러는 JSON Schema 2020-12에 따라 합성됩니다. 확장하는 Component의 필러는 통째로 상속됩니다 — 아무것도 작성하지 않으므로 그 계약은 정확히 기반의 계약이며, 따라서 구조상 기반의 제약을 완화할 수 없습니다. 고정 형태 표면인 usesSchema와 featuresSchema는 두 종류 모두에서 이름 기준으로 오버레이됩니다: 자식은 항목을 추가하고, 다시 선언한 항목은 기반의 항목을 통째로 대체합니다. 템플릿으로 작성되는 필러는 키별 얕은 대체를 사용하여, 자식이 선언한 모든 템플릿 슬롯을 자식이 완전히 소유하게 합니다.
확장하는 Component는 필러가 아니라 assertions:를 통해 제약을 강화합니다. 이는 자식이 추가하는 술어로, 상속받은 술어와 함께 평가됩니다. 이 메커니즘은 inheritance-and-interface.md를 참조하십시오.
상속 메커니즘 자체는 카탈로그 종류를 다루는 inheritance-and-interface.md의 “extends를 통한 상속”을 참조하십시오. Release는 카탈로그 엔터티가 아니며 자체 규칙으로 병합됩니다. 그 규칙은 entities/release.md의 “복합 Release와 extends: 상속”에 있습니다.
필러 간 메커니즘
이정표 프레이밍은 문서화된 자기 완결 영역을 제외한 모든 곳에서 필러 간 읽기를 허용합니다. 아래의 패턴들이 일반적인 필러 간 메커니즘을 정형화하며, 작성자가 트레이드오프를 인식할 수 있도록 작성상의 나쁜 징후 하나를 문서화합니다.
스키마 브리지 필러 간 파이핑 — 벽이 아닌 이정표
필러 경계는 작성 규율입니다. 아키텍처는 무엇이 어디에 들어가는지 이정표로 안내하며(개발자의 인지적 의도는 values:, Ops의 물리적 사이징은 infra:, Recipe가 내보내는 문자열은 provides: 등), 관례를 집행하는 것은 카탈로그 리뷰어입니다. 템플릿 엔진 자체는 문서화된 자기 완결 규칙이 금지하지 않는 한 필러 간 읽기를 허용합니다(Recipe provides:는 .context.inject를 보지 못하며, FeatureRecipe 경계 스코프 provides:는 소비자별 필드를 보지 못합니다). 필러의 벽은 이정표이지 강제가 아닙니다.
이정표로 안내되는 대표적인 예외는 다음과 같습니다. Component의 schema:는 개발자용 values: 다이얼을 선언할 수 있으며, Recipe의 valuesMapping: 템플릿이 이를 렌더링된 infra: 형태의 출력으로 전달합니다. 개발자는 타입이 지정된 values: 필드를 통해 의도를 지시하고, Recipe 템플릿은 개발자가 인프라 코드를 작성하지 않아도 결과 값을 provider의 인프라 계층으로 전달합니다. 작동 예시는 다음과 같습니다.
# Component schema declares a developer-facing dial in valuesspec: schema: values: required_iops: { type: integer, min: 100 }# Recipe valuesMapping pipes the developer's intent into the provider's infra-side knobvaluesMapping: iops_limit: "{{ .values.required_iops }}"이 브리지는 inheritance-and-interface.md에 작동 예시와 함께 문서화되어 있습니다. 아키텍처적 의도(Recipe가 전달하는, 선언된 필러 간 다이얼)는 한 방향, 즉 개발자 측 values:에서 Ops 측 렌더링 출력으로만 흐르며, Component 스키마 자체가 아니라 Recipe의 매핑 템플릿에 위치합니다. 필러 경계는 이정표로 유지됩니다. 개발자는 values:를 보고, Recipe는 values:와 infra:를 모두 보며, 렌더링된 출력은 이 둘을 결합합니다.
필러 간 inject 누산기
.context.inject 파이프는 필러에 걸친 세 소스가 병합되는 지점입니다.
- Component 수준 자기 주입(
component.inject) — 컴포넌트 자신의values와 자신의provides에서 문자열을 가져옵니다. - Uses 주입(
uses[].inject) — 대상의provides에서 문자열을 가져옵니다. - FeatureRecipe
injectMapping:가로채기 — 위의 모든 소스와 FeatureRecipe 자신의infra:페이로드에서 문자열을 가져옵니다.
기본 렌더링이 실행될 때쯤이면 .context.inject.<mechanism>.<key>에는 세 소스 모두의 항목이 누적되어 있습니다. 이 누산기는 구조상 필러 간에 걸칩니다. values, provides, infra에서 비롯된 항목이 모두 같은 .context.inject 맵으로 흘러듭니다. .context.inject를 소비하는 Recipes는 어느 필러가 어느 항목을 제공했는지 알 필요 없이 병합 이후의 상태를 봅니다.
inject 문법과 충돌 규칙은 topology-triad.md를 참조하십시오.
필러 간 제약 중복
검증 계층이 서로 다른 두 필러에 존재하는 필드는 중복된 제약을 가질 수 있습니다. 대표적인 예는 Component의 usesSchema에 선언된 포트 번호(JSON Schema로 검증, 범위 min: 1, max: 65535)와 Workload의 services.<name>.ports.<port> 필드에서 소비되는 같은 포트 번호입니다. 후자에 대해서는 provider 렌더링 플러그인의 spec.provider.workloadSchema가 비특권 포트를 위한 min: 1024 규칙을 추가할 수 있습니다. provider 렌더링 Plugin의 spec.provider.workloadSchema는 provider가 Workload를 변환하는 방식을 문서화하고 그 provider가 Workload를 합성할 수 있음을 표시할 뿐, 아무것도 검증하지 않습니다. 모든 Workload 본문은 provider와 관계없이 플랫폼의 Workload 스키마에 대해 검증되므로, workloadSchema에만 작성된 제약(예: min: 1024 포트 규칙)은 강제되지 않습니다. 그런 값을 거부하려면 제약을 Component의 스키마나 어서션에 두십시오.
Feature 부착 / Component 필러 격리
Feature 부착은 부모 Component의 필러에 기록하지 않습니다. 부착된 각 Feature는 자신만의 필러 페이로드(자신의 values: 블록과 자신의 infra: 블록)를 가집니다. Feature의 리소스를 합성하는 FeatureRecipe는 Component의 페이로드와 독립적으로 자신의 필러 페이로드를 읽습니다. 격리 대상은 입력입니다. 부착이 쓰는 것이 어떻게 되든, 부착이 읽는 것은 자기 자신의 것입니다. 대상의 provider가 개별 문서를 쓰는 경우, 부착의 렌더링 출력은 자체 디렉터리 아래에서 Component의 출력과 나란히 놓입니다. provider가 경계의 기여자들을 하나의 문서로 합치는 경우, 부착은 Component와 마찬가지로 그 문서에 기여하며, 각 리소스는 여전히 부착 자신의 식별 정보를 가지므로 무엇이 어디서 왔는지 읽을 수 있습니다.
작성자에게 미치는 두 가지 결과:
- Feature 부착의
values:설정은 Component의valuesMapping:템플릿의.values에 나타나지 않습니다. Component는 자신의 값만 봅니다. - Feature의
infra:페이로드는 Component의infra:로 흘러들지 않습니다. 부착된 각 Feature는 해당 Feature의 리소스로 범위가 한정된 자신만의 물리적 사이징을 가집니다.
이 격리는 아키텍처의 관심사 분리에 따라 명시적입니다. Features는 5-Tier Onion Model을 통해 Components 위에 계층화되는 독립적인 기여자입니다. 부착 영역과 순서는 labels-and-annotations.md “Feature attachment — five surfaces”를 참조하십시오.
두 필러에 있는 같은 속성 이름
spec.schema.values:와 spec.schema.infra:가 루트, 임의의 중첩 깊이, 또는 둘 다에서 같은 속성 이름을 선언하는 Component나 Feature는 흔한 작성상의 냄새입니다. 두 필러는 설계상 별개의 네임스페이스이므로(컴파일러는 중복을 허용합니다) 스키마는 검증을 통과하고 렌더링 출력도 올바른 형태입니다. 문제는 인지적입니다. 독자와 템플릿 작성자는 스키마를 훑거나 이에 대한 템플릿을 작성할 때마다 “지금 읽는 foo는 어느 필러에 있는가?”라는 마찰을 겪습니다.
# Smell — both pillars declare `mode`. A reader of the schema or a# template against the Feature has to disambiguate every reference.spec: schema: values: mode: { type: string } infra: mode: { type: string }의도적으로 중복시킨 작성자에게는 둘 다 유지할 실제 이유가 있습니다. 예를 들어 values 아래에서는 “애플리케이션 운영 모드”("debug" / "production")를, infra 아래에서는 “배포 토폴로지 모드”("standalone" / "clustered")를 뜻하는 mode는 서로 다른 의미를 가지며 이름이 우연히 일치할 뿐입니다. 우발적으로 중복시킨 작성자(더 흔한 경우)는 한 항목의 이름을 바꿉니다.
두 번째 의도적 형태는 어느 작성자든 제공할 수 있는 하나의 데이터입니다. 호출자의 로케이터를 담는 표준 라이브러리의 자격 증명 Features인 core/referenced-secret, core/referenced-secret-set, core/secret-value, core/secret-provided는 이를 두 필러 모두에 하나의 이름과 하나의 형태로 선언하므로, 개발자는 values에, 운영자는 infra에 이를 작성할 수 있으며, 각 Feature 자체의 assertion은 두 곳 모두에 쓰거나 어느 곳에도 쓰지 않은 부착을 거부합니다. 아래의 권고는 이 네 가지에 도달하는 모든 로드에서 이들의 이름을 표시하며, 이들에 대해서는 실수가 아니라 계약을 보고합니다.
카탈로그 로드는 중복이 적어도 한쪽에서 말단 리프로 해석되는 모든 같은 이름의 속성에 대해 notice: LINT: <kind> "<name>" at <path> declares property "<property>" in both values: and infra: pillars (path: <dotted-path>) 권고를 내보냅니다. 공유된 조직용 네임스페이스로 존재하는 같은 이름의 속성(두 필러 모두 서로 겹치지 않는 하위 속성을 가진 ingress라는 객체를 가짐)은 경고하지 않으며, 리프 중복만 보고됩니다. 이 경고는 권고일 뿐이며 빌드는 계속 진행됩니다.
필러 검증 티어
필러는 세 개의 티어에 걸쳐 검증을 수행합니다. 각 티어는 서로 다른 관심사를 다루며, 같은 필드가 둘 이상의 티어에서 검증될 수 있습니다(위의 “필러 간 제약 중복” 참조).
| 티어 | 검증 대상 | 실행 위치 |
|---|---|---|
| 1 — JSON Schema 엔벨로프 | 구조적 형태(어떤 키가 존재하는지, 타입이 필드 선언과 일치하는지) | 해석 단계, 파일 로드마다 |
2 — 필러별 스키마(schema / featuresSchema / usesSchema) | JSON Schema 2020-12로 검증되는 필러별 타입 지정 내용 | 해석 단계, 엔벨로프 통과 후 |
| 3 — provider 기능 게이트 | 바인딩된 provider의 합성 모드 기능으로 게이트되는 Workload 내용으로, provider 렌더링 플러그인의 spec.provider.workloadSchema에 문서화됨 | 기본 렌더링, valuesMapping 해석 후 |
네 계층 오류 형태 표와 계층별 오류 접두사는 validation-surface.md를 참조하십시오.
기본값 메커니즘
기본값은 코퍼스 전반에서 서로 다른 여러 메커니즘을 통해 나타납니다. 작성자는 “default”라는 단어를 다섯 가지 이상의 맥락에서 접하게 되며, 아래 표는 작성자가 필드를 비워 두었을 때 어떤 메커니즘이 값을 생성하는지에 대한 표준 참조입니다.
| # | 메커니즘 | 작성 위치 | 트리거 |
|---|---|---|---|
| 1 | JSON Schema default: (축약형 { default: <value> }) | Component / Feature schema:, Aggregate parameters: | 개발자가 키를 생략하면 필드는 기본값으로 검증됩니다. Aggregate 매개변수의 경우, 계약 검증이 실행되기 전에 매개변수 병합이 선언된 기본값을 채웁니다(templates/parameters-context.md 참조). |
| 2 | Go 템플릿 optional .X `Y` <fallback> | Recipe valuesMapping:, Workload 본문, FeatureRecipe 템플릿, 어설션 평가기 | 존재 여부를 인식하는 폴백 — 키가 맵에 없을 때만 <fallback>을 반환하며, 키에 작성된 0 / 빈 값 / false는 작성된 그 값을 반환합니다. Aggrega 측의 표준 누락 필드 폴백 형태입니다. templates/sprig-functions.md를 참조하십시오. |
| 3 | Go 템플릿 | default <expr> | Recipe valuesMapping:, Workload 본문, FeatureRecipe 템플릿 | “빈” 값(Sprig의 빈 값 검사 — 0, 빈 문자열, false, nil)에서 작동하는 인라인 파이프라인입니다. 맵에 없는 경우와 존재하지만 0/빈 값/false인 경우를 하나로 취급합니다. 이렇게 하나로 취급해도 괜찮은, 호출 지점별 재정의 의미론(바인딩의 폴백이 필드의 스키마 수준 기본값과 다른 경우)에 적합합니다. 작성된 0 / 빈 값 / false가 정당한 의도인 누락 필드 폴백에는 적합하지 않으며, 이 경우에는 optional(메커니즘 2)을 사용하십시오. |
| 4 | Sprig default 함수({{ default <expr> .field }}) | 3과 동일 | 메커니즘 3의 함수 형태로, 빈 값을 동일하게 하나로 취급합니다. |
| 5 | Recipe locals: 폴백 | Recipe locals: 템플릿 | locals 항목이 Recipe의 나머지 부분에서 사용하는 기본값을 담은 문자열을 계산합니다 |
권장 배치 지침. 기본값이 실제로 타입 계약의 일부인 경우(예: “개발자가 재정의하지 않는 한 이 포트는 기본적으로 5432입니다”)에는 JSON Schema default:(메커니즘 1)가 표준입니다. IDE 자동 완성이 기본값을 표시하고, 검증 도구가 이를 따르며, 계약은 Component / Feature 카탈로그 엔터티 또는 Aggregate 매개변수 선언과 함께 전달됩니다. Recipe 템플릿에 선택적 맵 키에 대한 폴백이 필요한 경우에는 optional 헬퍼(메커니즘 2)가 표준 누락 필드 폴백 형태이며, 작성된 0 / 빈 값 / false를 누락과 구분합니다. Go 템플릿 | default(메커니즘 3)는 누락된 값과 거짓 값을 하나로 취급해도 괜찮은 호출 지점별 재정의 경우를 위해 남겨 둡니다. 재정의 의미론이 명시적인 의도일 때만 사용하십시오.
상호 참조
inheritance-and-interface.md—extends:메커니즘,implements:Interface Binding, 스키마 브리지 교차 필러 파이핑.topology-triad.md—provides,inject,uses의 토폴로지 메커니즘.labels-and-annotations.md— 데이터 필러와 구별되는 콘텐츠 측 메타데이터 어휘(위의 정식 필러 목록에는 레이블 / 어노테이션 / 게시 필드가 포함되지 않으며, 이들은 메타데이터 어휘입니다).publishing-surface.md— 데이터 필러와 구별되는 게시 측 메타데이터 어휘.validation-surface.md— 위의 세 가지 필러 검증 계층을 포함한 네 가지 스키마 검증 계층.templates/expansion-matrix.md— 교차 필러 읽기에 대한 템플릿 위치별 사용 가능 여부 + Recipeprovides:및source:에서의 자기 완결성 규칙.examples/04-secrets.md— 여섯 접점으로 이루어진 시크릿 전달 체크리스트.architecture/06-data-taxonomy-and-composition.md— 다섯 가지 DSL 구조 키워드에 대한 정식 개념 설명.