Skip to main content
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"
}
Appending ?ref=v4.1.2 to the Git URL locks the module to version 4.1.2. This prevents unexpected changes due to upstream updates.

​
Module Inputs

InputDescriptionRequiredDefault
bucketName of the S3 bucket.yes—

​
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.
Do not store credentials in version control. Use secure credential helpers or environment variables to manage access.
ResourceURL
Terraform AWS S3 Modulehttps://github.com/terraform-aws-modules/terraform-aws-s3-bucket
Terragrunt Documentationhttps://terragrunt.gruntwork.io/docs/
Terraform Documentationhttps://www.terraform.io/docs/
AWS CLIhttps://aws.amazon.com/cli/

Watch Video