Команда: apply

Команда tofu apply выполняет действия, предложенные в плане OpenTofu.

Использование​

Использование: tofu apply [options] [plan file]

Автоматический режим планирования​

Если запустить tofu apply без передачи сохранённого файла плана, OpenTofu автоматически создаст новый план выполнения, как если бы вы запустили tofu plan, предложит подтвердить этот план и выполнит указанные действия. Вы можете использовать все режимы планирования и параметры планирования, чтобы настроить создание плана в OpenTofu.

Вы можете передать параметр -auto-approve, чтобы указать OpenTofu применить план без запроса подтверждения.

Режим сохранённого плана​

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

Используйте tofu show, чтобы проверить сохранённый файл плана перед его применением.

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

Параметры плана​

Если сохранённый файл плана не указан, tofu apply поддерживает все режимы и параметры планирования, доступные для tofu plan.

• Режимы планирования: к ним относятся -destroy, создающий план для уничтожения всех удалённых объектов, и -refresh-only, создающий план для обновления состояния OpenTofu и выходных значений корневого модуля.
• Параметры планирования: к ним относятся указание экземпляров ресурсов, которые OpenTofu следует заменить, задание входных переменных OpenTofu и т. д.

Параметры применения​

Следующие параметры изменяют способ выполнения команды apply и отображения сведений о применении.

• -auto-approve — пропускает интерактивное подтверждение плана перед применением. Этот параметр игнорируется, если вы передаёте ранее сохранённый файл плана: OpenTofu считает передачу файла плана подтверждением и в этом случае не запрашивает его.

• -compact-warnings — отображает предупреждения в компактном виде, включающем только сводные сообщения, если только предупреждения не сопровождаются хотя бы одной ошибкой; в таком случае текст предупреждения может содержать полезные сведения об ошибках.

• -input=false — отключает все интерактивные запросы OpenTofu. Обратите внимание, что это также не позволяет OpenTofu запросить интерактивное подтверждение плана, поэтому OpenTofu будет исходить из того, что вы не хотите применять план, и операция завершится с ошибкой.

• -json — включает вывод машиночитаемого интерфейса JSON. Этот параметр подразумевает -input=false, поэтому для продолжения всем переменным конфигурации должны быть назначены значения. Чтобы включить этот параметр, необходимо также включить параметр -auto-approve или указать ранее сохранённый план.

• -lock=false — не блокирует состояние на время операции. Это опасно, если другие пользователи могут одновременно выполнять команды в той же рабочей области.

• -lock-timeout=DURATION — если блокировка не отключена с помощью -lock=false, указывает OpenTofu повторять попытки получения блокировки в течение заданного времени, прежде чем вернуть ошибку. Длительность задаётся числом и буквой единицы времени, например "3s" означает три секунды.

• -no-color — отключает управляющие последовательности форматирования терминала в выводе. Используйте этот параметр, если запускаете OpenTofu в среде, где вывод отображается системой, не поддерживающей форматирование терминала.

• -parallelism=n — ограничивает число одновременных операций при обходе графа OpenTofu. Значение по умолчанию — 10.

• Все режимы планирования и параметры планирования для tofu plan — настраивают способ создания плана в OpenTofu. Доступны только при запуске tofu apply без сохранённого файла плана.

Для конфигураций, использующих только бэкенд local, команда tofu apply также принимает устаревшие параметры -state, -state-out и -backup.

Переменные среды​

Поведение команды apply можно дополнительно настроить с помощью переменных среды. Например, переменная среды TF_STATE_PERSIST_INTERVAL позволяет задать интервал сохранения состояния.

Передача другого каталога конфигурации​

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