如何在Jenkins流水线中调用另一条流水线并指定工作区与分支

由于流水线可能被并发多次调用，不指定工作区和分支会引发Git冲突等问题，因此需要实现：调用流水线时指定专属工作区与目标分支，切换工作区时自动重新克隆/拉取完整项目，同时在Jenkins UI中能直观看到被调用流水线的执行步骤。

现有调用方流水线代码 #

pipeline {
    agent {...}
    stages 
    {
        stage('Start') {
            steps {
                sh 'ls'
            }
        }
        stage ('Invoke_pipeline') {
            steps {
                // 需要在这里指定工作区和分支，同时UI可见被调用流水线的步骤
                build job: 'pipeline1', parameters: [
                    string(name: 'param1', value: "value1")
                ]
            }
        }
    }
}

实现方案 #

1. 给被调用流水线（pipeline1）添加参数 #

Jenkins的build指令本身不支持直接传入workspace或branch参数，需要通过流水线参数传递这两个配置。在pipeline1中新增两个字符串参数：

• WORKSPACE_PATH：指定自定义工作区路径
• BRANCH_NAME：指定要拉取的Git分支

2. 在pipeline1中配置自定义工作区与分支拉取 #

在pipeline1的agent部分使用customWorkspace指定工作区，拉取Git代码时指定分支并开启clean模式，确保每次切换工作区都重新克隆完整项目：

pipeline {
    agent {
        node {
            label 'your-agent-label' // 根据实际代理标签修改
            customWorkspace params.WORKSPACE_PATH // 使用传入的工作区路径
        }
    }
    parameters {
        string(name: 'WORKSPACE_PATH', description: '自定义工作区路径')
        string(name: 'BRANCH_NAME', description: 'Git分支名')
        string(name: 'param1', description: '业务参数')
    }
    stages {
        stage('拉取代码') {
            steps {
                git(
                    url: 'your-git-repo-url', // 替换为实际仓库地址
                    branch: params.BRANCH_NAME,
                    clean: true, // 开启clean，确保重新克隆/拉取完整代码
                    changelog: false
                )
            }
        }
        // 其他业务阶段...
    }
}

3. 在调用方流水线中传递参数并启用UI可视化 #

修改调用方流水线的build指令，传入工作区和分支参数，Jenkins默认会在UI中嵌套显示被调用流水线的执行步骤（无需额外配置，只要wait: true保持默认即可）：

pipeline {
    agent {...}
    stages 
    {
        stage('Start') {
            steps {
                sh 'ls'
            }
        }
        stage ('Invoke_pipeline') {
            steps {
                build job: 'pipeline1', parameters: [
                    string(name: 'param1', value: "value1"),
                    string(name: 'WORKSPACE_PATH', value: '/.A_Stage'), // 指定工作区
                    string(name: 'BRANCH_NAME', value: 'dev') // 指定分支
                ]
            }
        }
    }
}

关键说明 #

• customWorkspace的路径可以是绝对路径，也可以是相对于Jenkins主工作区的相对路径，根据实际环境调整。
• git步骤的clean: true会在拉取前清理工作区，确保每次都获取完整的分支代码，避免并发调用时的Git冲突。
• 在Jenkins UI中，点击调用方流水线的Invoke_pipeline阶段，即可看到被调用的pipeline1的完整执行步骤。

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