Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

EigenschaftTypErforderlichBeschreibung
apiVersionconst “aggrega.ai/v1beta1”jaKonstante: "aggrega.ai/v1beta1"
kindconst “WorkloadLibrary”jaKonstante: "WorkloadLibrary"
metadataobjectja
specobjectjaDer 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

EigenschaftTypErforderlichBeschreibung
namestringjaPascalCase-Bezeichner der Bibliothek. Er ist der Name in der Identitätsreferenz per bloßem Namen #/workloads/; die Version liefert das Lockfile pro Release, und kein Registry-Host geht in die Referenz oder einen abgeleiteten Bezeichner ein. Muster: ^[A-Z][A-Za-z0-9]*$.
versionstringjaStrikte semantische Versionierung der Bibliothek (z. B. 1.0.0). Ein Verbraucher kann sie als optionale Mindestversion :<version> in einer Referenz per bloßem Namen (:#/workloads/) zusichern; über die aufgelöste Version bestimmt das Lockfile pro Release. Muster: ^(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-]+)*))?$.
descriptionstringneinEine knappe Zusammenfassung dessen, was die Bibliothek abdeckt.
labelsMap von stringneinVom 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.
annotationsMap von stringneinVom 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.

EigenschaftTypErforderlichBeschreibung
workloadsMap von stringjaBenannte 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.