Terraform Import/Export

README.md

Terraform Import/Export

If you need to move resources between Terraform projects but they aren't configured in such a way you can directly run tf state move to move them between modules you can follow this process for migrating resources between terraform projects.

Commands Used

• terraform state mv
• terraform state pull
• terraform state push

Overview

Imagine you need to move some resources from Terraform project a into project b without disturbing the remote resources themselves.

The basic process for moving state would work like the following:

1. In Terraform project a figure out what pieces of state you'd like to move (terraform state list along with grep can be useful here)
2. Create a local file in project a called transfer.tfstate
3. Run terraform state mv -state-out=transfer.tfstate RESOURCE_NAME RESOURCE_NAME for each resource to move
4. Move transfer.tfstate into project b
5. Run terraform state pull > ./destination.tfstate to pull the project's remote state into a file
6. Run terraform state mv -state=transfer.tfstate -state-out=destination.tfstate RESOURCE_NAME RESOURCE_NAME for each resource to move
7. Run terraform state push ./destination.tfstate to overwrite the remote state with what is in the local file

If the transfer was successful running terraform plan in either project should show a noop of changes.

Helper Scripts

If you have a lot of resources to move see the attached helper scripts. These help automate steps 3 and 6 if you need to run for multiple resources.

Just replace the resources array in the bash script with an array of resources to export or import and run the script to automate the mv commands.

export.sh

#!/bin/bash

resources=(
	"module.my_piece_of_state"
	"module.another_piece.of.state"
)

for i in "${resources[@]}"
do
   : 
   terraform state mv -state-out=transfer.tfstate $i $i
done

import.sh

#!/bin/bash

resources=(
	"module.my_piece_of_state"
	"module.another_piece.of.state"
)

for i in "${resources[@]}"
do
   : 
   terraform state mv -state=transfer.tfstate -state-out=destination.tfstate $i $i
done