• Terraform: v1.13.4 or newer
• Terragrunt: v0.92.1 or newer
• AWS Provider: v6.x (auto-detected)

Option 1: Use Docker Image (Recommended)

docker build -t tg-tf:local . # Image includes Terraform 1.13.4 + Terragrunt v0.92.1 + Go

Option 2: Install Locally

1. Install Terraform 1.13+
2. Install Terragrunt 0.92+
3. Optionally, install pre-commit hooks

If you are using macOS you can install all dependencies using Homebrew:

brew install terraform terragrunt pre-commit

The recommended way to configure access credentials to AWS account is using environment variables:

$ export AWS_DEFAULT_REGION=ap-southeast-1 $ export AWS_ACCESS_KEY_ID=... $ export AWS_SECRET_ACCESS_KEY=... 

Alternatively, you can edit terragrunt.hcl and use another authentication mechanism as described in AWS provider documentation.

Infrastructure consists of multiple layers (magento_auto_scaling, mysql, load_balancer, ...) where each layer is described using one Terraform module with inputs arguments specified in terragrunt.hcl in respective layer's directory.

Navigate through layers to review and customize values inside inputs block.

There are two ways to manage infrastructure (slower&complete, or faster&granular):

• Region as a whole (slower&complete). Run this command to create infrastructure in all layers in a single region:

$ cd region $ terragrunt run-all apply 

• As a single layer (faster&granular). Run this command to create infrastructure in a single layer (eg, magento_auto_scaling):

$ cd ap-southeast-1/magento_auto_scaling $ terragrunt apply 

After the confirmation your infrastructure should be created.

destroy-all (DEPRECATED: use run-all) DEPRECATED: Use run-all destroy instead.

 terragrunt run-all destroy 

Destroy a ‘stack’ by running ‘terragrunt destroy’ in each subfolder.

This infrastructure uses the latest stable versions:

All module sources use HTTPS URLs (not SSH) for easier access without SSH keys.

• Terraform documentation and Terragrunt documentation for all available commands and features
• Terraform AWS modules
• Terraform modules registry
• Terraform best practices
• LocalStack for local testing