이 페이지는 기계 번역되었습니다. 영어 원문 읽기.
Aggrega 카탈로그(SchemaLibrary) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
카탈로그 콘텐츠(Components, Features 등)가 bare-name 식별 참조
SchemaLibrary 엔터티 작성에 관한 설명은 SchemaLibrary 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | 예 | 상수: "SchemaLibrary" |
metadata | object | 예 | |
spec | object | 예 | SchemaLibrary의 콘텐츠입니다. spec.schemas는 필수이며 하나 이상의 항목을 선언해야 합니다. spec.templates는 선택 사항이며 라이브러리가 매개변수화된 헬퍼를 사용할 때만 존재합니다. |
추가 속성은 허용되지 않습니다.
schemalibrary.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 라이브러리의 PascalCase 식별자입니다. bare-name 식별 참조 ^[A-Z][A-Za-z0-9]*$. |
version | string | 예 | 라이브러리의 엄격한 Semantic Versioning 버전입니다(예: 1.0.0). 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 맵 | 아니요 | 작성자가 선언한 어노테이션입니다. 레이블과 마찬가지로 불투명한 메타데이터로 취급됩니다. |
추가 속성은 허용되지 않습니다.
schemalibrary.spec
SchemaLibrary의 콘텐츠입니다. spec.schemas는 필수이며 하나 이상의 항목을 선언해야 합니다. spec.templates는 선택 사항이며 라이브러리가 매개변수화된 헬퍼를 사용할 때만 존재합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
schemas | object 맵 | 예 | 재사용 가능한 스키마 정의의 이름 있는 맵입니다. 각 항목의 내용은 파싱 시점에 compact-form 컴파일러가 검증하며, envelope 수준 검증은 구조적 래핑만 확인합니다. 키: PascalCase 식별자 — ^[A-Z][A-Za-z0-9]*$. 항목 키는 bare-name 식별 참조(<Library>#/schemas/<name>)에 나타나며, envelope 수준 제약은 PascalCase가 아닌 키가 카탈로그 생태계로 전파되는 것을 막습니다. 최소 1개 항목. |
templates | object 맵 | 아니요 | 매개변수화된 헬퍼의 선택적인 이름 있는 맵입니다. 스키마 항목은 $instantiate:를 통해 이름으로 템플릿을 참조합니다. 리터럴 스칼라 치환만 지원하며, 내장 Go 템플릿, 조건문, 반복문은 지원하지 않습니다. 라이브러리 치환 계층은 작성이 별도의 템플릿 표면을 도입하지 않고 스키마 언어 안에 머물도록 의도적으로 완전한 템플릿 평가보다 좁게 설계되었습니다. 키: PascalCase 식별자 — ^[A-Z][A-Za-z0-9]*$. 스키마 항목 키와 동일한 envelope 수준 규율을 따르며, 템플릿 이름은 인스턴스화 시점에 $instantiate:를 통해 참조됩니다. |
추가 속성은 허용되지 않습니다.