在Jenkins JNLP Docker代理构建Docker镜像时遇错误求助

针对「下载Docker client失败+无法连接守护进程」的问题 #

• 版本源失效：17.09.1-ce是老旧版本，官方已移除该版本的公开下载源，导致Jenkins Docker Tool插件无法获取安装包。建议更换为官方仍支持的稳定LTS版本，比如24.0.6。
• 守护进程权限与状态：确认jnlp-docker-agent代理节点上Docker服务已启动（执行systemctl start docker或对应系统的启动命令），同时将Jenkins agent运行用户加入docker用户组（执行usermod -aG docker jenkins，之后重启agent服务），确保Jenkins进程有权限连接Docker守护进程。

针对「docker: Exec format error」的问题 #

• 架构不兼容：该错误几乎都是因为下载的Docker客户端二进制文件与代理节点CPU架构不匹配。比如ARM64架构节点下载了x86_64的安装包，反之亦然。在Jenkins全局工具配置选择版本时，要对应节点架构：
  • x86_64节点选带linux-amd64后缀的版本包
  • ARM64节点选带linux-arm64后缀的版本包
• 版本格式错误：不要手动添加.tgz后缀，Jenkins Docker Tool插件会自动处理包格式，直接填写正确版本号（如24.0.6）即可，插件会自动匹配对应架构的下载链接。

优化后的Pipeline示例 #

建议在Pipeline中先验证Docker环境是否正常：

pipeline {
    agent none
    stages {
        stage('Build Docker') {
            agent {
                label 'jnlp-docker-agent'
            }
            tools {
                dockerTool 'docker_lts' // 对应全局配置中设置的稳定版本名称
            }

            steps {
                script {
                    sh 'docker info' // 先验证Docker连接状态
                    docker.build('demo-image:0.0.1')
                }
            }
        }
    }
}

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