|
| 1 | +--- |
| 2 | +title: Terraform v5.8.2 now available |
| 3 | +description: Terraform v5.8.2 stablizes a number of resources and known issues |
| 4 | +products: |
| 5 | + - fundamentals |
| 6 | +date: 2025-08-01 |
| 7 | +--- |
| 8 | + |
| 9 | +Earlier this year, we announced the launch of the new [Terraform v5 Provider](/changelog/2025-02-03-terraform-v5-provider/). We are aware of the high mumber of [issues](https://github.com/cloudflare/terraform-provider-cloudflare) reported by the Cloudflare community related to the v5 release. We have committed to releasing improvements on a 2 week cadeance to ensure it's stability and reliability. We have also pivoted from an issue-to-issue approach to a resource-per-resource approach - we will be focusing on specific resources for every release, stablizing the release and closing all associated bugs with that resource before moving onto resolving migration issues. |
| 10 | + |
| 11 | +Thank you for continuing to raise issues. We triage them weekly and they help make our products stronger. |
| 12 | + |
| 13 | +### Changes |
| 14 | +- Resources stablized: |
| 15 | + - `cloudflare_custom_pages` |
| 16 | + - `cloudflare_page_rule` |
| 17 | + - `cloudflare_dns_record` |
| 18 | + - `cloudflare_argo_tiered_caching` |
| 19 | +- Addressed chronic drift issues in `cloudflare_logpush_job`, `cloudflare_zero_trust_dns_location`, `cloudflare_ruleset` & `cloudflare_api_token` |
| 20 | +- `cloudflare_zone_subscripton` returns expected values `rate_plan.id` from former versions |
| 21 | +- `cloudflare_workers_script` can now successfully be destroyed with bindings & migration for Durable Objects now recorded in tfstate |
| 22 | +- Ability to configure `add_headers` under `cloudflare_zero_trust_gateway_policy` |
| 23 | +- Other bug fixes |
| 24 | + |
| 25 | +For a more detailed look at all of the changes, see the [changelog](https://github.com/cloudflare/terraform-provider-cloudflare/releases/tag/v5.8.2) in GitHub. |
| 26 | + |
| 27 | +### Issues Closed |
| 28 | +- [#5666: cloudflare_ruleset example lists id which is a read-only field](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5666) |
| 29 | +- [#5578: cloudflare_logpush_job plan always suggests changes](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5578) |
| 30 | +- [#5552: 5.4.0: Since provider update, existing cloudflare_list_item would be recreated "created" state](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5552) |
| 31 | +- [#5670: cloudflare_zone_subscription: uses wrong ID field in Read/Update](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5670) |
| 32 | +- [#5548: cloudflare_api_token resource always shows changes (drift)](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5548) |
| 33 | +- [#5634: cloudflare_workers_script with bindings fails to be destroyed](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5634) |
| 34 | +- [#5616: cloudflare_workers_script Unable to deploy worker assets](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5616) |
| 35 | +- [#5331: cloudflare_workers_script 500 internal server error when uploading python](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5331) |
| 36 | +- [#5701: cloudflare_workers_script migrations for Durable Objects not recorded in tfstate; cannot be upgraded between versions](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5701) |
| 37 | +- [#5704: cloudflare_workers_script randomly fails to deploy when changing compatibility_date](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5704) |
| 38 | +- [#5439: cloudflare_workers_script (v5.2.0) ignoring content and bindings properties](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5439) |
| 39 | +- [#5522: cloudflare_workers_script always detects changes after apply](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5522) |
| 40 | +- [#5693: cloudflare_zero_trust_access_identity_provider gives recurring change on OTP pin login](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5693) |
| 41 | +- [#5567: cloudflare_r2_custom_domain doesn't roundtrip jurisdiction properly](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5567) |
| 42 | +- [#5179: Bad request with when creating cloudflare_api_shield_schema resource](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5179) |
| 43 | + |
| 44 | +If you have an unaddressed issue with the provider, we encourage you to check the [open issues](https://github.com/cloudflare/terraform-provider-cloudflare/issues) and open a new one if one does not already exist for what you are experiencing. |
| 45 | + |
| 46 | +### Upgrading |
| 47 | + |
| 48 | +We suggest holding off on migration to v5 while we work on stablization. This help will you avoid any blocking issues while the Terraform resources are actively being stablized. |
| 49 | + |
| 50 | +If you'd like more information on migrating from v4 to v5, please make use of the [migration guide](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/guides/version-5-upgrade). We have provided automated migration scripts using Grit which simplify the transition, although these do not support implementations which use Terraform modules, so customers making use of modules need to migrate manually. Please make use of `terraform plan` to test your changes before applying, and let us know if you encounter any additional issues by reporting to our [GitHub repository](https://github.com/cloudflare/terraform-provider-cloudflare). |
| 51 | + |
| 52 | +### For more info |
| 53 | + |
| 54 | +- [Terraform provider](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs) |
| 55 | +- [Documentation on using Terraform with Cloudflare](/terraform/) |
0 commit comments