Migrate Workspace State Using Terraform State Push / Pull

Use Case

The current version of Terraform Enterprise (TFE) and Terraform Cloud (TFC) do not provide a feature to revert state within the application. You can, however, use Terraform on the command line to push a state file into a workspace to become the current state.

Procedure

1. To obtain the desired state, navigate to the workspace’s States list, select the desired state, and click "Download" or “Download raw” to download the raw state file to your local machine.
2. Configure Terraform locally with a TFE backend and run terraform init as described in that article.
3. With the remote backend configured and Terraform initialized, the state mv and state rm commands are supported. These commands enable direct modification of the state within the Terraform Enterprise or Terraform Cloud workspace.
4. In some scenarios, such as if the state in Terraform Enterprise or Terraform Cloud was updated incorrectly or corrupted, direct state manipulation may be required. In these cases, you may pull the state file to the local directory using for editing using the following command.

    $ terraform state pull

          The state may then be manipulated and subsequently uploaded using the following command, where /path/to/statefile.json is the updated state file.

    $ terraform state push /path/to/statefile.json

Additional Information

• Terraform’s state (mv|rm|push) and also Terraform’s import commands will modify the version of Terraform CLI in the state file to the version from which you are running the CLI command. Please make sure that you are using the same version of Terraform CLI as configured in the target workspace to avoid a conflict of the CLI version.
• This is terraform state push and not terraform push. terraform push is deprecated and does not operate in the current version of TFE.
• Please visit Import Terraform configuration tutorial for more sample of importing resources into Terraform state.
• Please visit Manage Resources in Terraform State tutorial for more sample of managing resources in Terraform state.