# Terraform v5.8.4 で安定版リソースが一気に 19 個に！テスト駆動でバグ退治も加速だよ

こんにちは、しぃちゃんだよ！今日も Cloudflare の Terraform provider にアップデートが来たから、IaC 勢のみんなに届けるね！

## なにが発表されたの？

Cloudflare の Changelog によると、2025 年 8 月 15 日に Terraform provider の v5.8.4 がリリースされたよ。今年発表された v5 provider はコミュニティから多くの issue が報告されていて、Cloudflare は 2 週間ごとの改善リリースを続けてきたの。

今回のポイントは、単なるバグ修正だけじゃなくて、直近で「より包括的なテスト駆動開発」へ舵を切ったことなんだって。個々の issue の検証は続けつつ、より深いテストへの投資と、今後の包括的なマイグレーションスクリプトへの投資も表明されているよ。その成果として、トラフィックの多い主要な API のいくつかが安定版になって、包括的な受け入れテストで裏付けられるようになったの。

## 今までどうだったの？

v5 provider は OpenAPI スキーマから自動生成される仕組みになった影響で、ローンチ後にコミュニティから多くの issue が報告されていたよ。Cloudflare はこれまでも 2 週間サイクルで改善リリースを重ねてきたけど、issue を 1 件ずつ潰すだけのやり方では、「このリソースはもう安心して使える」と言い切れる状態になかなかたどり着けなかったみたい。今回、テスト重視の開発体制へ転換したのは、そうした課題への対応なんだね。

## これで何が変わるの？

v5.8.4 で安定版として扱われるようになったリソースは、なんと 19 個もあるよ！

- `cloudflare_argo_smart_routing`
- `cloudflare_bot_management`
- `cloudflare_list` / `cloudflare_list_item`
- `cloudflare_load_balancer` / `cloudflare_load_balancer_monitor` / `cloudflare_load_balancer_pool`
- `cloudflare_spectrum_application`
- `cloudflare_managed_transforms`
- `cloudflare_url_normalization_settings`
- `cloudflare_snippet` / `cloudflare_snippet_rules`
- `cloudflare_zero_trust_access_application` / `_access_group` / `_access_identity_provider` / `_access_mtls_certificate` / `_access_mtls_hostname_settings` / `_access_policy`
- `cloudflare_zone`

Load Balancer や Zero Trust Access 関連など、実際の運用でよく触るリソースがまとめて安定版になったのは大きいね。あわせて `cloudflare_snippet` のマルチパート処理が復元されて、`cloudflare_bot_management` で `terraform plan` / `apply` のたびに出ていた差分の問題も解消されたよ。

## 深く潜ってみよう

このリリースでクローズされた issue の例も紹介するね。

- `cloudflare_snippets` を使うと「Uncaught Error: No such module」というエラーが出る問題(#5017)
- Durable Objects 向けの `cloudflare_workers_script` のマイグレーションが tfstate に記録されず、バージョン間でアップグレードできない問題(#5701)
- `cloudflare_argo_smart_routing` をインポートしても実際の値が読み込まれない問題(#5640)

アップグレードについて、Cloudflare は「安定化作業が続いている間は v5 への移行を見送ることを推奨する」とはっきり案内しているよ。移行を進めたい場合は、Grit を使った自動マイグレーションスクリプト付きの migration guide が用意されているけど、Terraform module を使っている環境は自動化の対象外だから手動での移行が必要とのこと。適用前には `terraform plan` で差分を確認してから進めるよう案内されているよ。

## まとめ

- Terraform provider v5.8.4 がリリースされたよ
- 修正方針として「より包括的なテスト駆動開発」への転換が明かされた
- Load Balancer や Zero Trust Access 関連など 19 個のリソースが安定版に
- `cloudflare_snippet` のマルチパート処理復元、`cloudflare_bot_management` の差分問題も解消
- Cloudflare は安定化が終わるまで v5 への移行を見送ることを推奨中(module 利用時は手動移行が必要)

Cloudflare の Load Balancer や Zero Trust Access、Snippets を Terraform で管理しているインフラ担当さんは、差分やエラーが減っているはずだから、ぜひ確認してみてね！