Terraform AWS Serverless Modules

This repository contains various modules that can be utilized for doing serverless infrastructure deployment on AWS utilizing Terraform.

NOTE: Modules in this repository are mainly for my own Infrastructure as Code skill development and not quite battle-tested for real, production scenarios (at least not yet...). Use at your own risk.

For more information on how to utilize each module, check the relevant module README.md files here:

Table of Modules

• lambda
• vpc
• security_group
• secrets_manager
• rds
• iam
• api_gateway

How do you use these modules with Terragrunt?

To use a module, create a terragrunt.hcl file that specifies the module you want to use as well as values for the input variables of that module:

# Use Terragrunt to download the module code
terraform {
  source = "git::git@github.com:dtsong/terraform-aws-serverless-modules.git//path/to/module?ref=v0.0.1"
}

# Fill in the variables for that module
inputs = {
  name = "acme"
  
  wordle = 263
}

(Note: the double slash (//) in the source URL is intentional and required. It's part of Terraform's Git syntax for module sources.)

You then run Terragrunt, and it will download the source code specified in the source URL into a temporary folder, copy your terragrunt.hcl file into that folder, and run your Terraform command in that folder:

> terragrunt apply
[terragrunt] Reading Terragrunt config file at terragrunt.hcl
[terragrunt] Downloading Terraform configurations from git::git@github.com:dtsong/terraform-aws-serverless-modules.git//path/to/module?ref=v0.0.1
[terragrunt] Copying files from . into .terragrunt-cache
[terragrunt] Running command: terraform apply
[...]