Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Разрешение версий

Артефакты каталога — Components, Features, Recipes, FeatureRecipes, Plugins и Aggregates — содержат metadata.version, и каталог может одновременно хранить несколько версий одного и того же артефакта. Когда что-либо ссылается на артефакт, ссылка определяет, какую версию использовать. На этой странице описано, как работает этот выбор.

Ссылка на версию

Ссылка — это URI типа артефакта, при необходимости закреплённый за версией. Допускаются три формы:

ФормаПримерВыбирает
Точнаяcore/datastore/mariadb:1.2.0именно эту версию
Диапазон (каретка)core/datastore/mariadb:^1.2.0наибольшую версию >= 1.2.0 и < 2.0.0
Без версииcore/datastore/mariadbнаибольшую доступную версию

Форма с кареткой следует соглашению о совместимости по мажорной версии, знакомому по npm, Cargo и модулям Go. В любой форме разрешение выбирает наибольшую версию, которая удовлетворяет ссылке, предпочитая стабильные выпуски предварительным. Точная ссылка — способ отказаться от автоматического выбора и закрепить одну версию.

Детерминированность

Выбор выполняется один раз, при фиксации зависимостей. Lock-файл записывает версию, выбранную ссылкой, — ссылка на диапазон записывается как версия, в которую она разрешилась, а не как диапазон, — вместе с отпечатком содержимого, снятым с собственного документа этой версии, и каждая последующая сборка воспроизводит в точности тот же артефакт по этой записи, поэтому появление в каталоге более новой версии никогда незаметно не изменяет уже зафиксированную сборку. Повторная фиксация — явное действие.

Одно и то же правило действует независимо от того, где находится каталог: локальная копия каталога и реестр разрешают ссылку в одну и ту же версию. Это же правило действует для каждой команды, читающей каталог. Pull, записывающий lock-файл, сборка, читающая его, validate, редактор и инструменты для ассистента выбирают из одного каталога одну и ту же версию, сколько бы версий одного имени ни содержали его каталоги, а проверка lock-файла при сборке сравнивает выбранную ею версию с той, которую записал pull.

Зависимости библиотек

Переиспользуемые библиотеки схем и сопоставлений (SchemaLibrary, MappingLibrary) разрешаются иначе: они используют выбор минимальной версии — наименьшую версию, которая удовлетворяет всем ограничениям в рабочем пространстве, — опять же как в модулях Go. Благодаря этому обновление библиотек остаётся осознанным, а не автоматическим.

Когда ссылке ничего не удовлетворяет

Если ссылка закрепляет версию или диапазон, которым не удовлетворяет ни одна доступная версия, — например, :^2.0.0, когда существуют только версии 1.x, — разрешение останавливается с ошибкой, называющей ссылку в том виде, в каком она написана, — артефакт и ограничение вместе, — а не незаметно переключается на другую версию. Pull и validate одной и той же сущности Release отклоняют её одними и теми же словами. При разрешении зависимостей сущности Release артефакт, которого вообще не существует, сообщается теми же словами, поскольку ссылка в обоих случаях ничему не соответствует, — поэтому проверяйте обе половины ссылки, названной в ошибке.