Schema del catalogo di Aggrega (ArtifactLibrary)
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json
Una raccolta riutilizzabile di bundle di artefatti con nome che Recipes e FeatureRecipes consumano al momento del rendering tramite artifacts.<name>: { $import: ... }. Ogni bundle è un insieme di file di output importati come un’unica unità. Livello 3 — opzionale, per i cataloghi che hanno bisogno di riusare artefatti tra una Recipe e l’altra. Una sola modalità di authoring: solo template Go.
Consulta il riferimento per l’authoring dell’ArtifactLibrary per una guida in prosa sulla scrittura delle entità ArtifactLibrary; 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 “ArtifactLibrary” | sì | Costante: "ArtifactLibrary" |
metadata | object | sì | |
spec | object | sì | Il contenuto dell’ArtifactLibrary. spec.artifacts è obbligatorio e deve dichiarare almeno un bundle. 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 (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano bundle importati. |
Non sono consentite proprietà aggiuntive.
artifactlibrary.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ò indicarlo 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.
artifactlibrary.spec
Il contenuto dell’ArtifactLibrary. spec.artifacts è obbligatorio e deve dichiarare almeno un bundle. 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 (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano bundle importati.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
artifacts | mappa di mappe di string | sì | Mappa con nome di bundle di artefatti riutilizzabili. Ogni bundle raggruppa i file di output che vanno insieme (ad esempio una CRD, il suo RBAC e una ConfigMap). Il corpo di ciascun file è 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 (#/artifacts/<name>); il vincolo a livello di involucro impedisce che chiavi non PascalCase si propaghino nell’ecosistema del catalogo. Il ^[A-Z][A-Za-z0-9]*$. Almeno 1 voce. |
Non sono consentite proprietà aggiuntive.