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

역할별 엔티티

모든 엔티티 종류에는 일반적으로 그것을 작성하는 역할이 있습니다. 이 페이지는 그 전체 지도로, 관심사는 알지만 그것이 어느 파일에 속하는지 아직 모를 때 참고하십시오. 역할 배정은 지침일 뿐 컴파일러가 강제하는 것이 아니며(페르소나 참조), 잘 분리된 구성에서 누가 보통 해당 종류를 소유하는지를 나타냅니다.

한눈에 보는 지도

역할엔티티 종류관심사
개발자Aggregate애플리케이션 의도: 앱이 무엇이고 무엇을 필요로 하는지
플랫폼 아키텍트Component, Feature재사용 가능하고 버전이 관리되는 카탈로그 계약
플랫폼 운영Recipe, FeatureRecipe, 프로바이더 렌더링 Plugin렌더링된 인프라로의 Provider별 변환
플랫폼 운영자Manifest, Release라우팅과 배포 연결
횡단 지원SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, Workload공유 형태, 확장 코드, 플랫폼이 소유하는 컴파일러 종류

개발자

Aggregate — 개발자의 유일한 작성 대상이자 애플리케이션 토폴로지의 단일 진실 공급원입니다. 애플리케이션을 구성하는 컴포넌트, 각 컴포넌트가 받는 values, 동작이 애플리케이션 의도에 해당하는 Features(및 그 values), 환경별 변형을 위해 노출되는 parameters, 그리고 컴포넌트를 서로 연결하는 uses 엣지를 선언합니다. 물리적 인프라에는 의도적으로 구애받지 않습니다. Aggregate의 어떤 부분도 클라우드, 클러스터, 프로바이더를 지정하지 않습니다. 이처럼 역량에 구애받지 않기 때문에 하나의 Aggregate를 어디에나 배포할 수 있습니다.

플랫폼 아키텍트

Component — 한 종류의 빌딩 블록에 대한 재사용 가능하고 버전이 관리되는 계약입니다. JSON Schema를 통해 개발자가 제공할 수 있는 values, 소비자에게 전달하는 provides 출력, 연결을 위해 노출하는 usesSchema 소켓을 선언합니다. Components는 정책과 렌더링을 이끄는 의미 레이블을 가집니다. 아키텍트는 개발자가 의존할 수 있도록 Component의 계약을 안정적으로 유지합니다.

Feature — 개발자나 운영자가 컴포넌트에 추가할 수 있는 부착형 기능입니다. 예를 들어 메트릭 익스포터, AI 게이트웨이의 민감한 텍스트 마스킹, 자격 증명 바인딩이 있습니다. Feature는 자신이 필요로 하는 것과 호환되지 않는 것을 선언하며, 그것이 어떻게 실현되는지, 즉 생성하는 리소스나 해당 컴포넌트가 이미 렌더링하는 내용에 기록하는 설정은 그 FeatureRecipe에 있습니다.

플랫폼 운영

Recipe — Component의 프로바이더별 실현입니다. 템플릿을 통해 Component가 선언한 값을 Helm 릴리스, Compose 서비스, Terraform 모듈 같은 구체적인 프로바이더의 출력에 매핑하고, provides 값을 소비자에게 전달합니다. Recipe는 Component가 선언한 개발자 대상 값을 절대 변경하지 않으며, 그 값이 어떻게 렌더링되는지만 결정합니다.

FeatureRecipe — Feature의 프로바이더별 실현으로, 바인딩 시점에 적용됩니다. 주어진 프로바이더에 대해 Feature 부착이 암시하는 리소스를 생성하거나, 그것이 암시하는 설정을 부착된 컴포넌트가 이미 렌더링하는 내용에 기록합니다.

Provider 렌더링 Plugin — provider는 Recipe의 입력을 provider 고유의 매니페스트로 변환하는 Wasm 게스트입니다. provider는 pluginType: provider를 가진 Plugin으로 제공되며, 이 Plugin은 자신이 렌더링하는 provider 이름과 provider 소켓 계약을 선언합니다. 운영 팀(또는 플러그인 작성자)이 provider를 제공하므로 Recipes는 렌더링 대상이 되는 provider를 갖게 됩니다. 기본 제공 provider와 그 계약은 Providers Overview(Providers 개요)를 참조하십시오.

Recipe에서 자격 증명을 안전하게 읽기

자격 증명은 inject 파이프인 .context.inject.env를 통해 작성자가 고른 임의의 텍스트로 Recipe에 도달하므로, 템플릿이 그대로는 YAML에 쓸 수 없는 문자를 담고 있을 수 있습니다. 큰따옴표로 묶인 스칼라 안에서 큰따옴표는 값을 일찍 끝내고 백슬래시는 이스케이프를 시작합니다. 그 결과 빌드가 중단되거나 백슬래시가 소리 없이 사라집니다. 값을 작성하는 곳에서 둘 다 이스케이프하십시오:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional은 빈 대체값을 사용하여 파이프의 맵에서 키를 읽으므로, 아무것도 전달되지 않은 비밀번호는 빈 텍스트로 렌더링됩니다. 두 replace 호출은 먼저 백슬래시를, 그다음 따옴표를 이스케이프합니다. 이 순서 덕분에 따옴표 자체의 이스케이프가 다시 이스케이프되지 않으며, 다른 모든 문자는 그대로 남습니다. 키가 없으면 중단되는 index로 읽은 값에도 같은 두 replace 호출을 그대로 적용합니다.

