能否从主Jenkinsfile调用其他Jenkinsfile？实践遇错求助

问题背景 #

想通过主Jenkinsfile里的选择参数，调用对应的其他Jenkinsfile执行流水线。初始代码如下：

pipeline {
    agent none

    parameters {
        choice(
            name: 'JENKINS_FILE_NAME',
            choices : ['JENKINS_FILE_1', 'JENKINS_FILE_2'],
            description: '选择要部署的应用'
        )     
    } 

    stages {
        stage('部署应用') {
            agent any
            steps {
                script {
                    sh 'ls -al'
                    
                    switch (JENKINS_FILE_NAME) {
                        case 'JENKINS_FILE_1':
// 想要调用Jenkinsfile 1并执行其中的阶段/步骤
                            break
                        case 'JENKINS_FILE_2':
// 想要调用Jenkinsfile 2并执行其中的阶段/步骤
                             break
                    }
                }
            }
        }
    }
}

尝试了两种方法但都踩了坑：

• 用load加载test-jenkins/Jenkinsfile-A执行时，报错提示“不能包含流水线步骤”；
• 用build调用test-jenkins/Jenkinsfile-B时，报错“ERROR: No item named test-jenkins/Jenkinsfile-B found”。

尝试的代码如下：

pipeline {
    agent any

    parameters {
        choice(
            name: 'FUNCTION',
            choices : ['选项A', '选项B', '选项C'],
            description: '选择要部署的应用'
        )
    }
    stages {
        stage('加载并执行其他Jenkinsfile') {
            steps {
                script {
                    switch (FUNCTION) {
                        case '选项A':

                            sh 'ls -al test-jenkins'
                            sh 'ls -al test-jenkins/Jenkinsfile-A'
                            fileA = load 'test-jenkins/Jenkinsfile-A'
                            fileA()
// 执行失败，提示不能包含流水线步骤
                            break
                        case '选项B':
                            sh 'ls -al'
                            build job: 'test-jenkins/Jenkinsfile-B', parameters: [
                                string(name: 'FUNCTION', value: "${FUNCTION}")
                            ]
                            break
                        default:
                            error "未知应用: ${FUNCTION}"
                    }
                }
            }
        }
    }
}

解决方案 #

方法一：调整被加载脚本的格式适配load #

load只能加载纯Groovy函数脚本，不能直接加载带pipeline {}结构的完整Jenkinsfile。你需要把被调用的Jenkinsfile改成函数形式：

比如test-jenkins/Jenkinsfile-A要改成这样：

def call() {
    stage('部署选项A') {
        steps {
            echo "执行选项A的部署逻辑"
            sh 'echo "部署中..."'
        }
    }
}

主Jenkinsfile里的调用代码不用改，这样load后执行函数就能正常跑步骤了。

方法二：用build调用独立流水线任务 #

build的job参数要填的是Jenkins里已经创建好的流水线任务名称，不是文件路径。你需要先把test-jenkins/Jenkinsfile-B的代码放到一个独立的流水线任务里（比如创建名为test-jenkins-B的任务，配置它使用test-jenkins/Jenkinsfile-B作为脚本）。

然后主Jenkinsfile里的调用代码改成：

build job: 'test-jenkins-B', parameters: [
    string(name: 'FUNCTION', value: "${FUNCTION}")
]

额外推荐：用共享库管理复用逻辑 #

如果需要频繁调用多个不同的部署逻辑，更建议用Jenkins共享库。把各个应用的部署逻辑封装成共享库中的函数，主流水线直接调用，结构更清晰，后续维护也更方便。

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