GitLab流水线如何仅在默认分支带标签时执行发布任务？

问题核心在于：当通过标签触发GitLab流水线时，CI环境中的分支相关变量（如$CI_COMMIT_REF_NAME、$CI_COMMIT_BRANCH）不会指向默认分支——此时$CI_COMMIT_REF_NAME是标签名称，$CI_COMMIT_BRANCH为空。因此直接同时判断分支和标签的条件永远无法成立。

正确配置方案 #

我们需要先通过标签触发任务，再验证该标签对应的提交是否存在于默认分支上。配置如下：

release_job:
  stage: release
  image: registry.gitlab.com/gitlab-org/release-cli:latest
  before_script:
    # 拉取默认分支的最新代码
    - git fetch origin $CI_DEFAULT_BRANCH
    # 检查当前标签对应的提交是否是默认分支的祖先（即存在于默认分支上）
    - |
      if ! git merge-base --is-ancestor $CI_COMMIT_SHA origin/$CI_DEFAULT_BRANCH; then
        echo "错误：该标签对应的提交不在默认分支 $CI_DEFAULT_BRANCH 上"
        exit 1
      fi
  release:
    tag_name: $CI_COMMIT_TAG
    name: "Release $CI_COMMIT_TAG"
    description: "Release created using the release-cli."
  rules:
    # 仅当存在标签时触发任务
    - if: $CI_COMMIT_TAG

配置说明 #

• rules: - if: $CI_COMMIT_TAG：确保只有当提交带有标签时，才会初始化该任务。
• before_script中的git命令：
  1. git fetch origin $CI_DEFAULT_BRANCH：拉取默认分支的远程代码，保证本地能获取到最新的分支状态。
  2. git merge-base --is-ancestor $CI_COMMIT_SHA origin/$CI_DEFAULT_BRANCH：验证当前标签对应的提交（$CI_COMMIT_SHA）是否是默认分支的祖先提交，也就是该提交是否存在于默认分支的提交历史中。如果验证不通过，脚本会输出错误信息并退出，终止发布任务。

这样就能实现仅当标签对应提交在默认分支上时，才完成发布任务的需求。

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