Skema Aggrega Catalog (WorkloadLibrary)
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Kumpulan fragmen templat Workload yang dapat digunakan ulang, yang dikonsumsi oleh Recipes saat render melalui workload: { $import: ... }. Tingkat 3 — opsional bagi katalog yang memerlukan penggunaan ulang workload lintas Recipe. Satu mode penulisan: hanya templat Go.
Lihat referensi penulisan WorkloadLibrary untuk panduan tentang penulisan entitas WorkloadLibrary; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ya | Konstanta: "aggrega.ai/v1beta1" |
kind | const “WorkloadLibrary” | ya | Konstanta: "WorkloadLibrary" |
metadata | object | ya | |
spec | object | ya | Konten WorkloadLibrary. spec.workloads wajib ada dan harus mendeklarasikan setidaknya satu entri. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima di tingkat envelope. Sikap satu mode penulisan ini menjaga render Recipe tetap seragam (templat Go di seluruhnya) dan menghindari pemaksaan penulis untuk beralih model evaluasi di tengah render saat mengonsumsi fragmen yang diimpor. |
Properti tambahan tidak diizinkan.
workloadlibrary.metadata
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Pengidentifikasi PascalCase untuk pustaka. Ini adalah nama ^[A-Z][A-Za-z0-9]*$. |
version | string | ya | Versi Semantic Versioning yang ketat dari pustaka (misalnya, 1.0.0). Konsumen dapat menyatakan ini sebagai batas bawah versi minimum :<version> opsional dalam referensi nama polos (^(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 | tidak | Ringkasan singkat tentang cakupan pustaka. |
labels | map of string | tidak | Label yang dideklarasikan penulis. Compiler netral terhadap konten dan tidak menafsirkan nilai label: label adalah metadata buram, yang dibawa agar apa pun yang membaca library dapat mencocokkan berdasarkan label tersebut. |
annotations | map of string | tidak | Anotasi yang dideklarasikan oleh penulis. Pendekatan metadata buram yang sama seperti label. |
Properti tambahan tidak diizinkan.
workloadlibrary.spec
Konten WorkloadLibrary. spec.workloads wajib ada dan harus mendeklarasikan setidaknya satu entri. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima di tingkat envelope. Sikap satu mode penulisan ini menjaga render Recipe tetap seragam (templat Go di seluruhnya) dan menghindari pemaksaan penulis untuk beralih model evaluasi di tengah render saat mengonsumsi fragmen yang diimpor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workloads | map of string | ya | Peta bernama berisi fragmen templat Workload yang dapat digunakan ulang. Isi setiap entri bersifat buram bagi validasi envelope — semantik konten ditangani oleh parser templat Go saat konsumsi. Kunci: pengidentifikasi PascalCase. Kunci entri muncul dalam URL referensi kanonis (#/workloads/<name>); batasan di tingkat envelope mencegah kunci non-PascalCase menyebar ke seluruh ekosistem katalog. Pola: ^[A-Z][A-Za-z0-9]*$. Minimal 1 entri. |
Properti tambahan tidak diizinkan.