如何避免GitLab创建新标签时触发流水线（模板引用场景）

针对你遇到的问题，核心原因大概率是以下两种情况之一：

1. 模板中的规则是作业级别的rules，而非全局workflow规则 #

你提到模板的release.yml里配置了“不触发流水线”的规则，但如果这些规则是写在.release作业的rules字段中，而非全局的workflow块里，就会出现这种情况：

• 作业级别的rules只会控制单个作业是否运行，但流水线本身仍会被创建。所以当Semantic Release创建标签后，GitLab还是会触发针对标签的第二条流水线，只是.release作业不会在这条流水线里执行。
• 而当你直接在项目的.gitlab-ci.yml里写全局workflow规则时，是从根源上阻止了标签流水线的创建，所以不会出现第二条流水线。

检查你的模板release.yml，确保规则是写在全局workflow下，而非作业的rules中：

# 正确的全局workflow写法
workflow:
  rules:
    - if: $CI_COMMIT_TAG
      when: never
    - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "test"
      when: always

# 作业模板部分
.release:
  script:
    - # 你的Semantic Release脚本

2. 项目的.gitlab-ci.yml覆盖了模板的workflow规则 #

GitLab CI中，全局workflow配置的优先级是：

• 项目自身.gitlab-ci.yml中定义的workflow会覆盖所有引入模板中的workflow。
• 如果项目没有定义workflow，则最后一个引入的模板中的workflow生效。

如果你的项目的.gitlab-ci.yml里自己定义了workflow，或者引入了其他包含workflow的模板，那么你自己模板中的workflow规则会被覆盖，导致标签流水线无法被阻止。

解决方法：

• 移除项目中多余的workflow配置，确保只有你的模板中的workflow生效。
• 调整模板引入顺序，让你的模板成为最后一个被引入的包含workflow的模板。

额外验证点 #

可以在标签流水线的运行日志中查看CI_COMMIT_TAG和CI_COMMIT_BRANCH变量的值，确认模板的workflow规则是否被正确应用：

• 针对标签的流水线中，CI_COMMIT_BRANCH变量是空的，只有CI_COMMIT_TAG有值。
• 如果模板的workflow规则顺序正确（先判断CI_COMMIT_TAG，再判断分支），则应该触发when: never阻止流水线。

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