Модули

Модули — это контейнеры для нескольких ресурсов, используемых вместе. Модуль состоит из набора файлов .tf, .tofu, .tf.json и/или .tofu.json, которые хранятся вместе в одном каталоге.

Модули — основной способ упаковывать конфигурации ресурсов и повторно использовать их в OpenTofu.

Корневой модуль​

Каждая конфигурация OpenTofu содержит как минимум один модуль, называемый корневым модулем. Он состоит из ресурсов, определённых в файлах .tf или .tofu в основном рабочем каталоге.

Дочерние модули​

Модуль OpenTofu (обычно корневой модуль конфигурации) может вызывать другие модули, чтобы включить их ресурсы в конфигурацию. Модуль, вызванный другим модулем, часто называют дочерним модулем.

Дочерние модули можно вызывать несколько раз в одной конфигурации, а несколько конфигураций могут использовать один и тот же дочерний модуль.

Опубликованные модули​

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

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

Кроме того, участники вашей организации могут разрабатывать модули специально для ваших потребностей в инфраструктуре. TACOS (программное обеспечение для автоматизации и совместной работы с TF) включают закрытый реестр модулей для обмена ими внутри организации.

Использование модулей​

• В разделе Блоки модулей описан синтаксис вызова дочернего модуля из родительского, включая метааргументы, такие как for_each.

• В разделе Источники модулей описаны типы путей, адресов и URI, которые можно использовать в аргументе source блока модуля.

• В разделе «Метааргументы» описаны специальные аргументы, которые можно использовать с любым модулем, включая providers, depends_on, count и for_each.

Разработка модулей​

Сведения о разработке повторно используемых модулей см. в разделе Разработка модулей.