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

Схема Aggrega Catalog (WorkloadLibrary)

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

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

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

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

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

Свойства

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

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

workloadlibrary.metadata

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

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

workloadlibrary.spec

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

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

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