如何使用Jenkins WithRegistry拉取私有Docker镜像并打新标签推送？

我来梳理下你遇到的问题和最终的解决方案，帮你理清每个错误的原因以及正确的实现方式：

你遇到的两次关键错误分析 #

1. Cannot invoke method tag() on null object #

这个错误出现在你第一次尝试用Jenkins Docker插件的image.tag()方法时。原因在于：你调用docker.image()时传入的镜像名称仅为repo:tag，没有包含私有仓库的地址前缀。虽然你用docker.withRegistry()配置了仓库地址，但插件的docker.image()方法需要完整的镜像标识（包含registry地址）才能正确关联到私有仓库中的镜像，导致pull()后返回的image对象为null，调用tag()时自然触发了空指针错误。

问题代码片段：

image = docker.image(repo.toLowerCase()+":"+params.versionToTag).pull()
image.tag("${deliveryTag}")

2. No such image :latest #

修改代码改用sh执行docker tag命令后，你遇到了这个错误。原因很简单：你在docker tag命令中只指定了镜像的仓库名（${repo.toLowerCase()}），没有附带标签，Docker会默认使用:latest标签，但本地并没有这个标签的镜像，因此报错。

问题代码片段：

sh "docker tag ${repo.toLowerCase()} ${configs.dockerRegistry.url}/${repo.toLowerCase()}:${deliveryTag}"

最终可行的解决方案 #

经过调整，你找到了正确的实现方式，这里再明确下关键要点和完整代码：

核心注意事项 #

• 借助docker.withRegistry()配置私有仓库的地址和认证凭据，确保所有Docker操作都能访问私有仓库
• 执行docker tag时，必须指定完整的源镜像路径（包含registry地址和原标签），避免默认使用latest标签
• 推送新标签时，同样要使用完整的目标镜像路径

完整可运行代码 #

stage("Applying to docker repo") {
    steps {
        script {
            docker.withRegistry('https://' + configs.dockerRegistry.url, configs.dockerRegistry.credentialsId) {
                // 拉取私有仓库中指定标签的镜像
                docker.image(repo.toLowerCase()+":"+params.versionToTag).pull()
                // 为镜像添加新标签：源镜像需带完整registry地址和原标签
                sh "docker tag ${configs.dockerRegistry.url}/${repo.toLowerCase()}:${params.versionToTag} ${configs.dockerRegistry.url}/${repo.toLowerCase()}:${deliveryTag}"
                // 将新标签的镜像推送到私有仓库
                sh "docker push ${configs.dockerRegistry.url}/${repo.toLowerCase()}:${deliveryTag}"
                // 可选操作：拉取新标签镜像，验证推送是否成功
                docker.image(repo.toLowerCase()+":${deliveryTag}").pull()
            }
        }
    }
}

代码解释 #

• docker.withRegistry()：这一步是关键，它为后续的Docker操作设置了默认的私有仓库地址和认证凭据，让docker.image().pull()能正确拉取私有镜像
• docker tag命令：明确指定源镜像的完整路径，避免了Docker默认使用:latest标签的问题，确保能准确找到要打标签的镜像
• 最后的pull()操作：可选步骤，用于确认新标签的镜像已经成功推送到私有仓库，保证流程的完整性

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