terraform refresh とは?

「誰かが管理コンソールから手動で変更してしまった内容を、Terraformにも認識させたい」というときに関係するのがterraform refreshです。実際のクラウド上のリソースの最新状態を確認し、stateに反映するコマンドです。

terraform refreshという書式で使います。設定ファイルは変更せず、あくまで「実際の状態」を「stateの記録」に合わせて更新します。

terraform refreshを実行すると、管理下の各リソースについて最新の状態が確認され、stateの内容が更新されます。

よくあるつまずきは、refreshで設定ファイル側まで自動的に書き換わると誤解することです。あくまでstate側が更新されるだけで、コード自体は手作業で修正する必要があります。

実務では最新のTerraformではplanやapplyの中で自動的にrefresh相当の処理が行われるため、単独で明示的に実行する機会は以前より減っています。