Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma du catalogue d’Aggrega (ArtifactLibrary)

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/artifactlibrary-v1beta1.schema.json

Une collection réutilisable de bundles d’artefacts nommés que les Recipes et les FeatureRecipes consomment au moment du rendu via artifacts.<name>: { $import: ... }. Chaque bundle est un ensemble de fichiers de sortie importés comme une seule unité. Niveau 3 — facultatif, pour les catalogues qui ont besoin de réutiliser des artefacts d’une Recipe à l’autre. Un seul mode de rédaction : des templates Go uniquement.

Consultez la référence de rédaction de l’ArtifactLibrary pour des conseils rédigés sur l’écriture des entités ArtifactLibrary ; cette page documente le schéma structurel que décrit cette référence.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
apiVersionconst “aggrega.ai/v1beta1”ouiConstante : "aggrega.ai/v1beta1"
kindconst “ArtifactLibrary”ouiConstante : "ArtifactLibrary"
metadataobjectoui
specobjectouiLe contenu de l’ArtifactLibrary. spec.artifacts est obligatoire et doit déclarer au moins un bundle. 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 garde le rendu uniforme (template Go partout) et évite de forcer les auteurs à changer de modèle d’évaluation en cours de rendu lorsqu’ils consomment des bundles importés.

Les propriétés supplémentaires ne sont pas autorisées.

artifactlibrary.metadata

PropriétéTypeObligatoireDescription
namestringouiIdentifiant PascalCase de la bibliothèque. C’est le nom dans la référence d’identité par nom nu #/artifacts/ ; la version est fournie par le fichier de verrouillage propre à chaque Release et aucun hôte de registre n’entre dans la référence ni dans aucun identifiant dérivé. Motif : ^[A-Z][A-Za-z0-9]*$.
versionstringouiVersionnage sémantique strict de la bibliothèque (par ex. 1.0.0). Un consommateur peut l’exiger comme version minimale :<version> facultative dans une référence par nom nu (:#/artifacts/) ; le fichier de verrouillage propre à chaque Release détient la version résolue. Motif : ^(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-]+)*))?$.
descriptionstringnonUn résumé concis de ce que couvre la bibliothèque.
labelsmap de stringnonLabels 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.
annotationsmap de stringnonAnnotations 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.

artifactlibrary.spec

Le contenu de l’ArtifactLibrary. spec.artifacts est obligatoire et doit déclarer au moins un bundle. 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 garde le rendu uniforme (template Go partout) et évite de forcer les auteurs à changer de modèle d’évaluation en cours de rendu lorsqu’ils consomment des bundles importés.

PropriétéTypeObligatoireDescription
artifactsmap de maps de stringouiMap nommée de bundles d’artefacts réutilisables. Chaque bundle regroupe les fichiers de sortie qui vont ensemble (par exemple une CRD, son RBAC et une ConfigMap). Le corps de chaque fichier est opaque pour la validation de l’enveloppe — la sémantique du contenu est prise en charge par le parseur 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 (#/artifacts/<name>) ; la contrainte au niveau de l’enveloppe empêche les clés non PascalCase de se propager dans l’écosystème du catalogue. Le désigne le bundle entier, jamais un fichier individuel qu’il contient. Motif : ^[A-Z][A-Za-z0-9]*$. Au moins 1 entrée.

Les propriétés supplémentaires ne sont pas autorisées.