容器内运行的Jenkins执行Docker构建时提示docker命令不存在如何解决
问题根源
报错的核心原因是Jenkins容器内部没有安装Docker客户端二进制文件。你挂载/var/run/docker.sock仅能让容器获得访问宿主机Docker daemon服务的权限,但缺少客户端可执行文件的情况下仍然无法调用docker命令。
可行解决方法
方法1:挂载宿主机Docker客户端到容器(最快生效)
直接将宿主机上的Docker二进制文件和依赖库挂载到Jenkins容器中,不需要修改镜像,和宿主机Docker版本完全兼容。
修改你的Jenkins启动命令,新增对应挂载参数即可:
docker run --detach --publish 8080:8080 -u 0 \ --volume jenkins_volume:/var/jenkins_home \ --volume apps:/apps \ --volume /var/run/docker.sock:/var/run/docker.sock \ --volume /usr/bin/docker:/usr/bin/docker \ --volume /usr/lib/x86_64-linux-gnu/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7 \ --name jenkins jenkins/jenkins
方法2:构建预装Docker客户端的自定义Jenkins镜像
如果需要更高的可移植性,可以基于官方Jenkins镜像做自定义构建,提前预装Docker客户端:
- 编写如下Dockerfile:
FROM jenkins/jenkins:latest USER root # 安装Docker客户端 RUN apt-get update && apt-get install -y ca-certificates curl gnupg lsb-release \ && 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 \ && rm -rf /var/lib/apt/lists/* USER jenkins
- 构建镜像:
docker build -t custom-jenkins . - 使用自定义镜像启动Jenkins容器,仍然保留
/var/run/docker.sock的挂载参数即可。
验证方式
容器启动后进入容器内部执行docker version,如果能正常输出客户端和服务端版本信息,说明配置生效,再运行Pipeline就不会出现找不到docker命令的报错。
内容的提问来源于stack exchange,提问作者Alex Bran
相关产品推荐
相关产品推荐

