GitLab流水线触发规则问题：Release分支SemVer标签提交无法触发流水线

问题根源 #

你编写的规则同时依赖CI_COMMIT_TAG和CI_COMMIT_BRANCH两个变量，但GitLab的标签流水线不会设置CI_COMMIT_BRANCH变量——这个变量仅在分支推送、合并请求等分支类型的流水线中存在。当你在release分支创建标签并触发流水线时，CI_COMMIT_BRANCH的值为空，导致$CI_COMMIT_BRANCH == "release"的条件永远不满足，流水线自然不会触发。

修复方案 #

方案1：校验标签格式+提交归属分支 #

保留标签格式的判断，同时在流水线前置步骤中验证标签对应的提交属于release分支，确保只有在release分支上打的符合要求的标签才会执行后续部署：

stages:
  - pre-check
  - deploy

verify_tag_on_release:
  stage: pre-check
  rules:
    - if: '$CI_COMMIT_TAG =~ /^v?\d+\.\d+\.\d+$/'
  script:
    # 拉取release分支最新代码
    - git fetch origin release
    # 检查当前标签的提交是否在release分支上
    - |
      if ! git merge-base --is-ancestor $CI_COMMIT_SHA origin/release; then
        echo "错误：该标签未关联release分支的提交，终止流水线"
        exit 1
      fi

deploy_to_production:
  stage: deploy
  rules:
    - if: '$CI_COMMIT_TAG =~ /^v?\d+\.\d+\.\d+$/'
  script:
    # 此处添加你的部署脚本
    - echo "执行部署操作..."

方案2：利用受保护标签（更简洁） #

如果你在GitLab仓库设置中配置了受保护标签（匹配^v?\d+\.\d+\.\d+$格式），并且仅允许在release分支创建这类标签，可以直接结合CI_COMMIT_REF_PROTECTED变量判断：

rules:
  - if: '$CI_COMMIT_TAG =~ /^v?\d+\.\d+\.\d+$/ && $CI_COMMIT_REF_PROTECTED == "true"'

注：配置受保护标签的路径为：仓库设置 → 仓库 → 受保护标签，添加匹配规则^v?\d+\.\d+\.\d+$，并设置仅允许维护者创建。

额外注意事项 #

• 通过GitLab UI创建标签时，务必确认选择的目标分支是release；
• 手动打标签后，需要执行git push origin <tag-name>推送标签到远程仓库，否则流水线不会触发。

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