在打印窗口把「目标」选为「另存为 PDF」即可保存,页面已带 awsgood.com 版权水印。 返回原文

www.awsgood.com

如何在 S3 存储桶上启用版本控制:开发、预发布、生产

2026-11-21 AWS Config 约 5 分钟

摘要

版本控制有三种状态,其中两种会花钱

存储桶要么未启用版本控制(从未启用),要么已启用,要么已暂停。第一种情况下,get-bucket-versioning 会返回 {},这一点常让人困惑——空结果不是错误,它表示“从创建起就未启用”。

aws s3api get-bucket-versioning --bucket acme-dev-assets --region us-east-1


```json
{}


一旦启用版本控制,每次 `PutObject` 都会获得一个版本 ID,并且每个副本都会按完整大小计费。S3 不存储增量。把一个 500 MB 的夜间导出文件覆盖 20 次,你存储的是 10 GB,而不是 500 MB。我曾见过一个存储桶在七周内从 12 GB 涨到 310 GB,因为一个同步任务每晚重写同样的 40 个对象,而没有人写过 `NoncurrentVersionExpiration` 规则。在 us-east-1 的 Standard 存储类别下,这大约是每月每 GB $0.023——请按你所在区域核对——乘以 300 GB 你永远不会读取的垃圾数据。

暂停版本控制是人们以为自己想要的“关闭开关”。它会停止创建新版本,但所有现有版本都会保留并继续计费。新写入会落在版本 ID `null` 下,如果此前已经存在一个 `null` 版本,这次写入会覆盖它。除非删除每一个版本以及存储桶本身,否则你无法回到真正未启用版本控制的存储桶。

## 真正有差异的按环境设置

下面是我用于三账户设置的差异表。版本控制*状态*在所有环境中都相同;不同的是保留策略。

| 设置 | 开发 | 预发布 | 生产 |
|---|---|---|---|
| 版本控制状态 | 已启用 | 已启用 | 已启用 |
| `NoncurrentVersionExpiration` | 7 天 | 30 天 | 90 天 |
| 保留的 `NewerNoncurrentVersions` | 3 | 10 | 30 |
| 非当前版本转换为 Glacier Instant Retrieval | 无 | 14 天后 | 30 天后 |
| `AbortIncompleteMultipartUpload` | 1 天 | 3 天 | 7 天 |
| `ExpiredObjectDeleteMarker` 清理 | 开启 | 关闭 | 关闭 |
| MFA Delete | 关闭 | 关闭 | 受监管存储桶开启 |
| 复制 | 无 | 无 | CRR 到 us-west-2 |
| 谁可以调用 `PutBucketVersioning` | 任何工程师 | 团队负责人 | 仅限紧急访问角色 |

`NewerNoncurrentVersions` 和 `NoncurrentDays` 的组合是大多数人会弄错的地方。版本只有在超过 `NoncurrentDays` *并且*排在新近的 `NewerNoncurrentVersions` 个版本之外后,才有资格过期。这正是你在生产环境想要的行为:周五的一次糟糕部署,不应该因为你上一个可用构建恰好已存在 91 天,就把它挤出保留窗口。

下面是开发环境用的生命周期规则——注意这里激进的删除标记清理,生产环境不会这么做:

```bash
cat > lifecycle-dev.json <<'EOF'
{
  "Rules": [
    {
      "ID": "trim-noncurrent",
      "Status": "Enabled",
      "Filter": { "Prefix": "" },
      "NoncurrentVersionExpiration": { "NoncurrentDays": 7, "NewerNoncurrentVersions": 3 },
      "AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 1 },
      "Expiration": { "ExpiredObjectDeleteMarker": true }
    }
  ]
}
EOF

aws s3api put-bucket-lifecycle-configuration 
  --bucket acme-dev-assets 
  --lifecycle-configuration file://lifecycle-dev.json


`ExpiredObjectDeleteMarker: true` 会移除下面没有任何对象的删除标记。在开发环境中,这能让 `list-object-versions` 保持可读。生产环境我会关掉它,因为有时删除标记是唯一能表明有人删错前缀的线索。

## 复制即用:启用、验证、暂停

CLI 的 `create-bucket` 没有 `--versioning` 标志;它始终是第二次调用。如果你用脚本创建存储桶,顺序很重要——必须先启用版本控制,再附加某些策略或尝试启用 Object Lock。

```bash
# 1. 按环境启用
for b in acme-dev-assets acme-staging-assets acme-prod-assets; do
  aws s3api put-bucket-versioning 
    --bucket "$b" 
    --versioning-configuration Status=Enabled 
    --region us-east-1
done

# 2. 确认(预期为 {"Status": "Enabled"})
aws s3api get-bucket-versioning --bucket acme-prod-assets --region us-east-1

# 3. 确认写入确实带有版本 ID
aws s3api put-object --bucket acme-prod-assets --key probe.txt --body probe.txt
# {"ETag": ""d41d8cd98f00b204e9800998ecf8427e"", "VersionId": "9gGJ8YvX3Kq..._Z"}

# 4. 暂停(仅预发布环境,在迁移窗口期间)
aws s3api put-bucket-versioning 
  --bucket acme-staging-assets 
  --versioning-configuration Status=Suspended


按环境验证清单,按我执行的顺序:

1. `get-bucket-versioning` 返回 `{"Status": "Enabled"}`——不是空,也不是 `Suspended`。
2. 测试 `put-object` 返回真实的 `VersionId`,而不是 `null`。
3. `get-bucket-lifecycle-configuration` 显示该环境预期的 `NoncurrentVersionExpiration` 块。
4. `list-object-versions --prefix <hot prefix>` 显示 `IsLatest: false` 的非当前条目。
5. 在 CloudTrail 中,你这次变更产生的 `PutBucketVersioning` 事件可见,且主体正确——如果之后生命周期规则出了问题,这就是你的审计线索。

有一个值得记住的坑:`aws s3 ls` 和 `aws s3 cp` 不会显示版本 ID。如果脚本需要版本 ID,请使用 `s3api put-object`,而不是 `s3 cp`,否则你会在解析错误工具的输出。

## 让三个账户保持一致:Terraform 变量和 CloudTrail 触发警报

`aws_s3_bucket_versioning` 与存储桶是分开的资源,这是有原因的——AWS 在 provider v4 中专门把它拆分出来,正是为了让版本控制的配置变更显示为独立的 diff,而不是藏在存储桶资源的重写里。

```hcl
locals {
  env_versioning = {
    dev     = { noncurrent_days = 7,  keep_newer = 3 }
    staging = { noncurrent_days = 30, keep_newer = 10 }
    prod    = { noncurrent_days = 90, keep_newer = 30 }
  }
}

resource "aws_s3_bucket_versioning" "assets" {
  bucket = aws_s3_bucket.assets.id
  versioning_configuration {
    status = "Enabled"
  }
}

resource "aws_s3_bucket_lifecycle_configuration" "assets" {
  bucket = aws_s3_bucket.assets.id

  rule {
    id     = "trim-noncurrent"