Схема 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 запис. |
Додаткові властивості не дозволені.