Jenkins流水线构建CentOS容器时遇sudo未知UID错误

这个问题我之前在配置Jenkins流水线时也碰到过，核心原因是Jenkins的Docker Agent在启动容器时，会使用主机上Jenkins用户的UID来运行命令，但这个UID在你基于CentOS构建的容器镜像里并没有对应的用户条目，导致系统无法识别该用户身份，sudo命令自然就抛出了这个错误。

下面给你几个可行的解决方案，按推荐程度排序：

方案1：在Dockerfile中创建对应UID的用户并赋予sudo权限（推荐） #

这个方案既符合安全规范，又能彻底解决问题。你需要修改你的Dockerfile，添加以下内容：

# 先安装sudo（CentOS默认没有预装sudo）
RUN yum install -y sudo && yum clean all

# 定义构建参数，用于接收主机Jenkins用户的UID
ARG JENKINS_UID=1000

# 创建与主机Jenkins UID匹配的用户，添加到sudo组并设置免密sudo
RUN useradd -u ${JENKINS_UID} jenkins-build && \
    echo "jenkins-build ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers && \
    mkdir -p /home/jenkins-build && \
    chown -R jenkins-build:jenkins-build /home/jenkins-build

然后修改流水线代码，传递主机Jenkins用户的UID给Docker构建：

pipeline {
    agent { 
        dockerfile {
            true
            # 从主机获取Jenkins用户的UID，传递给Docker构建参数
            args "--build-arg JENKINS_UID=$(id -u jenkins)"
        } 
    }
    stages {
        stage('Build') {
            steps {
                sh 'whoami' // 此时应该输出jenkins-build，UID可被系统识别
                sh 'printenv'
                sh 'sudo ./rpmBuild.sh' // 现在sudo命令可以正常执行了
            }
        }
    }
}

方案2：以root用户运行容器（不推荐，仅测试环境使用） #

如果是内部测试环境，想快速验证功能，可以直接强制Docker Agent以root用户启动容器，这样就不需要sudo了：

pipeline {
    agent { 
        dockerfile {
            true
            user 'root' // 指定以root用户运行容器
        } 
    }
    stages {
        stage('Build') {
            steps {
                sh 'whoami' // 输出root
                sh 'printenv'
                sh './rpmBuild.sh' // 直接以root权限运行脚本，无需sudo
            }
        }
    }
}

⚠️ 注意：这个方案会带来较大的安全风险，生产环境绝对不要使用。

方案3：在流水线中动态创建用户（无需修改Dockerfile） #

如果暂时无法修改Dockerfile，可以在流水线的前置步骤中动态创建匹配UID的用户：

pipeline {
    agent { dockerfile true }
    stages {
        stage('Prepare User') {
            steps {
                sh '''
                    # 安装sudo（如果镜像中没有的话）
                    yum install -y sudo > /dev/null 2>&1

                    # 获取当前运行的UID
                    CURRENT_UID=$(id -u)
                    # 检查该UID是否已存在于/etc/passwd中
                    if ! id -u ${CURRENT_UID} > /dev/null 2>&1; then
                        # 创建临时用户
                        useradd -u ${CURRENT_UID} temp-build-user
                        # 添加免密sudo权限
                        echo "temp-build-user ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
                    fi
                '''
            }
        }
        stage('Build') {
            steps {
                sh 'whoami' // 输出temp-build-user
                sh 'sudo ./rpmBuild.sh'
            }
        }
    }
}

这个方案不需要修改Dockerfile，但每次运行流水线都会执行用户创建步骤，略有冗余，适合临时场景。

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