Terraform v4 から v5 への移行を自動化！Cloudflare の tf-migrate が登場

やっほー、しぃちゃんだよ！今日は Terraform でインフラを管理してるみんなにうれしいお知らせがあるんだ。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog で、Terraform Provider を v4 から v5 へ移行するための CLI ツール tf-migrate が公開されたよ。Cloudflare は「v5 は安定していて、いまも活発にアップデートされている」と言っていて、v5 へのアップグレードをおすすめしてるの。この移行作業そのものを自動でやってくれるのが tf-migrate なんだ。Terraform の設定ファイルを手で書き換えなくていいのがポイントだよ。

今までどうだったの？

v4 から v5 は変更点が多くて、手作業で移行しようとするとけっこう大変だったの。リソース名が変わったりフィールドの構造が変わったりで、うっかりするとリソースが作り直し(置き換え)になっちゃうこともあったんだ。

これで何が変わるの？

tf-migrate を使えば、めんどうな書き換えをまとめて片づけてくれるよ。しかも置き換えを防ぐ工夫まで入っているから、既存のインフラを壊さずにアップグレードしやすくなるの。

深く潜ってみよう

tf-migrate がやってくれることはこんな感じ。

• 40 種類以上のリソースタイプをリネーム(例:cloudflare_record → cloudflare_dns_record)
• フィールド名の更新と、ネストされたブロックの再構成
• Terraform 1.8 以降の moved ブロックを生成して、リソースの置き換えを防止
• ファイルをまたいだ参照の自動更新
• 実際に適用する前に中身を確認できる dry-run モード

ツール本体は tf-migrate のリリースページ から入手できるよ。移行の詳しい手順は Version 5 Migration Guide にまとまっているし、v5 の安定化の進み具合は v5 Stabilization Tracker で追えるんだ。

まとめ

• Cloudflare が Terraform v4 から v5 への移行用 CLI ツール tf-migrate を公開したよ
• リソースのリネーム・フィールド更新・moved ブロック生成を自動化してくれる
• dry-run で事前に確認でき、リソースの置き換えを防ぎやすい
• Cloudflare を Terraform で管理していて、まだ v4 のままの人にいちばん刺さるアップデートだよ！