Résolution des versions
Les artefacts du catalogue — Components, Features, Recipes, FeatureRecipes, Plugins et Aggregates — portent un metadata.version, et un catalogue peut contenir simultanément plusieurs versions du même artefact. Lorsque quelque chose référence un artefact, la référence sélectionne la version à utiliser. Cette page décrit le fonctionnement de cette sélection.
Référencer une version
Une référence est l’URI de type de l’artefact, éventuellement épinglée à une version. Trois formes sont acceptées :
| Forme | Exemple | Sélectionne |
|---|---|---|
| Exacte | core/datastore/mariadb:1.2.0 | exactement cette version |
| Plage (caret) | core/datastore/mariadb:^1.2.0 | la version la plus élevée >= 1.2.0 et < 2.0.0 |
| Sans version | core/datastore/mariadb | la version la plus élevée disponible |
La forme caret suit la convention de compatibilité majeure familière de npm, Cargo et des modules Go. Dans chaque forme, la résolution sélectionne la version la plus élevée qui satisfait la référence, en préférant les versions stables aux préversions. Une référence exacte est le moyen de renoncer à la sélection automatique et d’épingler une version.
Déterminisme
La sélection s’exécute une seule fois, lorsque les dépendances sont verrouillées. Le lockfile enregistre la version sélectionnée par la référence — une référence de plage est enregistrée à la version vers laquelle elle s’est résolue, jamais comme plage — ainsi qu’une empreinte du contenu prise sur le document propre à cette version, et chaque build ultérieur reproduit exactement le même artefact à partir de cet enregistrement — ainsi, un catalogue qui reçoit une version plus récente ne modifie jamais silencieusement un build déjà verrouillé. Reverrouiller est une action explicite.
La même règle s’applique quel que soit l’endroit où se trouve le catalogue : un checkout local du catalogue et un registre résolvent une référence vers la même version. C’est aussi la même règle pour chaque commande qui lit le catalogue. Le pull qui écrit le lockfile, le build qui le lit, un validate, l’éditeur et les outils destinés à l’assistant sélectionnent tous la même version dans un même catalogue, quel que soit le nombre de versions d’un nom que contiennent ses répertoires, et la vérification du lockfile par le build compare la version qu’il a sélectionnée avec celle que le pull a enregistrée.
Dépendances des bibliothèques
Les bibliothèques réutilisables de schémas et de mappings (SchemaLibrary, MappingLibrary) se résolvent différemment : elles utilisent la sélection de version minimale — la version la plus basse qui satisfait toutes les contraintes de l’ensemble de l’espace de travail — là encore comme les modules Go. Cela garde les mises à niveau des bibliothèques délibérées plutôt qu’automatiques.
Quand rien ne satisfait une référence
Si une référence épingle une version, ou une plage, qu’aucune version disponible ne satisfait — par exemple :^2.0.0 alors que seules des versions 1.x existent —, la résolution s’arrête avec une erreur qui nomme la référence telle qu’elle est écrite, artefact et contrainte ensemble, plutôt que de se rabattre silencieusement sur une autre version. Un pull et un validate de la même Release la refusent dans les mêmes termes. La résolution des dépendances d’une Release signale aussi dans ces mêmes termes un artefact qui n’existe pas du tout, puisque la référence ne correspondait à rien dans les deux cas — lisez donc les deux moitiés de la référence que l’erreur nomme.