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

Aggrega 개발자 의도(Aggregate) 스키마

자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.

스키마 id: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json

재귀적이고 매개변수화된 AI 아키텍처입니다. 빌드의 루트이자 재사용 가능한 모듈로 동작합니다.

Aggregate 엔터티 작성에 관한 설명은 Aggregate 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.

최상위 타입: object

속성

속성타입필수설명
apiVersionconst “aggrega.ai/v1beta1”예상수: "aggrega.ai/v1beta1"
kindconst “Aggregate”예상수: "Aggregate"
metadataobject예
defsstring[]아니요표준 YAML 앵커(& 및 *)를 위한 선택적 블록으로, 컴파일러를 위해 평탄한 O(1) 딕셔너리를 유지하면서 Aggregate를 DRY하게 유지합니다. Manifest의 동일한 블록을 그대로 따릅니다.
specobject예Developer Intent 표면: 전역 파라미터 계약, 중첩된 aggregate 임포트, 내보낸 컴포넌트 공개 API, 서브시스템 그룹, 그리고 모듈을 구성하는 컴포넌트 인스턴스입니다.

추가 속성은 허용되지 않습니다.

aggregate.metadata

속성타입필수설명
namestring예최소 1자 이상이어야 합니다.
versionstring예aggregate 모듈의 엄격한 Semantic Versioning입니다. 패턴: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstring아니요
maintainersobject[]아니요이 엔티티를 소유하는 메인테이너 목록입니다.
licensestring아니요이 엔티티가 기술하는 소프트웨어의 라이선스를 나타내는 SPDX 식별자로, MIT 또는 AGPL-3.0 등이 있습니다. 이 파일의 조건이 아니라 해당 소프트웨어의 조건을 기록합니다.
repositorystring아니요소스 파일이 있는 Git 저장소의 URL입니다.
homestring아니요이 엔티티의 홈페이지, 위키 또는 문서의 URL입니다.
keywordsstring[]아니요UI에서 쉽게 찾을 수 있도록 하는 설명 키워드 목록입니다.
labelsstring 맵아니요카탈로그 탐색, 정책 평가, Studio/IDE 필터링을 위한 모듈 수준의 덕 타이핑 레이블입니다. 이 레이블은 재사용 가능한 모듈로서 Aggregate의 정체성을 기술합니다(예: aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). 하위 컴포넌트 노드로 전파되지 않습니다. 컴포넌트 레이블은 오직 Domain 2의 Component 카탈로그 엔티티에서만 옵니다.

추가 속성은 허용되지 않습니다.

aggregate.metadata.maintainers[]
속성타입필수설명
namestring예
emailstring아니요
urlstring아니요

추가 속성은 허용되지 않습니다.

aggregate.spec

Developer Intent 표면: 전역 파라미터 계약, 중첩된 aggregate 임포트, 내보낸 컴포넌트 공개 API, 서브시스템 그룹, 그리고 모듈을 구성하는 컴포넌트 인스턴스입니다.

속성타입필수설명
parametersobject 맵아니요전역 환경 계약입니다. 각 항목은 간결형 어휘의 부분 집합(type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties)을 작성하는 타입 지정 계약 객체입니다. 중첩 구조는 타입 지정형의 properties: 하위 필드로 표현합니다. Release의 충족은 인라인(parameters: {…})이나 단일 소스 파일 임포트(parameters: {$import: })로 할 수 있으며, 파라미터 계약 계층은 파라미터 보간 전에 병합된 맵을 이 계약에 대해 검증합니다. 전체 어휘는 언어 레퍼런스의 Aggregate 페이지에서 설명합니다.
aggregatesobject 맵아니요임포트된 모듈 역할을 하는 중첩 aggregate입니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
exportedComponentsstring 맵아니요공개 API 인터페이스입니다. 노출된 공개 이름을 내부 컴포넌트 ID에 매핑합니다. 이 모듈을 임포트하는 상위 Aggregates는 이 공개 이름으로 컴포넌트를 참조합니다.
subsystemssubsystem 맵아니요Aggregate의 컴포넌트를 서브시스템으로 묶은 이름 있는 논리적 그룹입니다. 최상위 components와 상호 배타적이며, 둘 다 선언하면 거부됩니다. 작성자가 default라고 이름 붙인 서브시스템은 평범한 선언된 서브시스템이며, 컴파일러가 components만 있는 Aggregate를 위해 합성하는 default와는 다릅니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
componentscomponent_instance 맵아니요이 Aggregate를 구성하는 논리적 원자 컴포넌트의 맵으로, 최상위에서 직접 작성합니다. 최상위 components와 subsystems는 상호 배타적이며, 둘 다 선언하면 거부됩니다. 컴포넌트를 여기에(subsystems 없이) 작성하면 컴파일러가 로드 시 이를 합성된 default 서브시스템으로 접어 넣으며, IR은 그 서브시스템을 합성된 것으로 표시합니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.

