Skip to content

Latest commit

 

History

History

tfimport

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 

README.md

Terraform Importer

Terraform Importer is a standalone utility to import existing infrastructure into a Terraform state, based on existing Terraform configs. Its target use-case is to facilitate migration between other infrastructure-as-code tools (such as Deployment Manager), and configs generated by the Terrarom Engine.

Requirements

Installation

Download a pre-built tfimport binary:

VERSION=v0.8.0
wget -O /usr/local/bin/tfimport https://github.com/GoogleCloudPlatform/healthcare-data-protection-suite/releases/download/${VERSION}/tfimport_${VERSION}_linux-amd64
chmod +x /usr/local/bin/tfimport

or build it yourself:

git clone https://github.com/GoogleCloudPlatform/healthcare-data-protection-suite
cd healthcare-data-protection-suite
go install ./cmd/tfimport

Usage

Enter the directory containing Terraform configs:

cd ~/path/to/terraform/configs/

Run the importer:

tfimport

On a successful run, the Terraform configs in the current working directory will be initialized and all supported resources will be in the state.

If you now run terraform plan, you should only see planned changes for differences between the configs and the actual infrastructure.

Flags

$ tfimport -h
Usage:
  -dry_run bool
        Run in dry-run mode, which only prints the import commands
        without running them.
  -input_dir string
        Path to the directory containing Terraform configs. (default ".")
  -interactive bool
        Interactively ask for user input when import information cannot be
        automatically determined. (default true)
  -resource_types string
        Specific resource types to import, specified as terraform resource
        names (e.g. 'google_storage_bucket', 'google_resource_manager_lien').
        Provide flag multiple times for multiple values.
        Leave empty to import all. (default {})
  -terraform_path string
        Name or path to the terraform binary to use. (default "terraform")
  -version bool
        show version and exit

Limitations

Unknown Fields

Sometimes, fields required for import will not be known at plan time. This generally falls into a few cases:

  1. Another resource must be imported first. The importer will keep trying to plan-and-import as long as it makes progress (i.e. successfully imports some resources, but not all).
  2. Unknowable fields, including all random_* resources and google_folder. In this case, the importer will ask the user to input the value. Where possible, it will offer a choice as well.

Related Tools

Terraformer

This tool is complementary to Terraformer.

Terraformer focuses on generating new Terraform configs from existing infrastructure, while the Importer allows you to define and organize your own Terraform configs, including importing resources from within modules.

Resource Support by Provider

Google Cloud Platform (GCP)

GSuite

Helm

Kubernetes

Kubernetes Provider (Alpha)

Local

Null

Random

TLS