S3 Lifecycle Expire

📦 Overview

This Terraform module applies an Amazon S3 lifecycle rule to automatically expire (delete) objects after a user-defined number of days.

It’s ideal for managing logs, temporary files, or datasets with strict data retention timelines.

---

✅ Key Features

• Deletes S3 objects automatically after a specified number of days
• Supports optional prefix filtering for targeted expiration
• Enforces data lifecycle compliance and reduces storage costs
• No manual cleanup required after deployment

---

💼 Use Cases

• Auto-deletion of application logs or debug files
• Cleanup of temporary assets in dev or staging buckets
• Enforcing compliance with retention policies (e.g., 90-day log expiry)
• Lifecycle automation for ephemeral cloud data

---

📥 Input Variables

Name	Type	Description
region	string	AWS region where the S3 bucket is located
bucket_name	string	Name of the existing S3 bucket to apply the rule to
expiration_days	number	Number of days after which objects should be expired (deleted)
prefix_filter	string	(Optional) Prefix to target specific objects (e.g., "temp/")
environment	string	Tag to specify the deployment environment (e.g., dev, staging, prod)

---

📤 Outputs

Name	Description
bucket_name	The name of the S3 bucket with the lifecycle rule
rule_id	The ID of the applied expiration lifecycle rule

---

🚀 Deployment Readiness

• ✅ Compatible with Terraform 1.0+
• ✅ Tested with AWS provider 5.x
• 🧪 Requires an existing S3 bucket and S3:PutLifecycleConfiguration permission

---

🛠️ Example Usage

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

  region          = "us-east-1"
  bucket_name     = "archiphire-logs"
  expiration_days = 90
  prefix_filter   = "temp/"
  environment     = "prod"
}

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 remove only the lifecycle expiration rule. The bucket and any existing objects will remain intact unless manually removed.

🛡️ Notes

This is a Level 1 lifecycle automation module built for modular integration. For enhanced data control and cost optimization, consider pairing with:

s3-lifecycle-to-ia s3-access-logging

🔒 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.