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

엔티티 레퍼런스 개요

Aggrega의 작성 어휘는 Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary로 구성되며, 여기에 Recipe의 합성된 입력 안에 포함되는 플랫폼 소유의 Workload 종류가 더해집니다. 모든 엔티티는 JSON Schema를 따르는 YAML 문서이며, 이 레퍼런스가 설명하는 모든 필드, 키워드, 엔티티 간 참조는 그 작성 계약의 일부입니다.

이 장들은 작성 표면을 다룹니다. 각 엔티티가 어떤 필드를 받는지, 각 필드가 작성자에게 무엇을 의미하는지, 필드가 엔티티 간에 어떻게 상호작용하는지(Recipe의 implements:가 그 Recipe가 구현하는 Component를 지정하는 것, Release의 manifest:가 Manifest를 가리키는 것, Workload의 containers.<name>.attachments가 Component의 featuresSchema에 선언된 슬롯을 참조하는 것)를 설명합니다. 각 엔티티의 개념적 역할, 즉 분류 체계가 왜 지금의 형태인지, 어느 도메인이 어느 엔티티를 소유하는지, 네 개의 도메인이 작성 관심사를 어떻게 분리하는지는 ../architecture/04-entity-taxonomy.md에서 다룹니다. 세 가지 Recipe 입력 종류 중 하나로서 Workload 종류가 갖는 아키텍처상의 역할은 ../architecture/16-recipe-input-composition.md에서 다룹니다.

이 레퍼런스의 구성

두 가지 표면이 작성 어휘를 문서화하며, 각각 서로 다른 질문에 답합니다.

위에 나열된 모든 종류에는 생성된 스키마 레퍼런스가 있습니다. 이 페이지들은 컴파일러 자체가 게시하는 스키마에서 생성되며, schema/README.md가 엔티티 종류, 플러그인 와이어 형태, 워크스페이스 파일을 포함한 전체 목록을 색인합니다. “이 문서에 무엇이 들어갈 수 있는가”라는 질문, 즉 모든 필드와 그 타입, 필수 여부, 엔벨로프가 강제하는 제약에 대한 답은 스키마 레퍼런스에서 찾습니다.

아래 페이지들은 작성 가이드입니다. 스키마가 가르칠 수 없는 것, 즉 어떤 종류가 무엇을 위한 것인지, 그 필드가 다른 종류와 어떻게 상호작용하는지, 어떤 상황에 어떤 작성 형태가 맞는지, 표준 라이브러리 카탈로그가 따르는 관례를 가르치기 위해 직접 작성되었습니다. “어떻게 작성하며, 왜 이런 형태인가”라는 질문의 답은 작성 가이드에서 찾습니다.

엔티티별 레퍼런스

  • Aggregate — 개발자의 선언적 의도 아티팩트입니다. 컴포넌트, uses를 통한 토폴로지, 환경별 변형을 위한 파라미터 계약, Feature 연결을 선언합니다.
  • Component — 플랫폼 아키텍트가 작성하는 카탈로그 엔티티로, 재사용 가능한 컴포넌트 종류를 정의합니다. values 및 infra 스키마(각각 간결형 또는 전체형의 JSON Schema 2020-12 선언), provides 출력 계약, usesSchema 인바운드 엣지 계약, featuresSchema를 통한 자격 증명 슬롯을 선언합니다.
  • Feature — 플랫폼 아키텍트가 작성하는 카탈로그 엔티티로, 횡단 관심사(모니터링 사이드카, 데이터 마스킹, 라우팅 정책)를 위한 것입니다. values 및 infra 스키마(각각 JSON Schema 2020-12 선언), appliesTo 연결 선택자, 상호 운용성 제약을 선언합니다.
  • Recipe — 운영팀이 작성하는, Component에서 특정 프로바이더로의 변환입니다. 세 가지 입력 종류(source: + valuesMapping:, workload:, artifacts: — 각각 통합 파일 가져오기 어휘에 따라 인라인 콘텐츠 또는 $import:를 받음)와 호출자 주입 계약을 이루는 provides 블록을 조합합니다.
  • FeatureRecipe — 운영팀이 작성하는, Feature에서 특정 프로바이더로의 변환입니다. Recipe와 동일한 세 가지 입력 종류 계약을 사용하며, 여기에 호출자 측 변수 재작성을 위해 주입 파이프를 가로채는 injectMapping이 더해집니다.
  • Plugin — 콘텐츠 주소 지정 방식의 WebAssembly 플러그인입니다. 구현하는 하나의 소켓 타입(provider, linter, pipeline-step, governance, cli, parser, importer 중 하나), ABI 버전, 그 소켓 타입이 제공하는 기능을 선언합니다. 프로바이더 렌더링 Plugin(pluginType: provider)은 제공하는 프로바이더 이름을 spec.provider.capabilities에 선언하고, 프로바이더 소켓 메타데이터인 workloadSchema와 wellKnownAnnotations를 같은 spec.provider 블록에 담습니다.
  • Manifest — 프로젝트별 매핑 테이블입니다. 추상 Component 및 Feature 타입을 components와 features 아래에서 구체적인 Recipe 및 FeatureRecipe URI에 바인딩하며, 조회 순서는 name > 버전이 지정된 type > 버전이 지정되지 않은 type입니다.
  • Release — 환경별 배포 라우터입니다. Aggregate를 Manifest에 바인딩하고, 컴포넌트를 물리적 경계에 매핑하며, 환경별 파라미터 값을 제공하고, 운영팀이 관리하는 Features를 연결합니다.

라이브러리 엔티티

네 가지 라이브러리 종류는 Tier 3, 즉 선택적으로 사용하는 재사용 엔티티입니다. 카탈로그는 동일한 콘텐츠가 엔티티 전반에 반복될 때 이를 선언하며, 그렇지 않으면 없이 배포됩니다. 각 라이브러리는 하나의 콘텐츠 타입을 담으며, 참조의 프래그먼트(#/schemas/, #/mappings/, #/workloads/, #/artifacts/)가 그 참조가 어느 라이브러리를 가리키는지 나타냅니다.

  • SchemaLibrary — 재사용 가능한 JSON Schema 2020-12 정의와 선택적인 파라미터화 헬퍼로, Component 또는 Feature의 스키마에서 $ref: <Library>#/schemas/<name>으로 참조합니다.
  • MappingLibrary — 재사용 가능한 Go 템플릿 조각으로, Recipe 또는 FeatureRecipe의 valuesMapping:에 $import: <Library>#/mappings/<name>으로 가져옵니다.
  • WorkloadLibrary — 재사용 가능한 Workload 콘텐츠로, Recipe 또는 FeatureRecipe의 workload:에 $import: <Library>#/workloads/<name>으로 가져옵니다.
  • ArtifactLibrary — 보조 출력 파일의 재사용 가능한 번들로, Recipe 또는 FeatureRecipe의 artifacts:에 $import: <Library>#/artifacts/<name>으로 가져옵니다. 번들이 재사용의 단위이며, 하나의 가져오기는 번들 안의 파일마다 하나의 출력으로 확장됩니다.

플랫폼 소유 종류

  • Workload — 플랫폼이 소유하는 컴파일러 종류입니다(사용자가 작성하는 카탈로그 엔티티가 아님). Recipe의 workload: 필드 안에 (인라인으로 또는 $import:를 통해) 포함되며, 프로바이더가 프로바이더 고유의 매니페스트로 합성하는 배포 형태를 기술합니다.