이 페이지는 기계 번역되었습니다. 영어 원문 읽기.
Aggrega 카탈로그(ArtifactLibrary) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json
Recipes와 FeatureRecipes가 렌더링 시점에 artifacts.<name>: { $import: ... }를 통해 사용하는, 이름이 지정된 아티팩트 번들의 재사용 가능한 모음입니다. 각 번들은 하나의 단위로 가져오는 출력 파일의 집합입니다. Tier 3 — Recipe 간 아티팩트 재사용이 필요한 카탈로그를 위한 선택 기능입니다. 단일 작성 모드: Go 템플릿만 사용합니다.
ArtifactLibrary 엔티티 작성에 대한 설명은 ArtifactLibrary 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “ArtifactLibrary” | 예 | 상수: "ArtifactLibrary" |
metadata | object | 예 | |
spec | object | 예 | ArtifactLibrary의 내용입니다. spec.artifacts는 필수이며 번들을 하나 이상 선언해야 합니다. spec에는 additionalProperties: false가 지정되어 있으므로 엔벨로프 수준에서 병렬 작성 모드는 허용되지 않습니다. 단일 작성 모드 방침은 렌더링을 균일하게(전체적으로 Go 템플릿) 유지하며, 가져온 번들을 사용할 때 작성자가 렌더링 도중에 평가 모델을 전환해야 하는 상황을 방지합니다. |
추가 속성은 허용되지 않습니다.
artifactlibrary.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 라이브러리의 PascalCase 식별자입니다. 베어 네임 식별 참조 ^[A-Z][A-Za-z0-9]*$. |
version | string | 예 | 라이브러리의 엄격한 Semantic Versioning입니다(예: 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 맵 | 아니요 | 작성자가 선언한 어노테이션입니다. 레이블과 마찬가지로 불투명한 메타데이터로 취급됩니다. |
추가 속성은 허용되지 않습니다.
artifactlibrary.spec
ArtifactLibrary의 내용입니다. spec.artifacts는 필수이며 번들을 하나 이상 선언해야 합니다. spec에는 additionalProperties: false가 지정되어 있으므로 엔벨로프 수준에서 병렬 작성 모드는 허용되지 않습니다. 단일 작성 모드 방침은 렌더링을 균일하게(전체적으로 Go 템플릿) 유지하며, 가져온 번들을 사용할 때 작성자가 렌더링 도중에 평가 모델을 전환해야 하는 상황을 방지합니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
artifacts | string 맵의 맵 | 예 | 재사용 가능한 아티팩트 번들의 이름 지정 맵입니다. 각 번들은 함께 속하는 출력 파일(예: CRD, 해당 RBAC, ConfigMap)을 묶습니다. 각 파일 본문은 엔벨로프 검증에서 불투명하게 취급되며, 내용의 의미는 사용 시점에 Go 템플릿 파서가 처리합니다. 키: PascalCase 식별자. 항목 키는 정식 참조 URL(#/artifacts/<name>)에 나타나며, 엔벨로프 수준의 제약은 PascalCase가 아닌 키가 카탈로그 생태계 전반에 퍼지는 것을 방지합니다. ^[A-Z][A-Za-z0-9]*$. 최소 1개 항목. |
추가 속성은 허용되지 않습니다.