Jenkins Pipeline部署Tomcat时出现权限拒绝错误求助

问题分析 #

手动执行cp命令能成功，但Jenkins流水线里失败，核心原因是Jenkins默认用jenkins系统用户执行任务，这个用户没有写入/opt/apache-tomcat-9.0.80/webapps/目录的权限。你之前执行的chown -R jenkins /var/lib/jenkins/workspace只处理了源文件所在的工作区权限，没解决目标目录的权限问题。

解决方案 #

方案1：给Jenkins用户配置免密sudo执行cp命令 #

如果不想修改Tomcat目录权限，可以让jenkins用户无需输入密码就能用sudo执行cp：

1. 编辑sudoers配置文件：

   sudo visudo
   

2. 在文件末尾添加一行（可通过which cp确认cp的实际路径）：

   jenkins ALL=(ALL) NOPASSWD: /usr/bin/cp
   

3. 修改流水线的sh步骤，加上sudo：

   stage('Copy WAR to Tomcat') {
       steps {
           script {
               sh "sudo cp /var/lib/jenkins/workspace/myporject/target/petclinic.war /opt/apache-tomcat-9.0.80/webapps/"
           }
       }
   }
   

方案2：修改Tomcat目录权限，让Jenkins用户可写入 #

直接给jenkins用户赋予Tomcat webapps目录的写入权限：

1. 将jenkins用户加入Tomcat所属用户组（可通过ls -l /opt/apache-tomcat-9.0.80/查看Tomcat的所属组，通常为tomcat）：

   sudo usermod -aG tomcat jenkins
   

2. 给webapps目录添加组写入权限：

   sudo chmod -R g+w /opt/apache-tomcat-9.0.80/webapps/
   

3. 重启Jenkins让组权限生效：

   sudo systemctl restart jenkins
   

之后流水线里原来的cp命令就能正常执行了。

方案3：用Tomcat管理API部署（更推荐） #

直接操作文件系统不是最规范的部署方式，建议用Tomcat自带的管理API来部署WAR包：

1. 先在Tomcat的conf/tomcat-users.xml里添加一个拥有manager-script权限的用户：

   <user username="deploy-user" password="your-password" roles="manager-script"/>
   

2. 修改流水线阶段，用curl调用部署接口：

   stage('Deploy to Tomcat') {
       steps {
           script {
               sh '''
                   curl -u deploy-user:your-password -T /var/lib/jenkins/workspace/myporject/target/petclinic.war \
                   http://localhost:8080/manager/text/deploy?path=/petclinic&update=true
               '''
           }
       }
   }
   

这种方式不需要处理文件系统权限，还能实现更灵活的部署控制（比如更新已存在的应用）。

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