A Terragrunt example to layout folders and modules in a Google Cloud Platform project. This is a real production-ready example, but you can change the folders/moduleslayout based on your requirements and needs.

This layout is trying to make both code and confirations really DRY. It is also solving a common chicken and egg problem: "how can I apply code with a remote state without having the remote backend in place?" --> remote_state block in live/global.hcl.

A brief overview on files in this repo:

• live/global.hcl contains global parameters (e.g region, location, common prefixes, ..)
• live/terragrunt.hcl centrally defines backend configurations, provider(s) definition, backend creation, global parameters
• live/_envcommon folder sets the common resources needed among all environments (dev and prod)
• live/dev/environment.hcl defines environment specific parameters

Code is self-explanatory, please read comments in hcl files.

To format the code in this repo I use pre-commit. You can install the tool with pip or brew:

# Install with pip
pip install pre-commit

# Install with brew
brew install pre-commit

Once installed you need to configure the cloned repo to use the versioned configuration:

pre-commit install

For further information read the upstream documentation.

Read Terraform documentation for Google provider as a reference.

Replace placeholders in:

• live/global.hcl
• live/dev/environment.hcl
• live/prod/environment.hcl

cd infrastructure/gcp/dev/buckets
terragrunt plan -out=terragrunt.plan
terragrunt apply terragrunt.plan

cd infrastructure/gcp/dev
terragrunt run-all --terragrunt-no-auto-approve apply