Провайдеры

OpenTofu использует плагины, называемые провайдерами, для взаимодействия с облачными провайдерами, SaaS-провайдерами и другими API.

В конфигурациях OpenTofu необходимо объявить требуемые провайдеры, чтобы OpenTofu мог их установить и использовать. Кроме того, некоторым провайдерам перед использованием требуется конфигурация (например, URL конечных точек или регионы облака).

Что делают провайдеры​

Каждый провайдер добавляет набор типов ресурсов и/или источников данных, которыми может управлять OpenTofu.

Каждый тип ресурса реализуется провайдером; без провайдеров OpenTofu не может управлять никакой инфраструктурой.

Большинство провайдеров предназначены для конкретной инфраструктурной платформы (облачной или размещённой на собственных серверах). Провайдеры также могут предоставлять локальные инструменты для таких задач, как генерация случайных чисел для уникальных имён ресурсов.

Откуда берутся провайдеры​

Провайдеры распространяются отдельно от OpenTofu, и у каждого провайдера свой график выпусков и нумерация версий.

Публичный реестр OpenTofu — это основной каталог общедоступных провайдеров, в котором представлены провайдеры для большинства крупных инфраструктурных платформ.

Документация провайдеров​

У каждого провайдера есть собственная документация с описанием типов ресурсов и их аргументов. Эту документацию можно найти в репозитории соответствующего провайдера на GitHub. Кроме того, документация многих провайдеров размещена в каталоге провайдеров публичного реестра OpenTofu.

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

Как использовать провайдеры​

Провайдеры выпускаются отдельно от OpenTofu и имеют собственную нумерацию версий. Для производственной среды мы рекомендуем ограничивать допустимые версии провайдеров в блоке требований к провайдерам конфигурации, чтобы tofu init не устанавливал более новые версии провайдера, несовместимые с конфигурацией.

Чтобы использовать ресурсы определённого провайдера, необходимо включить в конфигурацию некоторые сведения о нём. Подробности см. на следующих страницах:

• Требования к провайдерам — описание того, как объявить провайдеры, чтобы OpenTofu мог их установить.

• Конфигурация провайдеров — описание того, как настраивать параметры провайдеров.

• Файл блокировки зависимостей — описание дополнительного файла HCL, который можно включить в конфигурацию, чтобы указать OpenTofu всегда использовать определённый набор версий провайдеров.

Установка провайдеров​

• TACOS (программное обеспечение для автоматизации и совместной работы с TF) устанавливают провайдеры при каждом запуске.

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

  Чтобы сэкономить время и трафик, OpenTofu CLI поддерживает необязательный кэш плагинов. Его можно включить с помощью параметра plugin_cache_dir в файле конфигурации CLI.

Чтобы OpenTofu всегда устанавливал одни и те же версии провайдеров для заданной конфигурации, с помощью OpenTofu CLI можно создать файл блокировки зависимостей и добавить его в систему контроля версий вместе с конфигурацией. Если файл блокировки существует, OpenTofu CLI и TACOS (программное обеспечение для автоматизации и совместной работы с TF) будут учитывать его при установке провайдеров.

Как найти провайдеры​

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

Некоторые провайдеры в реестре разрабатываются и публикуются HashiCorp, некоторые публикуются разработчиками платформ, а некоторые — пользователями и волонтёрами.

Как разрабатывать провайдеры​

Провайдеры написаны на Go с использованием Terraform Plugin SDK. Дополнительные сведения о разработке провайдеров см. в документации по разработке плагинов.

Запуск приёмочных тестов с OpenTofu CLI​

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

TF_ACC_TERRAFORM_PATH="/path/to/opentofu"
TF_ACC_PROVIDER_NAMESPACE="hashicorp"
TF_ACC_PROVIDER_HOST="registry.opentofu.org"