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

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

속성

속성타입필수설명
capabilitystring아니요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_namestring아니요directory:와 subDirectory: 모두에서 사용할 수 있습니다. release.spec.boundaries.의 맵 키입니다.
parametersobject아니요directory:와 subDirectory: 모두에서 사용할 수 있습니다. Release의 타입이 지정된 parameter 맵입니다. 경로 템플릿은 parameters 단일 패스 수명 주기에 대한 의도적인 예외로서 .parameters에 접근할 수 있습니다. 값 템플릿은 .parameters를 받지 않으며, 환경에 따른 값은 이미 보간된 Aggregate YAML을 통해 값 템플릿으로 전달됩니다.
component_idstring아니요subDirectory:에서만 사용할 수 있습니다. 배치되는 기여자의 식별자입니다. 컴포넌트의 경우 평탄화된 컴포넌트별 인스턴스 ID입니다(예: ‘backend’ 또는 ‘data-layer.main-db’). FeatureRecipe가 경계에 대해 한 번 실행되는(executionScope: boundary) 경계에 부착된 Feature의 경우, 해당 부착이 내보내는 모든 리소스가 aggrega.ai/component-id 레이블에 담는 조합된 컴포넌트 식별자입니다(예: 경계 ‘app’의 부착 ‘shared’라면 ‘bfr—app—shared’). 부착의 렌더링 플러그인이 이름을 제한하는 경우 줄어들며, 그래서 그것이 가리키는 디렉터리가 그 레이블과 일치합니다. 경계 수준에서는 의미가 없으며 directory: 템플릿에서는 파싱 시점 검증에 의해 거부됩니다.
parent_boundaryobject아니요directory: 및 subDirectory: 모두에서 사용할 수 있습니다. 상위 boundary의 이미 해석된 값입니다. 각 boundary의 템플릿을 해당 상위의 해석된 값으로 평가하는 깊이 우선 탐색을 통해 채워지며, 하위 boundary는 여기서 자신의 값을 볼 수 없습니다. 최상위 boundary에는 상위가 없으므로, 거기서 parent_boundary 아래의 키를 읽으면 빌드가 중단되며 해당 boundary, 템플릿 필드, 누락된 키가 표시됩니다.
manifestobject아니요directory:와 subDirectory: 모두에서 사용할 수 있습니다. component별로 평가된, 해석된 Recipe 메타데이터를 담습니다.

추가 속성은 허용되지 않습니다.

path-template-context.parent_boundary

directory: 및 subDirectory: 모두에서 사용할 수 있습니다. 상위 boundary의 이미 해석된 값입니다. 각 boundary의 템플릿을 해당 상위의 해석된 값으로 평가하는 깊이 우선 탐색을 통해 채워지며, 하위 boundary는 여기서 자신의 값을 볼 수 없습니다. 최상위 boundary에는 상위가 없으므로, 거기서 parent_boundary 아래의 키를 읽으면 빌드가 중단되며 해당 boundary, 템플릿 필드, 누락된 키가 표시됩니다.

속성타입필수설명
directorystring아니요부모의 평가된 directory 문자열입니다.
boundary_namestring아니요부모의 이름입니다(release.spec.boundaries의 맵 키).
parametersobject아니요Release의 매개변수 맵으로, .parameters가 담는 것과 같은 맵입니다.
annotationsstring 맵아니요캐스케이드가 해석된 후의 상위 boundary 어노테이션입니다.

추가 속성은 허용되지 않습니다.

path-template-context.manifest

directory:와 subDirectory: 모두에서 사용할 수 있습니다. component별로 평가된, 해석된 Recipe 메타데이터를 담습니다.

속성타입필수설명
recipe_namestring아니요component별 조회로 해석된 Recipe의 이름입니다.

추가 속성은 허용되지 않습니다.