Команда: 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 — выводит предупреждения в краткой форме, содержащей только сводные сообщения, если только предупреждения не сопровождаются хотя бы одной ошибкой и их текст не может быть полезен для понимания ошибок.

• -consolidate-warnings — если OpenTofu выводит предупреждения, не объединяет похожие сообщения. Будут перечислены все предупреждения со всеми местами их возникновения.

• -consolidate-errors — если OpenTofu обнаруживает ошибки, пытается объединить похожие сообщения в один элемент.

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

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

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

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

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

• -concise — отключает сообщения о ходе выполнения в выводе.

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

• -show-sensitive — если указано, конфиденциальные значения не будут скрываться в выводе пользовательского интерфейса.

• -deprecation — задаёт тип выводимых предупреждений. Допустимые значения: "module:all", "module:local", "module:none". Значение по умолчанию: module:all. Если выбрано "module:all", OpenTofu будет выводить предупреждения об устаревании для всех модулей. Если выбрано "module:local", предупреждения будут выводиться только для модулей, импортированных по относительному пути. Если выбрано "module:none", все предупреждения об устаревании будут скрыты.

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

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

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

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

Указание другого каталога конфигурации​

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