如何在声明式JenkinsFile中创建并使用全局阶段共享库

你的核心问题是错误地将Groovy执行逻辑以字符串形式拼接，导致Jenkins解析代码时出现语法错误（比如换行符、转义字符破坏了Groovy语法结构）。Jenkins声明式Pipeline需要的是可直接执行的Groovy闭包，而非字符串拼接的代码片段。以下是正确的实现方式：

1. 重构共享库文件 vars/getGlobalStage.groovy #

将原来的字符串定义替换为Groovy闭包/方法，直接返回可执行的逻辑块：

// 初始化阶段：返回闭包形式的执行逻辑
def initStage() {
    return {
        env.STARTED_BY = buildInfo.getStartedByUser()
        env.SVN_REVISION = shell.getCommandOutput('svn info --show-item last-changed-revision')
        env.SVN_AUTHOR = scmExtras.getEmailsFromChangeList().join(',')
        env.PRODUCT_VERSION = versionHelper.getMainVersion()
        def timeInSeconds = (long) (currentBuild.startTimeInMillis / 1000)
        env.TEST_REPORT = "TestsResults_${currentBuild.number}.xml"
        currentBuild.description = "${env.STARTED_BY} on ${env.NODE_NAME}, ${env.PRODUCT_VERSION} - r.${env.SVN_REVISION}"
        buildInfo.printBuildInfo()
    }
}

// SVN检出阶段：修正原字符串中的语法错误（多余的右括号）
def svnCheckoutStage() {
    return {
        svn.checkout(env.REPO_NAME, env.BRANCH_NAME)
    }
}

// 统一的阶段调度方法
def generateStage(stageType) {
    switch(stageType) {
        case 'init':
            return initStage()
        case 'svnCheckout':
            return svnCheckoutStage()
        default:
            error("不支持的阶段类型: ${stageType}")
    }
}

2. 在声明式JenkinsFile中调用共享库 #

通过script块执行共享库返回的闭包（声明式Pipeline中自定义逻辑必须放在script内）：

pipeline {
    agent any
    // 此处可定义全局参数、环境变量等
    stages {
        stage('Init') {
            steps {
                script {
                    // 调用初始化阶段闭包
                    getGlobalStage.generateStage('init').call()
                }
            }
        }
        stage('Checkout') {
            steps {
                script {
                    // 调用SVN检出阶段闭包
                    getGlobalStage.generateStage('svnCheckout').call()
                }
            }
        }
        // 其他自定义阶段...
    }
}

关键注意事项 #

• 共享库文件必须放在共享库的vars目录下，Jenkins才能自动识别为全局可用变量。
• 闭包中直接操作env对象设置的变量是全局生效的，符合你声明全局参数的需求。
• 原代码中svnCheckoutStage字符串存在语法错误（多余的右括号），重构时已修正。

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