S3 Bucket

📦 Overview

This Terraform module provisions a basic AWS S3 bucket with tagging support and a randomly generated suffix to ensure global uniqueness.
It is intended for general-purpose storage in development, testing, or staging environments.

---

✅ Key Features

• Generates a globally unique S3 bucket name with random suffix
• Adds tagging support for environment and name tracking
• Optional auto-destruction of the bucket when using terraform destroy
• Lightweight and composable for use in larger infrastructures

---

💼 Use Cases

• General-purpose object storage
• Temporary buckets for development or CI/CD pipelines
• Base storage to be extended with lifecycle or logging modules
• Experimentation and learning environments

---

📥 Input Variables

Name	Type	Description
region	string	AWS region where the S3 bucket will be created
bucket_base_name	string	Base name for the bucket (random suffix will be appended)
environment	string	Tag to specify the deployment environment (e.g., dev, staging, prod)

---

📤 Outputs

Name	Description
bucket_name	The full name of the created S3 bucket
bucket_arn	The ARN of the created S3 bucket

---

🚀 Deployment Readiness

• ✅ Compatible with Terraform 1.0+
• ✅ Tested with AWS provider 5.x
• 🧪 Requires IAM permissions for S3 and tagging

---

🛠️ Example Usage

module "s3_bucket" {
source = "git::ssh://git@github.com/archiphire/aws-level-1-modules.git//storage/s3-bucket?ref=v1.0.0"

region = "us-east-1"
bucket_base_name = "archiphire-logs"
environment = "dev"
}

terraform init
terraform plan
terraform apply

or

tofu init
tofu plan
tofu apply

🧹 Cleanup Options

Terraform Destroy (for test environments):

terraform destroy

or

tofu destroy

⚠️ This will delete the bucket and all objects within. For production environments, use manual deletion to avoid unintentional data loss:

aws s3 rb s3://"bucket_name" --force

🛡️ Notes

This is a Level 1 baseline module. For hardened or policy-restricted buckets, use s3-secure-bucket instead.

🔒 Deployment Package Notice

This module is part of the Level 1 AWS License Tier. To access the full deployment package and source code, subscribe to Archiphire.