출력 구성
하나의 Aggrega 빌드는 여섯 가지 서로 다른 메커니즘을 통해 dist/ 아래의 경계별 디렉터리에 출력 파일을 생성합니다. 이 메커니즘은 소스 기반 렌더링, 워크로드 합성, FeatureRecipe 리소스 생성, FeatureRecipe 플러그인 파이프라인 패치, Release 수준 구성, 직접 아티팩트 방출입니다. 메커니즘은 정해진 순서로 실행됩니다. 두 메커니즘이 같은 경계 디렉터리에 같은 이름의 파일을 생성하면 출력은 결정적으로 충돌하며, 충돌이 감지되면 빌드는 방출 전에 해당 충돌 규칙이 지정하는 범주로 중단되고 모든 기여자를 명시합니다.
이 페이지는 여섯 가지 메커니즘을 한곳에서 설명하고, 메커니즘 전반의 렌더링 순서를 명시합니다. 장별 및 엔터티별 참조 문서는 각자의 영역을 다루며, 여섯 가지 메커니즘 전체에 걸친 충돌 감지 규칙은 이 페이지에 있습니다.
출력을 생성하는 여섯 가지 메커니즘
각 메커니즘은 특정한 Recipe / FeatureRecipe 작성 영역에 위치하며, 특정한 이름 지정 관례에 따라 파일을 생성합니다. 메커니즘은 노드별로 누적됩니다. 하나의 컴포넌트 인스턴스가 여러 메커니즘을 동시에 구동할 수 있습니다(소스 기반 기본 Recipe + Workload로 합성된 동반 파일 + FeatureRecipe가 내보낸 ExternalSecret CRD + 합성된 Deployment에 적용된 플러그인 파이프라인 패치).
1 — Recipe 소스 기반 렌더링(source: + valuesMapping:)
작성 영역. Recipe는 source: <path>와 valuesMapping:을 선언합니다(이 필드는 인라인 Go 템플릿, 파일 $import:, 또는 MappingLibrary 항목에 대한 라이브러리 $import:를 받습니다. entities/recipe.md의 “valuesMapping 필드 — 세 가지 작성 모드”를 참조하십시오). source는 디스크에 있는 Helm 차트, docker-compose YAML 파일 또는 기타 프로바이더 고유 아티팩트를 가리킵니다.
파이프라인 위치. 기본 렌더링 단계이며, Recipe의 locals와 provides가 해석된 후에 실행됩니다.
출력 형태. Provider별로 다릅니다:
- helm 프로바이더 — 평탄한 Kubernetes YAML 파일이며, 컴포넌트 식별자와 리소스 자체를 따라
<component-id>-<kind>[-<namespace>]-<name>.yaml로 이름이 지정됩니다. kind나 name이 없는 문서는 대신 템플릿 경로를 따라 이름이 지정됩니다. 이름은 템플릿이 아니라 리소스에서 오므로, 서로 다른 하위 디렉터리에 있으면서 파일 이름이 같은 두 템플릿은 두 개의 파일로 유지됩니다. Helm SDK가 병합된 값으로 차트를 렌더링하고, Aggrega는 렌더링 후에 출처 레이블과 어노테이션을 주입합니다. - helm-chart provider — 하위 차트 파일이
charts/<instance_id>/아래에 복사됩니다. 차트 자체의name을 제외하고는 그대로 복사되며, 이 이름은 umbrella 차트가 인스턴스의 인코딩된 식별자로 설정하므로 같은 이름을 선언하는 차트를 벤더링하는 두 컴포넌트도 서로 구별됩니다(providers/helm-chart.md참조). 경계별 umbrellaChart.yaml+values.yaml이 함께 생성됩니다. - compose 프로바이더 — Release 수준 구성(메커니즘 5)으로 흘러 들어가는 중간
<nodeID>.compose-fragment.yaml파일입니다.
2 — Recipe Workload 합성(workload:)
작성 영역. Recipe는 Workload 문서를 담은 workload:를 선언합니다. 이 필드는 인라인 콘텐츠(블록 스칼라) 또는 $import:(파일 경로)를 받습니다.
파이프라인 위치. 기본 렌더링 단계이며, Recipe의 valuesMapping이 해석된 후에 실행됩니다(Workload 본문 자체가 전체 템플릿 컨텍스트로 평가되는 Go 템플릿 문자열입니다).
출력 형태. Provider별로 다릅니다:
- helm 프로바이더 — Workload의
form에 따라 선택되는 컨트롤러 객체 하나(stateless는 Deployment, stateful은 StatefulSet, daemon은 DaemonSet, task는 Job, scheduled는 CronJob) + 서비스별 Service +persistent볼륨마다 PVC 하나입니다. 두 가지 이름 형태가 있으며, 둘은 같지 않습니다: 컨트롤러 객체는 노드의 릴리스 이름과 kind를 따라<release name>-deployment.yaml,<release name>-statefulset.yaml,<release name>-daemonset.yaml,<release name>-job.yaml,<release name>-cronjob.yaml로 이름이 지정되는 반면, 리소스별 파일은 담고 있는 리소스를 따라 kind를 마지막에 두어<release name>-<svcName>-service.yaml및<release name>-<volName>-pvc.yaml로 이름이 지정됩니다. 각 파일은 해당 리소스 자체의metadata.name에서 이름을 가져오기 때문입니다. 릴리스 이름은 노드의 식별자를 Kubernetes 이름이 허용하는 문자로 쓴 것이므로, 노드 ID에 밑줄과 대문자가 없으면 노드 ID와 같습니다. 노드my_api는my-zuapi-deployment.yaml을 씁니다(entities/workload.md의 “Synthesized-name convention” 참조). 유일한 노출이 외부 이름인 Workload는 담을 서비스 키가 없으므로 대신<release name>-service.yaml을 출력합니다. - compose 프로바이더 — Release 수준 구성으로 흘러 들어가는 중간
<nodeID>.compose-fragment.yaml파일입니다. - helm-chart 프로바이더 — 지원되지 않습니다. helm-chart의 역할은 소스 모드 차트 구성뿐입니다.
workload:를 사용하여 helm-chart를 대상으로 하는 Recipe는 렌더링 시점에 거부됩니다(helm-chart 프로바이더는 합성 기능이 없다고 보고합니다).
3 — FeatureRecipe 리소스 생성(FeatureRecipes의 소스 모드)
작성 영역. FeatureRecipe는 source:와 valuesMapping:(또는 이에 상응하는 것)을 선언합니다. Recipe 소스 기반 렌더링과 같은 패턴이지만, 기본 Components가 아니라 Feature 연결에 사용됩니다.
파이프라인 위치. 기본 렌더링 단계이며, 부모 Component에 대한 기본 Recipe 렌더링과 함께 실행됩니다. 각 Feature 연결은 자체 FeatureRecipe 렌더링 패스를 실행합니다.
출력 형태. 부모 Component의 프로바이더가 결정합니다. 연결의 출력은 자체 조립 그룹이 아니라 해당 Component의 조립 그룹에 합류하기 때문입니다. 그리고 출력 형태는 그 프로바이더가 그룹을 결합하는 방식에서 비롯됩니다. 연결을 둘 자리가 애초에 있는지를 결정하는 것이 바로 그 방식이기 때문입니다. 결합 방식마다 하나씩, 세 가지 형태가 있습니다.
- 각 기여자에게 고유한 위치를 부여하는 프로바이더(기여자마다 차트 하나를 담는 차트 하나, 기여자마다 모듈 하나를 담는 루트 구성 하나)는 연결에도 고유한 위치를 부여하며, 그 위치는 연결된 컴포넌트의 안이 아니라 옆입니다. 두 좌표가 그 위치의 단일 디렉터리 세그먼트
<component-id>--<feature-instance-id>를 구성하므로, 연결aux를 가진 컴포넌트api는 해당 프로바이더가 기여자용으로 지정한 디렉터리 아래에서api옆의api--aux에 위치합니다. 안이 아니라 옆인 이유는, 그러한 프로바이더의 대상이 자신이 부여한 위치에서 기여자를 발견하기 때문입니다. 그러한 위치 중 하나보다 한 단계 아래에 있는 디렉터리는 자체 기여자가 아니라 해당 기여자에 속한 콘텐츠이므로, 아무것도 그것을 지정하지 않고 아무것도 그것을 읽지 않습니다. 경계에 선언된 연결은 이름을 붙일 호스트 컴포넌트가 없으므로 세그먼트는 인스턴스 이름만으로 구성됩니다. 각 좌표는 두 좌표를 결합하기 전에 인코딩되므로, 결합 시퀀스를 자체적으로 포함하는 좌표가 결합으로 오인될 수 없습니다. - 각 문서를 경계 디렉터리에 직접 쓰는 프로바이더에는 그러한 자리가 없습니다. 그것이 바로 이 프로바이더가 자신의 대상에 대해 선언하는 내용이기 때문입니다. 즉, 디렉터리에 직접 놓인 파일만 읽힙니다. 따라서 같은 두 좌표가 디렉터리 세그먼트에서 파일 이름으로 옮겨지며, 연결의 파일은 컴포넌트 자체 파일 옆에
<component-id>--<feature-instance-id>--<file>형태로 놓입니다. 파일 이름에는 기댈 구분자가 없으므로 두 좌표는 인코딩되며, 인코딩된 좌표가 포함할 수 없는 두 문자 경계에서 파일 자체 이름과 결합됩니다. 이것이 같은 파일 이름을 내보내는 두 연결을 서로 다른 두 파일로 유지하는 방법입니다. - 그룹의 기여자를 하나의 문서로 합치는 프로바이더는 연결의 출력도 그 문서에 합치며, 이때 각 리소스는 연결 자체의 식별자를 담아 무엇이 어디서 왔는지 알아볼 수 있게 합니다. 그러한 프로바이더가 다른 대상을 위해 렌더링된 연결을 담는 경우, 그 콘텐츠는 속하지 않는 문서에 합쳐질 수 없으므로 같은 이유로 위에서 설명한 파일 이름 접두사 형태로 조립된 문서 옆에 쓰입니다.
일반적인 형태:
- 자격 증명 FeatureRecipe의 Fetcher가 생성하는
ExternalSecret/VaultSecretCRD. - 관측성 Feature가 생성하는
ServiceMonitor/PrometheusRuleCRD. - 라우팅 Feature가 생성하는
HTTPRoute/GatewayCRD.
4 — FeatureRecipe 플러그인 파이프라인(RFC 6902 패치 + 리소스 방출)
작성 표면. FeatureRecipe는 pipeline:을 선언합니다. 이는 Wasm 플러그인 단계의 배열입니다(Two-Part Plugin Principle: 자격 증명 Features에는 Fetcher + Injector, 자격 증명이 아닌 Features에는 임의의 플러그인 파이프라인).
파이프라인 내 위치. 기본 렌더링과 FeatureRecipe 소스 기반 렌더링이 완료된 후의 플러그인 파이프라인입니다.
출력 형태. Plugin별로 다릅니다. 한 단계는 두 가지 종류의 출력을 반환합니다.
- 적용 엔진이 렌더링된 집합에서 지정된 문서에 적용하는 RFC 6902 패치(예: 사이드카 컨테이너 추가, 시크릿 볼륨 마운트, 합성된 Deployment의 환경 변수 재작성).
- 부수 효과 — 단계의
side_effects를 통해 패치와 함께 방출되는 완전한 새 리소스(일반적으로 Injector가 이후 참조하는 Fetcher의 vault-fetch CRD).
현재 상태: 언어의 상태 → 컴파일 파이프라인 단계에 따라 사용 가능합니다. 선언된 각 단계는 aggrega build 중에 실행됩니다. 호스트는 렌더링된 집합에 대해 단계의 Wasm 플러그인을 디스패치하고, 반환된 패치를 적용하며, 단계의 부수 효과를 방출합니다. 플러그인 계약 표면은 plugins/plugin-contract.md를 참조하십시오.
5 — Release 수준 조합(프로바이더별 경계 어셈블리)
작성 표면. Release 형태에 의해 결정되며, Recipe별 작성은 없습니다. 경계를 어셈블하는 기능은 해당 경계의 모든 노드가 렌더링된 후 한 번 어셈블합니다. compose 기능은 노드별 조각을 모두 모아 경계당 하나의 docker-compose.yaml을 만들고, helm-chart 기능은 노드별 하위 차트 복사본을 모아 경계당 하나의 umbrella 차트를 만듭니다.
파이프라인 내 위치. 기본 렌더링 이후, 모든 노드의 Recipe별 출력이 경계에 누적된 시점입니다.
출력 형태. 프로바이더별로 다릅니다.
- compose 프로바이더 — 경계 루트에 하나의
docker-compose.yaml이 생성되며, 기여하는 모든 노드의 서비스, 볼륨, 네트워크를 집계합니다. 중간<nodeID>.compose-fragment.yaml파일(메커니즘 1 + 2)은 단일 출력으로 병합되며, 조각은 최종 경계 디렉터리에 나타나지 않습니다. - helm-chart 프로바이더 — 경계 루트에 하나의 umbrella
Chart.yaml+values.yaml이 생성되고,charts/<instance_id>/아래에 노드별 하위 차트 디렉터리가 생성됩니다.
6 — Recipe 직접 아티팩트 방출(artifacts:)
작성 표면. Recipe는 artifacts:를 이름이 지정된 항목의 맵으로 선언합니다. 각 항목은 인라인 콘텐츠(파일 본문을 담은 템플릿 문자열)이거나 템플릿 파일 경로에 대한 $import: 참조입니다. 이는 프로바이더를 거치지 않는 직접 파일 방출입니다.
파이프라인 내 위치. 기본 렌더링 내의 아티팩트 평가입니다.
출력 형태. 아티팩트 항목당 하나의 파일이며, artifacts: 맵에서 항목의 키에 따라 이름이 지정됩니다. Recipe 작성자가 파일 이름과 내용을 직접 결정합니다.
현재 상태: 언어의 상태 → Recipe 입력 종류에 따라 사용 가능합니다. 각 항목은 워크로드 합성과 소스 해석 이후 전체 템플릿 컨텍스트로 평가되며, 결과 파일은 항목의 키로 방출됩니다. 대상이 방출된 아티팩트를 어떻게 처리하는지는 기능에 따라 다릅니다. 독립 아티팩트를 허용하는 프로바이더는 이를 별도 파일로 방출하지만, 다른 입력 종류와 함께일 때만 아티팩트를 허용하는 프로바이더는 항목을 자신이 어셈블하는 결과에 통합합니다. 따라서 해당 어셈블러가 기대하는 형태가 아닌 본문은 그대로 방출되지 않고 TRANSLATION_ERROR 범주로 중단됩니다. 기능에 대한 아티팩트를 작성하기 전에 architecture/16-recipe-input-composition.md의 기능별 표를 확인하십시오.
렌더링 순서
여섯 가지 메커니즘은 하위 메커니즘이 상위 출력을 읽을 수 있도록 정해진 순서로 실행됩니다. 순서는 다음과 같습니다.
- Provides 평가 — 노드마다 Recipe의
locals:블록이 먼저 작성자 순서대로 해석되며, 각 항목은 그 위의 항목을 읽습니다. 그다음 노드의provides:템플릿이 서로 간에는 임의의 순서로 평가됩니다(자체 완결적:.context.instance_id, 노드의 provider가 보고하는 경우.context.rendered_name,.values,.infra, 해석된.locals, 정적 텍스트). locals를 provides보다 먼저 처리하는 이 순서 덕분에provides:항목이 local을 읽어 해석된 값을 받을 수 있습니다. - Locals 게시와 소스 해석 — 해당 locals가
.locals에 게시되고, Recipe의source:URI 템플릿이 이를 기준으로 평가됩니다(템플릿화된 경우 소스 포인터를 해석). 소스 표면은 locals 컨텍스트를 공유하므로.provides가 아니라.locals를 읽습니다. - Inject 매핑 — FeatureRecipe
injectMapping:블록이 평가됩니다(inject 파이프는 Recipe 렌더링 전에 가로채집니다). - Values 매핑 — Recipe
valuesMapping:이 평가됩니다(sourced 모드와 sourceless 모드가 values 딕셔너리를 생성합니다). - Workload 합성 — Recipe Workload 합성(메커니즘 2가 합성 모드용 매니페스트를 내보냅니다).
- Artifact 평가 — Recipe
artifacts:평가(메커니즘 6). - Provider 렌더링 — provider가 렌더링합니다(메커니즘 1 — sourced 모드는 평면 매니페스트를, sourceless 모드는 생성형 매니페스트를 생성합니다).
- Feature 렌더링 — 노드의 모든 Feature 연결에 대한 FeatureRecipe 렌더링(메커니즘 3 + 4 — Resource Generation은 여기서 실행되고, 플러그인 파이프라인은 나중에 9단계에서 실행됩니다).
- 플러그인 파이프라인 — 렌더링 후 변형: FeatureRecipe
pipeline:플러그인 단계가 RFC 6902 패치를 적용하고 추가 리소스를 내보냅니다(메커니즘 4). - Release 수준 구성 — capability의 경계 조립이 노드별 조각을 경계별 출력으로 모읍니다(메커니즘 5).
하위 메커니즘이 상위 출력을 읽을 수 있으므로 순서가 중요합니다. 예를 들어 플러그인 파이프라인 단계는 provider가 렌더링한 Deployment를 패치할 수 있고, Release 수준 composer는 provider 렌더링, feature 렌더링, 플러그인 파이프라인이 내보낸 조각을 병합할 수 있습니다.
충돌 감지 규칙 세트
두 메커니즘이 같은 boundary 디렉터리에 같은 이름의 파일을 생성하면, 빌드는 아래 각 규칙이 지정하는 범주로 중단되며 모든 기여자를 명시합니다. 규칙 세트는 다음과 같습니다.
Recipe 형태 규칙: artifacts: 항목 키 충돌
Recipe가 artifacts: 아래에 같은 키를 가진 항목 두 개를 선언하는 경우입니다(항목 본문을 인라인으로 작성했든 $import:로 불러왔든 키가 출력 파일 이름을 결정합니다). errors/fatal-halts.md의 “artifacts: entry keys must be unique(항목 키는 고유해야 합니다)”에 따라 Recipe 로드 시점에 감지됩니다.
Recipe 형태 규칙: 입력 종류 간 출력 시점 충돌
Recipe의 세 가지 입력 종류인 sourced, synthesized, artifacts는 각각 같은 boundary 디렉터리에 파일을 출력합니다. 소스 렌더링, 워크로드 합성 또는 아티팩트 출력 결과가 다른 입력 종류도 생성한 이름의 파일을 생성하면, 빌드는 출력 시점에 중단됩니다. errors/fatal-halts.md의 “Emission-time filename collision across input kinds(입력 종류 간 출력 시점 파일 이름 충돌)”에 따라 출력 시점에 감지됩니다.
Compose 서비스 이름 충돌(Release 수준)
서로 다른 두 노드가(boundary의 어떤 조합에서든) 병합된 compose 출력에 같은 이름의 서비스를 기여하면, compose provider는 boundary를 구성하는 시점에 TRANSLATION_ERROR 범주로 중단하며 기여한 모든 (boundary, node, serviceName) 튜플을 명시합니다. providers/compose.md의 Release 수준 출력 섹션에 따라 Release 수준 구성 단계에서 감지됩니다.
서비스는 두 노드가 선언한 내용을 비교하지 않고 이름만으로 거부됩니다. compose 서비스는 실행 중인 단일 컨테이너이므로, 각각 하나씩 원한 두 노드는 둘이 합쳐 하나만 얻게 되며, 두 정의가 아무리 동일하더라도 한 기여자의 의도는 사라집니다.
Compose 볼륨 이름 및 config 이름 충돌(Release 수준)
서로 다른 두 노드가 병합된 compose 출력에 같은 이름의 최상위 volumes: 또는 configs: 항목을 기여하고 두 선언이 다르면, compose provider는 TRANSLATION_ERROR 범주로 중단하며 해당 항목과 기여한 모든 (boundary, node) 튜플을 명시합니다. providers/compose.md의 Release 수준 출력 섹션에 따라 Release 수준 구성 단계에서 감지됩니다.
위의 서비스 규칙과 달리 이 규칙은 선언을 비교하며, 기여자들의 선언이 일치하면 이름을 공유하는 것이 정당합니다. 이름 있는 볼륨이나 config는 하나의 객체이므로, 이를 동일하게 선언한 두 노드는 모두 병합된 문서에 최종적으로 들어가는 바로 그 항목을 요청한 것이며 잃는 것이 없습니다. 이를 다르게 선언한 두 노드는 그 하나의 객체에 대해 의견이 다른 것이며, 어느 한 선언을 유지하면 그렇지 않았다면 성공했을 빌드에서 다른 선언을 버리게 됩니다. 두 선언이 조립된 파일에서 같은 항목을 기술하면 일치하는 것으로 간주하므로, 빈 매핑으로 작성한 본문과 아예 생략한 본문은 일치합니다.
Helm 차트 서브 차트 별칭과 디렉터리
helm-chart 서브 차트는 charts/<instance_id>/에 위치하며, 그 값은 별칭 아래로 범위가 지정됩니다. 별칭은 별칭 위치에 맞게 인코딩된 인스턴스 ID입니다. 인코딩은 별칭이 허용하지 않는 문자를 대체하지 않고 풀어서 쓰므로, 두 인스턴스는 인스턴스 ID가 같은 문자열이 아닌 한 하나의 별칭에 도달할 수 없습니다. 따라서 별칭은 정확히 하나의 서브 차트를 식별하며, 그 아래에 작성된 값은 해당 서브 차트에만 전달됩니다. 또한 인스턴스 ID는 Aggregate 평탄화 규칙에 따라 boundary마다 고유하므로 디렉터리도 충돌할 수 없습니다. 두 측면 모두 구조적이며, 어느 쪽도 검사에 의존하지 않습니다.
Helm 렌더링 리소스 이름 충돌
하나의 boundary 안에서 같은 Kubernetes 리소스 이름으로 렌더링되는 두 노드는 metadata.name 필드가 겹치는 두 YAML 파일을 생성합니다. 각 파일에는 자체 명명 기준이 접두사로 붙으므로 파일 이름은 다르지만, 그 안의 metadata.name은 여전히 겹칠 수 있습니다. 따라서 빌드는 렌더링된 리소스가 지닌 이름을 검사하며, 두 기여자가 한 네임스페이스에서 한 kind에 대해 같은 이름을 도출하면 무엇이든 쓰기 전에 TRANSLATION_ERROR 범주로 중단되고, 그 이름과 이를 도출한 각 컴포넌트 및 각 연결을 명시합니다(errors/fatal-halts.md 참조).
가장 큰 경우는 검사가 아니라 구조적으로 차단됩니다. 리소스 이름을 릴리스 이름을 따라 짓는 sourced 차트는 더 이상 두 컴포넌트 사이에서 이 충돌을 일으킬 수 없습니다. 조금이라도 다른 두 명명 기준은 서로 다른 두 릴리스 이름에 도달하기 때문입니다. providers/helm.md의 “How the release name is derived”를 참조하십시오. 두 가지 경우가 남으며, 위의 검사가 보고하는 것이 바로 이들입니다. 하나는 템플릿에 리소스 이름을 리터럴로 작성하는 차트이며, 어떤 도출 방식도 그러한 이름을 다른 리터럴과 구별할 수 없습니다. 다른 하나는 하나의 컴포넌트에 붙은 두 Feature 연결이 각각 작성자가 만든 차트를 전달하는 경우입니다. 두 차트 모두 설계상 해당 컴포넌트의 릴리스 이름으로 렌더링되므로, .Release.Name을 따라 리소스 이름을 짓는 두 차트는 그곳에서 겹칩니다. 두 차트의 리소스에 서로 다른 이름을 부여하거나, 서로 다른 컴포넌트에 연결하십시오.
모든 합성된 이름은 노드 자체의 식별자로 시작합니다. 컨트롤러 객체의 이름이 그러하고, 리소스별 이름은 합성된 Service 이름 관례 <release name>-<svcName>(entities/workload.md의 “Synthesized-name convention” 참조)을 통해 그러하므로, 노드 간 충돌은 구조적으로 불가능합니다. Deployment / Service 이름 때문에 빌드가 중단된 작성자는 먼저 서로 다른 두 Recipes가 서로 다른 렌더링 경로를 통해 같은 이름의 리소스를 출력하고 있지 않은지 확인해야 합니다(예: sourced 차트의 templates/deployment.yaml이 워크로드 합성 Deployment의 metadata.name과 충돌하는 경우).
메커니즘 간 상호 작용 패턴
Workload 합성 + 플러그인 파이프라인 패치
대표적인 패턴은 다음과 같습니다. 메커니즘 2(워크로드 합성)가 기본 Deployment를 내보내고, 메커니즘 4(Injector 플러그인)가 Deployment에 시크릿 볼륨을 마운트하는 RFC 6902 패치를 적용합니다. 두 메커니즘은 함께 구성됩니다. Deployment는 동일한 K8s 리소스이며, 패치가 합성된 기반 위에 ConfigMap / Secret 참조를 덧붙입니다.
이는 합성된 워크로드에 자격 증명을 주입하는 주된 패턴입니다. Fetcher(메커니즘 3, 리소스 생성)는 클러스터가 런타임에 가져오는 ExternalSecret CRD를 내보내고, Injector(메커니즘 4, 플러그인 파이프라인 패치)는 그 결과로 생성된 K8s Secret을 마운트하도록 Deployment를 수정합니다.
서로 다른 경계에서의 소스 기반 + Workload 합성
하나의 Aggregate는 경계 A에서 소스 기반 helm Recipe(메커니즘 1)에 바인딩된 컴포넌트와, 경계 B에서 Workload를 합성하는 helm Recipe(메커니즘 2)에 바인딩된 형제 컴포넌트를 가질 수 있습니다. 각 경계의 디렉터리는 해당하는 출력 형태를 담으며, 경계별 dist/ 디렉터리가 형제 간에 격리되어 있으므로 경계 간 파일 이름은 충돌하지 않습니다.
출력 디렉터리별 Compose Release 수준 병합
compose 기능의 어셈블리는 디렉터리가 같은 경로로 평가되는 모든 경계의 노드별 조각을 그 경로의 docker-compose.yaml 하나로 모읍니다. 한 Release 안의 compose 대상 경계 두 개는 디렉터리가 다르면 파일 두 개를 쓰고, 디렉터리를 공유하면 병합된 파일 하나를 씁니다.
따라서 서비스 이름 충돌은 위의 규칙에 따라 파일별로, 해당 파일의 Release 수준 병합에서 감지됩니다. 서로 다른 디렉터리에 있으면서 각각 api라는 서비스를 선언하는 compose 대상 경계 두 개는 충돌하지 않습니다. 각 경계의 파일이 자신의 서비스를 담기 때문입니다. 디렉터리를 공유하는 두 경계는 파일 하나를 쓰며, 빌드는 두 기여자를 모두 명시하고 중단됩니다.
상호 참조
entities/recipe.md— Recipe 작성 표면(메커니즘 1 + 2 + 6은 Recipe 내용에서 출력을 생성합니다).entities/featurerecipe.md— FeatureRecipe 작성 표면(메커니즘 3 + 4는 FeatureRecipe 내용에서 출력을 생성합니다).providers/helm.md— helm provider의 메커니즘별 출력 형태와 이름 지정 관례.providers/helm-chart.md— helm-chart provider의 umbrella + sub-chart 구성(메커니즘 5).providers/compose.md— compose provider의 노드별 조각화 + Release 수준 구성(메커니즘 5).errors/fatal-halts.md— 고유한artifacts:항목 키와 입력 종류 간 파일 이름 충돌에 관한 Recipe 형태 규칙.templates/expansion-matrix.md— 렌더링 순서 전반에 걸친 템플릿 위치별 평가 시점.plugins/plugin-contract.md— 플러그인 파이프라인 계약 표면(메커니즘 4).10-status.md— 메커니즘 6(artifacts:)과 메커니즘 4의 플러그인 파이프라인 런타임의 현재 준비 상태.architecture/10-compilation-pipeline.md— 렌더링 단계의 순서를 포함한 전체 컴파일 파이프라인.architecture/16-recipe-input-composition.md— 세 가지 Recipe 입력 종류(메커니즘 1 + 2 + 6의 상위 틀).