Jenkins流水线构建的Docker镜像归属root用户，无法推送至Docker Registry求助

问题原因 #

root用户无法推送镜像核心原因有两个：一是未完成Docker Hub的身份验证，二是部分环境下Docker配置限制root用户进行推送操作。

修复后的完整流水线脚本 #

pipeline {
    agent any 

    environment {
        IMAGE_TAG = "${BUILD_NUMBER}"
        DOCKER_HUB_USER = "tarunvoora"
        // 先在Jenkins凭据中添加Docker Hub密码，ID设为dockerhub-password
        DOCKER_HUB_PWD = credentials('dockerhub-password')
    }

    stages {
        stage('拉取代码'){
           steps {
              git branch: 'main', credentialsId: 'vooratarun-github-token', url: 'https://github.com/vooratarun/cicd-end-to-end.git'
           }
        }

        stage('登录Docker Hub'){
            steps{
                script{
                    sh "docker login -u ${DOCKER_HUB_USER} -p ${DOCKER_HUB_PWD}"
                }
            }
        }

        stage('构建Docker镜像'){
            steps{
                script{
                    sh '''
                    echo '开始构建Docker镜像'
                    docker build -t ${DOCKER_HUB_USER}/cicd-e2e:${IMAGE_TAG} .
                    '''
                }
            }
        }

        stage('推送Docker镜像'){
           steps{
                script{
                    sh '''
                    echo '推送镜像至Docker Hub'
                    docker push ${DOCKER_HUB_USER}/cicd-e2e:${IMAGE_TAG}
                    '''
                }
            }
        }

        stage('登出Docker Hub'){
            steps{
                sh 'docker logout'
            }
        }
    }
}

核心修复说明 #

• 新增登录/登出步骤：推送镜像前必须完成Docker Hub身份验证，推送后登出避免代理节点残留认证信息
• 使用Jenkins凭据管理密码：绝对不要在代码中硬编码密码，通过credentials()函数从Jenkins凭据库读取，安全性更高
• 统一环境变量：把Docker Hub用户名和镜像标签设为环境变量，后续修改更方便

可选优化（解决root构建的权限隐患） #

如果是root构建镜像本身导致的权限问题，可以在Dockerfile中切换为非root用户构建：

# 基础镜像
FROM xxx
# 创建非root用户
RUN useradd -m appuser
# 切换用户
USER appuser
# 后续构建步骤

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