Terraform CLI Cheat Sheet

What is Terraform

Terraform is an open-source software tool to manage end to end lifecycle of your IT infrastructure. Terraform provides a consistent CLI workflow to manage hundreds of cloud services.

Installation

Install Through curl

$ curl -O https://releases.hashicorp.com/terraform/0.11.10/terraform_0.11.10_linux_amd64.zip$ sudo unzip terraform_0.11.10_linux_amd64.zip -d /usr/local/bin/$ rm terraform_0.11.10_linux_amd64.zip

…or Install Through tfenv, a Terraform Version Manager

First of all, download the tfenv binary and put it in your PATH.

$ git clone https://github.com/Zordrak/tfenv.git ~/.tfenv$ echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> $HOME/bashrc

Then, you can install the desired version of Terraform:

$ tfenv install 0.11.10

Usage

Show Version

$ terraform --versionTerraform v0.11.10

Init Terraform

$ terraform init

It’s the first command you need to execute. Unless terraform plan , apply , destroy and import will not work. The command terraform init will install :

• Terraform modules
• Eventually a backend
• Provider(s) plugins

Init Terraform and Don’t Ask Any Input

$ terraform init -input=false

Change Backend Configuration During the Init

$ terraform init -backend-config=cfg/s3.dev.tf -reconfigure

-reconfigure is used in order to tell Terraform to not copy the existing state to the new remote state location.

Get

This command is useful when you have defined some modules. Modules are vendored, so when you edit them, you need to get again modules content.

$ terraform get -update=true

When you use modules, the first thing you’ll have to do is to do a terraform get . This pulls modules into the .terraform directory. Once you do that, unless you do another terraform get -update=true, you’ve essentially vendored those modules.

Plan

The plan step check configuration to execute and write a plan to apply to target infrastructure provider.

$ terraform plan -out plan.out

It’s an important feature of Terraform that allows a user to see which actions Terraform will perform prior to making any changes, increasing confidence that a change will have the desired effect once applied.

When you execute terraform plan, Terraform will scan all *.tf files in your directory and create the plan.

Apply

Now you have the desired state so you can execute the plan.

$ terraform apply plan.out

Good to know: Since Terraform v0.11+, in an interactive mode (non CI/CD/autonomous pipeline), you can just execute terraform apply command which will print out which actions TF will perform.

By generating the plan and applying it in the same command, Terraform can guarantee that the execution plan won’t change, without needing to write it to disk. This reduces the risk of potentially-sensitive data being left behind, or accidentally checked into version control.

$ terraform apply

Apply and Auto Approve

$ terraform apply -auto-approve

Apply and Define New Variables Value

$ terraform apply -auto-approve -var tags-repository_url=${GIT_URL}

Apply Only One Module

$ terraform apply -target=module.s3

This -target option works with Terraform plan too.

Destroy

$ terraform destroy

Delete all the resources!

A deletion plan can be created before:

$ terraform plan –destroy

-target option allows to destroy only one resource, for example, an S3 bucket :

$ terraform destroy -target aws_s3_bucket.my_bucket

Debug

The terraform console the command is useful for testing interpolations before using them in configurations. Terraform console will read configured state even if it is remote.

$ echo "aws_iam_user.notif.arn" | terraform consolearn:aws:iam::123456789:user/notif

Graph

$ terraform graph | dot –Tpng > graph.png

Visual dependency graph of Terraform resources.

Validate

The validate command is used to validate/check the syntax of the Terraform files. A syntax check is done on all the Terraform files in the directory and will display an error if any of the files don’t validate. The syntax check does not cover every syntax common issue.

$ terraform validate

Providers

You can use a lot of providers/plugins in your Terraform definition resources, so it can be useful to have a tree of providers used by modules in your project.

$ terraform providers.├── provider.aws ~> 1.24.0├── module.my_module│   ├── provider.aws (inherited)│   ├── provider.null│   └── provider.template└── module.elastic└── provider.aws (inherited)

State

Pull Remote State in A Local Copy

$ terraform state pull > terraform.tfstate

Push State in a Remote Backend storage

$ terraform state push

This command is useful if, for example, you originally use a local tf state and then you define backend storage, in S3 or Consul…

How to Tell Terraform You Moved a Resource in A Module?

If you moved an existing resource in a module, you need to update the state:

$ terraform state mv aws_iam_role.role1 module.mymodule

How to Import Existing Resources in Terraform?

If you have an existing resource in your infrastructure provider, you can import it into your Terraform state:

$ terraform import aws_iam_policy.elastic_postarn:aws:iam::123456789:policy/elastic_post

Workspaces

To manage multiple distinct sets of infrastructure resources/environments.

Instead of creating a directory for each environment to manage, we need to just create needed workspace and use them:

Create Workspace

This command creates a new workspace and then select it

$ terraform workspace new dev

Select a Workspace

$ terraform workspace select dev

List Workspaces

$ terraform workspace listdefault* devpreprod

Show Current Workspace

$ terraform workspace showdev

Tools

jq

jq is a lightweight command-line JSON processor. Combined with Terraform output it can be powerful.

Installation

For Linux:

$ sudo apt-get install jq

or

$ yum install jq

For OS X:

$ brew install jq

Usage

For example, we defined outputs in a module and when we execute terraform apply outputs are displayed:

$ terraform apply...Apply complete! Resources: 0 added, 0 changed, 0 destroyed.Outputs:elastic_endpoint = vpc-toto-12fgfd4d5f4ds5fngetwe4.eu-central-1.es.amazonaws.com

We can extract the value that we want in order to use it in a script for example. With jq it’s easy:

$ terraform output -json{"elastic_endpoint": {"sensitive": false,"type": "string","value": "vpc-toto-12fgfd4d5f4ds5fngetwe4.eu-central-1.es.amazonaws.com"}}$ terraform output -json | jq '.elastic_endpoint.value'"vpc-toto-12fgfd4d5f4ds5fngetwe4.eu-central-1.es.amazonaws.com"

Terraforming

If you have an existing AWS account for example with existing components like S3 buckets, SNS, VPC … You can use the Terraforming tool, a tool written in Ruby, which extracts existing AWS resources and converts them to Terraform files!

Installation

$ sudo apt install ruby or $ sudo yum install ruby

and

$ gem install terraforming

Usage

Pre-requisites:

Like for Terraform, you need to set AWS credentials:

$ export AWS_ACCESS_KEY_ID="an_aws_access_key"$ export AWS_SECRET_ACCESS_KEY="a_aws_secret_key"$ export AWS_DEFAULT_REGION="eu-central-1"

You can also specify your credential profile in ~/.aws/credentials_s and with _–profile option.

$ cat ~/.aws/credentials[aurelie]aws_access_key_id = xxxaws_secret_access_key = xxxaws_default_region = eu-central-1$ terraforming s3 --profile aurelie

Usage

$ terraforming --helpCommands:terraforming alb # ALB...terraforming vgw # VPN Gatewayterraforming vpc # VPC

Example:

$ terraforming s3 > aws_s3.tf

Remarks: As you can see, Terraforming can’t extract API gateway resources for the moment so you need to write it manually.

Click Here for Official Terraform CLI Reference Link