Ограничения версий

Везде, где OpenTofu позволяет указать диапазон допустимых версий чего-либо, он ожидает строку специального формата, называемую ограничением версии. Ограничения версий используются при настройке:

• Модулей
• Требований к провайдерам
• Параметра required_version в блоке terraform.

Синтаксис ограничений версий​

Синтаксис ограничений версий в OpenTofu очень похож на синтаксис, используемый в других системах управления зависимостями, таких как Bundler и NPM.

version = ">= 1.2.0, < 2.0.0"

Ограничение версии — это строковый литерал, содержащий одно или несколько условий, разделенных запятыми.

Каждое условие состоит из оператора и номера версии.

Номера версий должны представлять собой последовательность чисел, разделенных точками (например, 1.2.0), с необязательным суффиксом, указывающим на бета-версию.

Допустимы следующие операторы:

• = (или отсутствие оператора): допускает только один точный номер версии. Нельзя комбинировать с другими условиями.

• !=: исключает точный номер версии.

• >, >=, <, <=: сравнение с указанной версией, допускающее версии, для которых условие сравнения истинно. Операторы «больше» указывают на более новые версии, а «меньше» — на более старые.

• ~>: позволяет увеличивать только самый правый компонент версии. Например, чтобы допустить новые выпуски исправлений в рамках определенного минорного выпуска, укажите полный номер версии: ~> 1.0.4 позволит установить 1.0.5 и 1.0.10, но не 1.1.0. Обычно этот оператор называют оператором пессимистичного ограничения.

Поведение ограничений версий​

Номер версии, удовлетворяющий всем применимым ограничениям, считается допустимым.

OpenTofu использует ограничения версий, чтобы определить, есть ли у него допустимые версии самого OpenTofu, всех необходимых плагинов провайдеров и модулей. Для плагинов и модулей будет использоваться самая новая установленная версия, удовлетворяющая применимым ограничениям.

Если у OpenTofu нет допустимой версии необходимого плагина или модуля, он попытается загрузить самую новую версию, удовлетворяющую применимым ограничениям.

Если OpenTofu не сможет получить допустимые версии внешних зависимостей или у него не будет допустимой собственной версии, он не будет выполнять планы, применять изменения или манипулировать состоянием.

И корневой модуль, и любой дочерний модуль могут задавать ограничения допустимых версий OpenTofu и используемых ими провайдеров. OpenTofu считает эти ограничения равнозначными и продолжит работу, только если будут соблюдены все они.

Предварительная версия — это номер версии с суффиксом, введенным дефисом, например 1.2.0-beta. Предварительную версию можно выбрать только с помощью ограничения точной версии (оператор = или отсутствие оператора). Предварительные версии не соответствуют неточным операторам, таким как >=, ~> и т. д.

Рекомендации​

Версии модулей​

• При использовании сторонних модулей указывайте конкретные версии, чтобы обновления выполнялись только тогда, когда вам удобно.

• Для модулей, поддерживаемых внутри вашей организации, могут подойти диапазоны версий, если семантическое версионирование используется последовательно или существует четко определенный процесс выпуска, предотвращающий нежелательные обновления.

Версии ядра OpenTofu и провайдеров​

• В повторно используемых модулях следует задавать только минимальные допустимые версии OpenTofu и провайдеров, например >= 0.12.0. Это помогает избежать известных проблем совместимости и при этом позволяет пользователям модуля переходить на более новые версии OpenTofu, не изменяя сам модуль.

• В корневых модулях следует использовать ограничение ~>, задающее нижнюю и верхнюю границы версий для каждого используемого провайдера.

Поддержка версий OpenTofu и Terraform​

• Если конфигурация должна поддерживать и OpenTofu, и Terraform, например в модулях, которые будут использоваться обоими движками, используйте файл providers.tofu, чтобы задать ограничение версии OpenTofu, переопределяющее ограничение, указанное в providers.tf. Подробнее о приоритете расширений.