Docker部署Jenkins调用宿主机Docker失败及功能可行性咨询

为什么挂载/var/run/docker.sock仍提示docker: not found？ #

挂载/var/run/docker.sock只是让Jenkins容器能连接到宿主机的Docker守护进程（daemon），但Jenkins容器内部没有安装Docker命令行工具（CLI），所以执行docker或docker compose时会提示找不到命令。

解决方法 #

方法1：自定义Jenkins镜像（推荐，持久有效） #

基于官方Jenkins镜像，添加Docker CLI的安装步骤，构建自己的Jenkins镜像：

1. 创建Dockerfile文件：

FROM jenkins/jenkins:lts
USER root
# 安装Docker CLI依赖和工具
RUN apt-get update && apt-get install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg2 \
    software-properties-common && \
    # 添加Docker官方GPG密钥
    curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg && \
    # 添加Docker软件源
    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 && \
    # 安装Docker CLI
    apt-get update && apt-get install -y docker-ce-cli
# 切回jenkins用户
USER jenkins

2. 构建自定义镜像：

docker build -t custom-jenkins:lts .

3. 用这个自定义镜像启动Jenkins，保留原有的挂载参数（比如-v /var/run/docker.sock:/var/run/docker.sock）。

方法2：临时在容器内安装（重启后失效） #

进入运行中的Jenkins容器，手动安装Docker CLI：

# 进入容器
docker exec -it <你的Jenkins容器名/ID> bash
# 切换到root用户
su root
# 执行安装命令
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

解决后能否以此方式构建并运行镜像？ #

完全可以，这种方式叫做Docker-out-of-Docker (DooD)，是替代Docker-in-Docker（DinD）的轻量方案，优势是直接复用宿主机的Docker守护进程，避免DinD的存储层隔离和资源消耗问题。

使用时需要注意几个细节：

• 权限配置：确保Jenkins容器内的jenkins用户有权限访问/var/run/docker.sock。可以在启动容器时添加--group-add $(getent group docker | cut -d: -f3)参数，把容器内的jenkins用户加入宿主机的docker用户组。
• 路径一致性：如果构建时需要挂载宿主机目录（比如代码目录），要确保Jenkins容器内的路径和宿主机路径对应，避免出现文件找不到的情况。
• 镜像管理：通过这种方式构建的镜像会保存在宿主机的Docker镜像仓库中，和宿主机本地构建的镜像统一管理。

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