Aggrega 경로 템플릿 컨텍스트 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
Aggrega가 Release를 빌드할 때 Release.spec.boundaries[].directory 및 Release.spec.boundaries[].subDirectory(그리고 component별 subDirectory 재정의)에 대해 평가되는 Go 템플릿이 사용하는 변수 허용 목록입니다. 경로 템플릿은 missingkey=error(값 템플릿에 적용되는 전역 missingkey=zero 방식과 구별됨)와 함께 파싱 시점 검증을 사용합니다. 경로 템플릿의 모든 필드 참조는 해당 컨텍스트(directory: 또는 subDirectory:)에 대한 이 허용 목록에 있어야 하며, 알 수 없는 필드는 렌더링 시점이 아니라 항상 파싱 시점에 Loud Guardrail 오류를 발생시킵니다. 값 템플릿과의 차이는 언어 레퍼런스의 경로 템플릿 변수 페이지에서 설명합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
capability | string | 아니요 | directory:와 subDirectory: 모두에서 사용할 수 있습니다. 기여하는 component의 Recipe가 spec.capability에 선언한 렌더링 capability로, 버전 고정은 제거됩니다(예: ‘helm’, ‘helm-chart’ 또는 ‘compose’). subDirectory:의 기본값은 {{ .capability }}이며, 이 기본값 덕분에 각 capability의 아티팩트가 boundary의 directory 아래 각자의 하위 폴더에 배치됩니다. directory: 템플릿에서 이 값은 component별로 해석되므로, 하위 트리가 둘 이상의 capability를 기여하는 boundary는 capability마다 하나의 디렉터리로 평가됩니다. .parent_boundary.directory를 게시하는 별도의 boundary별 순회는 어떤 component도 바인딩되기 전에 실행되며 이 값을 비워 둡니다. |
boundary_name | string | 아니요 | directory:와 subDirectory: 모두에서 사용할 수 있습니다. release.spec.boundaries. |
parameters | object | 아니요 | directory:와 subDirectory: 모두에서 사용할 수 있습니다. Release의 타입이 지정된 parameter 맵입니다. 경로 템플릿은 parameters 단일 패스 수명 주기에 대한 의도적인 예외로서 .parameters에 접근할 수 있습니다. 값 템플릿은 .parameters를 받지 않으며, 환경에 따른 값은 이미 보간된 Aggregate YAML을 통해 값 템플릿으로 전달됩니다. |
component_id | string | 아니요 | subDirectory:에서만 사용할 수 있습니다. 배치되는 기여자의 식별자입니다. 컴포넌트의 경우 평탄화된 컴포넌트별 인스턴스 ID입니다(예: ‘backend’ 또는 ‘data-layer.main-db’). FeatureRecipe가 경계에 대해 한 번 실행되는(executionScope: boundary) 경계에 부착된 Feature의 경우, 해당 부착이 내보내는 모든 리소스가 aggrega.ai/component-id 레이블에 담는 조합된 컴포넌트 식별자입니다(예: 경계 ‘app’의 부착 ‘shared’라면 ‘bfr—app—shared’). 부착의 렌더링 플러그인이 이름을 제한하는 경우 줄어들며, 그래서 그것이 가리키는 디렉터리가 그 레이블과 일치합니다. 경계 수준에서는 의미가 없으며 directory: 템플릿에서는 파싱 시점 검증에 의해 거부됩니다. |
parent_boundary | object | 아니요 | directory: 및 subDirectory: 모두에서 사용할 수 있습니다. 상위 boundary의 이미 해석된 값입니다. 각 boundary의 템플릿을 해당 상위의 해석된 값으로 평가하는 깊이 우선 탐색을 통해 채워지며, 하위 boundary는 여기서 자신의 값을 볼 수 없습니다. 최상위 boundary에는 상위가 없으므로, 거기서 parent_boundary 아래의 키를 읽으면 빌드가 중단되며 해당 boundary, 템플릿 필드, 누락된 키가 표시됩니다. |
manifest | object | 아니요 | directory:와 subDirectory: 모두에서 사용할 수 있습니다. component별로 평가된, 해석된 Recipe 메타데이터를 담습니다. |
추가 속성은 허용되지 않습니다.
path-template-context.parent_boundary
directory: 및 subDirectory: 모두에서 사용할 수 있습니다. 상위 boundary의 이미 해석된 값입니다. 각 boundary의 템플릿을 해당 상위의 해석된 값으로 평가하는 깊이 우선 탐색을 통해 채워지며, 하위 boundary는 여기서 자신의 값을 볼 수 없습니다. 최상위 boundary에는 상위가 없으므로, 거기서 parent_boundary 아래의 키를 읽으면 빌드가 중단되며 해당 boundary, 템플릿 필드, 누락된 키가 표시됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
directory | string | 아니요 | 부모의 평가된 directory 문자열입니다. |
boundary_name | string | 아니요 | 부모의 이름입니다(release.spec.boundaries의 맵 키). |
parameters | object | 아니요 | Release의 매개변수 맵으로, .parameters가 담는 것과 같은 맵입니다. |
annotations | string 맵 | 아니요 | 캐스케이드가 해석된 후의 상위 boundary 어노테이션입니다. |
추가 속성은 허용되지 않습니다.
path-template-context.manifest
directory:와 subDirectory: 모두에서 사용할 수 있습니다. component별로 평가된, 해석된 Recipe 메타데이터를 담습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
recipe_name | string | 아니요 | component별 조회로 해석된 Recipe의 이름입니다. |
추가 속성은 허용되지 않습니다.