Cloudflare の Terraform provider v5.9 で cloudflare_snippet が誕生！

こんにちは、しぃちゃんだよ！ 今日は Cloudflare の Terraform provider にまたアップデートが来たよ。IaC で Cloudflare を管理してるみんな、要チェックだよ！

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog によると、2025 年 8 月 29 日に Terraform provider の v5.9 がリリースされたよ。今年公開されたばかりの v5 provider には、コミュニティから多くの issue が報告されていて、Cloudflare はその安定性と信頼性を高めるために 2 週間ごとのリリースサイクルで改善を続けることを表明していたの。今回の v5.9 は、その一環のリリースなんだって。

加えて今回から、修正のやり方そのものを変えたことも明かされたよ。これまでの issue ひとつひとつに対応する「issue-to-issue」方式から、特定のリソースに絞って集中的に安定化させる「resource-per-resource」方式へ転換したの。

今までどうだったの？

6 月の v5.6.0 のときも、v5 provider で見つかったバグをまとめて修正するリリースがあったんだけど、あのときは報告された issue を順番に潰していくやり方だったの。ただ、issue 単位で直していくと、ひとつのリソースに関する問題が複数の issue に分散していて、「このリソースはもう安心して使える」と言い切れる状態になかなかたどり着けなかったみたい。

そこで Cloudflare は、リリースのたびに特定のリソースに狙いを定めて、そのリソースに紐づく issue を全部クローズしてから次のリソースに移る、という方針に切り替えたんだね。

これで何が変わるの？

v5.9 でまず安定版として扱われるようになったのは、この 4 つのリソースだよ。

• cloudflare_zone_setting
• cloudflare_worker_script
• cloudflare_worker_route
• tiered_cache

これらは実際の運用でよく触るリソースだから、ゾーン設定や Workers、Tiered Cache を Terraform で管理しているチームには嬉しいアップデートだね。

もうひとつの大きな変更が、新しいリソース cloudflare_snippet の追加だよ。これは既存の cloudflare_snippets を置き換えるもので、Cloudflare の Snippets 機能を Terraform から管理できるようにするリソースなの。cloudflare_snippets はこのリリースで非推奨になったよ(まだ使うことはできるけど)。Cloudflare は「できるだけ早く cloudflare_snippet に乗り換えてほしい」とアナウンスしているから、Snippets を Terraform で管理している人は移行の準備をしておくとよさそうだよ。

深く潜ってみよう

このリリースでは、リソースの安定化以外にも細かい改善が入っているよ。

• DNS レコード: ドリフト検知(意図しない差分の検出)の精度が改善されたよ
• ロードバランサー: created_on フィールドの値が不整合になる問題を修正、プール設定の扱いも改善されたの
• Bot Management: 自動更新モデルの状態管理が改善され、fight mode まわりの挙動も改善されたよ

GitHub 上のv5.9.0 のリリースノートには、ロードバランサーの monitor / pool リソースで発生していた「リフレッシュや更新のたびにドリフトが検知される」問題の修正や、Zero Trust の Device Profile 系リソースで繰り返し差分が出る問題の修正なども挙げられているよ。あわせて 17 件の issue がこのリリースでクローズされているみたい。

v4 から v5 への移行を検討している人向けには、migration guide が引き続き用意されているから、まだ v4 を使っている人はあわせてチェックしてみてね。

まとめ

• Cloudflare の Terraform provider v5.9 がリリースされたよ
• 修正方針が issue 単位から「リソースを絞って集中的に安定化させる」方式に転換
• cloudflare_zone_setting / cloudflare_worker_script / cloudflare_worker_route / tiered_cache が安定版に
• 新リソース cloudflare_snippet が登場、cloudflare_snippets は非推奨になったので早めの移行が推奨されているよ
• DNS のドリフト検知やロードバランサーの created_on 不整合、Bot Management の状態管理なども改善済み

Cloudflare の Zone 設定や Workers、Snippets を Terraform で管理しているインフラ担当さんは、特に cloudflare_snippets を使っているなら見逃せないアップデートだよ！