Команда: workspace delete

Команда tofu workspace delete используется для удаления существующей рабочей области.

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

Использование: tofu workspace delete [OPTIONS] NAME [DIR]

Эта команда удаляет указанную рабочую область.

Чтобы удалить рабочую область, она должна уже существовать, не должна отслеживать ресурсы и не должна быть текущей рабочей областью. Если рабочая область отслеживает ресурсы, OpenTofu не позволит удалить её, если не указан флаг -force.

Кроме того, разные бэкенды могут устанавливать другие ограничения на то, считается ли рабочая область безопасной для удаления без флага -force, например, блокировку рабочей области.

Если удалить рабочую область, которая отслеживает ресурсы (с помощью -force), ресурсы могут стать «осиротевшими». Это ресурсы, которые физически существуют, но которыми OpenTofu больше не может управлять. Иногда это предпочтительно: возможно, вы хотите, чтобы OpenTofu перестал управлять ресурсами, чтобы ими можно было управлять другим способом. Однако чаще всего это не предполагается, поэтому OpenTofu защищает вас от такой ситуации.

Все флаги командной строки являются необязательными. Поддерживаются только следующие флаги:

• -force — удалить рабочую область, даже если она отслеживает ресурсы. После удаления OpenTofu больше не сможет отслеживать инфраструктуру рабочей области или управлять ею. По умолчанию — false.

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

• -lock-timeout=DURATION — время повторных попыток блокировки состояния. По умолчанию — 0s.

• -var 'NAME=VALUE' — задаёт значение для одной входной переменной, объявленной в корневом модуле конфигурации. Используйте этот параметр несколько раз, чтобы задать значения нескольких переменных. Дополнительные сведения см. в разделе Входные переменные в командной строке.

• -var-file=FILENAME — задаёт значения для нескольких входных переменных, объявленных в корневом модуле конфигурации, используя определения из файла «tfvars». Используйте этот параметр несколько раз, чтобы включить значения из нескольких файлов.

• -json — включает вывод машиночитаемого интерфейса JSON.

• -json-into=out.json — формирует тот же вывод, что и -json, но записывает его в файл. Это позволяет одновременно сохранять машиночитаемые и удобочитаемые для человека журналы.

Помимо параметров -var и -var-file, есть несколько других способов задать значения входных переменных в корневом модуле. Дополнительные сведения см. в разделе Задание значений переменных корневого модуля.

Пример​

$ tofu workspace delete example
Deleted workspace "example".