추가 속성은 허용되지 않습니다.

정의

inject_delivery

항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features..inject 컨텍스트에서는 그 첨부의 FeatureRecipe가 게시하는 provides에 대해, component.inject 컨텍스트에서는 컴포넌트 자신의 provides에 대해 해석됩니다. 첨부의 features..inject에서 FeatureRecipe가 게시하지 않는 키를 가리키는 ‘from’은 빌드를 중단시킵니다. 단, 그 FeatureRecipe가 첨부의 렌더 컨텍스트에 대해 평가하는 템플릿(그 valuesMapping, workload, artifacts, omits, 또는 파이프라인 단계의 with나 when — injectMapping은 제외)에서 첨부의 항목을 .inject에서 직접 읽는 경우는 예외이며, 이때 그 키는 컴포넌트의 .context.inject를 통해 전달되는 키가 아니라 FeatureRecipe가 스스로 소비하는 키입니다. ‘value’는 component.inject에서만 전달됩니다. uses[].inject 또는 첨부의 features..inject에서 이를 가진 항목은 빌드를 중단시키는데, 이 블록들은 다른 엔티티가 게시하는 키만 전달하기 때문입니다.

타입: object[]

inject_block

구애받지 않는 주입 라우팅입니다. 로컬 변수를 대상의 provides 키(uses[].inject), 첨부의 FeatureRecipe가 게시하는 provides 키(features..inject), 또는 리터럴 문자열 / 템플릿 표현식과 컴포넌트 자신의 provides 키(component.inject)에 매핑합니다. 각 전달 메커니즘(env, file, arg 또는 사용자 정의)은 {in, from?, value?} 항목의 배열로 작성되며, provides 참조에는 명시적인 ‘from’을, 리터럴에는 ‘value’를 사용합니다. 사용자 정의 메커니즘에는 all을 제외한 어떤 이름이든 붙일 수 있습니다. 템플릿은 모든 메커니즘을 하나의 뷰로 병합하여 .context.inject.all에서 읽으므로, 그 이름의 메커니즘은 이 뷰에 가려지며, 그 이름을 붙이면 빌드가 중단됩니다.

