The terraform wrapper script - terra_wrap

Terraform does not manage environments in a great way. You almost always have to supply a "var-file" and sometimes a "backend-config" file. This is where the terra_wrap wrapper script to the terraform command comes in. It is used to simplify having multiple environments and make less mistakes.

Running the command:

terra_wrap qa apply

Runs the following commands:

terraform init -backend-config env/qa.backend.tfvars -reconfigure
terraform apply -var-file env/qa.tfvars -input=false

Environment Management

To see an example of the environment layout, look at terraform_repo_layout An environment has a <env_name>.tfvars file and <env_name>.backend.tfvars file.

Help File of terra_wrap

Usage: terra_wrap <environment> <apply|output|destroy|plan|apply-plan|destroy-jenkins>

Typically you would only use the options 'apply, output or destroy'.
Example: 'terra_wrap qa apply' and 'terra_wrap qa destroy'

Environments, for example: qa, prod. You can add additional environments by adding variable files.

Options:
  apply: Used by Developers - It will both 'init' the backend and 'apply' your changes. It will create the environment if it does not exist.
  output: Used by Developers - Exact same as 'terraform output' which will show you all outputs in this directory.
  destroy: Used by Developers - Destroys the entire environment specified but will prompt first.
  console: Used by Developers - Test your expressions against that environments variable file.
  plan: Used by Jenkins - Creates a plan file that you can 'apply' at a later date.
  apply-plan: Used by Jenkins - Applies a plan without any prompt.
  destroy-jenkins: Used by Jenkins - Destroys the environment without any prompt.

Typical workflow

If you are following this repo layout, then first you need change directory into the product you are working on and then run the terra_wrap command:

cd product/product_foo
terra_wrap qa apply

When you don't want the environment anymore, just run destroy as usual.

terra_wrap qa destroy