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