如何在 S3 存储桶上启用版本控制:开发、预发布、生产
导出 PDF
浅色排版、带版权水印,可在打印窗口另存为 PDF

摘要
- 整个功能只需一次调用:
aws s3api put-bucket-versioning --bucket <name> --versioning-configuration Status=Enabled。真正困难的部分都在随后配置的生命周期规则里。 - 版本控制是单向的。你可以暂停它,但永远不能禁用它——而暂停的存储桶会保留所有旧版本,同时用
null版本 ID 写入新对象。 - 开发、预发布和生产环境应只在两个地方不同:非当前版本保留多久,以及谁有权切换该设置。而不是版本控制是否开启。
版本控制有三种状态,其中两种会花钱
存储桶要么未启用版本控制(从未启用),要么已启用,要么已暂停。第一种情况下,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"
推荐
推荐服务 · 一站式办理
由云市场认证服务商承接,下单后按需沟通交付。
腾讯云市场
NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
各服务器环境 SSL 证书安装配置,教程看不懂?直接交给服务商办。
查看服务 →
阿里云市场
代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名 DV
单域名 DV 证书代购,主流品牌可选,比官网渠道更省。
查看服务 →
阿里云市场
Wildcard 通配符 SSL 证书安装部署续费申请
一张通配符保护全部一级子域名,含安装部署与续费服务。
查看服务 →
腾讯云市场
SSL证书申请+配置 · 宝塔/WDCP 面板全站加密(OV 企业单域名等规格)
付费证书云上签发、一键部署到宝塔/WDCP 站点,OV 企业单域名可选。
查看服务 →
阿里云市场
企业级 EV / OV 证书与代码、驱动签名服务
SSL EV/OV 证书 + 软件代码签名、驱动签名,企业级一站式办理。
查看服务 →
阿里云市场
GlobalSign 代码签名证书服务(OV/EV 企业版)
对 exe/dll/驱动等软件做数字签名,消除「未知发布者」警告,企业版含申请代办。
查看服务 →
阿里云市场
HTTPS证书申请 · SSL证书安装部署 · 证书续费
证书过期、部署报错、需要续期?申请+部署+续费一站式办理。
查看服务 →
发表回复