创建基于Maven项目的Jenkins Pipeline：已安装Docker集成插件仍出现Docker错误

Hey，我之前搭建Maven项目的Jenkins Pipeline时也踩过一模一样的Docker坑——明明装了集成插件，还是各种报错。给你分享几个亲测有效的排查方向，一步步来应该能解决：

这是最容易忽略的点！不管你的Pipeline跑在Jenkins master还是slave节点上，先登录到节点机器上手动验证：

• 执行docker ps或者docker version，看看Docker服务是不是正常运行的，有没有报错。
• 重点检查权限：如果执行Docker命令需要sudo，那Jenkins用户大概率没加入docker用户组。执行这个命令修复：

  sudo usermod -aG docker jenkins
  

  之后必须重启Jenkins服务和Docker服务，否则权限变更不会生效。

很多时候是脚本里的小错误导致的：

• 如果用docker.build构建镜像，要确认Dockerfile的路径是否正确。比如你的Dockerfile在docker子目录里，就得这么写：

  docker.build("my-maven-app:latest", "-f docker/Dockerfile .")
  

  要是漏了-f指定路径，Jenkins会默认找项目根目录的Dockerfile，找不到就会报错。
• 如果是拉取私有镜像，要确保Jenkins里已经配置了对应镜像仓库的凭证，并且在Pipeline里引用了这个凭证，比如：

  docker.withRegistry('https://your-private-registry.com', 'registry-credential-id') {
      docker.image('private-image:latest').pull()
  }
  

装了插件不代表配置对了：

• 进入Jenkins的「全局工具配置」，找到Docker的配置项，确认Docker的安装路径（比如/usr/bin/docker）是正确的。如果是用远程Docker节点，要检查TCP连接的地址、端口，还有凭证是否配置正确，同时确保远程节点的Docker服务已经开启了远程访问权限。
• 另外，有些Docker插件需要重启Jenkins才能完全生效，你装完插件后有没有重启过？可以试试重启Jenkins再重新跑Pipeline。

别只看表面的错误提示，把Pipeline的日志开成全量输出，找具体的错误关键词：

• 如果看到permission denied，那就是权限问题，回到第一步解决。
• 如果看到Cannot connect to the Docker daemon，要么是Docker服务没启动，要么是Jenkins节点和Docker daemon的连接配置有问题（比如远程节点的端口没开）。
• 如果是用Maven的Docker插件（比如docker-maven-plugin）构建镜像，还要检查Maven的settings.xml里有没有配置好镜像仓库的地址、凭证，以及插件的相关参数。

我当时的问题就是Jenkins用户没加入docker组，执行命令时权限不够，加组重启后就搞定了。希望这些步骤能帮你解决问题！

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