템플릿 개요
Recipe 및 FeatureRecipe 작성자는 특정 평가 지점에서 Go text/template 코드를 작성합니다. 이 지점은 provides 항목, locals 항목, valuesMapping(인라인 또는 $import:로 로드), workload: 내용(인라인 또는 $import:로 로드), artifacts: 항목(인라인 또는 항목별 $import:로 로드), FeatureRecipe injectMapping, source:, assertions: 항목, 그리고 각 pipeline: 단계의 with:와 when:입니다. 각 지점은 컴파일 파이프라인의 정해진 단계에서 실행되며, 필러 컨텍스트의 정해진 뷰를 받습니다. 이 장들은 템플릿 표면, 즉 템플릿이 실행되는 위치, 각 지점에서 컨텍스트가 노출하는 내용, 사용할 수 있는 헬퍼 함수를 설명합니다.
템플릿 컨텍스트의 형태와 평가 순서는 핵심적인 계약이며, 둘 중 하나라도 변경되면 기존의 모든 Recipe 템플릿이 깨집니다. 템플릿 컨텍스트는 컴파일러와 함께 제공되는 JSON Schema에 형식적으로 정의되어 있습니다. 지점별 평가 매트릭스는 어느 지점에서 어느 필러를 읽을 수 있는지 설명하며, Go 템플릿 엔진은 Sprig 헬퍼 라이브러리와 Aggrega 고유 확장을 함께 제공합니다. 이러한 평가 지점의 기준이 되는 파이프라인 단계는 ../architecture/10-compilation-pipeline.md에서 아키텍처 수준으로 설명합니다. FeatureRecipe injectMapping에는 inject 매핑, Recipe .locals 및 .source에는 locals 프리앰블과 소스 해석, 기본 Recipe valuesMapping에는 기본 렌더링, FeatureRecipe 리소스 생성에는 feature 렌더링 단계가 해당합니다.
주제별 레퍼런스
- 템플릿 확장 매트릭스 — 모든 템플릿 평가 지점, 각 지점이 읽는 필러, 출력이 IR 그래프나 후속 하위 패스로 흐르는 방식을 다루는 지점별 공식 표입니다.
- 템플릿 컨텍스트 계약 — 컴파일러가 템플릿에 전달하는 템플릿 컨텍스트의 형식적 형태로, 이중 상태의
.inject/.inject_raw쌍과 보강된.context.usesJOIN 프로젝션을 포함합니다. - 렌더링된 리소스 이름 지정 — 두 식별 키 중 어느 것이 무엇의 이름을 정하는지,
uses대상과 생산자가 게시하는 참조의 차이, 어떤 프로바이더가 렌더링하는 리소스의 이름을 보고하고 나머지는 왜 보고하지 않는지, 그리고 그러한 이름이 없는 곳에서 키를 거부하는 중단을 설명합니다. - Sprig 함수와 헬퍼 — Go 템플릿 안에서 사용할 수 있는 Sprig 헬퍼와 Aggrega 고유 확장 및 안전 헬퍼, 작성된 숫자가 값 템플릿에서 어떻게 읽히고 출력되고 비교되는지, 그리고 값이 작성되었는지를 묻는 헬퍼와 값이 비어 있는지를 묻는 헬퍼의 구분입니다.
- 매개변수 템플릿 컨텍스트 — Release가 채운
parameters:값이 템플릿에 도달하는 위치입니다. 값 템플릿에는 실행 전에 보간되며, 경로 템플릿만 이를 직접 읽습니다. assertions:블록 — Component, Feature, Recipe 또는 FeatureRecipe가 템플릿으로 선언하는 이름 있는 필드 간 규칙으로, 렌더링 전에 평가됩니다.