Schema del file di lock delle dipendenze di Aggrega (Manifest)
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/manifest-v1beta1.schema.json
Un unico file di lock globale che associa i tipi astratti di componente e di Feature a implementazioni concrete di Recipe e FeatureRecipe, per tipo, con una sostituzione per istanza tramite il nome.
Consulta il riferimento per l’authoring del Manifest per una guida in prosa sulla scrittura delle entità Manifest; 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 “Manifest” | sì | Costante: "Manifest" |
metadata | object | sì | |
defs | string[] | no | Blocco opzionale per le ancore YAML standard (& e *), che mantiene il Manifest DRY pur conservando per il compilatore un dizionario piatto O(1). |
spec | object | sì | Le dichiarazioni di mappatura del Manifest più l’ereditarietà opzionale da una base: mappings collega i tipi astratti di componente e di funzionalità a implementazioni concrete di Recipe e FeatureRecipe; extends eredita le mappature da un Manifest di base. |
Non sono consentite proprietà aggiuntive.
manifest.metadata
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Lungo almeno 1 carattere. |
version | string | sì | Versionamento semantico rigoroso del file di lock del manifest (ad es. 1.0.0). 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-]+)*))?$. |
description | string | no | Che cos’è questa entità e a che cosa serve, scritto per chi sta decidendo se usarla. Apri con una frase che nomina la cosa, poi aggiungi ciò di cui un lettore ha bisogno per sceglierla e usarla correttamente — che cosa si aspetta dalla Release che la usa, e qualsiasi aspetto sorprendente del suo comportamento. Un breve paragrafo è la lunghezza abituale. |
maintainers | object[] | no | Elenco dei manutentori responsabili di questa entità. |
license | string | no | Identificatore SPDX della licenza del software descritto da questa entità, come MIT o AGPL-3.0. Registra le condizioni di quel software, non le condizioni di questo file. |
repository | string | no | L’URL del repository Git in cui risiedono i file sorgente. |
home | string | no | L’URL della home page, del wiki o della documentazione di questa entità. |
keywords | string[] | no | Un elenco di parole chiave descrittive per la reperibilità nell’interfaccia utente. |
Non sono consentite proprietà aggiuntive.
manifest.metadata.maintainers[]
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | |
email | string | no | |
url | string | no |
Non sono consentite proprietà aggiuntive.
manifest.spec
Le dichiarazioni di mappatura del Manifest più l’ereditarietà opzionale da una base: mappings collega i tipi astratti di componente e di funzionalità a implementazioni concrete di Recipe e FeatureRecipe; extends eredita le mappature da un Manifest di base.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
extends | string | no | URI di un Manifest di base da cui ereditare le mappature. La mappatura di un figlio sostituisce quella della base per la stessa chiave. |
mappings | object | sì | Associa interfacce astratte a implementazioni concrete. Dichiara le mappature sotto le chiavi di primo livello ‘components’ e ‘features’, ciascuna delle quali mappa direttamente URI di tipo di componente / tipo di funzionalità a URI di Recipe / FeatureRecipe. Queste due chiavi sono l’intera superficie; nessun’altra chiave è accettata qui. La mappatura è agnostica rispetto alla capacità al livello del Manifest — la determinazione della capacità deriva dallo spec.capability di ciascuna Recipe risolta quando Aggrega esegue la build della Release. Chiavi: una tra "components", "features". |
Non sono consentite proprietà aggiuntive.
manifest.spec.mappings
Associa interfacce astratte a implementazioni concrete. Dichiara le mappature sotto le chiavi di primo livello ‘components’ e ‘features’, ciascuna delle quali mappa direttamente URI di tipo di componente / tipo di funzionalità a URI di Recipe / FeatureRecipe. Queste due chiavi sono l’intera superficie; nessun’altra chiave è accettata qui. La mappatura è agnostica rispetto alla capacità al livello del Manifest — la determinazione della capacità deriva dallo spec.capability di ciascuna Recipe risolta quando Aggrega esegue la build della Release.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
components | mapping_tier | no | Mappatura dal tipo di Component all’URI della Recipe. Un URI di Recipe porta al massimo due segmenti — una capacità iniziale opzionale, poi il nome della ricetta — più una versione opzionale; un riferimento con un terzo segmento non corrisponde ad alcuna ricetta. Forme di versione: esatta (‘postgres-bitnami:1.2.0’), intervallo (‘postgres-bitnami:^1.2.0’) o senza versione (‘postgres-bitnami’); il resolver fissa la versione risolta nel file di lock alla prima risoluzione. Un riferimento può inoltre essere qualificato dalla capacità (‘terraform/mariadb-rds:1.0.0’, dove il segmento prima della prima ’/’ nomina lo spec.capability della ricetta) — obbligatorio quando più di una ricetta viene pubblicata con lo stesso nome; un riferimento semplice ambiguo arresta la risoluzione in modo esplicito anziché sceglierne una in silenzio. |
features | mapping_tier | no | Mappatura dal tipo di Feature all’URI della FeatureRecipe. Include sia le Features operative sia le Features di credenziali (etichettate con feature.aggrega.ai/kind: secret). |
Chiavi: una tra "components", "features".
Non sono consentite proprietà aggiuntive.
Definizioni
mapping_tier
Risoluzione a due livelli: ‘type’ mappa per tipo di catalogo (in blocco, DRY), ‘name’ mappa per nome di istanza (sostituzione granulare). Entrambi sono opzionali, ma almeno uno deve essere presente. Durante la risoluzione name prevale su type. Le chiavi type con versione prevalgono su quelle senza versione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
type | mappa di string | no | Mappa gli URI dei tipi di catalogo agli URI di Recipe. Supporta chiavi con versione (‘core/api-server:1.0.0’) per una corrispondenza esatta, chiavi di intervallo (‘core/api-server:^1.0.0’) per una corrispondenza compatibile con la versione major, oppure chiavi senza versione (‘core/api-server’) per una corrispondenza con qualsiasi versione. |
name | mappa di string | no | Mappa nomi di istanza specifici agli URI di Recipe. Ha la precedenza sulla mappatura basata sul tipo. |
annotations | mappa di object | no | Scorciatoie di Feature guidate da annotazioni. Associa chiavi di annotazione a un URI di Feature più una tabella di instradamento raggruppata per pilastro, dalla sottochiave in percorso puntato al pilastro della Feature (values o infra). La validazione deriva dalla dichiarazione spec.schema. |
Non sono consentite proprietà aggiuntive.