Aggrega-Schema für den Katalog (WorkloadLibrary)
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Eine wiederverwendbare Sammlung von Workload-Template-Fragmenten, die Recipes zur Renderzeit über workload: { $import: ... } verwenden. Stufe 3 — optional für Kataloge, die Arbeitslasten Recipe-übergreifend wiederverwenden müssen. Ein einziger Authoring-Modus: nur Go-Templates.
Siehe die Authoring-Referenz zur WorkloadLibrary für Anleitungen in Prosaform zum Verfassen von WorkloadLibrary-Entitäten; diese Seite dokumentiert das strukturelle Schema, das diese Referenz beschreibt.
Typ der obersten Ebene: object
Eigenschaften
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ja | Konstante: "aggrega.ai/v1beta1" |
kind | const “WorkloadLibrary” | ja | Konstante: "WorkloadLibrary" |
metadata | object | ja | |
spec | object | ja | Der Inhalt der WorkloadLibrary. spec.workloads ist erforderlich und muss mindestens einen Eintrag deklarieren. spec trägt additionalProperties: false — auf Ebene der Hülle werden keine parallelen Authoring-Modi akzeptiert. Die Ausrichtung auf einen einzigen Authoring-Modus hält das Recipe-Rendering einheitlich (durchgehend Go-Template) und erspart Autoren, beim Verwenden importierter Fragmente mitten im Rendern das Auswertungsmodell wechseln zu müssen. |
Zusätzliche Eigenschaften sind nicht zulässig.
workloadlibrary.metadata
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | ja | PascalCase-Bezeichner der Bibliothek. Er ist der Name ^[A-Z][A-Za-z0-9]*$. |
version | string | ja | Strikte semantische Versionierung der Bibliothek (z. B. 1.0.0). Ein Verbraucher kann sie als optionale Mindestversion :<version> in einer Referenz per bloßem Namen (^(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 | nein | Eine knappe Zusammenfassung dessen, was die Bibliothek abdeckt. |
labels | Map von string | nein | Vom Autor deklarierte Labels. Der Compiler ist inhaltsneutral und interpretiert Label-Werte nicht: Sie sind opake Metadaten, mitgeführt für alles, was die Bibliothek liest und darauf abgleichen will. |
annotations | Map von string | nein | Vom Autor deklarierte Annotationen. Dieselbe Haltung opaker Metadaten wie bei Labels. |
Zusätzliche Eigenschaften sind nicht zulässig.
workloadlibrary.spec
Der Inhalt der WorkloadLibrary. spec.workloads ist erforderlich und muss mindestens einen Eintrag deklarieren. spec trägt additionalProperties: false — auf Ebene der Hülle werden keine parallelen Authoring-Modi akzeptiert. Die Ausrichtung auf einen einzigen Authoring-Modus hält das Recipe-Rendering einheitlich (durchgehend Go-Template) und erspart Autoren, beim Verwenden importierter Fragmente mitten im Rendern das Auswertungsmodell wechseln zu müssen.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
workloads | Map von string | ja | Benannte Map wiederverwendbarer Workload-Template-Fragmente. Der Rumpf jedes Eintrags ist für die Validierung der Hülle opak — die inhaltliche Semantik übernimmt der Go-Template-Parser zum Zeitpunkt der Verwendung. Schlüssel: PascalCase-Bezeichner. Eintragsschlüssel erscheinen in kanonischen Referenz-URLs (#/workloads/<name>); die Einschränkung auf Ebene der Hülle verhindert, dass Schlüssel, die nicht PascalCase sind, sich durch das Katalog-Ökosystem verbreiten. Muster: ^[A-Z][A-Za-z0-9]*$. Mindestens 1 Eintrag. |
Zusätzliche Eigenschaften sind nicht zulässig.