Jenkins执行docker-compose报Permission Denied问题求助

可能的原因及解决步骤 #

• 检查docker-compose的执行权限
  先定位docker-compose的安装路径：

  which docker-compose
  

  查看该文件的权限详情：

  ls -l $(which docker-compose)
  

  如果输出中没有x标识（执行权限），给文件添加执行权限：

  sudo chmod +x $(which docker-compose)
  

• 确认Jenkins用户的PATH包含docker-compose路径
  在Jenkins流水线中执行echo $PATH，查看输出里是否包含docker-compose所在的目录（比如/usr/local/bin）。如果没有，有两种处理方式：

  1. 调用docker-compose时使用绝对路径，例如：

     /usr/local/bin/docker-compose build
     

  2. 在流水线脚本开头添加PATH配置：

     export PATH=$PATH:/usr/local/bin
     

• 检查docker-compose的安装归属
  如果docker-compose是通过pip安装在用户私有目录下（比如~/.local/bin），Jenkins用户可能无法访问该路径。可以重新将docker-compose安装到系统级目录，或者把私有目录下的bin路径添加到Jenkins的PATH中。

• 直接验证Jenkins用户权限
  在Jenkins服务器上切换到jenkins用户，手动执行docker-compose命令排查：

  su - jenkins
  docker-compose --version
  

  如果这里也报错，说明是Jenkins用户本身没有权限访问docker-compose，按照前面的步骤调整权限或路径即可。

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