Demo Sourcing a Module From a Git Repository

In this tutorial, you’ll learn how to source the official Terraform AWS S3 Bucket Module directly from GitHub using Terragrunt. By pinning to a specific release tag, you can guarantee consistent deployments across environments.

Prerequisites

• Terragrunt installed (v0.XX+).
• AWS CLI configured with valid credentials.
• Git installed and reachable from your environment.

terragrunt.hcl

Create or update your terragrunt.hcl file:

terraform {
  source = "git::https://github.com/terraform-aws-modules/terraform-aws-s3-bucket.git?ref=v4.1.2"
}

inputs = {
  # This module expects "bucket" (not "bucket_name")
  bucket = "terragrunt-demo-bucket"
}

Module Inputs

Apply the Configuration

Run the following command in the directory containing your terragrunt.hcl:

terragrunt apply

You should see a plan similar to:

  # module.s3_bucket.aws_s3_bucket.this will be created
  + resource "aws_s3_bucket" "this" {
      + bucket = "terragrunt-demo-bucket"
      …
    }

  # module.s3_bucket.aws_s3_bucket_public_access_block.this will be created
  + resource "aws_s3_bucket_public_access_block" "this" {
      …
    }

Confirm by typing yes and wait for provisioning to complete.

Verify the Bucket

After Terragrunt finishes, list your S3 buckets:

aws s3 ls

Expected output:

2023-06-01 12:34:56 terragrunt-demo-bucket

You should see terragrunt-demo-bucket in the list.

Sourcing from Private Repositories

If your module resides in a private Git repo, update the source URL to point to your private repository (HTTPS or SSH) and ensure authentication is set up:

• SSH: Configure SSH keys and add them to your Git provider.
• HTTPS: Use git-credential-helper or environment variables for credentials.

Links and References