如何识别触发Jenkins任务的Git分支及关联代码仓库

我来帮你搞定这两个Jenkins的问题，都是日常使用中经常碰到的场景，下面分情况给你具体的解决办法：

这里有几个简单直接的方法，按需选择就行：

• 利用Jenkins内置环境变量
  Jenkins本身会自动暴露一批和Git相关的环境变量，其中GIT_BRANCH就是触发本次构建的分支名，GIT_LOCAL_BRANCH是本地检出的分支（大部分时候和前者一致）。你可以直接在流水线里打印这个变量，比如：

  pipeline {
      agent any
      stages {
          stage('Check Trigger Branch') {
              steps {
                  echo "触发构建的Git分支是: ${env.GIT_BRANCH}"
              }
          }
      }
  }
  

  构建完成后去日志里找这条输出，就能看到分支信息了。

• 查看构建详情页面
  打开具体的构建页面，左侧菜单里的「Changes」或者「Git Information」模块会直接显示本次构建对应的分支和提交记录。如果是多分支流水线，页面标题本身就会标注分支名，一眼就能看到。

• 自由风格任务的变量配置
  如果你用的是自由风格任务，可以在「构建环境」里勾选「Set Git build variables」，之后在构建步骤里就能通过$GIT_BRANCH引用分支名，比如在shell脚本里写echo "触发分支: $GIT_BRANCH"就行。

当多个GitHub仓库共用同一个Jenkins任务的webhook时，要区分触发源可以试试这些方案：

• 直接读取GitHub提供的环境变量
  当GitHub推送触发Jenkins时，会自动设置GITHUB_REPOSITORY环境变量，格式是「用户名/仓库名」（比如viren-sow/repo-A）。你可以直接在流水线里打印：

  echo "触发本次构建的仓库是: ${env.GITHUB_REPOSITORY}"
  

  如果这个变量没自动生成，也可以读取webhook的payload来解析：

  pipeline {
      agent any
      stages {
          stage('Identify Trigger Repo') {
              steps {
                  script {
                      def payload = readJSON text: env.BODY
                      echo "触发仓库: ${payload.repository.full_name}"
                  }
              }
          }
      }
  }
  

  注意要确保Jenkins的GitHub插件已经正确配置，这样BODY变量才会包含完整的payload数据。

• 查看构建日志开头的触发记录
  每次构建的日志最开头，Jenkins都会打印触发来源的信息，比如：

  Started by GitHub push by Viren Sow
  GitHub Repo: viren-sow/repo-B

  直接看这段内容就能快速定位是哪个仓库触发的，不用写额外代码。

• 用Generic Webhook Trigger插件增强控制
  如果默认的变量不够用，推荐安装Generic Webhook Trigger插件。配置的时候，你可以从webhook payload里提取仓库名作为自定义变量，比如设置变量trigger_repo对应$.repository.full_name，之后在流水线里直接用env.trigger_repo就能拿到触发仓库的名字。这个插件还能帮你灵活设置不同仓库的触发规则，避免不必要的构建。

• 给不同仓库设置自定义触发参数
  你可以在每个GitHub仓库的webhook URL后面加自定义查询参数，比如把repo-A的webhook URL设为http://your-jenkins-url/job/your-job/build?token=YOUR_TOKEN&repo=repo-A，repo-B的设为http://your-jenkins-url/job/your-job/build?token=YOUR_TOKEN&repo=repo-B。然后在Jenkins流水线里读取这个参数：

  echo "触发仓库: ${env.repo}"
  

  这种方法简单直接，不需要依赖插件。

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