Jenkins流水线执行docker-compose时遇权限拒绝及配置文件缺失问题

看起来你在Jenkins流水线里运行docker-compose时碰到了权限相关的报错，结合你给出的日志信息，我来帮你一步步排查解决：

1. 核心问题：Jenkins用户没有Docker执行权限 #

Jenkins默认用jenkins系统用户运行，这个用户大概率没被加入docker用户组，导致执行Docker命令时触发Permission denied错误。解决步骤如下：

• 登录到Jenkins所在的服务器，执行命令把jenkins用户加入docker组：

  sudo usermod -aG docker jenkins
  

• 重启Jenkins服务，让用户组的变更生效：

  sudo systemctl restart jenkins
  

• 验证权限是否生效：可以在流水线里临时加个测试步骤，比如：

  sh 'docker --version'
  

  如果能正常输出版本信息，说明权限问题已经解决了。

2. 处理Docker认证配置缺失的警告（按需处理） #

日志里提到找不到Docker配置文件（/var/lib/jenkins/.docker/config.json），这个警告本身不会导致流水线失败，但如果你的docker-compose.yml里用到了私有镜像仓库的镜像，后续拉取镜像时可能会失败。处理方式：

• 先在Jenkins服务器上创建Docker配置目录并设置权限：

  sudo mkdir -p /var/lib/jenkins/.docker
  sudo chown jenkins:jenkins /var/lib/jenkins/.docker
  

• 如果你本地已经有Docker登录后的配置文件（一般在~/.docker/config.json），可以复制到jenkins用户的目录下：

  sudo cp ~/.docker/config.json /var/lib/jenkins/.docker/
  sudo chown jenkins:jenkins /var/lib/jenkins/.docker/config.json
  

  或者直接切换到jenkins用户，用docker login命令登录你的镜像仓库：

  sudo su - jenkins
  docker login <你的镜像仓库地址>
  

3. 可选：优化流水线脚本 #

可以在流水线的准备阶段提前验证Docker环境，避免后续执行到Build阶段才报错：

node { 
  stage ('Prepare Environment') { 
    checkout scm 
    sh 'npm install' 
    // 提前验证Docker权限和环境
    sh 'docker info'
  } 
  stage('Build') { 
    sh 'docker-compose --verbose up -d' 
  } 
}

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