이 형식이 전달하지 못하는 문자 하나는 줄 바꿈입니다. YAML은 큰따옴표로 묶인 스칼라 안의 줄 바꿈을 공백으로 접으므로, 줄 바꿈을 담은 자격 증명은 줄 바꿈이 있던 자리에 공백이 들어간 채로 전달됩니다. 자격 증명을 자신의 injectMapping에 작성하는 FeatureRecipe는 대신 toJson을 통해 작성하며, FeatureRecipe 참조에서 보여 주듯이 이 방식은 따옴표, 백슬래시, 줄 바꿈을 모두 전달합니다.

그 FeatureRecipe는 Recipe가 자격 증명을 읽어 오는 메커니즘 아래에 자격 증명을 작성합니다. 즉 .context.inject.env에 대해서는 env:, 또는 file:, arg:, 또는 컴포넌트 고유의 메커니즘이라면 그 고유한 이름 아래입니다. .context.inject.all은 이러한 메커니즘으로 구성되며 매핑의 출력으로 구성되는 일은 없으므로, all: 아래에 작성하는 매핑은 아무것도 전달하지 못합니다. 대신 빌드는 그 시점에서 중단되며 해당 첨부, 키, FeatureRecipe를 지명합니다.

플랫폼 운영자

Manifest — 라우팅 계층입니다. 주어진 대상에 대해 어떤 Recipe가 각 Component를 실현하는지 컴파일러에 지시하므로, 개발자의 파일을 변경하지 않고도 동일한 Aggregate가 환경마다 다른 구현(프로덕션에는 클라우드 Recipe, 로컬 테스트에는 Compose Recipe)을 가리킬 수 있습니다.

Release — 하나의 환경이 빌드하는 내용을 기록하는 단일 컴파일 입력입니다. Aggregate와 Manifest를 가리키고, 개발자가 노출한 parameters를 채우며, 입력이 운영에 관한 Features를 부착하고, 개발자가 부착한 것들의 크기를 infra로 정하며, 아키텍트가 선언한 소켓 안에서 자체 엣지를 연결합니다. Release는 노출된 변형 지점을 채울 뿐, 새로운 애플리케이션 values나 새로운 컴퓨트를 도입할 수 없습니다. 그것들은 오직 Aggregate에서만 옵니다.

횡단 지원 종류

이 종류들은 하나의 역할에 속하기보다 여러 역할의 작성자에게 쓰입니다.

SchemaLibrary — 여러 Components와 Features에 반복되는 스키마 형태의 공유 라이브러리입니다. 같은 구조(예: 파드 리소스 블록)가 여러 엔티티에 나타나면, 아키텍트는 이를 SchemaLibrary 항목으로 분리하여 한 번만 정의하고 갱신합니다.

MappingLibrary — Recipes와 FeatureRecipes가 활용하는 재사용 가능한 매핑 로직의 공유 라이브러리로, 공통 변환 패턴을 복사하지 않고 한 곳에서 관리합니다.

WorkloadLibrary — 재사용 가능한 Workload 내용의 공유 라이브러리로, 여러 Recipes에 반복되는 배포 형태를 한 번 선언하고 각 workload: 블록으로 가져옵니다.

ArtifactLibrary — 재사용 가능한 아티팩트 번들의 공유 라이브러리입니다. 번들은 RBAC가 딸린 CRD처럼 함께 속하는 보조 출력 파일의 이름 있는 집합입니다. Recipe나 FeatureRecipe는 하나의 artifacts: 항목에서 번들을 가져와 그 안의 모든 파일을 출력합니다.

Plugin — 확장 종류입니다. 프로바이더 렌더링 외에도 Plugins는 정책 검증, 변형, 린팅 및 기타 소켓과 같은 도메인 특화 지능을 제공하는 WebAssembly 코드를 패키징합니다. Plugin 작성은 다른 모든 역할을 지원하는 플랫폼 팀의 관심사입니다.

Workload — 플랫폼이 소유하는 컴파일러 종류로, 개발자나 운영자가 최상위 엔티티로 직접 작성하는 파일이 아닙니다. Recipe의 workload: 블록 안에서 소비되며, Recipe가 렌더링에 사용하는 프로바이더가 그곳에서 정규화된 워크로드 형태를 자신의 네이티브 형식으로 변환합니다. Recipe 작성자는 그 블록을 통해 이를 다루며, Workload 레퍼런스에 그 형태가 문서화되어 있습니다.

다음