如何基于同一Jenkinsfile为多客户多分支构建不同流水线

嘿，你现有的Jenkinsfile已经有了很棒的基础——用CUSTOMER_NAME参数来区分客户。接下来咱们可以从几个维度优化，让流水线更贴合不同客户的需求，同时保持可维护性：

1. 先给参数加个“防护栏”，避免人为错误 #

首先可以把原来的字符串参数改成下拉选择，列出所有支持的客户，这样触发流水线时不会因为拼写错误导致构建失败：

parameters {
    choice(
        name: 'CUSTOMER_NAME',
        choices: ['customer_1', 'customer_2', 'customer_3'], // 把所有客户都列在这里
        description: '选择需要构建的客户环境'
    )
}

2. 用条件逻辑区分不同客户的构建步骤 #

如果不同客户有特殊的构建需求（比如不同的Grunt参数、额外的预处理步骤），可以用script块里的if分支，或者Jenkins自带的when指令来处理：

方式一：用if分支处理不同命令 #

stages {
    stage('Install Dependencies') {
        steps {
            sh 'yarn --mutex network'
        }
    }
    stage('Build Customer Assets') {
        steps {
            script {
                def buildCommand = "/usr/local/bin/grunt fetch_and_deploy:$CUSTOMER_NAME -ac test"
                // 给customer_2加特殊参数
                if (CUSTOMER_NAME == 'customer_2') {
                    buildCommand += ' --enable-feature-x'
                }
                // 给customer_3跳过测试环节
                if (CUSTOMER_NAME == 'customer_3') {
                    buildCommand = "/usr/local/bin/grunt fetch_and_deploy:$CUSTOMER_NAME -ac prod"
                }
                sh buildCommand
            }
        }
    }
    stage('Collect Web Resources') {
        steps {
            sh '/usr/local/bin/grunt collect_web'
        }
    }
}

方式二：用when指令跳过专属阶段 #

如果某个客户需要额外的步骤，其他客户不需要，可以单独加一个阶段，用when控制是否执行：

stage('Customer 1 Post-Build Optimization') {
    when {
        expression { CUSTOMER_NAME == 'customer_1' }
    }
    steps {
        sh 'grunt minify-customer1-assets'
    }
}

3. 结合多分支流水线（适合客户有独立分支的场景） #

如果你的代码仓库里每个客户对应一个独立分支（比如customer1/main、customer2/main），可以把参数化和多分支流水线结合起来，这样不需要手动选客户，流水线会自动识别分支对应的客户：

// 从分支名里提取客户名，比如分支customer1/main就取customer1
def CUSTOMER_NAME = env.BRANCH_NAME.split('/')[0]

stages {
    stage('Build') {
        steps {
            sh ''' yarn --mutex network 
                   /usr/local/bin/grunt fetch_and_deploy:$CUSTOMER_NAME -ac test 
                   /usr/local/bin/grunt collect_web'''
        }
    }
}

配置多分支流水线后，每个分支的构建都会自动对应到对应的客户，触发起来更直观。

4. 用共享库封装通用逻辑（进阶，适合客户数量多的情况） #

如果客户数量越来越多，构建逻辑有很多重复，可以把通用的构建步骤封装成Jenkins共享库，减少代码冗余：

1. 在共享库的vars/buildCustomer.groovy里写通用逻辑：

def call(String customerName) {
    sh 'yarn --mutex network'
    // 可以在这里统一处理不同客户的差异，或者留钩子让客户自定义
    sh "/usr/local/bin/grunt fetch_and_deploy:$customerName -ac test"
    sh '/usr/local/bin/grunt collect_web'
}

2. 在你的Jenkinsfile里调用这个共享库方法：

// 引入共享库，替换成你的共享库名称
@Library('your-jenkins-shared-library') _

parameters {
    choice(name: 'CUSTOMER_NAME', choices: ['customer_1', 'customer_2'], description: '选择客户')
}

stages {
    stage('Build') {
        steps {
            buildCustomer(CUSTOMER_NAME)
        }
    }
}

这样后续新增客户时，只需要更新参数列表，核心构建逻辑不用改，维护起来更轻松。

你可以根据自己的实际情况选最适合的方案——如果客户之间差异小，用参数化+条件逻辑就足够；如果每个客户有独立分支，多分支流水线更省心；客户多的话，共享库能帮你省不少重复代码。

内容的提问来源于stack exchange，提问作者Usha S.M