Aggrega 의존성 잠금 파일(Manifest) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/manifest-v1beta1.schema.json
추상 component 및 Feature 타입을 타입별로 구체적인 Recipe 및 FeatureRecipe 구현에 매핑하는 단일 전역 잠금 파일로, 이름으로 인스턴스별 재정의를 할 수 있습니다.
Manifest 엔티티 작성에 관한 설명은 Manifest 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “Manifest” | 예 | 상수: "Manifest" |
metadata | object | 예 | |
defs | string[] | 아니요 | 컴파일러를 위한 평면적인 O(1) 딕셔너리를 유지하면서 Manifest를 DRY하게 유지하기 위한 표준 YAML 앵커(& 및 *)용 선택적 블록입니다. |
spec | object | 예 | Manifest의 매핑 선언과 선택적 기반 상속입니다. mappings는 추상적인 component 및 feature 타입을 구체적인 Recipe 및 FeatureRecipe 구현에 연결하고, extends는 기반 Manifest로부터 매핑을 상속합니다. |
추가 속성은 허용되지 않습니다.
manifest.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 최소 1자 이상이어야 합니다. |
version | string | 예 | manifest 잠금 파일의 엄격한 시맨틱 버저닝 버전입니다(예: 1.0.0). 패턴: ^(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-]+)*))?$. |
description | string | 아니요 | 이 엔티티가 무엇이며 무엇을 위한 것인지를, 사용 여부를 결정하려는 사람을 위해 작성합니다. 대상을 지칭하는 문장으로 시작한 뒤, 독자가 이를 선택하고 올바르게 사용하는 데 필요한 내용, 즉 이를 사용하는 Release에 무엇을 기대하는지와 동작 방식에서 예상하기 어려운 점을 덧붙입니다. 보통 짧은 문단 하나 정도의 분량입니다. |
maintainers | object[] | 아니요 | 이 엔티티를 소유하는 메인테이너 목록입니다. |
license | string | 아니요 | 이 엔티티가 기술하는 소프트웨어의 라이선스를 나타내는 SPDX 식별자로, MIT 또는 AGPL-3.0 등이 있습니다. 이 파일의 조건이 아니라 해당 소프트웨어의 조건을 기록합니다. |
repository | string | 아니요 | 소스 파일이 있는 Git 저장소의 URL입니다. |
home | string | 아니요 | 이 엔티티의 홈페이지, 위키 또는 문서의 URL입니다. |
keywords | string[] | 아니요 | UI에서 쉽게 찾을 수 있도록 하는 설명 키워드 목록입니다. |
추가 속성은 허용되지 않습니다.
manifest.metadata.maintainers[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | |
email | string | 아니요 | |
url | string | 아니요 |
추가 속성은 허용되지 않습니다.
manifest.spec
Manifest의 매핑 선언과 선택적 기반 상속입니다. mappings는 추상적인 component 및 feature 타입을 구체적인 Recipe 및 FeatureRecipe 구현에 연결하고, extends는 기반 Manifest로부터 매핑을 상속합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
extends | string | 아니요 | 매핑을 상속할 기반 Manifest의 URI입니다. 같은 키에 대해서는 하위의 매핑이 기반의 매핑을 대체합니다. |
mappings | object | 예 | 추상 인터페이스를 구체적인 구현에 매핑합니다. 최상위 키 ‘components’와 ‘features’ 아래에 매핑을 선언하며, 각각 component 타입 / feature 타입 URI를 Recipe / FeatureRecipe URI에 직접 매핑합니다. 이 두 키가 전부이며, 여기서는 다른 키를 허용하지 않습니다. Manifest 계층에서 매핑은 capability에 구애받지 않으며, capability 결정은 Aggrega가 Release를 빌드할 때 확인된 각 Recipe의 spec.capability에서 비롯됩니다. 키: "components", "features" 중 하나. |
추가 속성은 허용되지 않습니다.
manifest.spec.mappings
추상 인터페이스를 구체적인 구현에 매핑합니다. 최상위 키 ‘components’와 ‘features’ 아래에 매핑을 선언하며, 각각 component 타입 / feature 타입 URI를 Recipe / FeatureRecipe URI에 직접 매핑합니다. 이 두 키가 전부이며, 여기서는 다른 키를 허용하지 않습니다. Manifest 계층에서 매핑은 capability에 구애받지 않으며, capability 결정은 Aggrega가 Release를 빌드할 때 확인된 각 Recipe의 spec.capability에서 비롯됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
components | mapping_tier | 아니요 | Component-type에서 Recipe URI로의 매핑입니다. Recipe URI는 최대 두 개의 세그먼트(선택적인 선행 capability, 그다음 recipe 이름)와 선택적인 버전으로 구성되며, 세 번째 세그먼트가 있는 참조는 어떤 recipe와도 일치하지 않습니다. 버전 형식: 정확한 버전(‘postgres-bitnami:1.2.0’), 범위(‘postgres-bitnami:^1.2.0’), 또는 버전 없음(‘postgres-bitnami’). 리졸버는 최초 해석 시 해석된 버전을 lockfile에 고정합니다. 참조는 추가로 capability로 한정할 수 있으며(‘terraform/mariadb-rds:1.0.0’, 첫 번째 ’/’ 앞의 세그먼트가 recipe의 spec.capability를 나타냄), 둘 이상의 recipe가 같은 이름을 제공하는 경우에는 필수입니다. 모호한 단순 참조는 하나를 조용히 선택하지 않고 해석을 명시적으로 중단합니다. |
features | mapping_tier | 아니요 | Feature-type에서 FeatureRecipe URI로의 매핑입니다. 운영용 Features와 자격 증명 Features(feature.aggrega.ai/kind: secret 레이블이 지정됨)를 모두 포함합니다. |
키: "components", "features" 중 하나.
추가 속성은 허용되지 않습니다.
정의
mapping_tier
2단계 확인: ‘type’은 카탈로그 타입별로 매핑하고(DRY 일괄), ‘name’은 인스턴스 이름별로 매핑합니다(세분화된 재정의). 둘 다 선택 사항이지만 적어도 하나는 있어야 합니다. 확인 시 name이 type보다 우선합니다. 버전이 지정된 type 키가 버전 없는 키보다 우선합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string 맵 | 아니요 | 카탈로그 타입 URI를 Recipe URI에 매핑합니다. 정확한 일치를 위한 버전 지정 키(‘core/api-server:1.0.0’), 메이저 호환 일치를 위한 범위 키(‘core/api-server:^1.0.0’), 모든 버전 일치를 위한 버전 없는 키(‘core/api-server’)를 지원합니다. |
name | string 맵 | 아니요 | 특정 인스턴스 이름을 Recipe URI에 매핑합니다. 타입 기반 매핑보다 우선합니다. |
annotations | object 맵 | 아니요 | 어노테이션 기반 Feature 바로 가기입니다. 어노테이션 키를 Feature URI와, 점 경로 하위 키에서 Feature 필러(values 또는 infra)로의 필러별 라우팅 테이블에 매핑합니다. 검증은 대상 Feature의 spec.schema. |
추가 속성은 허용되지 않습니다.