|
| 1 | +--- |
| 2 | +title: Terraform v5.6.0 now available |
| 3 | +description: Terraform v5.6.0 fixes a number of known bugs in the v5 Provider |
| 4 | +products: |
| 5 | + - fundamentals |
| 6 | +date: 2025-06-17 |
| 7 | +--- |
| 8 | + |
| 9 | +Earlier this year, we announced the launch of the new [Terraform v5 Provider](/changelog/2025-02-03-terraform-v5-provider/). |
| 10 | +Unlike the earlier Terraform providers, v5 is automatically generated based on the OpenAPI Schemas for our REST APIs. Since |
| 11 | +launch, we have seen an unexpectedly high number of [issues](https://github.com/cloudflare/terraform-provider-cloudflare) |
| 12 | +reported by customers. These issues currently impact about 15% of resources. We have been working diligently to address |
| 13 | +these issues across the company, and have released the v5.6.0 release which includes a number of bug fixes. Please keep an |
| 14 | +eye on this changelog for more information about upcoming releases. |
| 15 | + |
| 16 | +### Changes |
| 17 | + |
| 18 | +- Broad fixes across resources with recurring diffs, including, but not limited to: |
| 19 | + - `cloudflare_zero_trust_access_identity_provider` |
| 20 | + - `cloudflare_zone` |
| 21 | +- `cloudflare_page_rules` runtime panic when setting `cache_level` to `cache_ttl_by_status` |
| 22 | +- Failure to serialize requests in `cloudflare_zero_trust_tunnel_cloudflared_config` |
| 23 | +- Undocumented field 'priority' on `zone_lockdown` resource |
| 24 | +- Missing importability for `cloudflare_zero_trust_device_default_profile_local_domain_fallback` and `cloudflare_account_subscription` |
| 25 | +- New resources: |
| 26 | + - `cloudflare_schema_validation_operation_settings` |
| 27 | + - `cloudflare_schema_validation_schemas` |
| 28 | + - `cloudflare_schema_validation_settings` |
| 29 | + - `cloudflare_zero_trust_device_settings` |
| 30 | +- Other bug fixes |
| 31 | + |
| 32 | +For a more detailed look at all of the changes, see the |
| 33 | +[changelog](https://github.com/cloudflare/terraform-provider-cloudflare/releases/tag/v5.6.0) in GitHub. |
| 34 | + |
| 35 | +### Issues Closed |
| 36 | +- [#5098: 500 Server Error on updating 'zero_trust_tunnel_cloudflared_virtual_network' Terraform resource](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5098) |
| 37 | +- [#5148: cloudflare_user_agent_blocking_rule doesn’t actually support user agents](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5148) |
| 38 | +- [#5472: cloudflare_zone showing changes in plan after following upgrade steps](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5472) |
| 39 | +- [#5508: cloudflare_zero_trust_tunnel_cloudflared_config failed to serialize http request](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5508) |
| 40 | +- [#5509: cloudflare_zone: Problematic Terraform behaviour with paused zones](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5509) |
| 41 | +- [#5520: Resource 'cloudflare_magic_wan_static_route' is not working](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5520) |
| 42 | +- [#5524: Optional fields cause crash in cloudflare_zero_trust_tunnel_cloudflared(s) when left null](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5524) |
| 43 | +- [#5526: Provider v5 migration issue: no import method for cloudflare_zero_trust_device_default_profile_local_domain_fallback](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5526) |
| 44 | +- [#5532: cloudflare_zero_trust_access_identity_provider detects changes on every plan](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5532) |
| 45 | +- [#5561: cloudflare_zero_trust_tunnel_cloudflared: cannot rotate tunnel secret](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5561) |
| 46 | +- [#5569: cloudflare_zero_trust_device_custom_profile_local_domain_fallback not allowing multiple DNS Server entries](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5569) |
| 47 | +- [#5577: Panic modifying page_rule resource](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5577) |
| 48 | +- [#5653: cloudflare_zone_setting resource schema confusion in 5.5.0: value vs enabled](https://github.com/cloudflare/terraform-provider-cloudflare/issues/5653) |
| 49 | + |
| 50 | +If you have an unaddressed issue with the provider, we encourage you to check the |
| 51 | +[open issues](https://github.com/cloudflare/terraform-provider-cloudflare/issues) and open a new one if one does not already |
| 52 | +exist for what you are experiencing. |
| 53 | + |
| 54 | +### Upgrading |
| 55 | + |
| 56 | +If you are evaluating a move from v4 to v5, please make use of the |
| 57 | +[migration guide](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/guides/version-5-upgrade). We have |
| 58 | +provided automated migration scripts using Grit which simplify the transition, although these do not support implementations which |
| 59 | +use Terraform modules, so customers making use of modules need to migrate manually. Please make use of `terraform plan` to test |
| 60 | +your changes before applying, and let us know if you encounter any additional issues by reporting to our |
| 61 | +[GitHub repository](https://github.com/cloudflare/terraform-provider-cloudflare). |
| 62 | + |
| 63 | +### For more info |
| 64 | + |
| 65 | +- [Terraform provider](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs) |
| 66 | +- [Documentation on using Terraform with Cloudflare](/terraform/) |
0 commit comments