Windows环境容器化Jenkins执行Pipeline无法拉取Docker Hub镜像求助

1. 基础运行环境检查 #

• 确认Docker Desktop运行模式：node:4.6仅提供Linux架构镜像，需将Docker Desktop切换为Linux容器模式，Windows容器模式下无法拉取匹配架构的镜像。
• 确认Jenkins容器已挂载Docker守护进程套接字：启动Jenkins容器时需添加套接字挂载参数，Windows环境启动命令参考：

docker run -d -p 8080:8080 -p 50000:50000 -v //var/run/docker.sock:/var/run/docker.sock -v jenkins_home:/var/jenkins_home --group-add docker jenkins/jenkins:lts

• 确认Jenkins容器内已安装Docker客户端：进入容器执行docker -v，如无版本输出，执行以下命令安装：

apt update && apt install -y docker.io

• 确认套接字访问权限：进入容器执行chmod 666 /var/run/docker.sock，避免权限不足无法调用Docker接口。

2. 网络与镜像源排查 #

• 先在宿主机执行docker pull node:4.6，验证宿主机本身是否可以正常拉取镜像，如宿主机拉取失败，优先排查宿主机Docker配置：
  • 配置Docker Hub镜像加速：打开Docker Desktop设置 -> Docker Engine，添加国内镜像源配置，示例如下，配置完成后重启Docker Desktop生效：

  {
    "registry-mirrors": ["https://registry.docker-cn.com", "https://mirror.baidubce.com"]
  }
  

  • 检查宿主机网络代理、DNS配置，确保可以正常访问Docker Hub服务。
• 宿主机拉取正常的情况下，进入Jenkins容器执行curl -v https://registry-1.docker.io，验证容器内网络连通性，如不通，检查容器网络配置是否继承了宿主机的代理、DNS规则。

3. Jenkins配置与Pipeline优化 #

• 检查Jenkins凭证配置：拉取Docker Hub公共镜像无需配置凭证，如之前配置过错误的Docker Hub认证凭证，进入Jenkins凭据管理页面删除对应凭证，避免错误认证导致拉取失败。
• 优化Pipeline代码：docker.image().inside()方法会自动拉取本地不存在的镜像，无需手动调用pull()方法，冗余调用可能会放大异常；同时原代码中sh 'npm'无执行参数会直接报错，需补充对应操作指令，优化后代码参考：

node {
    def commit_id
    stage('Preparation') {
        checkout scm
        sh "git rev-parse --short HEAD > .git/commit_id"
        commit_id = readFile('.git/commit_id').trim()
    }

    stage('test') {
        docker.image('node:4.6').inside {
            sh 'npm install --only=dev'
            sh 'npm test' // 按需替换为实际要执行的npm命令
        }
    }
}

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