如何让Jenkins识别steps中调用的Groovy方法内的stage节点？

问题根源在于Jenkins流水线（尤其是Declarative Pipeline）的stage识别逻辑无法穿透自定义Groovy方法的调用——当你在方法内部定义stage时，Jenkins会把它当作普通Groovy代码处理，不会将其解析为流水线的正式stage节点，因此Blue Ocean无法展示这些stage，失败检查逻辑也无法识别它们的状态。

以下是两种可行的修改方案：

方案一：让方法返回包含Stage的闭包 #

调整processOrg方法，使其返回一个包含stage定义的闭包，而非在方法内部直接定义stage：

def processOrg(int orgNumber, String testCycleID, String testCycleDefinition, String newCycleName, String testResultFolder) {
    return {
        def orgUsername
        def directory

        stage ('Deployment' + orgNumber) {
            // 保留原来的Deployment阶段逻辑
            echo "处理组织 ${orgNumber}"
            // ...其他业务代码
        }
    }
}

然后在构建并行任务时，直接将方法返回的闭包赋值给tests变量：

tests = [:]
// 其他前置stage：Prepare, Initialize, Prepare App
stage('Test') {
    stages{
        stage('Cycle and Test Definition Prep') {
            steps {
                script {
                    // 填充并行任务集合
                    for (int i = 1; i <= NUMBER_OF_ORGS.toInteger(); ++i) {
                        def orgNumber = i;
                        tests['Org ' + orgNumber] = processOrg(orgNumber, cycleKey, definitionKey, newCycleName, folderName)
                    }
                 }
            }
        }
        stage('Code Push and Test Execution') {
            steps {
                script {
                    parallel tests
                }
            }
        }
    }
}

方案二：拆分逻辑，Stage定义在并行闭包内 #

将业务逻辑和stage定义分离，方法只处理具体业务，stage直接定义在并行任务的闭包中：

// 仅处理业务逻辑，不包含stage定义
void processOrgLogic(int orgNumber, String testCycleID, String testCycleDefinition, String newCycleName, String testResultFolder) {
    def orgUsername
    def directory

    // 原来的Deployment阶段内的业务代码
    echo "处理组织 ${orgNumber}"
    // ...其他操作
}

// 构建并行任务时直接定义stage
tests = [:]
// 其他前置stage：Prepare, Initialize, Prepare App
stage('Test') {
    stages{
        stage('Cycle and Test Definition Prep') {
            steps {
                script {
                    for (int i = 1; i <= NUMBER_OF_ORGS.toInteger(); ++i) {
                        def orgNumber = i;
                        tests['Org ' + orgNumber] = {
                            stage ('Deployment' + orgNumber) {
                                processOrgLogic(orgNumber, cycleKey, definitionKey, newCycleName, folderName)
                            }
                        }
                    }
                 }
            }
        }
        stage('Code Push and Test Execution') {
            steps {
                script {
                    parallel tests
                }
            }
        }
    }
}

两种方案的核心都是让stage直接出现在Jenkins流水线引擎能解析的层级（并行闭包的顶层），这样Blue Ocean就能正常展示这些stage，失败检查逻辑也能正确捕获它们的执行状态。

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