cloudflare/tf-migrate v1.0.0

v1.0.0

Repository: cloudflare/tf-migrate

Tag: v1.0.0

Published: 2026-04-24T23:13:02Z

Prerelease: no

Release notes:

Changelog

First generally available release. Includes all changes from v1.0.0-beta.1 through v1.0.0-beta.12.

Supported Migration Paths

• v4 → v5: 80+ Cloudflare Terraform Provider resource types. See the [supported resources table](README.md#supported-resources-v4--v5) for the complete list.
• v5 → v5: Bypass mode — generates moved {} blocks only, for provider-level schema moves within v5.

Highlights

• Automatic .tf configuration transformation — resource renames, attribute changes, block restructuring, moved {} / import {} / removed {} block generation
• Cross-file reference rewriting — updates resource type names, attribute references, and computed attribute references across all .tf files in the config directory
• Phased migration for cloudflare_zone_settings_override — handles state cleanup via removed {} blocks without requiring terraform state rm, compatible with Atlantis-managed workspaces
• Pre-migration preflight scan — classifies all resources before transformation, warns about unsupported types and conflicting moved {} blocks
• verify-drift command — reads terraform plan output and classifies each change as expected or unexpected using embedded drift exemptions
• Dry-run mode (--dry-run) — previews all changes without modifying files
• Recursive directory support (--recursive) for module structures
• Verbose diagnostics (--verbose) and in-file # MIGRATION WARNING comments for changes requiring manual follow-up
• Automatic provider version update in required_providers (fetched from GitHub API, with --target-provider-version override for air-gapped or CI environments)
• Minimum provider version enforcement — blocks migration if v4 provider is below v4.52.5
• Backup files created by default; disable with --no-backup
• E2E test infrastructure — full lifecycle tests against real Cloudflare infrastructure with R2-backed remote state