Terragrunt

This walkthrough will guide you through using Terragrunt with CloudTruth enabling you to manage your multiple environments parameters and secretes from a centralized location.
You can also use CloudTruth to externally reference backend tfstate output as an external parameter.
Prerequisites
You know basic Terraform.
You have installed Terragrunt.
You have created a CloudTruth API Access token and installed the CLI.
Terragrunt DRY deploy
Terragrunt with CloudTruth allows you to keep your code DRY across multiple environments while centralizing your configuration input values.
Rather than using hardcoded and scattered Terragrunt inputs to define parameter values, we will inject inputs directly from a specified CloudTruth project and environment.
This example deployed with Terragrunt HCL will create an AWS Instance in us-west-2 and an S3 bucket, utilizing CloudTruth to manage Terraform variable keys and values for a development, production, and staging environment.
You can follow along in your AWS account by cloning this repo.
git clone https://github.com/cloudtruth-demo/terragrunt-cloudtruth-deploy.git
The Terragrunt folder structure for this repo contains development, production, and staging directories.
1
# terragrunt-cloudtruth-deploy
2
├── development
3
│   ├── instance
4
│   │   └── terragrunt.hcl
5
│   ├── s3
6
│   │   └── terragrunt.hcl
7
│   └── terragrunt.hcl
8
│       
9
├── production
10
│   ├── instance
11
│   │   └── terragrunt.hcl
12
│   ├── s3
13
│   │   └── terragrunt.hcl
14
│   └── terragrunt.hcl
15
│       
16
└── staging
17
    ├── instance
18
    │   └── terragrunt.hcl
19
    ├── s3
20
    │   └── terragrunt.hcl
21
    └── terragrunt.hcl
Copied!
The instance and s3 sub-folders contain a terragrunt.hcl file that set the source parameter to point at the specific modules in the terragrunt-cloudtruth-modules repo. They also include the parent terragrunt.hcl which configures the AWS provider.
Example instance terragrunt.hcl:
1
terraform {
2
  source = "git::https://github.com/cloudtruth-demo/terragrunt-cloudtruth-modules.git//instance?ref=v0.0.1"
3
}
4
​
5
include {
6
  path = find_in_parent_folders()
7
}
Copied!
Notice that we are not hardcoding inputs in the terragrunt.hcl! Inputs will be centrally managed and sourced from CloudTruth and not buried in environment subdirectories. 🎉
Setup a CloudTruth Project and Environments
Create a CloudTruth Project called Terragrunt.
1
cloudtruth project set Terragrunt
Copied!
Now add the parameters to the Terragrunt project that are required by the Terraform modules we are calling in the terragrunt.hcl.
1
cloudtruth --project Terragrunt parameter set TF_VAR_ami -v ami-830c94e3
2
cloudtruth --project Terragrunt parameter set TF_VAR_instance_type -v t2.micro
3
cloudtruth --project Terragrunt parameter set TF_VAR_availability_zone_names -v '["us-west-2a", "us-west-2b"]'
4
cloudtruth --project Terragrunt parameter set TF_VAR_resource_tags -v '{"Name":"Cloudtruth-Instance","project":"CloudTruth Run Terraform","environment":"default"}'
Copied!
Set unique resource tags that get applied to the EC2 instance and s3 bucket for each environment.
1
cloudtruth --project Terragrunt --env development parameter set TF_VAR_resource_tags -v '{"Name":"CloudTruth-development","project":"CloudTruth Run Terraform","environment":"development"}'
2
cloudtruth --project Terragrunt --env production parameter set TF_VAR_resource_tags -v '{"Name":"CloudTruth-production","project":"CloudTruth Run Terraform","environment":"production"}'
3
cloudtruth --project Terragrunt --env staging parameter set TF_VAR_resource_tags -v '{"Name":"CloudTruth-staging","project":"CloudTruth Run Terraform","environment":"staging"}'
Copied!
Now your CloudTruth Terragrunt project is setup to centrally manage the TF_VAR variables with unique values for resource tags across our multiple environments.
Running a centrally managed DRY deploy
Terragrunt respects any TF_VAR_xxx variables you’ve manually set in your environment and follows the same variable precedence as Terraform. Using CloudTruth Run we will pass the CloudTruth configured TF_VAR_xxx variables directly to the Terraform modules through Terragrunt for the specified environment.
Change directory to terragrunt-cloudtruth-deploy/development/.
From terragrunt-cloudtruth-deploy/development/ execute the following command which passes variables from the CloudTruth project Terragrunt for the development environment into terragrunt:
1
cloudtruth --project Terragrunt --env development run -- terragrunt run-all apply
Copied!
You have now deployed an instance in EC2 and an S3 bucket with a DRY Terragrunt configuration and CloudTruth! 🙌
You can view the outputs that display the parameter values from the CloudTruth Development environment by running terragrunt run-all output.
1
AMI = <sensitive>
2
instance_name = "CloudTruth-development"
3
instance_type = "t2.micro"
4
zone = "us-west-2a"
5
s3_bucket_name = "cloudtruth-grunt-free-panda"
6
s3_tag_name = "CloudTruth-development"
Copied!
You can change to the production or staging directories and pass the respective CloudTruth environment to deploy various settings across your different infrastructure!
Cleanup
Destroy the AWS resources by passing environment variables the same way we created them.
1
cloudtruth --project Terragrunt --env development run -- terragrunt run-all destroy
Copied!
You can see the source code for the Terraform modules and Terragrunt Deploy in the following repos.
GitHub - cloudtruth-demo/terragrunt-cloudtruth-deploy: Terragrunt DRY deploy across environments with CloudTruth run
GitHub
GitHub - cloudtruth-demo/terragrunt-cloudtruth-modules: AWS Modules to demonstrate a DRY deploy with Terragrunt
GitHub

Terraform

Explorer

Last modified 2mo ago

Copy link

Contents

Prerequisites

Terragrunt DRY deploy