import とは

管理画面で手作業で作ったものを、作り直さずに Terraform の管理下に入れる操作です。既存の実物を、state の中の1つのアドレスに結びつけます。1つの実物は、1つのアドレスだけに結びつけます。2つのアドレスに同じ実物を取り込むと、思わぬ変更が起きます。

import ブロック

• to に取り込み先のアドレス、id に実物の ID を書く
• plan で、何が取り込まれるかを先に確かめられる。取り込みは apply のときに行われる
• 設定に残るので、レビューしてから取り込める。公式もこちらを勧めている

設定の生成

resource ブロックをまだ書いていないときは、terraform plan に -generate-config-out=ファイル名 を付けると、取り込むものの resource ブロックの下書きを作ってくれます。出力先には、まだ無いファイル名を指定します。生成されたものは読み直して、要らない値を消し、変数に置き換えます。

terraform import コマンド

terraform import にアドレスと ID を付けて実行します。先に resource ブロックを書いておく必要があり、設定は生成しません。

TF_LOG

• TF_LOG にレベルを入れると詳しいログが出る。TRACE・DEBUG・INFO・WARN・ERROR の順に詳しい
• TF_LOG_PATH にファイル名を入れると、そこに追記する。TF_LOG が無いとログは出ない
• TF_LOG_CORE と TF_LOG_PROVIDER で、Terraform 本体とプロバイダのログを分けられる

• import で既存のインフラを管理下に入れる考え方
• import ブロックの to と id、取り込まれるタイミング
• -generate-config-out による設定の生成と、terraform import コマンドとの違い
• TF_LOG と TF_LOG_PATH で詳しいログを出す方法