This repository contains infrastructure as Terraform configurations.
Terragrunt is used to work with Terraform configurations which allows to orchestrate dependent layers, update arguments dynamically and keep configurations DRY.
- Overview
- Quick start
- Configure access to AWS account
- Create and manage your infrastructure
- References
- Install Terraform 0.12 or newer
- Install Terragrunt 0.19 or newer
- Optionally, install pre-commit hooks to keep Terraform formatting and documentation up-to-date.
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=us-east-1
$ export AWS_ACCESS_KEY_ID=...
$ export AWS_SECRET_ACCESS_KEY=...
Alternatively, you can edit common/main_providers.tf and use another authentication mechanism as described in AWS provider documentation.
Infrastructure consists of multiple layers (rds, autoscaling_2, autoscaling_1, ...) 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 us-east-1
$ terragrunt apply-all
- As a single layer (faster&granular). Run this command to create infrastructure in a single layer (eg,
rds):
$ cd us-east-1/rds
$ terragrunt apply
After the confirmation your infrastructure should be created.
- Terraform documentation and Terragrunt documentation for all available commands and features.
- Terraform AWS modules.
- Terraform modules registry.
All content, including Terraform AWS modules used in these configurations, is released under the MIT License.