Skip to main content

Learn How to Import Infrastructure Into Terraform

Terraform not only allows you to create and manage greenfield infrastructure, but also to manage existing resources for a variety of popular infrastructure providers. You can migrate manually created infrastructure to Terraform in order to use its powerful configuration language and workflow over the entire lifecycle of your project.

Consider the scenario where you are already running a database in the cloud, and that database is being actively used by your business applications. Rather than destroying the database and recreating a new one from scratch with Terraform, you can tell Terraform about the existing resources and start managing them with Terraform from that point forward.

»Learn to use Terraform import

In this hands-on tutorial, you will import an existing Docker container and Docker image into a Terraform project’s state and create configuration to match.

»Manage existing infrastructure

The typical Terraform workflow involves first writing Terraform configuration and then planning and applying that configuration to create new infrastructure. Once you become comfortable creating and managing infrastructure with code, eventually you'll encounter a situation where you wish to import existing infrastructure into Terraform without destroying or recreating it. The terraform import command can be used to import infrastructure into a Terraform project’s state.

Terraform import workflow

Note: The import command does not create Terraform configuration. Users will need to create configuration to match the state created by the import process.

Follow the steps of this hands-on tutorial to start using Terraform with your existing infrastructure.


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.