如何在Jenkins多节点并行构建中用环境变量设置customWorkspace？

你原来的写法无法生效，核心原因是：声明式流水线的agent { node {} }块在Jenkins控制器端解析，此时还未连接目标代理，env引用的是控制器的环境变量，根本拿不到代理本地的agent_1_workspace变量。

下面是两种可行的实现方式：

方式一：脚本化流水线（灵活直接） #

直接先连接到目标节点，读取代理的环境变量后切换工作区：

node('agent 1 label') {
    // 读取代理本地的环境变量
    def customWorkspace = env.agent_1_workspace
    // 切换到自定义工作区执行任务
    ws(customWorkspace) {
        sh 'pwd' // 验证当前工作区路径
        // 这里添加你的构建步骤，比如编译、打包等
    }
}

方式二：声明式流水线（规范兼容） #

如果倾向用声明式语法，先通过agent块连接代理，再在steps里用script块配合ws步骤切换工作区：

pipeline {
    agent none
    stages {
        stage('Agent 1 构建') {
            agent { label 'agent 1 label' }
            steps {
                script {
                    // 此时已连接代理，能拿到代理的环境变量
                    def customWs = env.agent_1_workspace
                    ws(customWs) {
                        sh 'echo 当前工作区: $PWD'
                        // 执行你的构建任务
                    }
                }
            }
        }
        // 其他代理的构建stage同理，如需并行可放在parallel块内
        stage('并行构建') {
            parallel {
                stage('Agent 2 构建') {
                    agent { label 'agent 2 label' }
                    steps {
                        script {
                            def customWs = env.agent_2_workspace
                            ws(customWs) {
                                sh 'mvn clean package'
                            }
                        }
                    }
                }
            }
        }
    }
}

注意事项 #

• 代理上的agent_1_workspace等环境变量必须是全局生效的系统变量（Linux需写入/etc/profile或~/.bashrc并重启Jenkins代理；Windows需设置系统环境变量并重启代理服务），确保Jenkins代理进程能读取到。
• 若多个代理的构建逻辑重复，可封装成函数复用，避免重复代码。

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