Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Схема Aggrega Catalog (ArtifactLibrary)

Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.

Идентификатор схемы: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json

Повторно используемая коллекция именованных наборов артефактов, которые сущности Recipes и FeatureRecipes потребляют во время рендеринга через artifacts.<name>: { $import: ... }. Каждый набор — это множество выходных файлов, импортируемых как единое целое. Уровень 3 — подключается по желанию в каталогах, которым нужно повторное использование артефактов между сущностями Recipe. Единственный режим описания: только шаблоны Go.

Описание того, как создавать сущности ArtifactLibrary, см. в справочнике по созданию сущностей ArtifactLibrary; на этой странице документирована структурная схема, которую описывает этот справочник.

Тип верхнего уровня: object

Свойства

СвойствоТипОбязательноОписание
apiVersionconst “aggrega.ai/v1beta1”даКонстанта: "aggrega.ai/v1beta1"
kindconst “ArtifactLibrary”даКонстанта: "ArtifactLibrary"
metadataobjectда
specobjectдаСодержимое сущности ArtifactLibrary. Поле spec.artifacts обязательно и должно объявлять хотя бы один набор. Для spec задано additionalProperties: false — параллельные режимы описания на уровне оболочки не принимаются. Единственный режим описания сохраняет рендеринг единообразным (везде шаблоны Go) и избавляет авторов от необходимости переключать модели вычисления посреди рендеринга при потреблении импортированных наборов.

Дополнительные свойства не допускаются.

artifactlibrary.metadata

СвойствоТипОбязательноОписание
namestringдаИдентификатор библиотеки в стиле PascalCase. Это имя в ссылке на идентичность по голому имени #/artifacts/; версию задаёт lockfile каждой сущности Release, и ни хост реестра, ни какой-либо производный идентификатор в ссылку не входит. Шаблон: ^[A-Z][A-Za-z0-9]*$.
versionstringдаВерсия библиотеки по строгому семантическому версионированию (например, 1.0.0). Потребитель может указать её как необязательный нижний порог минимальной версии :<version> в ссылке по голому имени (:#/artifacts/); разрешённой версией владеет lockfile каждой сущности Release. Шаблон: ^(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нетКраткое описание того, что охватывает библиотека.
labelsmap of stringнетМетки, объявленные автором. Компилятор нейтрален к содержимому и не интерпретирует значения меток: это непрозрачные метаданные, переносимые для того, что читает библиотеку, чтобы выполнять сопоставление по ним.
annotationsmap of stringнетАннотации, объявленные автором. Как и метки, это непрозрачные метаданные.

Дополнительные свойства не допускаются.

artifactlibrary.spec

Содержимое сущности ArtifactLibrary. Поле spec.artifacts обязательно и должно объявлять хотя бы один набор. Для spec задано additionalProperties: false — параллельные режимы описания на уровне оболочки не принимаются. Единственный режим описания сохраняет рендеринг единообразным (везде шаблоны Go) и избавляет авторов от необходимости переключать модели вычисления посреди рендеринга при потреблении импортированных наборов.

СвойствоТипОбязательноОписание
artifactsmap из map из stringдаИменованная карта переиспользуемых наборов артефактов. Каждый набор объединяет выходные файлы, которые относятся друг к другу (например, CRD, его RBAC и ConfigMap). Тело каждого файла непрозрачно для проверки оболочки — семантикой содержимого занимается парсер шаблонов Go в момент потребления. Ключи: идентификатор в стиле PascalCase. Ключи записей появляются в канонических URL ссылок (#/artifacts/<name>); ограничение на уровне оболочки не даёт ключам не в стиле PascalCase распространяться по экосистеме каталогов. адресует весь набор целиком, а не отдельный файл в нём. Шаблон: ^[A-Z][A-Za-z0-9]*$. Не менее 1 записи.

Дополнительные свойства не допускаются.