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

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

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

Помимо параметров -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.