MacOS High Sierra下Jenkins调用Docker提示‘docker: command not found’求助

这个docker: command not found错误本质上是Jenkins的执行环境无法正常访问Docker命令，核心原因主要有两个：

1. Jenkins运行用户缺少Docker执行权限 #

在macOS上，执行Docker命令需要用户属于docker用户组，但默认情况下Jenkins的运行用户（通常是jenkins）并没有被加入这个组，导致它没有权限调用Docker相关命令。

2. Docker的路径不在Jenkins的环境变量PATH中 #

Docker Desktop在macOS上默认安装路径是/usr/local/bin/docker，但Jenkins进程的默认PATH可能没有包含这个目录，系统自然找不到docker命令。

解决步骤 #

第一步：确认Jenkins的运行用户

打开终端，执行以下命令查看Jenkins进程的所属用户：

ps aux | grep jenkins

通常结果里会显示用户为jenkins。

第二步：将Jenkins用户加入docker组

如果系统中还没有docker用户组，先创建它：

sudo dscl . create /Groups/docker

然后把jenkins用户添加到该组：

sudo dscl . append /Groups/docker GroupMembership jenkins

第三步：确保Docker路径被包含在Jenkins的PATH中

有两种配置方式可选：

• 方法一：通过Jenkins Web界面配置全局环境变量

  1. 进入Jenkins后台，点击「Manage Jenkins」→「Configure System」
  2. 找到「Global properties」区域，勾选「Environment variables」
  3. 添加新变量：
     • 名称：PATH
     • 值：/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin（确保包含/usr/local/bin，这是Docker的默认安装路径）
  4. 保存配置后重启Jenkins。

• 方法二：修改Jenkins的启动配置文件

  1. 打开终端，编辑Jenkins的launchd配置文件：

     sudo nano /Library/LaunchDaemons/org.jenkins-ci.plist
     

  2. 在文件中找到（没有则添加）<key>EnvironmentVariables</key>，然后补充PATH配置：

     <key>EnvironmentVariables</key>
     <dict>
         <key>PATH</key>
         <string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
     </dict>
     

  3. 保存文件后，重启Jenkins服务：

     sudo launchctl stop org.jenkins-ci && sudo launchctl start org.jenkins-ci
     

最后：确认Docker Desktop处于运行状态

确保你的macOS上Docker Desktop是启动状态，Jenkins需要调用本地的Docker守护进程才能正常工作。

完成以上步骤后，重新运行你的Pipeline，应该就能成功执行node --version命令了。

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