使用Source.bucket时BucketDeployment不更新文件，如何实现每次部署复制？

问题原因 #

直接使用Source.bucket()指向S3源桶时，CDK无法自动检测桶内文件的修改——它只会在部署配置变更或源路径的内容哈希变化时触发同步操作，导致源文件更新后部署不生效。

解决方法 #

1. 手动指定sourceHash参数强制触发同步 #

通过给BucketDeployment添加sourceHash参数，每次部署时更新这个值（比如版本号、时间戳或基于源文件内容生成的哈希），让CDK认为部署配置发生了变化，从而重新执行文件同步。

示例代码：

import * as s3deploy from 'aws-cdk-lib/aws-s3-deployment';
import * as s3 from 'aws-cdk-lib/aws-s3';

// 假设sourceBucket和destBucket是已定义的S3桶资源
new s3deploy.BucketDeployment(this, 'SyncS3Files', {
  sources: [s3deploy.Source.bucket(sourceBucket)],
  destinationBucket: destBucket,
  sourceHash: 'v20240520', // 每次部署更新这个值，比如用当前日期或版本号
});

2. 针对特定文件/前缀同步（可选） #

如果只需要同步源桶中的特定文件或前缀，可以在Source.bucket()中指定objectKey或prefix，结合sourceHash更精准地控制同步范围：

new s3deploy.BucketDeployment(this, 'SyncSpecificFiles', {
  sources: [s3deploy.Source.bucket(sourceBucket, { prefix: 'assets/' })],
  destinationBucket: destBucket,
  sourceHash: 'assets-v1.1',
});

3. 禁用文件跳过逻辑（不推荐） #

通过设置exclude为空数组并启用overwrite: true，强制覆盖所有目标文件，但这种方法会同步所有文件，可能增加不必要的开销：

new s3deploy.BucketDeployment(this, 'ForceOverwrite', {
  sources: [s3deploy.Source.bucket(sourceBucket)],
  destinationBucket: destBucket,
  overwrite: true,
  exclude: [], // 确保不排除任何文件
});

注意：即使启用overwrite: true，CDK仍可能依赖内容哈希判断是否需要同步，因此最可靠的方式还是使用sourceHash强制触发。

内容的提问来源于stack exchange，提问作者Dark Matter