Skip to main content

Terraform migrate now generally available

The GA release of Terraform migrate introduces several improvements and new capabilities based on feedback from our beta users.

Today, we are excited to announce that Terraform migrate is now generally available, providing a purpose-built solution for transitioning from Terraform Community Edition to HCP Terraform and Terraform Enterprise. Designed to reduce manual effort and improve accuracy, it streamlines the migration process, helping teams adopt HCP Terraform and Terraform Enterprise with confidence.

»Why Terraform migrate?

Terraform migrate is a command-line tool that simplifies the process of migrating your Terraform state and configuration to HCP Terraform and Terraform Enterprise. It addresses the key challenges of migration:

  • Automating state transfer: Migrate your state files seamlessly and reliably, minimizing manual intervention and reducing the risk of errors.
  • State refactoring: Adapt your existing Terraform workspaces to align with evolving organizational requirements by handling necessary changes automatically.
  • Validation and verification: Validate your migration process and verify the integrity of your state in the new environment.

»What’s new in GA?

The GA release of Terraform migrate introduces enhanced automation, security, and efficiency, making it easier than ever to transition from Terraform Community Edition to HCP Terraform (TFC) and Terraform Enterprise (TFE).

»Expanded features

  • Variable management and migration: Users can now migrate workspace variables and their values to HCP Terraform and Terraform Enterprise, reducing the need for manual reconfiguration.
  • GitLab integration: Added Git operations support for GitLab, allowing users to incorporate Terraform migrate seamlessly into their CLI-driven workflows.
  • Security and validation: Improved security by adding validation checks on Git personal access tokens (PAT) during the prepare and execute commands.

»Workflow enhancements

  • Refined directory skipping: The --skip-dir flag has been enhanced to eliminate the need for manual changes in template files, streamlining migrations.
  • Dry-run mode: A --dry-run option has been introduced for the execute step, enabling users to preview migration changes before applying them.

»Stability and performance

  • Improved target branch naming: Target branch names now dynamically reflect the current branch, enhancing traceability in version control workflows.
  • Optimizations: Enhanced error handling, improved logging for better debugging and audit trails, and an optimized prepare command for faster execution, reducing migration time.

»Get started

Terraform migrate is generally available and ready for download. You can find detailed documentation and instructions on how to get started on HashiCorp Developer.

»Next steps

This release marks a significant milestone in our commitment to providing you with the best tools for managing your infrastructure as code. We encourage you to explore Terraform migrate and experience the benefits of a simplified and efficient migration to HCP Terraform. See the benefits of HCP Terraform by signing up here.

Sign up for the latest HashiCorp news

By submitting this form, you acknowledge and agree that HashiCorp will process your personal information in accordance with the Privacy Policy.