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

Aggrega 카탈로그(SchemaLibrary) 스키마

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

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

카탈로그 콘텐츠(Components, Features 등)가 bare-name 식별 참조 #/schemas/를 통해 $ref로 참조할 수 있는, 재사용 가능한 JSON Schema 2020-12 정의 모음입니다(버전은 Release별 lockfile이 제공하며, 참조에는 레지스트리 호스트가 나타나지 않습니다). Tier 3 — Component 간 스키마 재사용이 필요한 카탈로그를 위한 선택 기능입니다.

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

최상위 타입: object

속성

속성타입필수설명
apiVersionconst “aggrega.ai/v1beta1”예상수: "aggrega.ai/v1beta1"
kindconst “SchemaLibrary”예상수: "SchemaLibrary"
metadataobject예
specobject예SchemaLibrary의 콘텐츠입니다. spec.schemas는 필수이며 하나 이상의 항목을 선언해야 합니다. spec.templates는 선택 사항이며 라이브러리가 매개변수화된 헬퍼를 사용할 때만 존재합니다.

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

schemalibrary.metadata

속성타입필수설명
namestring예라이브러리의 PascalCase 식별자입니다. bare-name 식별 참조 #/schemas/에서 이름에 해당합니다. 버전은 Release별 lockfile이 제공하며, 레지스트리 호스트는 참조나 파생된 어떤 식별자에도 포함되지 않습니다. 패턴: ^[A-Z][A-Za-z0-9]*$.
versionstring예라이브러리의 엄격한 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-]+)*))?$.
descriptionstring아니요라이브러리가 다루는 내용의 간결한 요약입니다.
labelsstring 맵아니요작성자가 선언한 레이블입니다. 컴파일러는 내용에 중립적이며 레이블 값을 해석하지 않습니다. 레이블은 불투명한 메타데이터로, 라이브러리를 읽는 쪽이 일치 여부를 판단하는 데 쓰도록 전달됩니다.
annotationsstring 맵아니요작성자가 선언한 어노테이션입니다. 레이블과 마찬가지로 불투명한 메타데이터로 취급됩니다.

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

schemalibrary.spec

SchemaLibrary의 콘텐츠입니다. spec.schemas는 필수이며 하나 이상의 항목을 선언해야 합니다. spec.templates는 선택 사항이며 라이브러리가 매개변수화된 헬퍼를 사용할 때만 존재합니다.

속성타입필수설명
schemasobject 맵예재사용 가능한 스키마 정의의 이름 있는 맵입니다. 각 항목의 내용은 파싱 시점에 compact-form 컴파일러가 검증하며, envelope 수준 검증은 구조적 래핑만 확인합니다. 키: PascalCase 식별자 — ^[A-Z][A-Za-z0-9]*$. 항목 키는 bare-name 식별 참조(<Library>#/schemas/<name>)에 나타나며, envelope 수준 제약은 PascalCase가 아닌 키가 카탈로그 생태계로 전파되는 것을 막습니다. 최소 1개 항목.
templatesobject 맵아니요매개변수화된 헬퍼의 선택적인 이름 있는 맵입니다. 스키마 항목은 $instantiate:를 통해 이름으로 템플릿을 참조합니다. 리터럴 스칼라 치환만 지원하며, 내장 Go 템플릿, 조건문, 반복문은 지원하지 않습니다. 라이브러리 치환 계층은 작성이 별도의 템플릿 표면을 도입하지 않고 스키마 언어 안에 머물도록 의도적으로 완전한 템플릿 평가보다 좁게 설계되었습니다. 키: PascalCase 식별자 — ^[A-Z][A-Za-z0-9]*$. 스키마 항목 키와 동일한 envelope 수준 규율을 따르며, 템플릿 이름은 인스턴스화 시점에 $instantiate:를 통해 참조됩니다.

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