Команда: workspace new

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

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

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

Эта команда создаст новую рабочую область с указанным именем. Рабочая область с таким именем уже не должна существовать.

Если указан флаг -state, состояние из указанного пути будет скопировано и использовано для инициализации состояния этой новой рабочей области.

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

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

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

• -state=path — путь к существующему файлу состояния для инициализации состояния этой среды.

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

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

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

Пример: создание​

$ tofu workspace new example
Created and switched to workspace "example"!

You're now on a new, empty workspace. Workspaces isolate their state,
so if you run "tofu plan" OpenTofu will not see any existing state
for this configuration.

Пример: создание из состояния​

Чтобы создать новую рабочую область из существующего локального файла состояния:

$ tofu workspace new -state=old.terraform.tfstate example
Created and switched to workspace "example".

You're now on a new, empty workspace. Workspaces isolate their state,
so if you run "tofu plan" OpenTofu will not see any existing state
for this configuration.