속성타입필수설명
envinject_delivery아니요항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features..inject 컨텍스트에서는 그 첨부의 FeatureRecipe가 게시하는 provides에 대해, component.inject 컨텍스트에서는 컴포넌트 자신의 provides에 대해 해석됩니다. 첨부의 features..inject에서 FeatureRecipe가 게시하지 않는 키를 가리키는 ‘from’은 빌드를 중단시킵니다. 단, 그 FeatureRecipe가 첨부의 렌더 컨텍스트에 대해 평가하는 템플릿(그 valuesMapping, workload, artifacts, omits, 또는 파이프라인 단계의 with나 when — injectMapping은 제외)에서 첨부의 항목을 .inject에서 직접 읽는 경우는 예외이며, 이때 그 키는 컴포넌트의 .context.inject를 통해 전달되는 키가 아니라 FeatureRecipe가 스스로 소비하는 키입니다. ‘value’는 component.inject에서만 전달됩니다. uses[].inject 또는 첨부의 features..inject에서 이를 가진 항목은 빌드를 중단시키는데, 이 블록들은 다른 엔티티가 게시하는 키만 전달하기 때문입니다.
fileinject_delivery아니요항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features..inject 컨텍스트에서는 그 첨부의 FeatureRecipe가 게시하는 provides에 대해, component.inject 컨텍스트에서는 컴포넌트 자신의 provides에 대해 해석됩니다. 첨부의 features..inject에서 FeatureRecipe가 게시하지 않는 키를 가리키는 ‘from’은 빌드를 중단시킵니다. 단, 그 FeatureRecipe가 첨부의 렌더 컨텍스트에 대해 평가하는 템플릿(그 valuesMapping, workload, artifacts, omits, 또는 파이프라인 단계의 with나 when — injectMapping은 제외)에서 첨부의 항목을 .inject에서 직접 읽는 경우는 예외이며, 이때 그 키는 컴포넌트의 .context.inject를 통해 전달되는 키가 아니라 FeatureRecipe가 스스로 소비하는 키입니다. ‘value’는 component.inject에서만 전달됩니다. uses[].inject 또는 첨부의 features..inject에서 이를 가진 항목은 빌드를 중단시키는데, 이 블록들은 다른 엔티티가 게시하는 키만 전달하기 때문입니다.
arginject_delivery아니요항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features..inject 컨텍스트에서는 그 첨부의 FeatureRecipe가 게시하는 provides에 대해, component.inject 컨텍스트에서는 컴포넌트 자신의 provides에 대해 해석됩니다. 첨부의 features..inject에서 FeatureRecipe가 게시하지 않는 키를 가리키는 ‘from’은 빌드를 중단시킵니다. 단, 그 FeatureRecipe가 첨부의 렌더 컨텍스트에 대해 평가하는 템플릿(그 valuesMapping, workload, artifacts, omits, 또는 파이프라인 단계의 with나 when — injectMapping은 제외)에서 첨부의 항목을 .inject에서 직접 읽는 경우는 예외이며, 이때 그 키는 컴포넌트의 .context.inject를 통해 전달되는 키가 아니라 FeatureRecipe가 스스로 소비하는 키입니다. ‘value’는 component.inject에서만 전달됩니다. uses[].inject 또는 첨부의 features..inject에서 이를 가진 항목은 빌드를 중단시키는데, 이 블록들은 다른 엔티티가 게시하는 키만 전달하기 때문입니다.

component_uses_block

컴포넌트가 의존하는 컴포넌트로 연결하는 연결들로, 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. 별칭으로 이름이 지정된 연결은 개발자의 연결별 값과 소켓이 선언한 슬롯을 채우는 첨부를 가질 수 있습니다.

키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.

값은 string[] or map of object입니다.

그 밖의 키는 허용되지 않습니다.

feature_uses_block

첨부된 Feature가 맺는 연결들로, Feature가 usesSchema에 선언한 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. Feature가 맺는 연결은 자체 첨부를 갖지 않습니다. 연결에 필요한 자격 증명은 Feature가 자신의 featuresSchema에 선언한 슬롯을 채우며 Feature 옆에 첨부됩니다.

키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.

값은 string[] or map of object입니다.

그 밖의 키는 허용되지 않습니다.

connection_attachment

연결이 가지는 하나의 첨부입니다. 연결의 소켓이 선언한 슬롯을 채우는 Feature와 그에 대한 개발자의 구성으로 이루어집니다.

속성타입필수설명
typestring예이 첨부가 요청하는 Feature 인터페이스의 URI입니다(예: core/referenced-secret:1.0.0).
descriptionstring아니요이 연결이 해당 첨부를 가지는 이유를 설명하는 선택적 문서입니다.
valuesobject아니요Feature에 대해 개발자가 제공하는 구성으로, 해당 스키마 선언에 따라 검증됩니다.

추가 속성은 허용되지 않습니다.

subsystem

속성타입필수설명
descriptionstring아니요이 서브시스템의 목적과 서브시스템이 나타내는 논리적 그룹을 설명하는 선택적 문서입니다.
annotationsstring 또는 object 또는 null의 맵아니요이 서브시스템에 대해 개발자가 작성한 어노테이션입니다. 값은 문자열, 구조화된 객체(하위 키에서 값으로의 맵으로, 상속된 구조화된 값과 하위 키별로 병합됨) 또는 null입니다. 상위 서브시스템에서 상속된 키에 명시적으로 null을 지정하면 상속된 바인딩이 이 서브시스템에서 제거됩니다(어노테이션 기반 Feature 옵트아웃). 여기에 선언된 어노테이션은 중첩된 서브시스템과 포함된 컴포넌트에 상속되며, 키별로 더 가까운 수준이 우선합니다. 파생된 각 IR 노드의 .context.annotations.aggregate 버킷으로 하위 전파됩니다.
featuresobject 맵아니요이 서브시스템의 모든 컴포넌트에 첨부되는 횡단 기능입니다. 컴포넌트 수준 기능과 동일한 스키마(type, values, uses, inject)를 가집니다. 그래프 확정 시 각 컴포넌트로 평탄화되며, 실행 순서에서 컴포넌트 수준 기능 뒤에 배치됩니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
subsystemssubsystem 맵아니요키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
componentscomponent_instance 맵아니요키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.

