- コマンドライン
- 基本的なCLI機能
- コマンド: state
- コマンド: state pull
コマンド: state pull
tofu state pull
コマンドは、リモートステートから手動でステートをダウンロードして出力するために使用されます。このコマンドはローカルステートでも機能します。
使用法
使用法: tofu state pull
このコマンドは、現在の場所からステートをダウンロードし、ローカルにインストールされた OpenTofu と互換性のある最新のステートファイルバージョンにローカルコピーをアップグレードし、生の形式を stdout に出力します。
これは、ステートから値を読み取る(このコマンドと jq のようなものを組み合わせる可能性もある)のに役立ちます。また、ステートを手動で変更する必要がある場合にも役立ちます。
リモートステートの OpenTofu バージョンを検査するためにこのコマンドを使用することはできません。出力前に常に現在の OpenTofu バージョンに変換されるためです。
OpenTofu ステートファイルは、バイトオーダーマーク (BOM) なしの UTF-8 形式である必要があります。Windows の PowerShell では、Set-Content
を使用してファイルを UTF-8 形式で自動的にエンコードします。たとえば、tofu state pull | sc terraform.tfstate
を実行します。
モジュールソース、バックエンド構成、または 暗号化ブロックでの変数の使用には、tofu state pull
の実行時に ルートモジュール変数への値の割り当てが必要です。
このコマンドは、次のコマンドライン引数をサポートしています。
-
-var 'NAME=VALUE'
- 設定のルートモジュールで宣言された単一の入力変数の値を設定します。複数の変数を設定するには、このオプションを複数回使用します。詳細については、コマンドラインでの入力変数を参照してください。 -
-var-file=FILENAME
- 「tfvars」ファイルからの定義を使用して、設定のルートモジュールで宣言された潜在的に多くの入力変数の値を設定します。複数のファイルから値を含めるには、このオプションを複数回使用します。
-var
および -var-file
オプション以外にも、ルートモジュールで入力変数の値を設定する方法がいくつかあります。詳細については、ルートモジュール変数への値の割り当てを参照してください。