首次配置AWS CodeDeploy出现部署事件不运行问题求助

故障原因及排查解决步骤 #

1. CodeDeploy Agent运行异常 #

即使已经安装Agent，未启动、启动失败都会导致部署任务无响应：

• 执行命令检查Agent运行状态：sudo systemctl status codedeploy-agent
• 若状态为停止，执行启动命令：sudo systemctl start codedeploy-agent，并设置开机自启：sudo systemctl enable codedeploy-agent
• 若启动失败，查看Agent日志定位问题：日志路径为/var/log/aws/codedeploy-agent/codedeploy-agent.log

2. IAM权限配置错误 #

• 确认EC2实例已正确绑定你配置的IAM实例配置文件（Instance Profile），仅创建角色未绑定到实例不会生效
• 确认IAM策略已包含部署包所在S3桶的读权限，EC2实例需要拉取S3上的部署包才能执行部署
• 确认信任关系配置正确，信任主体应为ec2.amazonaws.com

3. 网络连通性问题 #

• 确认EC2实例安全组出站规则开放443端口，允许访问CodeDeploy服务、S3服务的公网端点
• 若EC2部署在私有子网，确认已配置NAT网关或CodeDeploy、S3的VPC端点，保障出网连通性

4. 部署配置与脚本问题 #

• 确认stop_server.sh文件拥有可执行权限，打包部署包前需给脚本添加执行权限：chmod +x scripts/stop_server.sh
• 空白脚本建议添加shebang声明，在文件首行增加#!/bin/bash，避免执行时报错
• 确认部署包根目录下存在scripts/stop_server.sh路径，路径不匹配会导致钩子执行失败卡住

5. 部署组实例匹配失败 #

• 确认CodeDeploy部署组配置的实例标签，与EC2实例的标签完全一致（键、值的大小写、空格均需匹配），标签不匹配会导致CodeDeploy找不到目标实例，部署无执行动作

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