TeamCity：构建前设置VCS分支名称以匹配关联代码库分支

这种多仓库分支同步构建的场景我处理过不少，核心就是要让CI工具能自动识别当前构建的分支名，然后把这个分支名传递给其他依赖仓库的拉取步骤，下面给你具体的实现思路和方案：

1. 先统一分支命名规范 #

这是实现同步的基础前提：确保Core、AuthN、Other三个仓库的对应分支完全同名。比如：

• Other的Hotfix/2024-05-login-fix分支，Core和AuthN也要有完全一致的Hotfix/2024-05-login-fix分支
• 同理，Current、Patch分支也要保持命名完全对齐

如果之前有分支命名不一致的情况，先做一次统一调整，避免后续匹配失败。

2. 配置CI工具的分支参数化拉取 #

不同CI工具的实现方式略有不同，这里给你两种主流工具的配置方法：

针对TeamCity #

在VCS根配置中使用分支参数化：

• 定义一个全局参数（或构建参数）%BRANCH_NAME%，设置其默认值为当前触发构建的分支名（TeamCity会自动填充teamcity.build.branch变量）
• 分别给Core、AuthN、Other的VCS根设置分支规则为：refs/heads/%BRANCH_NAME%
• 这样当触发Other的某个分支构建时，Core和AuthN会自动拉取同名分支

针对Jenkins（Pipeline脚本） #

通过env.BRANCH_NAME获取当前分支名，然后在拉取依赖仓库时指定该分支：

pipeline {
    agent any
    stages {
        stage('Checkout All Repos') {
            steps {
                // 拉取Core的对应分支
                git branch: env.BRANCH_NAME, url: '你的Core仓库地址'
                // 拉取AuthN的对应分支
                git branch: env.BRANCH_NAME, url: '你的AuthN仓库地址'
                // 拉取当前触发构建的Other分支
                git branch: env.BRANCH_NAME, url: '你的Other仓库地址'
            }
        }
        stage('Setup Test DB') {
            steps {
                // 执行创建测试数据库的脚本
                sh './setup-test-db.sh'
            }
        }
        // 后续集成测试、构建步骤
    }
}

3. 可选：添加分支不存在的 fallback 逻辑 #

如果存在某个依赖仓库没有对应分支的情况（比如Other开了新Hotfix，但Core还没同步创建），可以添加 fallback 规则，默认拉取Current分支：

Jenkins Pipeline示例 #

// 自定义函数：检查分支是否存在，不存在则返回Current
def getTargetBranch(String repoUrl) {
    def targetBranch = env.BRANCH_NAME
    // 远程仓库检查分支是否存在
    def branchExists = sh(script: "git ls-remote --heads ${repoUrl} ${targetBranch}", returnStatus: true) == 0
    return branchExists ? targetBranch : 'Current'
}

pipeline {
    agent any
    stages {
        stage('Checkout All Repos') {
            steps {
                git branch: getTargetBranch('你的Core仓库地址'), url: '你的Core仓库地址'
                git branch: getTargetBranch('你的AuthN仓库地址'), url: '你的AuthN仓库地址'
                git branch: env.BRANCH_NAME, url: '你的Other仓库地址'
            }
        }
        // 后续步骤...
    }
}

4. 限制触发构建的分支范围 #

为了避免无关分支触发不必要的构建，可以在CI工具中设置分支过滤规则，只允许Current、Patch、Hotfix相关的分支触发构建：

• TeamCity：在构建触发规则中添加+:*Current*、+:*Patch*、+:*Hotfix*
• Jenkins：在分支源配置中设置包含规则为**/Current*、**/Patch*、**/Hotfix*

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