추가 속성은 허용되지 않습니다.

component_instance

속성타입필수설명
typestring예요청하는 추상 Component를 참조로 지정합니다. metadata.name에 선택적인 :version을 붙인 것(예: core/api-server:1.0.0)이며, 파일 경로가 아닙니다. 3계층 엔터티 해석 모델(워크스페이스 카탈로그 디렉터리 → 캐시 → 레지스트리)로 해석됩니다. 로컬에서 작성한 Component는 워크스페이스 루트의 catalog/ 아래나 workspace.catalog_dirs에 나열된 디렉터리에 둡니다. 상대 파일 경로로 작성된 type은 어떤 카탈로그에도 없는 엔터티로서 빌드를 중단시킵니다.
activeboolean 또는 string아니요이 컴포넌트가 컴파일된 토폴로지에 존재하는지 여부입니다. boolean이거나, boolean으로 해석되어야 하는 .parameters 기반 string 템플릿입니다. false로 해석되면 컴포넌트는 토폴로지에서 제거되며, 이는 해당 uses 에지와 첨부에도 연쇄 적용됩니다. 값을 파라미터로 구동하면 Release가 해당 파라미터를 채워 컴포넌트의 존재 여부를 전환할 수 있습니다. 생략하면 기본값은 true입니다. 기본값: true
descriptionstring아니요애플리케이션에서 이 컴포넌트 인스턴스의 역할을 설명하는 선택적 문서입니다. IR 그래프까지 전달됩니다.
annotationsstring 또는 object 또는 null의 맵아니요이 컴포넌트에 개발자가 작성한 어노테이션입니다. 값은 문자열, 구조화된 객체(하위 키에서 값으로의 맵으로, 상속된 구조화된 값과 하위 키별로 병합됨) 또는 null이며, 상위 서브시스템에서 상속된 키에 명시적으로 null을 지정하면 상속된 바인딩이 이 컴포넌트에서 제거됩니다(어노테이션 기반 Feature 옵트아웃). Component 수준 어노테이션은 상속된 서브시스템 수준 어노테이션을 키별로 재정의하며, 같은 서브시스템의 형제 컴포넌트는 각자의 어노테이션 맵을 독립적으로 유지합니다.
valuesobject아니요Component에 전달되는 불투명한 인지적 속성으로, 해당 스키마로 검증됩니다.
usescomponent_uses_block아니요컴포넌트가 의존하는 컴포넌트로 연결하는 연결들로, 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. 별칭으로 이름이 지정된 연결은 개발자의 연결별 값과 소켓이 선언한 슬롯을 채우는 첨부를 가질 수 있습니다.
injectinject_block아니요컴포넌트 수준 self-inject입니다. 컴포넌트 자신의 값(‘value:‘를 통해) 또는 자신의 provides 키(‘from:‘을 통해)를 전달 파이프(.context.inject)에 직접 주입합니다. Component 카탈로그 엔터티가 해당 메커니즘과 함께 ‘spec.inject’를 선언한 경우에만 허용됩니다. uses[].inject에 선언된 키와 충돌하는 inject 키는 inject 소스 간에 중복된 전달 키로서 빌드를 중단시킵니다.
featuresobject 맵아니요이 컴포넌트에 첨부된 Features로, 작성자가 각 첨부에 부여한 인스턴스 이름을 키로 사용합니다. 이것이 유일한 첨부 지점입니다. 운영 Feature, 자격 증명 Feature(feature.aggrega.ai/kind: secret 레이블이 지정된 것), 아이덴티티 Feature 모두 같은 키워드와 같은 형태로 여기에 첨부됩니다. 이들 사이의 차이는 첨부가 무엇을 생성하는지이지, 어떻게 선언되는지가 아닙니다. 인스턴스 이름이 Component가 featuresSchema에 선언한 슬롯과 일치하는 첨부는 그 슬롯을 채우며, 그 밖의 인스턴스 이름은 자유 첨부입니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.

추가 속성은 허용되지 않습니다.