엔터티 분류 체계
Aggrega 아키텍처는 네 개의 도메인으로 구성되며, 각 도메인은 서로 다른 페르소나가 소유하고 특정 엔터티 종류를 담고 있습니다. 여기에 재사용 가능한 스키마, 매핑, 워크로드, 아티팩트 콘텐츠를 보관하는 티어 3 라이브러리 계층(언어 레퍼런스의 엔터티 티어 모델의 세 번째 티어)이 더해집니다. 아래 개요도는 네 도메인과 티어 3 라이브러리가 서로 어떻게 관련되는지 보여 줍니다. 이어지는 각 섹션은 해당 섹션 자체의 엔터티를 나타낸 다이어그램으로 시작하며, 그 다이어그램에서 다른 도메인의 엔터티는 점선 윤곽으로 그려집니다. 각 엔터티의 상세한 작성 영역(필드, 스키마, 예제)은 언어 레퍼런스 엔터티 카탈로그에 있습니다.
graph TD
Intent["<b>Domain 1: Developer Intent</b><br/><i>Developer</i>"]
Catalog["<b>Domain 2: Platform Catalog</b><br/><i>Platform Architect</i>"]
Routing["<b>Domain 4: Routing & Policy</b><br/><i>Platform Operator / DevOps</i>"]
Infra["<b>Domain 3: Infrastructure Base</b><br/><i>Infrastructure Engineer / Ops</i>"]
Libs["<b>Tier 3: Libraries</b>"]
Intent -->|"requests, attaches"| Catalog
Intent -->|"binds via"| Routing
Routing -->|"attaches"| Catalog
Catalog -->|"resolved to"| Infra
Routing -->|"resolves, renders via"| Infra
Catalog -.->|"$ref"| Libs
Infra -.->|"$import"| Libs
전체 자료는 네 도메인과 티어 3 라이브러리 계층에 걸쳐 있습니다.
| # | 엔터티 | 도메인 | 역할 |
|---|---|---|---|
| 1 | Aggregate | 도메인 1 — 개발자 의도 | 애플리케이션 토폴로지 청사진 |
| 2 | Component | 도메인 2 — Platform Catalog | 추상 컴퓨트 노드 인터페이스 |
| 3 | Feature | 도메인 2 — Platform Catalog | 운영 특성(자격 증명 Features 항목 포함) |
| 4 | Recipe | 도메인 3 — 인프라 기반 | 제공자별 Component 구현 |
| 5 | FeatureRecipe | 도메인 3 — 인프라 기반 | 제공자별 Feature 구현 |
| 6 | Plugin | 도메인 3 — 인프라 기반 | 콘텐츠 주소 지정 WebAssembly 플러그인(제공자 렌더링, 파이프라인 단계, 린팅) |
| 7 | Manifest | 도메인 4 — 라우팅 및 정책 | 인터페이스를 Recipes 정의에 매핑하는 의존성 잠금 파일 |
| 8 | Release | 도메인 4 — 라우팅 및 정책 | Aggregate 정의를 Manifest 정의에 바인딩하는 배포 라우터 |
| 9 | SchemaLibrary | 티어 3 — 라이브러리 | 재사용 가능한 JSON Schema 2020-12 정의 |
| 10 | MappingLibrary | 티어 3 — 라이브러리 | 재사용 가능한 Go 템플릿 조각 |
| 11 | WorkloadLibrary | 티어 3 — 라이브러리 | 재사용 가능한 Workload 템플릿 조각 |
| 12 | ArtifactLibrary | 티어 3 — 라이브러리 | 재사용 가능한 이름 있는 아티팩트 번들 |
이 표가 작성용 엔터티 종류, 즉 작성자가 kind: 필드에 선언하는 종류의 전체 집합입니다. Workload 종류는 독립적인 카탈로그 엔터티가 아니라 Recipe 정의의 합성된 입력 안에 포함되는 플랫폼 소유 콘텐츠이므로(16장 참조), 의도적으로 위 표에서 제외되었습니다.
Plugin은 고유한 종류, JSON Schema, 카탈로그 디렉터리를 갖춘 일급 작성 엔터티이며, 도메인 3의 Platform Ops가 소유합니다. Plugin은 WebAssembly 아티팩트에 대한 콘텐츠 주소 지정 참조로, 자신이 구현하는 하나의 소켓 유형을 선언합니다. 분류 체계에는 일곱 가지 구성원이 있습니다. provider(IR 노드를 제공자 고유 아티팩트로 렌더링), linter(작성된 콘텐츠에 대한 진단 발생), pipeline-step(feature-recipe-pipeline 단계), governance(거버넌스 역할 수행: 레이블이나 어노테이션을 변환하거나, IR 그래프 또는 렌더링된 아티팩트에 대해 수락/거부 판정을 반환), cli(운영자가 명령줄에서 호출하는 aggrega 하위 명령 제공), parser(외부 소스 텍스트를 정규 구조화 트리로 변환), importer(외부 인프라 또는 에이전트 정의 소스를 Aggrega 작성 파일 초안으로 변환)입니다. 제공자 렌더링 Plugin(pluginType: provider)은 제공자 렌더링을 담당하는 단위입니다. 이 Plugin은 자신이 렌더링하는 제공자 이름을 spec.provider.capabilities에 선언하고, 나머지 제공자 소켓 메타데이터도 같은 spec.provider 블록에 담습니다. 컴파일러는 참조를 고정하고 라우팅하며, WebAssembly 런타임은 바이트를 실행합니다. 컴파일러는 플러그인이 하는 일을 해석하지 않습니다. 플러그인은 WebAssembly 안에 있는 도메인 특화 지능을 전달하는 수단입니다. 작성 및 메타데이터 영역은 language-reference/entities/plugin.md에 문서화되어 있습니다.
도메인 1: 개발자 의도(“무엇을”)
graph LR
classDef ext stroke-dasharray:5 4;
A["Aggregate<br/>The 'What'"]
CC["Component"]:::ext
CapC["Feature"]:::ext
EB["Release"]:::ext
A -.->|"Requests"| CC
A -.->|"Attaches"| CapC
A -->|"Binds via"| EB
- 역할: 개발자. AI 아키텍처, 인지 루프, 애플리케이션 생존 요구 사항에만 집중합니다. CEL, OPA, 물리적 포트에 대한 지식이 필요하지 않습니다.
- 1. Aggregate: 애플리케이션 토폴로지의 맵 기반 선언적 청사진입니다. Release 정의가 빌드하는 루트 Aggregate로도, 매개변수화된 재사용 가능한 모듈로도 쓰이며, 논리적
components를 정의하고features아래에 동작이 애플리케이션 의도에 해당하는 Features 항목을 해당values와 함께 연결합니다. 입력이 모두 운영적인 Feature 항목은 대신 운영자가 Release 정의에서 연결합니다(도메인 4 참조). 자격 증명도 같은features연결 영역에서 자격 증명 Feature 항목을 통해 요청하며, 이를 위한 별도의 블록은 없습니다.parameters(컴팩트 형식 어휘로 작성된 타입 지정 계약)를 통해 추상적인 용량 요구 사항을,values를 통해 페이로드 상태를 정의합니다. Component 인스턴스는 문서화와 Studio 렌더링을 위한 선택적description필드를 지원합니다. 대상 플랫폼이나 네임스페이스를 하드코딩하지 않고 “Zero-Port” 관례(기존 코드가 명시적으로 요구하지 않는 한 네트워크 포트를 추상화하는 것)를 장려합니다.
도메인 2: Platform Catalog(“인터페이스와 인텔리전스”)
graph TD
classDef ext stroke-dasharray:5 4;
A["Aggregate"]:::ext
EB["Release"]:::ext
CC["Component<br/>The Compute Interface"]
CapC["Feature<br/>The Operational Trait"]
CD["Recipe"]:::ext
CapD["FeatureRecipe"]:::ext
A -.->|"Requests"| CC
A -.->|"Attaches"| CapC
EB -.->|"Attaches"| CapC
CC -.->|"Resolved to"| CD
CapC -.->|"Resolved to"| CapD
- 역할: Platform Architect. 플랫폼의 “프로그래머”입니다. 각 컴포넌트를 운영 온톨로지에 배치하고, 프로그래밍 가능한 정책(Wasm 변형기 및 검증기)을 작성하며, 의미적 덕 타이핑 레이블을 확립합니다.
- 2. Component: 컴퓨트 노드의 추상 인터페이스입니다. 운영 클라우드 온톨로지(예:
component.aggrega.ai/type: server)를 통해 기본 형태를 선언하고, 덕 타이핑 레이블(예:model.aggrega.ai/capability: generative)을 통해 인지적 정체성을 덧입힙니다.featuresSchema를 통해 자격 증명 슬롯(필수/선택, 블랙박스/투명)을 선언하고,schema:(JSON Schema 2020-12, 보통 컴팩트 형식 축약 표기로 작성)를 사용해 개발자의 불투명한values블록을 엄격하게 검증합니다. - 3. Feature: 모듈식 운영 특성입니다(예: 데이터 마스킹, DNS 라우팅, 시크릿 관리).
appliesTo레이블 셀렉터를 사용해 특정 의미 레이블에 동적으로 바인딩합니다. Components 항목과 마찬가지로featuresSchema를 통해 자격 증명 슬롯을 선언하여 API 키 프로비저닝을 강제합니다. 결정적으로,metadata.annotations를 사용해 평면 IR 그래프의 요소에 명시적으로 태그를 붙이며, 이를 통해 다운스트림 Wasm 정책 검증기와 렌더링 플러그인에 해당 Feature 정의의 구성 페이로드를 어떻게 처리할지 알려 줍니다.- 자격 증명 Features 항목: 플랫폼은 자격 증명 관리를 Feature 엔터티로 통합합니다.
feature.aggrega.ai/kind: secret레이블이 있는 Feature 항목은 자격 증명 기능으로, 시크릿 저장소(예: AWS Secrets Manager, HashiCorp Vault)에 대한 조회 인터페이스를 정의합니다. 다른 Feature 항목과 마찬가지로 같은 영역에 같은 형태로features:아래에 연결됩니다. 레이블은 연결이 무엇을 만들어 내는지 설명하기 위해 카탈로그가 지니는 메타데이터이며, 어떤 컴파일러 분기도 이를 읽지 않습니다. 별도의 시크릿 저장소나 시크릿 Recipe 종류는 없습니다. 자격 증명 FeatureRecipe는 다른 FeatureRecipe와 같은 형태이고, 가져온 뒤 전달하는 파이프라인도 둘 다 같으며,inject전달 계약(env,file,arg)도 공유됩니다. 하나의 엔터티, 하나의 연결 키워드, 렌더링을 관통하는 하나의 수정자 실행 경로입니다. 그리고 자격 증명은 Manifest 정의의features.type아래에 매핑됩니다.
- 자격 증명 Features 항목: 플랫폼은 자격 증명 관리를 Feature 엔터티로 통합합니다.
레이블로서의 온톨로지. 운영 클라우드 온톨로지는 최상위 spec.type 필드가 아니라 metadata.labels["component.aggrega.ai/type"]에 선언됩니다. 이 선택 덕분에 컴파일러의 레이블 셀렉터 엔진이 온톨로지 값을 직접 대상으로 삼을 수 있습니다. Feature 정의는 appliesTo: "component.aggrega.ai/type in (server, worker)"를 선언하여, 핵심 컴파일러에 새로운 Go 로직을 전혀 추가하지 않고도 모든 server 또는 worker 컴포넌트에 동적으로 연결됩니다. 같은 셀렉터 메커니즘이 모든 Aggrega 레이블에 적용되므로, Feature 정의, 소켓 셀렉터, Release 경계 매핑은 카탈로그 고유의 레이블 키를 이 키와 똑같은 방식으로 읽습니다.
component.aggrega.ai/type은 Aggrega 고유의 키이며, 그 값 집합은 닫혀 있습니다. 게시된 Component 스키마가 프리미티브를 열거하며, 그 밖의 값을 담은 문서는 로드 시 거부되고 E0215가 해당 레이블을 지목하며 허용되는 값을 나열합니다. Aggrega 시스템이 정의하지 않는 분류가 필요한 카탈로그는 그 옆에 자체 레이블 키를 추가합니다(Component 스키마는 문자열 값을 가진 추가 레이블 키를 모두 허용합니다). 따라서 새로운 축에 드는 비용은 자신의 키 하나뿐이고 컴파일러의 새 릴리스는 필요 없으며, 예약된 키는 어디서나 하나의 의미를 유지합니다. 바로 이것이 component.aggrega.ai/type in (stateful-server)를 대상으로 작성된 Feature 정의가 서로 만난 적 없는 작성자들의 Components 항목에서도 동작하게 만드는 이유입니다.
도메인 3: 인프라 기반(“구현”)
graph LR
classDef ext stroke-dasharray:5 4;
CC["Component"]:::ext
CapC["Feature"]:::ext
ENV["Manifest"]:::ext
EB["Release"]:::ext
CD["Recipe<br/>The Implementation"]
CapD["FeatureRecipe<br/>The Binding"]
T["Plugin<br/>The Wasm Plugin"]
CC -.->|"Resolved to"| CD
CapC -.->|"Resolved to"| CapD
ENV -->|"Resolves Interfaces to"| CD
ENV -->|"Resolves Interfaces to"| CapD
EB -->|"Renders via"| T
- 역할: 인프라 엔지니어 / Ops. 물리적 현실, 네트워크 포트 할당, 템플릿 로직을 소유합니다.
- 4. Recipe: 다중 제공자 변환 템플릿입니다(예: Helm 또는 Docker Compose).
implements키워드를 통해 카탈로그 컴포넌트와 엄격한 1:1 API 계약을 맺습니다. Recipe 정의는 개발자의.values를 물리적 형식으로 매핑합니다. 물리적 네트워크 포트(예:5432)를 하드코딩하고,.context.uses파이프를 통해 대상의provides를 읽음으로써 데이터베이스 이름을 하드코딩하지 않고도 주입 계약을 충족합니다. - 5. FeatureRecipe:
implements키워드를 통해Feature를 구체적인 인프라 구현에 명시적으로 매핑합니다.capability에 대상 제공자 기능(예:helm,compose)을 필수로 지정합니다. 플랫폼이 자격 증명 관리를 Feature 엔터티로 통합하므로, FeatureRecipes 정의는 운영 기능(데이터 마스킹, DNS 라우팅, 사이드카 주입)과 자격 증명 기능(볼트 CRD 생성, 시크릿 볼륨 마운트)을 모두 처리합니다. 이 전체 범위를 지원하기 위해 세 가지 서로 다른 실행 블록을 지원합니다.pipeline: 렌더링 후 Workload 변형을 위한 WebAssembly (Wasm) 플러그인의 순차 배열입니다(예: JSONPatch로 Envoy 사이드카 주입, 또는 시크릿 볼륨 마운트).source및valuesMapping,workload,artifacts: Recipe가 지니는 것과 같은 세 가지 입력 종류로, 리소스 생성에 사용되며, Ops가 기본 컴포넌트와 함께 정적 템플릿을 네이티브로 렌더링할 수 있게 합니다(예: 새HTTPRouteCRD 또는ExternalSecretCRD 생성).injectMapping(렌더링 전 가로채기): 기본 Recipe 정의가 렌더링되기 전에 실행되는 네이티브 Go 템플릿 블록입니다. JSON 딕셔너리를 출력하며, 컴파일러는 이를 호출자의.context.inject메모리 파이프 위에 네이티브로 깊은 병합합니다. 이를 통해 Wasm 없이 호출자 측에서 환경 변수와 연결 문자열을 변경할 수 있습니다.
- 자격 증명 FeatureRecipe 패턴: FeatureRecipe 정의가 자격 증명 Feature 항목(
feature.aggrega.ai/kind: secret레이블 지정)을 구현할 때는 표준 “2단 Plugin 원칙”이 적용됩니다.pipeline은 Fetcher 플러그인(볼트 전용 CRD 생성)에 이어 Injector 플러그인(시크릿을 대상 컨테이너에 마운트)을 연결합니다. Fetcher/Injector 분리는 재사용성을 극대화합니다. AWS Secrets Manager에서 HashiCorp Vault로 전환할 때는 Fetcher 플러그인만 교체하면 되고, Injector는 그대로 유지됩니다.
- 6. Plugin: 콘텐츠 주소 지정 WebAssembly 플러그인입니다. 제공자 렌더링 Plugin 엔터티(
pluginType: provider)는 Recipe 정의의 입력 종류를 최종 문자열화된 파일 형식으로 바꾸는 단위입니다. 자신이 담당하는 제공자 이름을spec.provider.capabilities(예:helm)에 선언하고, 컴파일러가 디스패치하는render_node익스포트를 공개하며, 제공자 소켓의 나머지 메타데이터(workloadSchema,wellKnownAnnotations)를 같은spec.provider블록에 담습니다. Plugin 엔터티가 선언할 수 있는 다른 소켓 유형은pipeline-step,linter,governance,cli,parser,importer입니다. 컴파일러는 고정된 참조를 라우팅하고, WebAssembly 런타임은 바이트를 실행합니다.
도메인 4: 라우팅 및 정책(“접착제”)
graph TD
classDef ext stroke-dasharray:5 4;
A["Aggregate"]:::ext
EB["Release<br/>The Deployment Router"]
ENV["Manifest<br/>The Dependency Lockfile"]
CapC["Feature"]:::ext
T["Plugin"]:::ext
CD["Recipe"]:::ext
CapD["FeatureRecipe"]:::ext
A -->|"Binds via"| EB
EB -.->|"Attaches"| CapC
EB -->|"Uses"| ENV
EB -->|"Renders via"| T
ENV -->|"Resolves Interfaces to"| CD
ENV -->|"Resolves Interfaces to"| CapD
- 역할: Platform Operator / DevOps.
- 7. Manifest: 의존성 잠금 파일입니다. 평면 URI 매핑을 사용합니다.
components.type딕셔너리는 카탈로그 컴포넌트 유형을 Recipe URI에 매핑하고,features.type딕셔너리는 Feature 유형을 FeatureRecipe URI에 매핑합니다. 해석은 잠금 파일과 카탈로그에 대한 직접 URI 조회이며, 역량 결정은 빌드 시점에 해석된 각 Recipe 정의의spec.capability필드에서 도출됩니다. 해석 후 모든 엔터티에 매핑이 있어야 하며, 그렇지 않으면 컴파일러가 중단됩니다. DRY한 생태계를 유지하기 위해 Manifests 정의는extends키워드를 통한 Kustomize 스타일의 합성 패턴을 지원하므로, 환경별 매니페스트(로컬이나 스테이징 등)가 전역 기본 매니페스트를 깔끔하게 상속하고 자신의 특정 재정의만 선언할 수 있습니다. - 8. Release: 라우터입니다.
aggregate를manifest에 바인딩하고 컴포넌트를 물리적 경계(예:aws-eks-production)에 매핑합니다. DRY한 워크플로를 유지하기 위해 Releases 정의는extends키워드를 통한 상속을 지원하므로, 환경별 릴리스가 전역 기본 릴리스를 깔끔하게 상속할 수 있습니다. 물리적 현실을 엄격하게parameters블록에 주입하여 추상적인 aggregate 계약을 이행하고, 물리적 사이징(CPU나 포트 등)은 병렬 네임스페이스infra를 통해 주입합니다. Aggregate 정의를 단일 진실 공급원으로 보호하기 위해 Release 스키마는values:블록을 기계적으로 금지합니다. Ops는 Release 정의에서 어떤 Component 항목이나 Feature 항목에도values를 선언할 수 없습니다. 개발자 대상 값의 환경별 차이는 Parameter Hoisting을 통해 흐릅니다. 개발자가 Aggregate 정의에 타입이 지정된parameters.*필드를 노출하고, Component 정의의values템플릿이 이를 참조하며, Release 정의가 해당 환경의 매개변수를 채웁니다. 렌더링된 값은 환경마다 다르지만, 어떤 값이 존재하고 그 값이 어떻게 흐르는지를 작성하는 영역인 Aggregate 정의는 단일 진실 공급원으로 남습니다. 스키마 수준의 금지가 명시적으로 기술된 내용은 아키텍처 제약과 권장 패턴의 제약 4 “Release는 개발자 값을 재정의할 수 없음”을 참조하십시오. 결정적으로, 추적할 수 없는 “aggregate 변경” Releases 정의를 막기 위해, Release 정의가extends를 사용하면aggregate선언은 Release 스키마에 의해 거부됩니다(extends를 사용할 때 스키마 제약이aggregate선언을 허용하지 않습니다). 자식 릴리스는 부모와 정확히 같은 개발자 의도에 매핑되어야 합니다. 반면manifest는 선택 사항이 되어 “지연 바인딩”을 가능하게 합니다. Ops는 전체 물리 토폴로지를 상속하면서도 의존성 잠금 파일만 정밀하게 교체할 수 있습니다.- Feature 연결: Release 정의도 경계나 하나의 컴포넌트의
features아래에 Features 항목을 연결합니다. 입력이 모두 운영적인 Feature 항목은 그type및infra와 함께 바로 연결하고, Aggregate 정의가 연결한 Feature 항목은 같은 이름 아래에 해당 연결의infra를 작성하여 사이징합니다.
- Feature 연결: Release 정의도 경계나 하나의 컴포넌트의
Manifest 정의를 Release 정의와 분리하는 이유. 소프트웨어 잠금 파일(Manifest)을 배포 라우터(Release)와 분리하면 두 엔터티가 각각 단독으로는 만들어 낼 수 없는 형태가 가능해집니다. DevOps는 하나의 애플리케이션을 여러 지역 배포 라우터(서로 다른 클라우드 리전을 대상으로 하면서 모두 같은 Manifest 정의를 참조하는 서로 다른 Releases 정의)에 배포할 수 있으며, 환경 간에 Recipe 바인딩을 중복할 필요가 없습니다. 각 지역의 Release 정의는 Manifest 정의가 제공하는 같은 소프트웨어 잠금 파일을 사용하면서 자신의 경계 레이아웃과 환경별 매개변수를 지닙니다. 멀티 리전 확장은 Manifest 복제가 아니라 도메인 분리에서 비롯됩니다.
티어 3: 라이브러리(카탈로그 재사용)
graph LR
classDef ext stroke-dasharray:5 4;
CC["Component"]:::ext
CapC["Feature"]:::ext
CD["Recipe"]:::ext
CapD["FeatureRecipe"]:::ext
SL["SchemaLibrary<br/>JSON Schema definitions"]
ML["MappingLibrary<br/>Go template fragments"]
WL["WorkloadLibrary<br/>Workload template fragments"]
AL["ArtifactLibrary<br/>Named artifact bundles"]
CC -.->|"$ref"| SL
CapC -.->|"$ref"| SL
CD -.->|"valuesMapping $import"| ML
CapD -.->|"$import"| ML
CD -.->|"workload $import"| WL
CD -.->|"artifacts $import"| AL
CapD -.->|"$import"| AL
- 역할: Platform Architect(도메인 2와 같은 페르소나)이지만, 이 역할은 카탈로그 콘텐츠가 Component 간 스키마 재사용이나 Recipe 간 템플릿, 워크로드 형태, 아티팩트 번들 재사용의 이점을 얻을 만큼 커졌을 때에만 작동합니다. 개인 작성자와 작은 카탈로그는 티어 3 엔터티 없이도 배포할 수 있습니다.
- 9. SchemaLibrary: 재사용 가능한 JSON Schema 2020-12 정의입니다. 라이브러리는
spec.schemas:에 이름 있는 스키마를,spec.templates:에 선택적인 매개변수화 헬퍼를 선언합니다(매개변수적 재사용을 위한$params:선언과$instantiate:참조 포함). 카탈로그 엔터티는 표준 JSON Schema$ref:키워드로 라이브러리 항목을 식별자로 가리켜 사용하며, 형식은 호스트 없는<library>#/schemas/<name>입니다(버전은 참조가 아니라 잠금 파일에서 옵니다). PascalCase 명명, OCI 배포, 잠금 파일 고정. Component 간 스키마 재사용이 필요한 카탈로그를 위한 선택 기능입니다.PodResources,PersistenceSpec,NodePool,MetricsServiceMonitor같은 공통 형태는 모든 데이터스토어 Component 정의와 모든 워크로드 Component 정의에서 반복되며, SchemaLibrary 항목은 이 반복을 각 Component 정의의 작성에서 분리해 냅니다. - 10. MappingLibrary: 재사용 가능한 Go 템플릿 조각입니다. 라이브러리는
spec.mappings:에 이름 있는 템플릿을 선언합니다. Recipes 및 FeatureRecipes 정의는valuesMapping: { $import: <library>#/mappings/<name> }를 통해 라이브러리 항목을 식별자로 사용합니다. 작성 방식은 하나뿐(Go 템플릿만)이며, 병렬 Jsonnet 작성 경로는 없습니다. Recipe 간 매핑 재사용이 필요한 카탈로그를 위한 선택 기능입니다. Bitnami 차트 헬퍼 로직이나 공유 파드 템플릿 패턴 같은 공통 패턴은 같은 제공자를 대상으로 하는 모든 데이터스토어 Recipe 정의에서 반복되며, MappingLibrary 항목은 이 반복을 각 Recipe 정의의 작성에서 분리해 냅니다. - 11. WorkloadLibrary: 재사용 가능한 Workload 템플릿 조각입니다. 라이브러리는
spec.workloads:에 이름 있는 워크로드 항목을 선언합니다. Recipe 정의는workload: { $import: <library>#/workloads/<entry> }를 통해 항목을 식별자로 사용하며, 가져온 본문은 인라인workload:블록과 똑같이 플랫폼 소유의 Workload 스키마에 대해 검증됩니다. 따라서 라이브러리에서 가져온 워크로드는 동등한 인라인 워크로드와 동일하게 렌더링됩니다. 작성 방식은 하나뿐입니다(Go 템플릿만). Recipe 간 워크로드 재사용이 필요한 카탈로그를 위한 선택 기능으로, 여러 Recipes 정의가 하나의 배포 형태를 공유하고 값만 다른 경우에 사용합니다. - 12. ArtifactLibrary: 재사용 가능한 이름 있는 아티팩트 번들입니다. 라이브러리는
spec.artifacts:에 이름 있는 번들을 선언하며, 각 번들은 함께 속하는 출력 파일(예: CRD, 그 RBAC, ConfigMap)을 묶어 하나의 단위로 가져옵니다. Recipes 및 FeatureRecipes 정의는artifacts.<name>: { $import: <library>#/artifacts/<name> }를 통해 번들을 식별자로 사용합니다. 작성 방식은 하나뿐입니다(Go 템플릿만). Recipe 간 아티팩트 재사용이 필요한 카탈로그를 위한 선택 기능으로, 같은 보조 리소스 세트가 많은 Recipes 정의에 함께 따라붙는 경우에 사용합니다.
모든 라이브러리는 OCI를 통해 게시되고, 잠금 파일(schema_libraries:, mapping_libraries:, workload_libraries:, artifact_libraries: 섹션)에 고정되며, 소비자 인식 정보와 함께 Hub UI에 표시됩니다(어떤 Components 정의가 어떤 라이브러리 항목을 참조하는지, 어떤 Recipes 정의가 어떤 라이브러리 항목을 사용하는지).