Skip to content

antonbabenko/modules.tf-demo

Repository files navigation

Infrastructure code for "Web App Reference Architecture (complete)"

This repository contains Terraform configuration files which were automatically generated from blueprint created using Cloudcraft.

Original infrastructure

Web App Reference Architecture (complete)


Terragrunt is used to work with Terraform configurations which allows to orchestrate dependent layers, update arguments dynamically and keep configurations DRY.

Table of Contents

  1. Quick start
  2. Configure access to AWS account
  3. Create and manage your infrastructure
  4. References
  5. About d2c.modules.tf

Quick start

  1. Install Terraform 0.15 or newer
  2. Install Terragrunt 0.29 or newer
  3. 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

Configure access to AWS account

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

$ export AWS_DEFAULT_REGION=eu-west-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.

Create and manage your infrastructure

Infrastructure consists of multiple layers (rds_2, rds_1, autoscaling_2, ...) 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 eu-west-1
$ terragrunt run-all apply
  • As a single layer (faster&granular). Run this command to create infrastructure in a single layer (eg, rds_2):
$ cd eu-west-1/rds_2
$ terragrunt apply

After the confirmation your infrastructure should be created.

References

About d2c.modules.tf

modules.tf is an open-source project created by Anton Babenko:

  1. Questions, bugs and feature-requests - open an issue.
  2. Become a sponsor to @antonbabenko.
  3. You are always welcome to share, star, like, tweet, follow!

@antonbabenko @antonbabenko modules.tf-lambda

All content, including Terraform AWS modules used in these configurations, is released under the MIT or Apache License.