Команда: providers mirror
Команда tofu providers mirror загружает провайдеры, необходимые для текущей конфигурации, и копирует их в каталог в локальной файловой системе.
При обычном использовании tofu init автоматически загружает необходимые провайдеры из реестров провайдеров при инициализации текущего рабочего каталога. Иногда OpenTofu запускается в среде, где это невозможно, например в изолированной сети без доступа к реестру OpenTofu. В таком случае явная настройка метода установки позволяет настроить OpenTofu так, чтобы при запуске в конкретной системе он обращался только к каталогу локальной файловой системы, в котором создано локальное зеркало необходимых плагинов, и вообще не обращался к вышестоящему реестру.
Команда tofu providers mirror может автоматически заполнить каталог, который будет использоваться в настройках установки провайдеров как локальное зеркало файловой системы.
Использование
Использование: tofu providers mirror [options] <target-dir>
Требуется указать один целевой каталог. OpenTofu создаст в этом каталоге структуру путей, предусмотренную для зеркал плагинов провайдеров на основе файловой системы, и заполнит её файлами .zip, содержащими сами плагины.
Использование переменных в источниках модулей требует присваивания значений переменным корневого модуля при запуске tofu providers mirror.
Эта команда принимает следующие общие параметры:
-
-var 'NAME=VALUE'— задаёт значение для одной входной переменной, объявленной в корневом модуле конфигурации. Используйте этот параметр несколько раз, чтобы задать значения для нескольких переменных. Дополнительные сведения см. в разделе Входные переменные в командной строке. -
-var-file=FILENAME— задаёт значения для любого количества входных переменных, объявленных в корневом модуле конфигурации, используя определения из файла «tfvars». Используйте этот параметр несколько раз, чтобы включить значения из нескольких файлов.
Помимо параметров -var и -var-file, существуют и другие способы задать значения входных переменных в корневом модуле. Дополнительные сведения см. в разделе Присваивание значений переменным корневого модуля.
OpenTofu также создаст различные индексные файлы .json, содержащие подходящие ответы для реализации протокола сетевого зеркала, если загрузить полученный каталог на хост статического веб-сайта. При использовании каталога в качестве зеркала файловой системы OpenTofu игнорирует эти индексные файлы, поскольку в этом случае источником истины являются сами записи каталога.
Эта команда поддерживает следующие дополнительные параметры:
-
-platform=OS_ARCH— выберите целевую платформу, для которой нужно создать зеркало. По умолчанию OpenTofu получает пакеты плагинов, подходящие для платформы, на которой выполняется эта команда. Используйте этот флаг несколько раз, чтобы включить пакеты для нескольких целевых систем.Названия целевых платформ состоят из операционной системы и архитектуры ЦП. Например,
linux_amd64выбирает операционную систему Linux, работающую на ЦП AMD64 или x86_64.
Чтобы обновить существующий каталог-зеркало, добавив в него новые пакеты, можно повторно запустить tofu providers mirror. Например, чтобы добавить пакеты для новой целевой платформы, повторно запустите команду с нужным новым параметром -platform=.... Команда разместит пакеты для новой платформы, не удаляя ранее загруженные пакеты, объединит полученные наборы пакетов и обновит JSON-файлы индексов.
Copyright (c) The OpenTofu Authors
Copyright (c) 2014 HashiCorp, Inc.
Mozilla Public License, version 2.0
https://opentofu.org/docs/v1.9/cli/commands/providers/mirror/