Команда: 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".