Jenkins声明式流水线如何通过shell命令动态生成docker args参数

问题根因 #

你之前直接在args字段内写$(shell命令)的写法无法生效，是因为声明式流水线的Docker Agent参数不会自动做Shell命令展开，Jenkins会直接把整段字符串作为参数传递给docker run命令，Docker解析时误将命令片段中的group识别为镜像名称，才会出现拉取group:latest镜像失败的报错。

实现方案 #

可以通过顶层环境变量预执行命令拿到宿主侧的UID和Docker组GID，再传入Docker Agent的args参数，步骤如下：

1. 顶层声明agent none，确保环境变量执行阶段在Jenkins构建宿主上直接运行，而非提前启动容器
2. 在environment块中通过sh方法执行Shell命令获取对应ID值，注意调用trim()去除返回结果末尾的换行符
3. 在具体Stage的Docker Agent配置中，直接引用预定义的环境变量拼接args参数

完整配置示例 #

pipeline {
    // 顶层不指定agent，保证环境变量在宿主侧执行
    agent none
    environment {
        // 获取当前构建执行用户的UID
        HOST_USER_UID = sh(script: 'id -u', returnStdout: true).trim()
        // 获取宿主Docker组的GID
        HOST_DOCKER_GID = sh(script: 'getent group docker | cut -d: -f3', returnStdout: true).trim()
    }
    stages {
        stage('镜像构建') {
            agent {
                docker {
                    label '<你的构建节点标签>'
                    image '<你的构建镜像名>:latest'
                    args "-u ${HOST_USER_UID}:${HOST_DOCKER_GID} --privileged --network host -v /etc/passwd:/etc/passwd -v /etc/group:/etc/group -v /var/run/docker.sock:/var/run/docker.sock"
                }
            }
            steps {
                // 你的构建逻辑
                sh 'docker build -t <你的镜像标签> .'
            }
        }
    }
}

验证说明 #

该配置无需硬编码UID/GID，可适配不同构建主机的用户/组ID配置，同时配合挂载的/etc/passwd和/etc/group文件，容器内的UID/GID可直接映射到正确的用户/组名，不需要在构建镜像中预先创建jenkins用户。

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