标签谁都能打,发布出口该怎么守住

极狐GitLab
2026年11月19日
18000
分享:

标签谁都能打,发布出口该怎么守住

定义框|受保护标签(Protected Tags)
极狐GitLab 提供的一种代码仓库权限规则,用来控制「谁有权限创建某个标签」,并防止标签在创建后被意外更新或删除。一条规则可以匹配单个标签名,也可以用通配符一次覆盖一批标签。它源自受保护分支的机制,配置入口在「设置 > 代码仓库 > 受保护标签」。受保护标签只能通过平台的 UI 或 API 删除,本地 Git 命令与第三方客户端都删不掉。

发版这件事,很多团队把注意力全放在流水线上:构建、测试、制品、灰度,一环扣一环。但真正决定「哪个版本能被发出去」的,往往是一个不起眼的动作——给某次提交打个标签,比如 v2.8.0。

问题就出在这。标签默认谁都能打:任何一个有开发者角色的成员,本地一条 git tag v2.8.0 && git push origin v2.8.0 就能触发一条以版本标签为起点的发布流水线。标签名写错了、打在了错误的提交上、或者被人误删,都有机会让一次发布偏离预期。更麻烦的是,标签被删掉后,对应的版本溯源链也跟着断了。

为什么发布出口值得单独设一道闸(Why)

把标签管起来,解决的不是「权限洁癖」,而是三个很具体的工程问题。

第一,发布触发源需要收口。 在极狐GitLab 里,标签常用于触发发布流水线(CI_COMMIT_TAG)。如果打标签的权限和跑发布流水线的人不是同一批人,等于把「决定发哪个版本」和「决定怎么发」拆给了两拨人,出问题时很难对齐。

第二,标签是不可变的版本锚点。 代码分支会继续往前走,但 v2.8.0 应该永远指向那一次确定的提交。受保护标签能防止创建后被意外更新或删除,让回滚、审计、对外交付的版本号都有一个稳定参照。

第三,命名需要统一规则。 版本号、发布候选、热修复标签混着用,人肉约定早晚失效。用通配符规则(如 v*)把「谁能打发布标签」一次性约束住,比在文档里写十遍规范有效。

需要说清楚的是,受保护标签不是万能锁。它管的是「标签的创建与删除」,不改变流水线本身的构建逻辑,也不替代代码审查。它的定位很明确:给版本出口加一道与职责匹配的门槛。

怎么配,按这四步来(How)

第 1 步:确认角色前提。 配置受保护标签需要项目维护者或所有者角色。先盘点现有标签命名习惯(git tag --list 'v*'),把正式版本、候选版本、临时标签分清楚。

第 2 步:在 UI 里建规则。 进入「设置 > 代码仓库」,展开「受保护标签」,选择「添加新项」。保护单个标签就从下拉列表里选标签名;要覆盖一批标签,输入带 * 的字符串并选择「创建通配符」。随后在「允许创建」里选择可创建该标签的角色,专业版与旗舰版还能把指定群组或单个用户加进来。

官方文档给出的通配符语义值得抄下来对照:v* 匹配 v1.0.0、version-9.1;*-deploy 匹配 march-deploy、1.0-deploy;*gitlab* 匹配 gitlab、gitlab/v1;单独一个 * 匹配全部标签。若两个通配符都能匹配同一个标签(例如 *-stable 与 production-* 都命中 production-stable),只要其中任一规则带了「允许创建」设置,该标签就继承这个设置。

第 3 步:用 API 把规则纳入 IaC。 手工点选适合试点,规模化要靠 API 固化:

# 保护所有 v 开头的版本标签,仅维护者可创建
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "name=v*" \
  --data "allowed_to_create[][access_level]=40" \
  "https://gitlab.example.com/api/v4/projects/123/protected_tags"

# 查询已生效的规则
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/projects/123/protected_tags"

POST /projects/:id/protected_tags 的 name 必填,allowed_to_create 是访问级别数组,元素可用 {user_id}、{group_id}、{deploy_key_id}、{access_level} 几种形式,其中 user_id、group_id、access_level 仅专业版与旗舰版可用。响应里的 create_access_levels 会回显生效配置,可直接拿去做合规核对。

第 4 步:把它和发布流水线绑起来。 受保护标签解决「谁能打」,流水线还要解决「打了之后跑什么」。用 workflow: rules 让发布流水线只在版本标签上创建,避免每次普通推送都空跑一遍:

workflow:
  rules:
    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
    - if: $CI_PIPELINE_SOURCE == "web"
      when: manual
    - when: never

release-build:
  stage: deploy
  script:
    - echo "构建并发布 $CI_COMMIT_TAG"
  rules:
    - if: $CI_COMMIT_TAG

workflow 关键字在作业之前求值,被它挡掉的流水线里,作业级 rules 不会再有机会执行——这个先后顺序是排查「规则写了却不生效」时最先要确认的一点。

几个容易踩的坑(Tips)

通配符重叠时别想当然。 多条规则命中同一标签时,「允许创建」是继承合并的,不是取最严或最松。想收紧权限,得先把重叠的通配符梳理干净。

取消保护不等于删标签。 「取消保护」只是移除规则,之后开发者、维护者、所有者都能删除匹配该模式的标签;真正删除标签要从「代码 > 标签」进入,输入标签名确认。两件事别混。

本地删不掉是设计,不是故障。 受保护标签只能通过平台 UI 或 API 删除,git push --delete origin v2.8.0 会被拒绝。遇到「删不掉」先确认是不是保护规则在生效,而不是去改本地 Git 配置。

部署密钥要单独授权。 若发布流程用部署密钥打标签,需要开启「允许部署密钥创建受保护标签」,否则自动化脚本会在推送标签那一步被拦下。

顺手关掉同名冲突。 官方还提供「防止创建与分支同名的标签」,多分支并行开发的仓库建议一并打开,减少 git checkout 时的歧义。

常见问题(FAQ)

Q1:受保护标签会不会挡住日常开发打标签?

不会,只要规则只覆盖发布类标签(如 v*),日常临时标签仍可自由创建。关键是先规划命名分区,再配通配符,别一上来就用 *。

Q2:它和受保护分支有什么区别?

机制同源,作用对象不同。受保护分支约束的是「谁能向分支推送、合并」,受保护标签约束的是「谁能创建/删除版本锚点」。发布链路建议两者都配,前者管代码入口,后者管版本出口。

Q3:流水线没在打标签后触发,先查哪里?

先查 workflow: rules 是否把标签流水线挡掉了(它在作业之前求值),再查作业级 rules 是否匹配 CI_COMMIT_TAG,最后确认该标签是否落在受保护规则的命名范围内。


把版本出口纳入治理
受保护标签是极狐GitLab 代码仓库权限体系里成本最低、见效最快的一环:不用改流水线逻辑,就能把「谁决定发哪个版本」讲清楚。建议先用一条 v* 规则试点,再把规则写进 IaC 与项目模板,逐步推广到全部发布仓库。
想了解极狐GitLab 在 CI/CD、代码安全与研发效能上的完整能力,可访问 极狐GitLab 官网 查阅文档中心,或预约一次产品演示,结合自己团队的版本流程做一次对照评估。