GitLab CI标签推送时如何获取标签的源分支名称

我刚好碰到过类似的需求，GitLab CI确实没有直接提供标签源分支的内置变量，但我们可以通过Git命令来搞定这件事，下面是具体的实现方案：

前提准备：确保完整克隆仓库 #

GitLab CI默认是浅克隆（只拉取最近的提交），这会导致我们无法获取完整的分支和提交历史，所以第一步要在CI job里设置GIT_DEPTH: 0，确保拉取整个仓库的历史。

具体实现脚本 #

下面是一个完整的CI job示例，会在标签推送时自动检测对应的源分支：

get_tag_source_branch:
  variables:
    GIT_DEPTH: 0  # 关键：获取完整的仓库历史
  only:
    - tags  # 只在标签推送时触发这个job
  script:
    - |
      # 获取当前标签对应的提交哈希
      COMMIT_HASH=$(git rev-parse "$CI_COMMIT_TAG^{commit}")
      # 拉取所有远程分支到本地，这样我们能查到所有分支的信息
      git fetch origin '+refs/heads/*:refs/heads/*'
      # 查找包含该提交的所有本地分支，取第一个匹配的分支作为源分支
      SOURCE_BRANCH=$(git for-each-ref --format='%(refname:short)' refs/heads/ --contains "$COMMIT_HASH" | head -n 1)
      
      if [ -n "$SOURCE_BRANCH" ]; then
        echo "✅ 标签 $CI_COMMIT_TAG 是从分支 $SOURCE_BRANCH 创建的"
        # 这里可以把SOURCE_BRANCH作为环境变量传递给后续步骤
        export SOURCE_BRANCH="$SOURCE_BRANCH"
      else
        echo "⚠️ 未找到标签 $CI_COMMIT_TAG 对应的源分支，可能分支已被删除或标签直接从提交创建"
      fi

注意事项 #

• 多分支匹配的情况：如果同一个提交存在于多个分支中，head -n 1会返回第一个查到的分支。如果你的项目有特定的分支命名规则（比如development、release/*），可以通过过滤来精准获取，比如：

  SOURCE_BRANCH=$(git for-each-ref --format='%(refname:short)' refs/heads/ --contains "$COMMIT_HASH" | grep -E '^development|^release/' | head -n 1)
  

• 已删除的分支：如果标签是从一个已经被删除的远程分支创建的，这个方法无法找到对应的分支，因为本地拉取不到已删除的分支。这种场景下只能依赖创建标签时的备注信息（如果有的话），但这不是可靠的方案。
• 性能考虑：拉取完整仓库历史对于大型项目可能会增加CI运行时间，如果你的项目标签都是从特定几个分支创建的，可以只拉取这些分支来优化，比如git fetch origin development release/*。

内容的提问来源于stack exchange，提问作者Têtard