Docker容器中Jenkins执行docker命令提示not found问题修复请求

1. 确保Jenkins镜像完整安装Docker CLI #

检查你的Jenkins Dockerfile，必须完整安装Docker CLI组件，以下是基于官方Jenkins镜像的标准安装示例：

FROM jenkins/jenkins:lts-jdk17

USER root

# 安装Docker CLI依赖与二进制文件
RUN apt-get update && apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg2 \
    software-properties-common && \
    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
    $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null && \
    apt-get update && apt-get install -y docker-ce-cli

# 将jenkins用户加入docker组，避免用root运行容器
RUN usermod -aG docker jenkins

USER jenkins

2. 验证Docker Socket挂载与权限配置 #

检查docker-compose.yml的挂载配置，Windows环境下的sock.raw挂载路径是正确的，但要确保容器内用户有权限访问：

version: '3.8'
services:
  jenkins:
    build: .
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
      - /var/run/docker.sock.raw:/var/run/docker.sock
    environment:
      - DOCKER_HOST=unix:///var/run/docker.sock

修改配置后，重新构建镜像并重启容器。

3. 手动验证容器内Docker命令可用性 #

进入Jenkins容器，直接执行命令确认CLI是否正常：

# 获取Jenkins容器ID
docker ps
# 进入容器
docker exec -it <jenkins-container-id> bash
# 验证命令
docker --version

如果能正常输出版本信息，说明容器内Docker CLI安装无误，问题出在流水线环境配置。

4. 排查Jenkins流水线的环境变量 #

在Jenkinsfile中先打印PATH并定位docker命令，确认路径是否在环境变量中：

pipeline {
    agent any
    stages {
        stage('Debug Docker Path') {
            steps {
                sh 'echo $PATH'
                sh 'which docker'
            }
        }
        stage('Build Image') {
            steps {
                # 若which docker返回空，手动指定路径执行
                sh '/usr/bin/docker build -t noyandocker/flightsearchapi-jenkins:latest .'
            }
        }
    }
}

5. 使用Jenkins Docker Pipeline插件替代原生Shell命令 #

如果已安装Docker Pipeline插件，推荐使用插件提供的方法构建镜像，自动处理环境依赖：

pipeline {
    agent any
    stages {
        stage('Build Docker Image') {
            steps {
                script {
                    docker.build('noyandocker/flightsearchapi-jenkins:latest')
                }
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu