Схема Aggrega Catalog (ArtifactLibrary)
Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.
Идентификатор схемы: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json
Повторно используемая коллекция именованных наборов артефактов, которые сущности Recipes и FeatureRecipes потребляют во время рендеринга через artifacts.<name>: { $import: ... }. Каждый набор — это множество выходных файлов, импортируемых как единое целое. Уровень 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 | да | Версия библиотеки по строгому семантическому версионированию (например, 1.0.0). Потребитель может указать её как необязательный нижний порог минимальной версии :<version> в ссылке по голому имени (^(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 | map of string | нет | Метки, объявленные автором. Компилятор нейтрален к содержимому и не интерпретирует значения меток: это непрозрачные метаданные, переносимые для того, что читает библиотеку, чтобы выполнять сопоставление по ним. |
annotations | map of string | нет | Аннотации, объявленные автором. Как и метки, это непрозрачные метаданные. |
Дополнительные свойства не допускаются.
artifactlibrary.spec
Содержимое сущности ArtifactLibrary. Поле spec.artifacts обязательно и должно объявлять хотя бы один набор. Для spec задано additionalProperties: false — параллельные режимы описания на уровне оболочки не принимаются. Единственный режим описания сохраняет рендеринг единообразным (везде шаблоны Go) и избавляет авторов от необходимости переключать модели вычисления посреди рендеринга при потреблении импортированных наборов.
| Свойство | Тип | Обязательно | Описание |
|---|---|---|---|
artifacts | map из map из string | да | Именованная карта переиспользуемых наборов артефактов. Каждый набор объединяет выходные файлы, которые относятся друг к другу (например, CRD, его RBAC и ConfigMap). Тело каждого файла непрозрачно для проверки оболочки — семантикой содержимого занимается парсер шаблонов Go в момент потребления. Ключи: идентификатор в стиле PascalCase. Ключи записей появляются в канонических URL ссылок (#/artifacts/<name>); ограничение на уровне оболочки не даёт ключам не в стиле PascalCase распространяться по экосистеме каталогов. ^[A-Z][A-Za-z0-9]*$. Не менее 1 записи. |
Дополнительные свойства не допускаются.