Schéma du catalogue d’Aggrega (WorkloadLibrary)
Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.
Identifiant du schéma : https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Une collection réutilisable de fragments de template de Workload que les Recipes consomment au moment du rendu via workload: { $import: ... }. Niveau 3 — facultatif, pour les catalogues qui ont besoin de réutiliser des charges de travail d’une Recipe à l’autre. Un seul mode de rédaction : templates Go uniquement.
Consultez la référence de rédaction de la WorkloadLibrary pour des conseils rédigés sur l’écriture des entités WorkloadLibrary ; cette page documente le schéma structurel que décrit cette référence.
Type de premier niveau : object
Propriétés
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | oui | Constante : "aggrega.ai/v1beta1" |
kind | const “WorkloadLibrary” | oui | Constante : "WorkloadLibrary" |
metadata | object | oui | |
spec | object | oui | Le contenu de la WorkloadLibrary. spec.workloads est obligatoire et doit déclarer au moins une entrée. spec porte additionalProperties: false — aucun mode de rédaction parallèle n’est accepté au niveau de l’enveloppe. Le choix d’un mode de rédaction unique maintient uniforme le rendu de la Recipe (template Go partout) et évite d’obliger les auteurs à changer de modèle d’évaluation en cours de rendu lorsqu’ils consomment des fragments importés. |
Les propriétés supplémentaires ne sont pas autorisées.
workloadlibrary.metadata
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Identifiant PascalCase de la bibliothèque. C’est le nom ^[A-Z][A-Za-z0-9]*$. |
version | string | oui | Versionnage sémantique strict de la bibliothèque (par ex. 1.0.0). Un consommateur peut l’affirmer comme plancher de version minimale :<version> facultatif dans une référence par nom nu (^(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 | non | Un résumé concis de ce que couvre la bibliothèque. |
labels | map de string | non | Labels déclarés par l’auteur. Le compilateur est neutre vis-à-vis du contenu et n’interprète pas les valeurs des labels : ce sont des métadonnées opaques, transmises pour que tout ce qui lit la bibliothèque puisse s’en servir pour la correspondance. |
annotations | map de string | non | Annotations déclarées par l’auteur. Même posture de métadonnées opaques que les labels. |
Les propriétés supplémentaires ne sont pas autorisées.
workloadlibrary.spec
Le contenu de la WorkloadLibrary. spec.workloads est obligatoire et doit déclarer au moins une entrée. spec porte additionalProperties: false — aucun mode de rédaction parallèle n’est accepté au niveau de l’enveloppe. Le choix d’un mode de rédaction unique maintient uniforme le rendu de la Recipe (template Go partout) et évite d’obliger les auteurs à changer de modèle d’évaluation en cours de rendu lorsqu’ils consomment des fragments importés.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
workloads | map de string | oui | Map nommée de fragments de template de Workload réutilisables. Le corps de chaque entrée est opaque pour la validation de l’enveloppe — la sémantique du contenu est prise en charge par le parser de templates Go au moment de la consommation. Clés : identifiant PascalCase. Les clés des entrées apparaissent dans les URL de référence canoniques (#/workloads/<name>) ; la contrainte au niveau de l’enveloppe empêche les clés non PascalCase de se propager dans l’écosystème du catalogue. Motif : ^[A-Z][A-Za-z0-9]*$. Au moins 1 entrée. |
Les propriétés supplémentaires ne sont pas autorisées.