Jenkins CodeDeploy插件部署失败及npm依赖警告问题咨询

我来帮你一步步排查这个问题，咱们从你提到的npm警告和部分服务部署失败的核心问题入手：

这个警告其实是可选依赖不兼容导致的——fsevents是专门给macOS（darwin系统）设计的文件监听工具，而你的EC2是Linux系统，npm会自动跳过这个可选依赖，它本身不会导致部署失败，但看着闹心可以这么处理：

• 如果你用的是npm 5及以上版本，直接在npm install命令里加--no-optional参数，跳过所有可选依赖的安装：npm install --no-optional
• 或者升级fsevents到支持跨平台的v2+版本（如果你的项目确实需要用到这个包的话）
• 要是你不在意这个警告，完全可以忽略它，毕竟只是提示跳过了非必需的依赖，不影响服务功能

既然有部分服务成功，说明Jenkins→S3→CodeDeploy的整体链路是通的，问题大概率出在单个服务的部署脚本、权限或依赖安装环节，按以下步骤排查：

2.1 查看CodeDeploy的详细部署日志 #

CodeDeploy在EC2实例上的日志路径是：/opt/codedeploy-agent/deployment-root/<deployment-group-id>/<deployment-id>/logs/scripts.log
这里会记录每个部署钩子（比如BeforeInstall、AfterInstall、ApplicationStart）的执行细节，失败的服务肯定会在这里输出具体错误——比如npm安装失败、脚本执行权限不足、端口被占用等，这是排查的核心依据。

2.2 检查/tmp目录权限的影响 #

你提到/tmp权限是700，这个权限意味着只有/tmp的所有者（一般是root）能读写，而CodeDeploy Agent通常是以codedeploy-agent用户运行的，如果你的部署脚本需要在/tmp下生成临时文件（比如npm缓存、解压包），就会因为权限不足失败：

• 可以临时把/tmp权限改成755试试：chmod 755 /tmp，然后重新部署失败的服务，如果成功了，说明就是权限问题
• 或者在部署脚本里指定npm缓存到其他有读写权限的路径，比如：npm install --cache /home/ec2-user/.npm-cache

2.3 对比成功与失败服务的差异 #

把成功和失败服务的以下内容做对比，很容易找到问题：

• appspec.yml文件：检查钩子脚本的路径、执行用户、命令是否正确，比如失败服务的AfterStart脚本是不是写错了路径
• package.json：看看失败服务有没有需要编译的依赖（比如node-gyp），而EC2上没安装gcc、python等编译环境
• 部署脚本：检查有没有硬编码的路径（比如只在某个实例存在的路径），或者有没有需要sudo权限的命令但没加sudo

虽然部分服务成功，但还是可以确认下Jenkins的CodeDeploy插件配置：

• 确保上传到S3的zip包包含了所有必要文件（不建议把node_modules打包进去，应该在EC2上现场安装）
• 检查Jenkins拉取BitBucket代码时，有没有被.gitignore排除了部署需要的配置文件

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