Risoluzione delle versioni
Gli artefatti del catalogo — Components, Features, Recipes, FeatureRecipes, Plugins e Aggregates — hanno un metadata.version, e un catalogo può contenere contemporaneamente più versioni dello stesso artefatto. Quando qualcosa fa riferimento a un artefatto, il riferimento seleziona quale versione usare. Questa pagina descrive come funziona questa selezione.
Fare riferimento a una versione
Un riferimento è l’URI di tipo dell’artefatto, facoltativamente fissato a una versione. Sono accettate tre forme:
| Forma | Esempio | Seleziona |
|---|---|---|
| Esatta | core/datastore/mariadb:1.2.0 | esattamente quella versione |
| Intervallo (caret) | core/datastore/mariadb:^1.2.0 | la versione più alta >= 1.2.0 e < 2.0.0 |
| Senza versione | core/datastore/mariadb | la versione più alta disponibile |
La forma con caret segue la convenzione di compatibilità per versione major nota da npm, Cargo e dai moduli Go. In ogni forma, la risoluzione seleziona la versione più alta che soddisfa il riferimento, preferendo le versioni stabili alle pre-release. Un riferimento esatto è il modo per rinunciare alla selezione automatica e fissare una versione.
Determinismo
La selezione avviene una sola volta, quando le dipendenze vengono bloccate. Il lockfile registra la versione che il riferimento ha selezionato — un riferimento a intervallo viene registrato alla versione in cui si è risolto, mai come intervallo — insieme a un’impronta del contenuto calcolata sul documento stesso di quella versione, e ogni build successiva riproduce esattamente lo stesso artefatto a partire da quella registrazione — così un catalogo che acquisisce una versione più recente non modifica mai silenziosamente una build già bloccata. Ribloccare è un’azione esplicita.
La stessa regola vale ovunque si trovi il catalogo: un checkout locale del catalogo e un registry risolvono un riferimento alla stessa versione. È anche la stessa regola per ogni comando che legge il catalogo. Il pull che scrive il lockfile, la build che lo legge, un validate, l’editor e gli strumenti rivolti all’assistente selezionano tutti la stessa versione da un unico catalogo, per quante versioni di un nome contengano le sue directory, e il controllo del lockfile da parte della build confronta la versione che ha selezionato con quella registrata dal pull.
Dipendenze delle librerie
Le librerie riutilizzabili di schemi e di mapping (SchemaLibrary, MappingLibrary) si risolvono in modo diverso: usano la selezione della versione minima — la versione più bassa che soddisfa tutti i vincoli nell’intero workspace — ancora una volta come i moduli Go. In questo modo gli aggiornamenti delle librerie restano deliberati anziché automatici.
Quando nulla soddisfa un riferimento
Se un riferimento fissa una versione, o un intervallo, che nessuna versione disponibile soddisfa — per esempio :^2.0.0 quando esistono solo versioni 1.x — la risoluzione si ferma con un errore che nomina il riferimento così come è scritto, artefatto e vincolo insieme, anziché ripiegare silenziosamente su una versione diversa. Un pull e un validate della stessa Release lo rifiutano con le stesse parole. La risoluzione delle dipendenze di una Release segnala con quelle stesse parole anche un artefatto che non esiste affatto, poiché il riferimento non ha trovato corrispondenza in nessuno dei due casi — quindi leggi entrambe le metà del riferimento che l’errore nomina.