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

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

Пример​

$ tofu workspace delete example
Deleted workspace "example".