이 페이지는 기계 번역되었습니다. 영어 원문 읽기.
Aggrega 카탈로그(MappingLibrary) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/mappinglibrary-v1beta1.schema.json
Recipes와 FeatureRecipes가 렌더링 시점에 valuesMapping: { $import: ... }를 통해 사용하는 재사용 가능한 Go 템플릿 조각 모음입니다. Tier 3 — Recipe 간 매핑 재사용이 필요한 카탈로그를 위한 선택 기능입니다. 작성 방식은 하나뿐이며, Go 템플릿만 사용합니다.
MappingLibrary 엔티티 작성에 대한 설명은 MappingLibrary 작성 레퍼런스를 참고하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “MappingLibrary” | 예 | 상수: "MappingLibrary" |
metadata | object | 예 | |
spec | object | 예 | MappingLibrary의 내용입니다. spec.mappings는 필수이며 항목을 하나 이상 선언해야 합니다. spec에는 additionalProperties: false가 지정되어 있으므로 엔벌로프 수준에서 병행 작성 방식은 허용되지 않습니다. 단일 작성 방식을 취함으로써 Recipe 렌더링이 일관되게(전체가 Go 템플릿으로) 유지되며, 가져온 조각을 사용할 때 작성자가 렌더링 도중 평가 모델을 전환해야 하는 일을 피할 수 있습니다. |
추가 속성은 허용되지 않습니다.
mappinglibrary.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 라이브러리의 PascalCase 식별자입니다. 이름만 사용하는 식별 참조 ^[A-Z][A-Za-z0-9]*$. |
version | string | 예 | 라이브러리의 엄격한 시맨틱 버저닝 버전입니다(예: 1.0.0). 사용하는 쪽은 이름만 사용하는 참조(:<version> 최소 버전 하한으로 지정할 수 있습니다. 확정된 버전은 Release별 lockfile이 관리합니다. 패턴: ^(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 | 아니요 | 라이브러리가 다루는 내용의 간결한 요약입니다. |
labels | string 맵 | 아니요 | 작성자가 선언한 레이블입니다. 컴파일러는 내용에 중립적이며 레이블 값을 해석하지 않습니다. 레이블은 불투명한 메타데이터로, 라이브러리를 읽는 쪽이 일치 여부를 판단하는 데 쓰도록 전달됩니다. |
annotations | string 맵 | 아니요 | 작성자가 선언한 어노테이션입니다. 레이블과 마찬가지로 불투명한 메타데이터로 취급됩니다. |
추가 속성은 허용되지 않습니다.
mappinglibrary.spec
MappingLibrary의 내용입니다. spec.mappings는 필수이며 항목을 하나 이상 선언해야 합니다. spec에는 additionalProperties: false가 지정되어 있으므로 엔벌로프 수준에서 병행 작성 방식은 허용되지 않습니다. 단일 작성 방식을 취함으로써 Recipe 렌더링이 일관되게(전체가 Go 템플릿으로) 유지되며, 가져온 조각을 사용할 때 작성자가 렌더링 도중 평가 모델을 전환해야 하는 일을 피할 수 있습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
mappings | string 맵 | 예 | 재사용 가능한 Go 템플릿 조각의 이름 있는 맵입니다. 각 항목의 본문은 엔벌로프 검증에서 불투명하게 취급되며, 내용의 의미는 사용 시점에 Go 템플릿 파서가 처리합니다. 키: PascalCase 식별자. 항목 키는 정식 참조 URL(#/mappings/<name>)에 나타나며, 엔벌로프 수준의 제약은 PascalCase가 아닌 키가 카탈로그 생태계 전반으로 퍼지는 것을 막습니다. 패턴: ^[A-Z][A-Za-z0-9]*$. 항목이 1개 이상 있어야 합니다. |
추가 속성은 허용되지 않습니다.