本地Jenkins执行Docker命令报错：docker: command not found 求助

首先咱们先拆解下你遇到的两个核心问题：Docker命令找不到，还有docker build命令的语法错误，一个个来解决：

一、先修正docker build的语法错误 #

你当前写的命令是：

docker build -f myapp-web:latest .

这里的-f参数是用来指定自定义Dockerfile的路径的（比如你的Dockerfile不叫默认的Dockerfile，而是Dockerfile.web，才需要用-f Dockerfile.web）。要指定镜像名和标签，应该用-t参数！正确的命令应该是：

docker build -t myapp-web:latest .

这个错误先改了，不然即使Docker命令能找到，构建还是会失败。

二、解决"docker: command not found"的问题 #

这个问题本质是Jenkins运行的agent节点（你用的是agent any，大概率是Jenkins所在的本地节点）的环境变量里没有包含Docker的可执行文件路径，或者Jenkins用户没有权限调用Docker。下面是具体的排查和解决步骤：

1. 确认Docker的安装路径 #

在你的本地终端里执行which docker，会得到Docker的绝对路径，比如Mac上一般是/usr/local/bin/docker。

2. 检查Jenkins节点的PATH环境变量 #

在你的Pipeline里先加一个临时步骤打印当前的PATH，看看有没有包含上面的Docker路径：

stage('Debug PATH') {
    steps {
        sh 'echo $PATH'
    }
}

运行后对比本地终端的echo $PATH输出，如果Jenkins的PATH里没有Docker的路径，就需要手动添加：

• 方法一：在Jenkins的节点配置里（Manage Jenkins → Manage Nodes → 点击你的本地节点 → Configure），找到Node Properties，勾选Environment variables，添加变量PATH，值为$PATH:/usr/local/bin（把你查到的Docker路径的目录加进去）。
• 方法二：在Pipeline的Build Image阶段里，临时把路径加到PATH中：

stage('Build Image') {
    steps {
        script {
            sh 'export PATH=$PATH:/usr/local/bin && docker build -t myapp-web:latest .'
        }
    }
}

3. 确保Jenkins用户有权限执行Docker命令 #

Mac上Jenkins默认是以jenkins用户运行的，需要让这个用户能访问Docker：

• 打开Docker Desktop的设置 → Resources → File Sharing，确保Jenkins的工作目录（比如/Users/Shared/Jenkins/Home/workspace）在共享列表里。
• 另外，在终端执行sudo usermod -aG docker jenkins（如果docker组存在的话），然后重启Jenkins服务。

4. 检查Jenkins Docker插件的配置 #

你说已经安装了Docker Pipeline和Docker插件，还要确认在Manage Jenkins → Global Tool Configuration里配置了Docker：

• 找到Docker部分，点击Add Docker，设置一个名称（比如docker-latest），然后指定Docker的安装路径（就是刚才which docker得到的路径，比如/usr/local/bin/docker）。
• 然后在Pipeline的tools块里添加Docker：

tools {
    maven 'maven_3.6.1'
    jdk 'jdk8'
    docker 'docker-latest' // 对应你在全局配置里的名称
}

这样Jenkins会自动把Docker的路径加入到环境变量中。

把这些步骤做完，应该就能解决命令找不到的问题，同时修正了build命令的语法错误，后续的push步骤也能正常执行了。

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