使用Jenkins搭建部署流水线时如何生成CodeDeploy所需的appspec.yml

appspec.yml是AWS CodeDeploy执行部署时的唯一强制配置文件，你之前理解的「直接解压S3压缩包到服务器」只是部署流程中的一个环节，CodeDeploy需要通过这个文件明确全流程的所有规则，核心作用包括：

• 定义文件映射规则：明确压缩包内的哪些文件/目录需要部署到目标实例的对应路径，避免全量解压覆盖服务器上的其他非部署文件
• 配置文件权限：指定部署完成后文件、目录的所属用户、用户组和读写权限，避免应用因权限异常无法启动
• 声明生命周期钩子：CodeDeploy的部署流程分为BeforeInstall、AfterInstall、ApplicationStart、ValidateService等多个阶段，你可以在对应阶段指定要执行的自定义脚本，比如停止旧服务、安装依赖、启动新服务、健康检查等，没有这部分配置CodeDeploy解压完代码后不知道怎么完成后续部署动作
• 适配部署场景：针对EC2/本地服务器、Lambda、ECS三种不同的部署目标，appspec.yml会对应不同的配置结构，自动适配对应场景的部署逻辑

这个文件不需要复杂的生成工具，直接根据你的部署场景套对应模板即可，只需要放在代码仓库根目录，Jenkins构建时和业务代码一起打进压缩包上传到S3，CodeDeploy会自动识别压缩包根目录下的该配置文件。

最简EC2静态资源部署示例（无自定义脚本） #

version: 0.0
os: linux
files:
  - source: /build # 压缩包内待部署的静态资源目录，可根据实际情况修改
    destination: /usr/share/nginx/html # 目标实例上的部署路径，可根据实际情况修改

完整EC2后端服务部署示例 #

version: 0.0
os: linux
files:
  - source: /
    destination: /opt/my-service
permissions:
  - object: /opt/my-service
    pattern: "**"
    owner: appuser
    group: appuser
    mode: 644
    type:
      - file
  - object: /opt/my-service
    pattern: "**/*/"
    owner: appuser
    group: appuser
    mode: 755
    type:
      - directory
hooks:
  BeforeInstall:
    - location: scripts/stop_old_service.sh
      timeout: 300
      runas: root
  AfterInstall:
    - location: scripts/install_dependencies.sh
      timeout: 600
      runas: appuser
  ApplicationStart:
    - location: scripts/start_new_service.sh
      timeout: 300
      runas: root
  ValidateService:
    - location: scripts/health_check.sh
      timeout: 300
      runas: appuser

如果不需要执行自定义脚本，直接删除hooks块即可正常使用。

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