Aggrega 템플릿 컨텍스트 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
컴파일러가 렌더링 중에 조립하여 Recipe 및 FeatureRecipe 템플릿에 전달하는 뷰입니다. 첨부 FeatureRecipe를 렌더링할 때 컴파일러는 추가로 .attachment_name과 .inject에 첨부 범위의 컨텍스트를, .context.render_facts에 호스트의 provider가 호스트의 렌더링에 대해 보고한 내용을 채우며, 첨부 자체의 리소스를 생성하는 템플릿에서는 .context.used_by에 호스트를 사용하는 component를 채웁니다. 경계 범위 FeatureRecipe(spec.executionScope: boundary)의 경우, 경계에 대해 한 번 실행하는 템플릿(locals, provides, source, valuesMapping, artifacts, pipeline 단계 등)에서는 .context, .workload, .attachment_name, .inject, .inject_raw 축이 존재하지 않으며 대신 .boundary.* 축이 채워집니다. properties 하단의 boundary 블록을 참조하십시오. 그 injectMapping은 첨부가 도달하는 각 component에 대해 해당 component의 컨텍스트에서 한 번씩 실행되므로 .context.*와 .attachment_name을 읽으며, 그곳에서는 .boundary가 설정되지 않습니다. 이 컨텍스트는 디스크에 저장되지 않으며, 렌더링 중 컴파일러 메모리에만 존재합니다. 이 스키마는 컴파일러와 Ops 템플릿 작성자 간의 계약을 문서화합니다.
기본 렌더링 단계별 가용성(단계 실행 순서대로):
- Provides 평가(locals 프리앰블, 이어서 provides): 노드 로컬 축만 사용 가능합니다. locals 항목은 자신의 블록에서 그 위에 있는 항목을 읽고, provides 템플릿은 노드의 해석된 .locals 전체를 읽습니다. 자기 참조는 금지됩니다(어떤 provides 항목도 다른 항목을 읽지 않음).
- Source 해석(locals 게시 + source 평가): 모든 축 사용 가능, .source와 .workload는 없음. 이 단계에서 해당 locals가 .locals에 게시된 뒤, source:가 이를 기준으로 평가됩니다.
- Values 매핑(valuesMapping): 모든 축 + .source, .workload는 없음.
- Workload 합성(workload 평가): 모든 축 + .source, .workload는 평가 중(자기 참조에서는 없음).
- Artifact 평가(artifacts): 모든 축 + .source + .workload(가장 완전한 컨텍스트).
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
context | object | 예 | ID, 토폴로지, 전달 데이터를 제공하는, 컴파일러가 조립한 실행 컨텍스트입니다. |
values | object | 예 | 이 노드의 불투명한 인지 페이로드로, 해석 시점에 스키마 검증기가 이미 검증한 것입니다. 변경 없이 그대로 전달됩니다. |
infra | object | 예 | 이 노드에 대해 Release에서 주입되는 물리적 사이징 페이로드입니다. Developer를 완전히 우회합니다. |
locals | string 맵 | 예 | Recipe 자체의 비공개 상태입니다(예: primary_compute, volumes_path). locals 프리앰블에서 해당 노드의 provides보다 먼저 평가되고, source 해석 시점에 이 필러에 게시됩니다. 각 항목은 같은 블록에서 지금까지 해석된 항목을 담은 자기 완결적인 노드 로컬 컨텍스트에 대해 평가되는 Go 템플릿이므로, 항목은 자신보다 위에 정의된 형제 항목을 읽을 수 있으며(MAY) 그 형제 항목의 해석된 값을 받습니다. 한 항목이 다른 항목을 읽는 곳에서는 작성 순서가 계약의 일부입니다. 정의를 그것을 읽는 항목 아래로 옮기면 빌드가 깨집니다. 뒤쪽 항목이나 블록이 선언하지 않은 키에 대한 ‘.locals. |
provides | string 맵 | 아니요 | Recipe의 공개 API 계약입니다. provides 평가에서 채워집니다. 기본 렌더링의 valuesMapping에서 자기 참조용으로 사용할 수 있습니다(예: {{ .provides.host }}). provides 템플릿 자체 안에서는 사용할 수 없습니다(provides 자기 완결성 불변 조건). 호출자는 inject 키를 이 값들에 대해 해석합니다. |
features | template_attachment 맵 | 아니요 | 이 노드의 모든 첨부로, 작성자가 부여한 인스턴스 이름을 키로 합니다. 운영 Feature, 자격 증명 Feature, ID Feature 등 무엇을 생성하든 하나의 필러가 모두를 담습니다. 첨부 간에 다른 것은 무엇을 생성하느냐이지 템플릿이 이를 읽는 방식이 아니기 때문입니다. Recipe는 첨부된 기능에 맞춰 렌더링을 조정하고 첨부가 게시하는 것을 사용하기 위해 이를 읽습니다. 노드의 연결 중 하나에 작성된 첨부는 여기에 포함되지 않습니다. 그것은 해당 연결 아래의 .context.uses. |
metadata | object | 아니요 | 결정적 명명을 위한 전역 ID를 제공하는 Release 및 컴파일 메타데이터입니다. 모든 템플릿 블록(valuesMapping, injectMapping, pipeline with)에서 사용할 수 있습니다. |
attachment_name | string | 아니요 | 첨부 FeatureRecipe를 렌더링할 때만 채워집니다. 첨부의 인스턴스 이름, 즉 소유 엔터티의 featuresSchema에서 채우는 슬롯 또는 작성자가 부여한 자유 이름(예: ‘admin_password’, ‘db_credentials’)을 담습니다. 첨부마다 다른 결정적 리소스 이름을 구성하는 데 사용되며, 호스트 컴포넌트 이름 뒤에 조합됩니다. 호스트의 provider가 helm처럼 렌더링된 이름을 보고하는 경우 ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}‘(Kubernetes 이름이 허용하는 문자로 표기된 호스트 이름과, 밑줄을 하이픈으로 바꾼 첨부 이름)를, 호스트의 provider가 아무것도 보고하지 않는 경우 ’{{ .context.instance_id }}-{{ .attachment_name }}‘를 사용합니다. |
inject | object | 아니요 | 작성된 inject 블록(예: { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] })을 지닌 attachment FeatureRecipe를 렌더링할 때만 채워집니다. .context.inject와는 구별되며, .context.inject는 uses 엣지로부터 미리 하이드레이션된 기본 component의 전달 파이프입니다. 작성된 inject가 없는 attachment와 기본 Recipes에서는 null/부재로 평가됩니다. |
inject_raw | object 또는 null | 아니요 | inject 블록에 대한 불변이며 변경되지 않은 Developer 의도입니다. 블록이 지정하는 모든 메커니즘(env, file, arg, 또는 ssm_param 같은 사용자 정의 메커니즘)은 각자의 이름 아래에 있으며, 작성된 그대로의 항목(in과 함께 from 또는 value)을 작성된 순서대로 담습니다. 따라서 .inject_raw.ssm_param은 .inject_raw.env가 핵심 메커니즘을 읽는 것과 같은 방식으로 사용자 정의 메커니즘을 읽습니다. Developer가 inject 블록을 완전히 생략한 경우 null로 평가됩니다. Ops가 inject 매핑의 변경 이전에 생략 여부를 감지하는 논리 검사(예: {{ if not .inject_raw }})에 사용합니다. 각 항목이 컴포넌트 자신의 어떤 values 또는 provides를 전달하는지는 항목의 텍스트가 아니라 .context.self_inject에서 읽습니다. |
steps | object 맵 | 아니요 | 파이프라인 단계 간 통신입니다. Wasm 파이프라인의 ‘with:’ 블록 안에서만 사용할 수 있습니다. 각 키는 파이프라인 단계 ID이며, 해당 단계가 내보낸 출력을 담습니다. |
source | string 또는 object 또는 null | 아니요 | 해석된 source 필드 내용입니다. Recipe의 템플릿에서는 source 해석 시점에 Go 템플릿 평가를 거친 Recipe의 source: 필드로부터 채워지고, 값 매핑 이후(valuesMapping, workload, artifacts)부터 사용할 수 있으며, Recipe에 source:가 없으면 null입니다. FeatureRecipe의 템플릿에서는 Go 템플릿 평가를 거친 FeatureRecipe 자체의 source: 필드로, 그 valuesMapping보다 먼저 평가되어 valuesMapping과 그 이후에 평가되는 모든 템플릿(omits, workload, artifacts, 파이프라인 단계)에서 읽히며, 호스트 컴포넌트의 것이 되는 일은 없습니다. FeatureRecipe에 source:가 없으면 null입니다. FeatureRecipe의 injectMapping은 그 source보다 먼저 평가되며 호스트 컴포넌트의 것을 읽습니다. 문자열 형식은 URI 경로이고, 객체 형식은 구조화된 source(예: 해석된 버전을 가진 OCI 디스크립터)입니다. |
workload | workload-v1beta1.schema.json 또는 null | 아니요 | 이 노드에 대해 파싱된 Workload 명세입니다. workload 합성 시점에 Go 템플릿 평가와 Workload JSON 스키마 검증(workload-v1beta1.schema.json 기준)을 거친 Recipe의 workload: 필드로부터 채워집니다. artifact 평가 이후(artifacts)부터 사용할 수 있으므로 artifacts가 중복 없이 workload 필드를 참조할 수 있습니다(예: .workload.services.metrics.ports.prom을 읽는 ServiceMonitor). Recipe에 workload: 블록이 없으면 null로 평가됩니다. null 값에서 .workload.*를 역참조하려는 템플릿은 템플릿 평가 시점에 명확한 오류로 실패합니다. |
boundary | object | 아니요 | 경계 범위 컨텍스트입니다. spec.executionScope가 ‘boundary’인 FeatureRecipe가 경계에 대해 한 번 실행하는 템플릿을 평가할 때만 채워집니다. Component 범위 FeatureRecipes는 이 pillar를 받지 않으며, 대신 context.instance_id, context.inject, context.uses와 .workload pillar가 component별 데이터를 담습니다. 경계 범위 FeatureRecipe가 경계에 대해 실행하는 템플릿은 이러한 component별 pillar 대신 .boundary.*를 받습니다. 그 injectMapping은 첨부가 도달하는 각 component의 컨텍스트에서 실행되어 이러한 component별 pillar를 읽으며, 이 pillar는 받지 않습니다. |
추가 속성은 허용되지 않습니다.
template-context.context
ID, 토폴로지, 전달 데이터를 제공하는, 컴파일러가 조립한 실행 컨텍스트입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
instance_id | string | 예 | 현재 노드의 평탄화된 절대 ID입니다(예: ‘backend’, 또는 모듈 인스턴스 data-layer의 component main-db의 경우 ‘data-layer-zdmain-db’). 작성된 모든 component 이름이 따르는 문자 집합으로 작성됩니다. 같은 Aggregate에 대해 컴파일 간에 결정적이고 안정적입니다. 이 노드를 위해 만들어지는 리소스 중 어떤 provider도 이름을 도출하지 않는 리소스, 즉 Recipe에서 배치되는 artifact 세트와 식별자를 따라 이름을 붙이는 provider가 합성한 workload의 이름이므로, 이들 중 하나에 대해 게시되는 주소는 이 값으로 만들어집니다. |
rendered_name | string | 아니요 | 이 노드에 바인딩된 provider가 노드를 위해 렌더링하는 리소스에 부여하는 이름입니다. 작성자가 제공한 source의 경우 제공된 템플릿 자체가 렌더링 기준으로 삼는 이름(예: chart가 읽는 release 이름)이고, provider가 합성하는 workload의 경우 노드의 식별자를 쓰는 대신 이름을 도출할 때 그 workload의 리소스에 부여하는 이름입니다. helm provider가 같은 release 이름으로 그렇게 합니다. 이 Recipe가 제공된 chart나 module이 선언했거나 그러한 provider가 합성한 리소스의 이름을 지정하는 곳이라면 provides 항목, valuesMapping, workload, artifacts 항목, pipeline 단계의 with나 when 어디에서든 이 값을 읽습니다. provider가 그 이름을 작성된 component 이름보다 제한된 문자 집합으로 표기할 수 있어 두 값이 달라질 수 있기 때문입니다. 바인딩된 provider가 그러한 이름을 도출하지 않으면 비어 있습니다. 배치된 artifact 세트의 리소스와 식별자를 따라 이름을 붙이는 provider가 합성한 workload의 리소스는 노드의 식별자를 가지므로 이 경우에는 ’{{ .context.instance_id }}‘를 읽으며, 자체 리소스 이름을 작성한 Recipe는 이미 그 이름을 알고 있습니다. 바인딩된 provider가 이름을 보고하지 않는데 이 키를 읽으면 빌드가 중단되고 대신 무엇을 작성해야 하는지 알려 줍니다. 이 거부는 Recipe가 인라인으로 작성한 템플릿에 적용됩니다. ‘$import’로 제공된 valuesMapping, workload 또는 artifacts 항목은 렌더링이 그곳에 도달할 때에만 해석되므로, 그 안의 참조는 중단되지 않고 빈 값으로 렌더링됩니다. component의 attachment에 바인딩된 FeatureRecipe의 템플릿에서는 호스트 자체 provider가 보고하는 호스트 component의 이름입니다. 이는 호스트 자체 Recipe가 읽는 값이며, 그곳의 instance_id가 호스트의 식별자인 것과 같습니다. 따라서 attachment는 이 값으로 호스트를 따라 리소스 이름을 지정하고 호스트의 플랫폼이 허용하는 이름을 얻습니다. 호스트의 provider가 이름을 보고하지 않으면 비어 있으며, attachment의 injectMapping 이외의 인라인 템플릿에서 이를 읽으면 빌드가 중단됩니다. 그곳에서는 대신 ’{{ .context.instance_id }}‘를 읽습니다. |
labels | string 맵 | 아니요 | 현재 노드의 덕 타이핑 및 온톨로지 레이블로, 토폴로지 구성 시 label-transform 역할로 연결된 거버넌스 플러그인이 가한 모든 변경을 포함합니다. |
annotations | object | 아니요 | 현재 노드의 세 가지 계단식 annotation 버킷으로, 출처별로 분리되어 있습니다. |
inject | object | 예 | 미리 하이드레이션되고 가로채진 전달 파이프입니다. Developer의 inject 키를 Target의 provides 값으로 해석하는 컴파일러 생성 맵으로 시작합니다. injectMapping 딥 머지에 의해 제자리에서 변경됩니다. Base Recipe가 렌더링될 때에는 완전히 해석된 물리적 문자열을 담고 있습니다. |
uses | enriched_edge 맵 | 예 | 보강된 토폴로지 edge 맵입니다. Developer의 별칭(예: ‘my_db’, ‘my_api’)을 키로 합니다. 각 항목은 대상 노드의 식별자, 해석된 provides, 주입 매핑, 계단식 annotation, 그리고 해당 연결에 작성된 attachment를 컴파일러가 조합한 뷰이며, readsTargetRenderFacts를 선언한 FeatureRecipe의 경우 대상의 렌더링이 보고한 내용도 포함합니다. 이는 원시 IR edge가 아니며, 템플릿에서 사용하도록 컴파일러가 특별히 만든 보강된 프로젝션입니다. 이 맵을 순회하는 템플릿은 연결을 작성된 순서가 아니라 키 순서, 즉 별칭으로 정렬된 순서로 봅니다. |
self_inject | object | 예 | 개발자가 이미 전달 이름을 부여한 컴포넌트 자신의 values와 provides로, 컴포넌트 자체에 작성된 inject: 블록에서 읽습니다. 이 블록은 .inject_raw가 작성된 그대로 담고 .context.inject가 확인된 형태로 담는 블록입니다. 블록이 지정하는 각 메커니즘(env, file, arg 또는 ssm_param 같은 사용자 정의 메커니즘)은 개발자가 작성한 각 이름을 해당 항목이 전달하는 자신의 키에 매핑하며, 이는 .context.uses. |
used_by | inbound_edge[] | 아니요 | 이 component를 사용하는 component들입니다. 다른 component가 이 component에 만드는 uses 연결마다 항목이 하나씩 있으며, 연결하는 component가 작성된 순서, 그다음 각 component 자체의 uses 항목 순서를 따릅니다. 두 번 연결하는 component는 두 번 나타납니다. 이 component에 연결된 FeatureRecipe만, 그리고 attachment 자체의 리소스를 생성하는 템플릿, 즉 valuesMapping, workload, artifacts에서만 읽을 수 있습니다. component 자체의 Recipe 템플릿, injectMapping, pipeline 단계의 with와 when에는 없습니다. 이들 각각의 출력은 component 자체의 렌더링 출력에 들어갈 수 있으며, 그 출력은 누가 연결하든 동일하게 유지되기 때문입니다. 각 항목은 키가 아니라 목록 항목이므로 이를 순회하는 템플릿은 호출자를 그 순서대로 만납니다. |
render_facts | render_facts | 아니요 | 이 component를 렌더링한 provider가 자신이 내보낸 출력에 대해 보고한 내용, 즉 provider가 보고하는 render fact로, fact 이름을 키로 합니다. provider가 어떤 이름을 보고하고 각 항목에 무엇이 담기는지는 해당 provider가 자체적으로 문서화한 계약입니다. 모든 값은 항목이 하나뿐이어도 목록이므로 템플릿은 항상 이를 순회합니다. component의 렌더링에 provider 호출이 둘 이상 필요했고 하나의 이름을 여러 호출이 보고한 경우, 그 목록들은 호출이 실행된 순서대로 하나로 합쳐집니다. component가 렌더링된 후에는 이 component에 연결된 FeatureRecipe의 모든 템플릿, 즉 valuesMapping, workload, artifacts, pipeline 단계의 with와 when에 존재하며, provider가 아무것도 보고하지 않으면 비어 있으므로 아무도 보고하지 않은 이름은 빈 목록으로 읽힙니다. component가 렌더링되기 전에 실행되는 component 자체의 Recipe 템플릿과 injectMapping에는 없습니다. |
추가 속성은 허용되지 않습니다.
template-context.context.annotations
현재 노드의 세 가지 계단식 annotation 버킷으로, 출처별로 분리되어 있습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
release | string 맵 | 아니요 | Release 경계에서 계단식으로 내려오는 물리적 토폴로지 문자열입니다. |
catalog | string 맵 | 아니요 | Domain 2에서 Platform Architect가 작성한 변경 불가능한 고유 특성입니다. |
aggregate | string 맵 | 아니요 | Aggregate 하위 시스템에서 계단식으로 내려오는 인지 메타데이터입니다. |
추가 속성은 허용되지 않습니다.
template-context.context.inject
미리 하이드레이션되고 가로채진 전달 파이프입니다. Developer의 inject 키를 Target의 provides 값으로 해석하는 컴파일러 생성 맵으로 시작합니다. injectMapping 딥 머지에 의해 제자리에서 변경됩니다. Base Recipe가 렌더링될 때에는 완전히 해석된 물리적 문자열을 담고 있습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 환경 변수 전달입니다. 키는 Developer의 로컬 변수 이름이고, 값은 해석된 대상 문자열입니다. |
file | string 맵 | 아니요 | 파일 마운트 전달입니다. 키는 로컬 파일 경로이고, 값은 해석된 대상 문자열입니다. |
arg | string 맵 | 아니요 | 명령줄 인수 전달입니다. 키는 플래그 접두사이고, 값은 해석된 대상 문자열입니다. |
all | string 맵 | 아니요 | env + file + arg + custom 메커니즘을 미리 계산해 평탄하게 병합한 것입니다. uses-inject 해석 후에 채워지고 inject 매핑 후에 다시 계산됩니다. 템플릿은 범용 직렬화를 위해 {{ toJson .context.inject.all }}을 사용합니다. |
template-context.context.self_inject
개발자가 이미 전달 이름을 부여한 컴포넌트 자신의 values와 provides로, 컴포넌트 자체에 작성된 inject: 블록에서 읽습니다. 이 블록은 .inject_raw가 작성된 그대로 담고 .context.inject가 확인된 형태로 담는 블록입니다. 블록이 지정하는 각 메커니즘(env, file, arg 또는 ssm_param 같은 사용자 정의 메커니즘)은 개발자가 작성한 각 이름을 해당 항목이 전달하는 자신의 키에 매핑하며, 이는 .context.uses.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 환경 변수 전달: 키는 개발자의 변수 이름이고, 값은 각 항목이 전달하는 자신의 키입니다. |
file | string 맵 | 아니요 | 파일 마운트 전달: 키는 개발자의 파일 경로이고, 값은 각 항목이 전달하는 자신의 키입니다. |
arg | string 맵 | 아니요 | 명령줄 인수 전달: 키는 개발자의 플래그 접두사이고, 값은 각 항목이 전달하는 자신의 키입니다. |
template-context.metadata
결정적 명명을 위한 전역 ID를 제공하는 Release 및 컴파일 메타데이터입니다. 모든 템플릿 블록(valuesMapping, injectMapping, pipeline with)에서 사용할 수 있습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
release_name | string | 아니요 | 빌드 중인 Release의 이름입니다(예: ‘prod-billing’). Ops가 전역적으로 고유한 클라우드 리소스 이름(S3 버킷, IAM 역할)을 구성하는 데 사용합니다. .context.instance_id와 결합하여 환경 간 고유성을 보장합니다. |
release_version | string | 아니요 | Release의 시맨틱 버전입니다. |
environment | string | 아니요 | Release 메타데이터의 environment 문자열입니다(예: ‘production’, ‘local’). |
aggregate_name | string | 아니요 | 컴파일되는 루트 Aggregate의 이름입니다. |
추가 속성은 허용되지 않습니다.
template-context.inject
작성된 inject 블록(예: { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] })을 지닌 attachment FeatureRecipe를 렌더링할 때만 채워집니다. .context.inject와는 구별되며, .context.inject는 uses 엣지로부터 미리 하이드레이션된 기본 component의 전달 파이프입니다. 작성된 inject가 없는 attachment와 기본 Recipes에서는 null/부재로 평가됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 첨부 범위의 환경 변수 전달입니다. |
file | string 맵 | 아니요 | 첨부 범위의 파일 마운트 전달입니다. |
arg | string 맵 | 아니요 | 첨부 범위의 인수 전달입니다. |
all | string 맵 | 아니요 | 모든 첨부 inject 방식을 컴파일러가 편의상 병합한 것입니다. |
template-context.boundary
경계 범위 컨텍스트입니다. spec.executionScope가 ‘boundary’인 FeatureRecipe가 경계에 대해 한 번 실행하는 템플릿을 평가할 때만 채워집니다. Component 범위 FeatureRecipes는 이 pillar를 받지 않으며, 대신 context.instance_id, context.inject, context.uses와 .workload pillar가 component별 데이터를 담습니다. 경계 범위 FeatureRecipe가 경계에 대해 실행하는 템플릿은 이러한 component별 pillar 대신 .boundary.*를 받습니다. 그 injectMapping은 첨부가 도달하는 각 component의 컨텍스트에서 실행되어 이러한 component별 pillar를 읽으며, 이 pillar는 받지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
path | string | 아니요 | FeatureRecipe가 연결된 Release 경계의 경로입니다. 가장 바깥쪽부터 안쪽으로의 경계 이름을 ’/‘로 이은 것입니다(예: ‘bridge’, ‘bridge/frontend’). 이는 경계를 가리키며, 그 출력이 기록되는 디렉터리를 가리키지 않습니다. 그 디렉터리는 경계의 directory:가 설정합니다. |
assembly_path | string | 아니요 | 이 첨부 자체의 출력이 조립되는 디렉터리로, 빌드 출력 디렉터리에 대한 상대 경로입니다. 경계의 평가된 directory:와 subDirectory:이며, 빌드가 그 출력을 보내는 디렉터리입니다(예: ‘bridge/compose’). 연결 엔드포인트가 같은 조립 파일로 렌더링될 때에만 그 엔드포인트의 source_assembly_path 또는 target_assembly_path와 정확히 같으므로, FeatureRecipe는 이를 비교하여 자기 파일 안의 연결과 다른 파일의 연결을 구별합니다. 불투명한 데이터이며, 코어는 이를 해석하지 않습니다. |
boundary_name | string | 아니요 | boundary의 이름입니다(release.spec.boundaries의 맵 키). |
components | object | 아니요 | boundary 하위 트리에 있는 모든 component에 대한 instance_id에서 항목으로의 맵입니다(재귀적이며, 중첩된 boundary의 component를 포함합니다). 각 항목에는 component의 해석된 타입 URI, 인스턴스 ID, 그리고 component별 provides 평가에서 얻은 제공 값이 담깁니다. |
internal_uses_edges | object[] | 아니요 | source와 target이 모두 이 boundary의 하위 트리에 있는 uses 에지입니다. |
outgoing_cross_boundary_uses_edges | object[] | 아니요 | 소스가 이 경계의 하위 트리 안에 있고 대상이 그 밖에 있는 uses 엣지입니다. |
incoming_cross_boundary_uses_edges | object[] | 아니요 | target은 하위 트리 안에 있고 source는 밖에 있는 uses 에지입니다. 누가 호출해 오는지 알아야 하는 ingress 방식의 집계기가 사용합니다. |
cross_boundary_uses_edges | object[] | 아니요 | boundary를 가로지르는 나가는 에지와 들어오는 에지를 편의상 합친 것입니다. |
labels | string 맵 | 아니요 | 하위 트리에 있는 component 레이블의 합집합으로, 작성 순서를 유지합니다. |
annotations | string 맵 | 아니요 | 캐스케이드가 해석된 후의 boundary 자체 annotation입니다. |
feature_attachments | template_attachment[] | 아니요 | 이 boundary에 직접 첨부된 attachment들로(boundary 범위 안에서 attachment 간 참조를 위한 것), .features가 담는 것과 같은 attachment 형태입니다. |
추가 속성은 허용되지 않습니다.
정의
inbound_edge
다른 component가 연결된 FeatureRecipe의 렌더링 대상 component에 맺는 하나의 연결입니다. 누가 연결하는지, 어떤 소켓을 통하는지, 연결하는 component가 무엇을 게시하는지, 그리고 그것이 배치된 namespace와 boundary를 담습니다. 모든 값은 컴파일러가 해석하지 않고 전달하는 문자열입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
component_id | string | 예 | 연결하는 component의 평탄화된 인스턴스 ID입니다(예: ‘frontend’ 또는 ‘data-layer.etl’). subDirectory 경로 템플릿이 .component_id로 읽는 값이며, .context.uses. |
socket | string | 예 | 연결하는 component가 이 연결을 끌어오는 usesSchema 카테고리입니다(예: ‘databases’, ‘apis’). |
provides | string 맵 | 예 | 연결하는 component의 해석된 provides로, 해당 Component가 선언한 키로 좁혀집니다. 그 component의 소비자가 .context.uses. |
source_namespace | string | 아니요 | 연결하는 component가 배치된 namespace입니다. 그 component 자체의 렌더링이 받는 aggrega.ai/namespace annotation으로, 해당 boundary들의 annotation에 자신의 Release 항목의 annotation이 마지막으로 적용된 것입니다. 따라서 항목에서 namespace를 설정하거나 해제한 component는 boundary의 설정이 아닌 자신의 설정을 가집니다. boundary 범위 FeatureRecipe가 .boundary uses-edge 목록에서 같은 연결의 항목에 대해 source_namespace로 읽는 값입니다. 연결하는 component에 적용되는 namespace가 없으면 존재하지 않으므로, 출력하기 전에 if 또는 with로 확인하십시오. |
source_boundary_path | string | 아니요 | 연결하는 component를 포함하는 Release boundary의 슬래시로 구분된 경로입니다(예: ‘edge’ 또는 ‘aws-prod/payments’). boundary 범위 FeatureRecipe가 .boundary uses-edge 목록에서 같은 연결의 항목에 대해 source_boundary_path로 읽는 값입니다. |
render_facts | render_facts | 아니요 | 연결하는 component의 렌더링이 출력한 결과에 대해 보고한 내용으로, fact 이름을 키로 합니다. 먼저 그 component 자체의 provider 호출이 보고한 fact가 오고, 이어서 그 component에 연결되어 함께 렌더링된 각 Feature의 fact가 렌더링된 순서대로 오며, 여러 곳에서 같은 이름으로 받은 목록은 그 순서대로 하나로 합쳐집니다. 모든 값은 항목이 하나뿐이어도 목록이므로, 템플릿은 항상 range로 순회합니다. readsCallerRenderFacts를 선언한 FeatureRecipe에만 존재하며(그 attachment는 모든 component가 렌더링된 뒤에 렌더링되므로 모든 호출자의 렌더링이 완료되어 있습니다), 그 경우 모든 항목에 존재하고 provider가 아무것도 보고하지 않은 호출자에 대해서는 비어 있습니다. 그 외의 모든 FeatureRecipe에는 존재하지 않습니다. |
추가 속성은 허용되지 않습니다.
render_facts
이름을 키로 하는 render fact입니다. component를 렌더링한 provider가 출력한 결과에 대해 보고한 내용입니다. provider가 어떤 이름을 보고하고 각 항목이 무엇을 담는지는 해당 provider가 문서화한 고유한 계약이며, 컴파일러는 각 값이 목록이라는 점 외에는 어느 쪽에 대해서도 알지 못합니다. 목록은 항목의 순서를 유지합니다. 객체 항목은 provider가 작성한 순서대로 키를 유지한 채 전달되며, 이를 range로 순회하는 템플릿은 이 컨텍스트의 다른 모든 키 맵과 마찬가지로 키 순서대로 만납니다.
자유 형식 객체이며, 값은 any[]입니다.
template_attachment
템플릿이 읽는 하나의 attachment로, 연결된 Feature의 인스턴스별 뷰입니다. 모든 attachment는 무엇을 생성하든 같은 필드를 노출하므로, .features.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | 아니요 | 연결된 Feature의 Catalog Feature URI입니다. |
resolved_version | string | 아니요 | Manifest 해석 후 연결된 Feature의 버전으로, 이 빌드에 실제로 바인딩된 버전이며 .features. |
labels | string 맵 | 아니요 | 연결된 Feature의 Catalog label로, Feature가 선언한 순서대로 그대로 전달됩니다. 아무것도 필터링되거나 이름이 바뀌거나 접두사가 제거되지 않으므로, 템플릿은 Feature 작성자가 쓴 그대로를 읽습니다. 템플릿이 연결된 Feature의 이름이나 URI가 아닌 그것이 무엇인지에 따라 분기할 수 있게 합니다. .context.uses.if로 확인하거나 맵을 range로 순회하십시오. |
values | object | 아니요 | attachment 자체의 개발자 의도 pillar로, attachment 선언에서 그대로 전달됩니다. |
infra | object | 아니요 | attachment 자체의 운영 사이징 pillar로, attachment 선언에서 그대로 전달됩니다. |
provides | string 맵 | 아니요 | 이 attachment에 바인딩된 FeatureRecipe의 해석된 공개 계약으로, 생성된 리소스의 이름, 키, 식별자, 그리고 추가로 생성된 키를 담으며 소비자에게 .features. |
추가 속성은 허용되지 않습니다.
enriched_edge
컴파일러가 조립한 하나의 보강된 토폴로지 엣지입니다. 대상의 해석된 식별자, provides, 캐스케이드된 어노테이션을 포함합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
target | string | 예 | 대상 노드의 절대 평탄화 ID입니다(예: ‘data-layer.main-db’). |
socket | string | 예 | 이 엣지가 속한 usesSchema 카테고리입니다(예: ‘databases’, ‘apis’). |
source | string | 아니요 | 소스(소비자) 노드의 절대 평탄화 ID입니다. 소비자별 출력을 소비자 노드 기준으로 키를 매기는 boundary 범위 뷰에서 채워집니다. |
source_namespace | string | 아니요 | 소스 엔드포인트의 원시 aggrega.ai/namespace 어노테이션입니다(없으면 빈 값). source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. provider의 네트워크 식별자 해석을 위한 불투명 데이터이며, 코어는 이를 해석하지 않습니다. |
source_boundary_path | string | 아니요 | 소스 엔드포인트의 boundary 경로로, 그것을 담고 있는 Release 경계의 슬래시로 구분된 경로입니다(예: ‘bridge/frontend’). source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. |
source_assembly_path | string | 아니요 | 소스 엔드포인트의 조립 경로로, 그 출력이 조립되는 디렉터리이며 빌드 출력 디렉터리에 대한 상대 경로이고, 경계의 평가된 directory:와 subDirectory:로 구성됩니다(예: ‘bridge/compose’). 조립 경로가 같은 두 엔드포인트는 하나의 조립 파일로 렌더링되며, 조립 경로가 .boundary.assembly_path와 같은 엔드포인트는 이를 읽는 FeatureRecipe 자체의 출력이 조립되는 파일로 렌더링됩니다. 엔드포인트를 네트워크에 배치하는 경계 범위 FeatureRecipe는 aggrega.ai/namespace가 적용되지 않을 때 이를 소스 엔드포인트의 네트워크로 읽을 수 있습니다. source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. 불투명한 데이터이며, 코어는 이를 해석하지 않습니다. |
target_namespace | string | 아니요 | 대상 엔드포인트의 원시 aggrega.ai/namespace 어노테이션입니다(없으면 빈 값). source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. provider의 네트워크 식별자 해석을 위한 불투명 데이터입니다. |
target_boundary_path | string | 아니요 | 대상 엔드포인트의 boundary 경로로, 그것을 담고 있는 Release 경계의 슬래시로 구분된 경로입니다(예: ‘bridge/backend’). source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. |
target_assembly_path | string | 아니요 | 대상 엔드포인트의 조립 경로로, 그 출력이 조립되는 디렉터리이며 빌드 출력 디렉터리에 대한 상대 경로이고, 경계의 평가된 directory:와 subDirectory:로 구성됩니다(예: ‘bridge/compose’). 조립 경로가 .boundary.assembly_path와 같은 엔드포인트는 이를 읽는 FeatureRecipe 자체의 출력이 조립되는 파일로 렌더링됩니다. 엔드포인트를 네트워크에 배치하는 경계 범위 FeatureRecipe는 aggrega.ai/namespace가 적용되지 않을 때 이를 대상 엔드포인트의 네트워크로 읽을 수 있습니다. source와 마찬가지로 boundary 범위 뷰에서만 채워지며, 컴포넌트 자신의 .context.uses 항목에서는 빈 값입니다. 불투명한 데이터이며, 코어는 이를 해석하지 않습니다. |
provides | string 맵 | 예 | 대상 노드의 완전히 해석된 provides 딕셔너리입니다. inject 하이드레이션 전, provides 평가 시점에 평가됩니다. |
inject | object | 예 | 이 엣지에 대한 Developer의 원래 inject 매핑입니다(키 = 로컬 변수 이름, 값 = 대상 provides 키). 해석된 값이 아니라 원시(RAW) 매핑입니다. |
labels | string 맵 | 아니요 | 대상 노드의 덕 타이핑 및 온톨로지 레이블입니다(토폴로지 구성 과정의 변경 이후 값). |
annotations | object | 아니요 | 대상 노드의 세 가지 캐스케이드 어노테이션 버킷입니다. |
component | string | 아니요 | 대상 노드의 Catalog 컴포넌트 타입 URI입니다(예: ‘core/postgres’). |
resolved_version | string | 아니요 | 대상 노드의 해석된 SemVer입니다. |
boundary_path | string | 아니요 | Release에서 가져온 대상 노드의 물리적 공간 계층입니다(예: ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | 아니요 | 이 엣지가 Feature(feature.aggrega.ai/kind: secret 레이블이 붙은 자격 증명 Features 포함)에 의해 자율적으로 선언된 경우, 해당 Feature 인스턴스 이름입니다. Developer가 선언한 엣지에서는 Null이거나 없습니다. |
origin_release | 불리언 | 아니요 | Aggregate가 선언한 것이 아니라 Release가 이 연결을 배선한 경우 true입니다. Aggregate가 선언한 연결에서는 없습니다. |
values | object | 아니요 | 이 연결에 대해 Aggregate의 uses 항목에 작성된 연결별 개발자 구성으로, 그대로 전달됩니다. 연결에 구성이 없으면 없습니다. 소비하는 노드의 컨텍스트에만 전달되며, 대상의 컨텍스트에는 전달되지 않습니다. |
infra | object | 아니요 | 이 연결에 대해 Release의 uses 항목에 작성된 연결별 운영 구성으로, 그대로 전달됩니다. 연결에 구성이 없으면 없습니다. 소비하는 노드의 컨텍스트에만 전달되며, 대상의 컨텍스트에는 전달되지 않습니다. |
features | template_attachment 맵 | 아니요 | 이 연결에 작성된 어태치먼트로, 연결의 소켓이 각각에 대해 선언한 슬롯 이름을 키로 하며, 각각 .features가 담는 어태치먼트 형태(타입, 해석된 버전, 레이블, values, infra, 그리고 바인딩된 FeatureRecipe의 해석된 provides)를 가집니다. Recipe는 연결의 자격 증명을 .context.uses. |
render_facts | render_facts | 아니요 | 대상의 렌더링이 출력한 결과에 대해 보고한 내용으로, 팩트 이름을 키로 하며 .context.used_by의 호출자 항목이 담는 형태와 같습니다. 먼저 자신의 provider 호출이 보고한 팩트, 그다음 함께 렌더링된 각 연결 Feature의 팩트가 렌더링된 순서대로 오며, 한 이름이 여러 곳에서 받은 리스트는 그 순서대로 하나로 합쳐집니다. 항목이 하나여도 모든 값은 리스트이므로 템플릿은 항상 이를 순회합니다. readsTargetRenderFacts를 선언한 FeatureRecipe에 대해서만 .context.uses에 존재하며(그 어태치먼트는 모든 컴포넌트가 렌더링된 뒤에 렌더링되므로 모든 대상의 렌더링이 완료된 상태입니다), 이때 모든 항목에 존재하고 provider가 아무것도 보고하지 않는 대상에서는 비어 있습니다. 그 밖의 모든 FeatureRecipe, 파이프라인 단계의 with와 when, 컴포넌트 자신의 Recipe 템플릿, boundary 범위 FeatureRecipe가 읽는 엣지 리스트에서는 없습니다. |
추가 속성은 허용되지 않습니다.
enriched_edge.inject
이 엣지에 대한 Developer의 원래 inject 매핑입니다(키 = 로컬 변수 이름, 값 = 대상 provides 키). 해석된 값이 아니라 원시(RAW) 매핑입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | string 맵 | 아니요 | 환경 변수 전달입니다. 키는 소비자의 로컬 변수 이름이고, 값은 대상의 provides 키입니다. |
file | string 맵 | 아니요 | 파일 마운트 전달입니다. 키는 소비자의 로컬 파일 경로이고, 값은 대상의 provides 키입니다. |
arg | string 맵 | 아니요 | 명령줄 인수 전달입니다. 키는 소비자의 플래그 접두사이고, 값은 대상의 provides 키입니다. |
enriched_edge.annotations
대상 노드의 세 가지 캐스케이드 어노테이션 버킷입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
release | string 맵 | 아니요 | 대상 노드의 Release boundary에서 가져온 물리적 토폴로지 문자열입니다. |
catalog | string 맵 | 아니요 | 대상 노드의 Catalog 엔티티에서 가져온 불변 특성입니다. |
aggregate | string 맵 | 아니요 | 대상 노드의 Aggregate 하위 시스템에서 가져온 인지 메타데이터입니다. |
추가 속성은 허용되지 않습니다.