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

Aggrega 의존성 잠금 파일(Manifest) 스키마

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

스키마 ID: https://aggrega.ai/schemas/manifest-v1beta1.schema.json

추상 component 및 Feature 타입을 타입별로 구체적인 Recipe 및 FeatureRecipe 구현에 매핑하는 단일 전역 잠금 파일로, 이름으로 인스턴스별 재정의를 할 수 있습니다.

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

최상위 타입: object

속성

속성타입필수설명
apiVersionconst “aggrega.ai/v1beta1”예상수: "aggrega.ai/v1beta1"
kindconst “Manifest”예상수: "Manifest"
metadataobject예
defsstring[]아니요컴파일러를 위한 평면적인 O(1) 딕셔너리를 유지하면서 Manifest를 DRY하게 유지하기 위한 표준 YAML 앵커(& 및 *)용 선택적 블록입니다.
specobject예Manifest의 매핑 선언과 선택적 기반 상속입니다. mappings는 추상적인 component 및 feature 타입을 구체적인 Recipe 및 FeatureRecipe 구현에 연결하고, extends는 기반 Manifest로부터 매핑을 상속합니다.

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

manifest.metadata

속성타입필수설명
namestring예최소 1자 이상이어야 합니다.
versionstring예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-]+)*))?$.
descriptionstring아니요이 엔티티가 무엇이며 무엇을 위한 것인지를, 사용 여부를 결정하려는 사람을 위해 작성합니다. 대상을 지칭하는 문장으로 시작한 뒤, 독자가 이를 선택하고 올바르게 사용하는 데 필요한 내용, 즉 이를 사용하는 Release에 무엇을 기대하는지와 동작 방식에서 예상하기 어려운 점을 덧붙입니다. 보통 짧은 문단 하나 정도의 분량입니다.
maintainersobject[]아니요이 엔티티를 소유하는 메인테이너 목록입니다.
licensestring아니요이 엔티티가 기술하는 소프트웨어의 라이선스를 나타내는 SPDX 식별자로, MIT 또는 AGPL-3.0 등이 있습니다. 이 파일의 조건이 아니라 해당 소프트웨어의 조건을 기록합니다.
repositorystring아니요소스 파일이 있는 Git 저장소의 URL입니다.
homestring아니요이 엔티티의 홈페이지, 위키 또는 문서의 URL입니다.
keywordsstring[]아니요UI에서 쉽게 찾을 수 있도록 하는 설명 키워드 목록입니다.

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

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

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

manifest.spec

Manifest의 매핑 선언과 선택적 기반 상속입니다. mappings는 추상적인 component 및 feature 타입을 구체적인 Recipe 및 FeatureRecipe 구현에 연결하고, extends는 기반 Manifest로부터 매핑을 상속합니다.

속성타입필수설명
extendsstring아니요매핑을 상속할 기반 Manifest의 URI입니다. 같은 키에 대해서는 하위의 매핑이 기반의 매핑을 대체합니다.
mappingsobject예추상 인터페이스를 구체적인 구현에 매핑합니다. 최상위 키 ‘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에서 비롯됩니다.

속성타입필수설명
componentsmapping_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가 같은 이름을 제공하는 경우에는 필수입니다. 모호한 단순 참조는 하나를 조용히 선택하지 않고 해석을 명시적으로 중단합니다.
featuresmapping_tier아니요Feature-type에서 FeatureRecipe URI로의 매핑입니다. 운영용 Features와 자격 증명 Features(feature.aggrega.ai/kind: secret 레이블이 지정됨)를 모두 포함합니다.

키: "components", "features" 중 하나.

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

정의

mapping_tier

2단계 확인: ‘type’은 카탈로그 타입별로 매핑하고(DRY 일괄), ‘name’은 인스턴스 이름별로 매핑합니다(세분화된 재정의). 둘 다 선택 사항이지만 적어도 하나는 있어야 합니다. 확인 시 name이 type보다 우선합니다. 버전이 지정된 type 키가 버전 없는 키보다 우선합니다.

속성타입필수설명
typestring 맵아니요카탈로그 타입 URI를 Recipe URI에 매핑합니다. 정확한 일치를 위한 버전 지정 키(‘core/api-server:1.0.0’), 메이저 호환 일치를 위한 범위 키(‘core/api-server:^1.0.0’), 모든 버전 일치를 위한 버전 없는 키(‘core/api-server’)를 지원합니다.
namestring 맵아니요특정 인스턴스 이름을 Recipe URI에 매핑합니다. 타입 기반 매핑보다 우선합니다.
annotationsobject 맵아니요어노테이션 기반 Feature 바로 가기입니다. 어노테이션 키를 Feature URI와, 점 경로 하위 키에서 Feature 필러(values 또는 infra)로의 필러별 라우팅 테이블에 매핑합니다. 검증은 대상 Feature의 spec.schema.. 선언에서 파생되며, 바인딩은 라우팅만 선언합니다. ‘feature’가 참조하는 Feature URI는 반드시 ‘type’ 섹션에도 있어야 합니다(FeatureRecipe 버전 바인딩이 그곳에 있습니다).

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