Schema del catalogo di Aggrega (WorkloadLibrary)
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Una raccolta riutilizzabile di frammenti di template di Workload che le Recipes consumano in fase di rendering tramite workload: { $import: ... }. Livello 3 — opzionale, per i cataloghi che hanno bisogno di riusare carichi di lavoro tra una Recipe e l’altra. Un’unica modalità di authoring: solo template Go.
Consulta il riferimento per l’authoring della WorkloadLibrary per una guida in prosa sulla scrittura delle entità WorkloadLibrary; questa pagina documenta lo schema strutturale descritto da quel riferimento.
Tipo di primo livello: object
Proprietà
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sì | Costante: "aggrega.ai/v1beta1" |
kind | const “WorkloadLibrary” | sì | Costante: "WorkloadLibrary" |
metadata | object | sì | |
spec | object | sì | Il contenuto della WorkloadLibrary. spec.workloads è obbligatorio e deve dichiarare almeno una voce. spec porta additionalProperties: false — a livello di involucro non sono accettate modalità di authoring parallele. L’impostazione a modalità di authoring unica mantiene uniforme il rendering della Recipe (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano frammenti importati. |
Non sono consentite proprietà aggiuntive.
workloadlibrary.metadata
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Identificatore PascalCase della libreria. È il nome ^[A-Z][A-Za-z0-9]*$. |
version | string | sì | Versionamento semantico rigoroso della libreria (ad es. 1.0.0). Un consumatore può affermarla come soglia minima di versione :<version> opzionale in un riferimento per nome semplice (^(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 | no | Un riepilogo conciso di ciò che la libreria copre. |
labels | mappa di string | no | Etichette dichiarate dall’autore. Il compilatore è neutrale rispetto ai contenuti e non interpreta i valori delle etichette: sono metadati opachi, portati perché chiunque legga la libreria possa usarli per la corrispondenza. |
annotations | mappa di string | no | Annotazioni dichiarate dall’autore. Stessa impostazione di metadati opachi delle etichette. |
Non sono consentite proprietà aggiuntive.
workloadlibrary.spec
Il contenuto della WorkloadLibrary. spec.workloads è obbligatorio e deve dichiarare almeno una voce. spec porta additionalProperties: false — a livello di involucro non sono accettate modalità di authoring parallele. L’impostazione a modalità di authoring unica mantiene uniforme il rendering della Recipe (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano frammenti importati.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
workloads | mappa di string | sì | Mappa con nome di frammenti di template di Workload riutilizzabili. Il corpo di ciascuna voce è opaco per la validazione dell’involucro — la semantica del contenuto è gestita dal parser dei template Go al momento del consumo. Chiavi: identificatore PascalCase. Le chiavi delle voci compaiono negli URL di riferimento canonici (#/workloads/<name>); il vincolo a livello di involucro impedisce che chiavi non PascalCase si propaghino nell’ecosistema del catalogo. Pattern: ^[A-Z][A-Za-z0-9]*$. Almeno 1 voce. |
Non sono consentite proprietà aggiuntive.