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

Везде, где 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. Подробнее о приоритете расширений.