AWS CodeDeploy部署前未解压文件：S3静态网站部署异常

使用AWS CodePipeline将静态网站部署至S3存储桶，流程已正常运行，但存在问题：构建产物的zip文件在上传至S3前未被解压，最终直接以zip文件形式存入存储桶，不符合静态网站的部署需求。

当前CodeBuild配置如下：

version: 0.2
   phases:
      install:
         runtime-versions:
            nodejs: 16
      pre build:
         commands:
            - echo Installing source NPM dep
            - npm install
      build:
         commands:
            - echo Build started on 'date'
            - npm run build
      post_build:
         commands:
            - zip -r test.zip dist
artifacts:
  files:
     - 'test.zip'

问题原因 #

当前CodeBuild配置中，post_build阶段将构建好的dist目录打包成了test.zip，并且artifacts仅指定该zip文件作为输出产物。这导致CodePipeline传递给部署阶段的是完整的zip包，若部署环节未配置自动解压逻辑，就会直接将zip文件上传至S3。

解决方案 #

方案1：修改CodeBuild配置，直接输出解压后的构建产物（推荐） #

不需要手动打包zip，直接将dist目录下的所有文件作为CodeBuild的输出产物，这样部署阶段能直接获取到静态文件并上传至S3。修改后的buildspec.yml如下：

version: 0.2
phases:
  install:
    runtime-versions:
      nodejs: 16
  pre_build:
    commands:
      - echo Installing source NPM dependencies
      - npm install
  build:
    commands:
      - echo Build started on `date`
      - npm run build
artifacts:
  base-directory: 'dist'  # 指定构建产物的根目录为dist
  files:
    - '**/*'  # 包含dist下所有文件及子目录

说明：移除post_build阶段的zip命令，通过base-directory指定dist为产物根目录，files字段用**/*匹配目录下所有内容，CodeBuild会自动将这些文件作为artifacts传递给后续部署步骤。

方案2：保留zip打包，配置部署阶段自动解压（不推荐） #

若坚持要保留zip打包流程，需确保部署环节配置了解压选项：

• 检查Pipeline的部署动作：静态网站部署到S3建议使用Amazon S3部署动作，而非CodeDeploy（CodeDeploy更适用于EC2等实例部署）
• 在S3部署动作的配置中，勾选「解压文件后部署」（对应英文选项Extract file before deploy）
• 确认S3目标路径为存储桶的网站根目录，避免zip包被错误上传

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