如何用Terraform高效部署多仅名称与内容不同的同配置AWS S3桶？

方案选择理由 #

Workspaces的设计初衷是隔离不同环境（如dev/staging/prod）的状态文件，每个workspace对应独立的部署状态，并不适合批量创建同配置的多个资源——用它的话你得逐个切换workspace执行创建，反而增加操作成本。而Modules是Terraform专门用来封装可复用资源模板的机制，完美匹配你这种“同配置、仅名称和内容不同”的多实例场景，只需要写一次核心配置，多次调用传入不同参数即可。

具体实现步骤 #

1. 目录结构 #

采用模块化的分层结构，清晰分离复用模板和实例配置：

terraform-s3-deploy/
├── modules/
│   └── s3-bucket-template/       # 封装好的可复用S3桶模板
│       ├── main.tf
│       ├── variables.tf
│       └── outputs.tf
├── main.tf                       # 模块调用入口
├── variables.tf                  # 全局变量定义
└── terraform.tfvars              # 具体桶的配置参数

2. 编写可复用的S3桶模块 #

modules/s3-bucket-template/variables.tf

定义模块接收的变量，仅保留需要差异化的参数，固定配置直接写在模块里：

variable "bucket_name" {
  type        = string
  description = "唯一的S3桶名称"
}

variable "content_dir" {
  type        = string
  description = "本地待上传内容的目录路径"
}

# 可选：如果需要统一修改区域，可设为变量，否则模块内固定
variable "aws_region" {
  type        = string
  description = "桶所在的AWS区域"
  default     = "us-east-1"
}

modules/s3-bucket-template/main.tf

编写通用的桶创建和内容上传逻辑，这里用fileset批量遍历目录文件，避免逐个写上传资源：

# 创建S3桶，包含所有固定配置
resource "aws_s3_bucket" "main" {
  bucket = var.bucket_name
  region = var.aws_region

  # 示例固定配置：版本控制、默认加密，根据你的实际需求调整
  versioning {
    enabled = true
  }

  server_side_encryption_configuration {
    rule {
      apply_server_side_encryption_by_default {
        sse_algorithm = "AES256"
      }
    }
  }
}

# 批量上传目录下的所有文件（包括子目录）
resource "aws_s3_object" "content_upload" {
  for_each = fileset(var.content_dir, "**")
  bucket   = aws_s3_bucket.main.id
  key      = each.value
  source   = "${var.content_dir}/${each.value}"
  etag     = filemd5("${var.content_dir}/${each.value}") # 用于文件变更检测
}

modules/s3-bucket-template/outputs.tf

输出桶的关键信息，方便后续引用：

output "bucket_arn" {
  type        = string
  description = "S3桶的ARN"
  value       = aws_s3_bucket.main.arn
}

output "bucket_name" {
  type        = string
  description = "S3桶名称"
  value       = aws_s3_bucket.main.bucket
}

3. 根目录配置：批量调用模块 #

variables.tf

定义全局变量，用对象列表来存储所有桶的差异化参数：

variable "s3_bucket_list" {
  type = list(object({
    bucket_name = string
    content_dir = string
  }))
  description = "需要创建的所有S3桶及其对应内容目录的列表"
}

variable "global_aws_region" {
  type        = string
  description = "所有桶统一使用的AWS区域"
  default     = "us-east-1"
}

main.tf

用for_each遍历桶列表，批量调用模块创建实例：

module "s3_buckets" {
  # 用桶名作为唯一键，确保每个实例独立
  for_each = { for bucket in var.s3_bucket_list : bucket.bucket_name => bucket }
  source   = "./modules/s3-bucket-template"

  bucket_name = each.value.bucket_name
  content_dir = each.value.content_dir
  aws_region  = var.global_aws_region
}

terraform.tfvars

填写具体的桶配置，新增/删除桶只需要修改这个文件：

s3_bucket_list = [
  {
    bucket_name = "my-blog-static-files-123"
    content_dir = "./static-content/blog"
  },
  {
    bucket_name = "my-backup-storage-456"
    content_dir = "./backup-files"
  },
  {
    bucket_name = "my-log-archive-789"
    content_dir = "./log-archives"
  }
]

global_aws_region = "us-west-2"

方案优势 #

• 严格遵循DRY原则：所有通用配置只在模块中维护一次，修改时无需重复修改多个资源块
• 配置集中管理：所有桶的差异化参数都在terraform.tfvars中，新增/删除桶只需修改这个文件
• 状态清晰：每个桶对应独立的模块实例，Terraform状态文件会分别跟踪每个桶的状态，便于排查问题

内容的提问来源于stack exchange，提问作者John Skiles Skinner