メインコンテンツへスキップ

コマンド: workspace new

tofu workspace newコマンドは、新しいワークスペースを作成するために使用されます。

使用方法​

使用方法: tofu workspace new [OPTIONS] NAME [DIR]

このコマンドは、指定された名前で新しいワークスペースを作成します。この名前のワークスペースがすでに存在してはなりません。

-stateフラグが指定された場合、指定されたパスで指定された状態がコピーされ、この新しいワークスペースの状態を初期化します。

コマンドラインフラグはすべてオプションです。サポートされているフラグは次のとおりです。

  • -lock=false - 操作中に状態ロックを保持しません。他のユーザーが同じワークスペースに対してコマンドを同時に実行する可能性がある場合は危険です。

  • -lock-timeout=DURATION - 状態ロックを再試行する期間。デフォルトは0秒です。

  • -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.