Jenkinsfile区域阶段能否重构为共享库复用？遇DSL错误求助

你遇到的报错是因为Jenkins声明式DSL的结构限制：stages只能作为pipeline或父stage的直接子元素，而script块属于steps的内部范畴，steps里仅允许放置执行类步骤（如sh、dir、script等），不能直接定义stages节点，所以才会出现「stages not found in steps」的错误。

将区域内部阶段重构到共享库的方案是可行的，只需调整实现方式，以下是两种推荐的做法：

方法一：共享库返回完整的嵌套Stage节点 #

在共享库中定义一个函数，直接返回包含子阶段的完整stage结构，主Jenkinsfile将其直接嵌入顶层stages中，完全贴合原有的嵌套结构。

共享库实现（vars/regionStages.groovy） #

def call(String region, String label) {
    return stage(region) {
        stages {
            stage('build') {
                steps {
                    script {
                        dir("testing") {
                            build(region: region, labels: label)
                        }
                    }
                }
            }
            stage('delete') {
                steps {
                    script {
                        dir("testing") {
                            delete(region)
                        }
                    }
                }
            }
        }
    }
}

主Jenkinsfile调用 #

pipeline {
    agent any
    stages {
        stage('init') {
            steps {
                sh 'do-init'
            }
        }
        // 直接调用共享库函数生成region1的嵌套阶段
        regionStages('region1', 'label1')
        // 调用生成region2的嵌套阶段
        regionStages('region2', 'label2')
    }
}

方法二：共享库封装子阶段的执行逻辑 #

如果需要在父stage的steps内调用，可以在共享库中用Jenkins的stage步骤（注意是执行步骤，不是声明式DSL的stage节点）来封装子阶段逻辑，这种方式会在父stage下生成缩进的子阶段，功能与原结构一致。

共享库实现（vars/runRegionTasks.groovy） #

def call(String region, String label) {
    // 用stage步骤定义build子阶段
    stage("${region}-build") {
        dir("testing") {
            build(region: region, labels: label)
        }
    }
    // 用stage步骤定义delete子阶段
    stage("${region}-delete") {
        dir("testing") {
            delete(region)
        }
    }
}

主Jenkinsfile调用 #

pipeline {
    agent any
    stages {
        stage('init') {
            steps {
                sh 'do-init'
            }
        }
        stage('region1') {
            steps {
                script {
                    runRegionTasks('region1', 'label1')
                }
            }
        }
        stage('region2') {
            steps {
                script {
                    runRegionTasks('region2', 'label2')
                }
            }
        }
    }
}

两种方法都能实现代码复用，方法一更贴合你原有的嵌套stage结构，推荐优先使用。

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