为何Pulumi提供AWS S3 Bucket与BucketV2两种资源？

背景 #

早期Pulumi的AWS Provider是基于Terraform的AWS Provider构建的。Terraform当初因为S3 API持续演进，加上旧版aws_s3_bucket资源存在设计缺陷（比如属性耦合、默认值不符合AWS新规范），推出了aws_s3_bucket_v2。Pulumi同步跟进了这个变更，所以现在同时提供Bucket和BucketV2两种资源。

实际差异 #

• 资源设计逻辑：Bucket是旧版资源，绑定了不少早期S3的默认行为，比如强制关联版本控制的旧逻辑，部分属性的默认值已经不符合AWS当前最佳实践；BucketV2则完全重构了资源模型，把版本控制、服务器端加密、Object Ownership等特性拆分成独立配置项，避免了旧版的隐含依赖和冲突。
• API调用细节：虽然最终都调用AWS的CreateBucket API，但Bucket会用旧的参数处理逻辑，可能包含一些过时配置；BucketV2则适配了AWS最新的API规范，支持S3新特性，比如Bucket Keys、精细权限控制等。
• 属性与输出：BucketV2的输出属性更直接，比如直接返回ARN、域名等常用值，不需要额外计算；而且对属性的校验更严格，会阻止使用AWS已废弃的参数。

为何S3资源有大量V2变体 #

核心原因有两个：

1. AWS API的迭代：S3这些年一直在更新API，新增了很多特性（比如Object Ownership、默认加密的新选项），旧版资源模型没法很好兼容这些新功能，强行修改旧资源会引发兼容性问题，所以推出V2版本重新适配。
2. 上游Terraform的影响：Pulumi的AWS Provider大部分逻辑继承自Terraform的Provider SDK，Terraform为解决旧资源的设计缺陷（比如属性耦合导致的配置冲突），推出了V2系列资源，Pulumi随之同步更新，保证用户在两个工具间迁移时体验一致。

常见疑问解答 #

• 是AWS API更新导致Pulumi推出V2吗？：是，但不全是。AWS API演进是核心驱动，同时也是为了修复旧版Bucket资源的设计问题，比如属性耦合引发的配置矛盾。
• 是否源自Terraform并沿用？：没错。Pulumi的AWS Provider基于Terraform的SDK构建，所以Terraform对S3资源的重构会同步到Pulumi中。
• 二者用不同API创建相同存储桶？：底层最终都是调用AWS的CreateBucket API，但参数处理逻辑不一样。BucketV2会用符合当前AWS最佳实践的参数，比如默认设置正确的Object Ownership，而Bucket可能保留旧的默认值。
• BucketV2会取代Bucket吗？：是的，官方现在明确推荐用BucketV2，它更适配AWS的最新特性，适合新项目使用。
• Bucket会被弃用吗？：目前官方还没给出明确的弃用时间表，但已经不再推荐使用。未来随着AWS旧API逐步淘汰，Bucket资源大概率会被标记为弃用，最终移除。

内容的提问来源于stack exchange，提问作者Diogo Melo