如何在Node应用中配置用于Veracode扫描的Jenkins任务？——AWS EC2实例上freestyle job提示zip文件未找到的问题排查

针对你遇到的Veracode扫描任务中zip文件找不到的问题，我来梳理下可能的原因，以及当前实现方式的合理性和优化建议：

一、Zip文件未找到的常见原因 #

• 工作目录路径不匹配：Jenkins Freestyle Job的默认工作目录是${WORKSPACE}，如果你的Shell脚本生成zip的路径不在这个目录下，或者构建后步骤中指定的文件路径有误，就会触发“文件未找到”的错误。比如脚本里用了相对路径但实际生成到了其他位置，或者绝对路径拼写错误。
• Shell脚本执行失败：可能存在以下几种情况：
  • EC2实例未安装zip命令（AWS默认镜像可能没有预装，比如Amazon Linux需要手动执行sudo yum install zip -y）；
  • 压缩命令参数错误，比如未正确指定要压缩的目录，或者遇到权限问题无法读取文件；
  • Git拉取的代码目录为空，导致压缩命令无法生成有效zip文件。
    你可以查看Jenkins构建日志中Shell脚本的执行输出，里面会有明确的错误提示。
• 步骤顺序错误：如果你的Shell脚本是放在构建后步骤中执行，而Veracode上传步骤也在构建后，那上传时zip文件还没生成。正确的顺序应该是：先在构建步骤中执行Shell脚本生成zip，再在构建后步骤中执行上传操作。
• 文件权限问题：Shell脚本生成的zip文件可能被设置了Jenkins进程（通常以jenkins用户运行）无法读取的权限，不过这种情况一般会提示权限错误，而非“文件未找到”，但也可以排查下。

二、当前实现方式的合理性与优化建议 #

你的思路是可行的，但有几个可以优化的点，能减少出错概率并提升效率：

1. 避免压缩整个Git仓库：Git仓库中的.git目录、依赖目录（如node_modules、target）等不需要上传到Veracode，不仅会增加zip体积，还可能干扰扫描结果。建议在压缩命令中排除这些目录，比如：

   zip -r my-app.zip . -x ".git/*" "node_modules/*" "target/*"
   

2. 优先使用Veracode Jenkins插件的原生功能：Veracode插件本身支持直接扫描工作目录或指定文件，无需手动压缩。你可以在Freestyle Job的构建步骤中添加「Veracode Static Analysis」步骤，配置好API凭证后，选择扫描工作目录或指定文件路径，插件会自动完成打包、上传和扫描流程，比手动写Shell脚本更可靠。

3. 添加日志排查步骤：在Shell脚本中加入pwd和ls命令，输出当前工作目录和文件列表，方便确认zip文件是否生成在正确位置：

   # 打印当前工作目录
   pwd
   # 列出目录下所有文件
   ls -la
   # 执行压缩命令
   zip -r my-app.zip . -x ".git/*"
   # 确认zip文件是否生成
   ls -la my-app.zip
   

总结 #

先排查Shell脚本的执行日志，确认zip文件是否生成、路径是否正确，同时调整步骤顺序确保压缩在上传前完成。如果想简化流程，建议直接使用Veracode插件的原生扫描功能，减少手动操作的出错点。

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