Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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àTipoObbligatoriaDescrizione
apiVersionconst “aggrega.ai/v1beta1”sìCostante: "aggrega.ai/v1beta1"
kindconst “ArtifactLibrary”sìCostante: "ArtifactLibrary"
metadataobjectsì
specobjectsì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àTipoObbligatoriaDescrizione
namestringsìIdentificatore PascalCase della libreria. È il nome nel riferimento di identità per nome semplice #/artifacts/; la versione è fornita dal file di lock per Release e nessun host di registry entra nel riferimento né in alcun identificatore derivato. Pattern: ^[A-Z][A-Za-z0-9]*$.
versionstringsì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 (:#/artifacts/); il file di lock per Release detiene la versione risolta. Pattern: ^(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-]+)*))?$.
descriptionstringnoUn riepilogo conciso di ciò che la libreria copre.
labelsmappa di stringnoEtichette 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.
annotationsmappa di stringnoAnnotazioni 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àTipoObbligatoriaDescrizione
artifactsmappa di mappe di stringsì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 indirizza l’intero bundle, mai un singolo file al suo interno. Pattern: ^[A-Z][A-Za-z0-9]*$. Almeno 1 voce.

Non sono consentite proprietà aggiuntive.