コマンド: refresh
tofu refresh
コマンドは、管理されているすべてのリモートオブジェクトから現在の設定を読み取り、OpenTofuの状態をそれに合わせて更新します。
このコマンドは非推奨です。プロバイダの資格情報に誤りがあると、デフォルトの動作が安全ではありません。詳細と推奨される代替手段については、以下をご覧ください。
これは実際のリモートオブジェクトを変更しませんが、OpenTofuの状態を変更します。
通常、このコマンドを使用する必要はありません。OpenTofuは、tofu plan
コマンドとtofu apply
コマンドの両方で、計画の作成の一部として、同じ更新操作を自動的に実行します。このコマンドは主に下位互換性のために存在しますが、状態を更新する前に操作の影響を確認する機会がないため、使用はお勧めしません。
使用方法
使用方法: tofu refresh [オプション]
このコマンドは、事実上以下のコマンドのエイリアスです。
tofu apply -refresh-only -auto-approve
そのため、tofu apply
と同様のすべてのオプションをサポートしますが、保存された計画ファイルを受け入れず、「refresh only」以外の計画モードを選択できず、-auto-approve
は常に有効になります。
モジュールソース、バックエンド設定、または暗号化ブロックで変数を使用するには、tofu refresh
を実行する際にルートモジュール変数に値を代入する必要があります。
更新の効果を自動的に適用することは危険です。1つ以上のプロバイダの資格情報が誤って設定されている場合、OpenTofuは管理対象オブジェクトがすべて削除されたと誤解し、確認プロンプトなしに追跡されているすべてのオブジェクトを削除する可能性があります。
代わりに、以下のコマンドを使用することをお勧めします。これにより、状態にコミットする前に、OpenTofuが検出した変更を確認できます。
tofu apply -refresh-only
この代替コマンドは、検出された変更を確認するためのインタラクティブなプロンプトを表示します。