如何在Jenkins多分支流水线执行时向Jenkinsfile传递配置

我经常帮团队解决Jenkins多分支流水线的配置映射问题，针对你的需求，这里有两种实用方案，既能满足分支到服务器的灵活映射，又能让流水线代码保持整洁：

方案一：直接在Jenkinsfile内封装分支匹配逻辑 #

这种方案适合配置不常变动的场景，所有映射规则都写在Jenkinsfile里，一目了然。核心思路是利用Jenkins自动注入的env.BRANCH_NAME变量获取当前分支，再通过正则匹配找到对应的服务器：

pipeline {
    agent any
    environment {
        // 定义分支-服务器映射，key是正则表达式，适配通配符场景
        BRANCH_SERVER_MAP = [
            ~/^master$/              : 'prodServer',
            ~/^develop$/            : 'devServer',
            ~/^release\/.*$/        : 'stagingServer',
            ~/^hotfix\/.*$/         : 'stagingServer',
            ~/^feature\/Thing-I-Want-To-Change-Regularly$/ : 'testingServer'
        ]
        DEPLOY_SERVER = '' // 初始化部署服务器变量
    }
    stages {
        stage('确定部署服务器') {
            steps {
                script {
                    // 遍历映射规则，匹配当前分支
                    BRANCH_SERVER_MAP.each { pattern, server ->
                        if (env.BRANCH_NAME ==~ pattern) {
                            DEPLOY_SERVER = server
                            echo "已匹配到分支 ${env.BRANCH_NAME} 的部署服务器：${DEPLOY_SERVER}"
                        }
                    }
                    // 分支无匹配规则时的处理：抛出错误或设置默认值
                    if (DEPLOY_SERVER.isEmpty()) {
                        error "分支 ${env.BRANCH_NAME} 未配置对应的部署服务器！"
                        // 可选：设置默认服务器
                        // DEPLOY_SERVER = 'defaultTestServer'
                    }
                }
            }
        }
        stage('示例构建') {
            steps {
                echo 'Hello World'
            }
        }
        stage('示例部署') {
            steps {
                echo "开始部署到服务器 ${DEPLOY_SERVER}..."
                // 这里替换成你的实际部署逻辑，比如SSH执行脚本
                // sh "ssh ${DEPLOY_SERVER} './deploy-app.sh'"
            }
        }
    }
}

关键细节说明： #

• 用Groovy正则表达式（~//）实现release/*这类通配符匹配，比简单的字符串匹配更灵活。
• 单独加一个“确定部署服务器”的阶段，提前完成匹配逻辑，避免后续阶段重复计算。
• 分支无匹配时的逻辑可按需调整，比如抛出错误防止误部署，或者设置默认测试服务器。

方案二：借助Jenkins全局配置解耦映射规则 #

如果你的分支-服务器映射需要频繁调整，或者不想改动Jenkinsfile来更新配置，可以用Jenkins的全局流水线变量库来存储映射规则：

步骤1：配置全局变量库 #

1. 进入Jenkins → 系统管理 → 全局流水线库
2. 添加一个新的库（比如命名为branch-configs），选择“从SCM加载”或者“手动输入”，然后创建一个变量文件（比如BranchServerMap.groovy），内容如下：

def getMap() {
    return [
        ~/^master$/              : 'prodServer',
        ~/^develop$/            : 'devServer',
        ~/^release\/.*$/        : 'stagingServer',
        ~/^hotfix\/.*$/         : 'stagingServer',
        ~/^feature\/Thing-I-Want-To-Change-Regularly$/ : 'testingServer'
    ]
}

步骤2：在Jenkinsfile中引用全局变量 #

@Library('branch-configs') _ // 替换成你的全局库名称

pipeline {
    agent any
    environment {
        DEPLOY_SERVER = ''
    }
    stages {
        stage('确定部署服务器') {
            steps {
                script {
                    def branchMap = new BranchServerMap().getMap()
                    branchMap.each { pattern, server ->
                        if (env.BRANCH_NAME ==~ pattern) {
                            DEPLOY_SERVER = server
                            echo "已匹配到分支 ${env.BRANCH_NAME} 的部署服务器：${DEPLOY_SERVER}"
                        }
                    }
                    if (DEPLOY_SERVER.isEmpty()) {
                        error "分支 ${env.BRANCH_NAME} 未配置对应的部署服务器！"
                    }
                }
            }
        }
        // 后续构建、部署阶段和方案一完全一致
        stage('示例构建') {
            steps {
                echo 'Hello World'
            }
        }
        stage('示例部署') {
            steps {
                echo "开始部署到服务器 ${DEPLOY_SERVER}..."
            }
        }
    }
}

方案优势： #

• 映射规则和流水线代码分离，更新配置不需要修改Jenkinsfile，适合多人协作场景。
• 全局库可以版本控制，方便追溯配置变更历史。

额外注意事项 #

• 确保你的多分支流水线已开启BRANCH_NAME环境变量（默认是开启的，若未开启，在项目配置中勾选“Expose git branch name”）。
• 正则表达式的顺序很重要：如果某个分支能匹配多个规则，会以第一个匹配的规则为准，所以把精确匹配（比如master）放在通配符匹配前面。

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