Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Versionsauflösung

Katalogartefakte — Components, Features, Recipes, FeatureRecipes, Plugins und Aggregates — tragen eine metadata.version, und ein Katalog kann gleichzeitig mehr als eine Version desselben Artefakts enthalten. Wenn etwas auf ein Artefakt verweist, wählt die Referenz aus, welche Version verwendet wird. Diese Seite beschreibt, wie diese Auswahl funktioniert.

Auf eine Version verweisen

Eine Referenz ist der Typ-URI des Artefakts, optional auf eine Version festgelegt. Drei Formen werden akzeptiert:

FormBeispielWählt aus
Exaktcore/datastore/mariadb:1.2.0genau diese Version
Bereich (Caret)core/datastore/mariadb:^1.2.0die höchste Version >= 1.2.0 und < 2.0.0
Ohne Versioncore/datastore/mariadbdie höchste verfügbare Version

Die Caret-Form folgt der von npm, Cargo und Go-Modulen bekannten Konvention der Major-Kompatibilität. In jeder Form wählt die Auflösung die höchste Version, die die Referenz erfüllt, und bevorzugt dabei stabile Versionen gegenüber Vorabversionen. Eine exakte Referenz ist der Weg, sich gegen die automatische Auswahl zu entscheiden und eine Version festzulegen.

Determinismus

Die Auswahl läuft einmal, wenn die Abhängigkeiten gesperrt werden. Die Lockfile hält die Version fest, die die Referenz ausgewählt hat — eine Bereichsreferenz wird mit der Version festgehalten, zu der sie aufgelöst wurde, nie als Bereich —, zusammen mit einem Inhalts-Fingerabdruck, der über das eigene Dokument dieser Version gebildet wird, und jeder spätere Build reproduziert aus diesem Eintrag genau dasselbe Artefakt — so ändert ein Katalog, der eine neuere Version erhält, nie stillschweigend einen bereits gesperrten Build. Das erneute Sperren ist eine explizite Aktion.

Dieselbe Regel gilt unabhängig davon, wo der Katalog liegt: Ein lokaler Checkout des Katalogs und eine Registry lösen eine Referenz zur selben Version auf. Es ist auch dieselbe Regel für jeden Befehl, der den Katalog liest. Der Pull, der die Lockfile schreibt, der Build, der sie liest, ein Validate, der Editor und die für den Assistenten bestimmten Werkzeuge wählen alle dieselbe Version aus einem Katalog aus, wie viele Versionen eines Namens seine Verzeichnisse auch enthalten, und die Prüfung der Lockfile durch den Build vergleicht die ausgewählte Version mit derjenigen, die der Pull festgehalten hat.

Bibliotheksabhängigkeiten

Wiederverwendbare Schema- und Mapping-Bibliotheken (SchemaLibrary, MappingLibrary) werden anders aufgelöst: Sie verwenden die minimale Versionsauswahl — die niedrigste Version, die alle Einschränkungen im gesamten Workspace erfüllt — wiederum wie Go-Module. Dadurch bleiben Bibliotheks-Upgrades bewusst statt automatisch.

Wenn nichts eine Referenz erfüllt

Wenn eine Referenz eine Version oder einen Bereich festlegt, die keine verfügbare Version erfüllt — zum Beispiel :^2.0.0, wenn nur 1.x-Versionen existieren —, stoppt die Auflösung mit einem Fehler, der die Referenz so benennt, wie sie geschrieben ist, Artefakt und Einschränkung zusammen, statt stillschweigend auf eine andere Version auszuweichen. Ein Pull und ein Validate desselben Release lehnen sie mit denselben Worten ab. Beim Auflösen der Abhängigkeiten eines Release wird auch ein Artefakt, das überhaupt nicht existiert, mit genau diesen Worten gemeldet, da die Referenz in beiden Fällen auf nichts passte — lesen Sie also beide Hälften der Referenz, die der Fehler nennt.