受保护的标签 (FREE)
受保护的标签:
- 允许控制谁有权创建标签。
- 一旦创建,防止意外更新或删除。
每个规则都允许您匹配:
- 一个单独的标签名称。
- 通配符一次控制多个标签。
此功能由受保护的分支演变而来。
谁可以修改受保护的标签
默认情况下:
- 要创建标签,您必须具有维护者角色。
- 没有人可以更新或删除标签。
配置受保护的标签
要保护标签,您至少需要具有维护者角色。
-
转到项目的 设置 > 仓库。
-
从 标签 下拉菜单中,选择要保护或键入的标签,然后单击 创建通配符。在下面的屏幕截图中,我们选择保护所有匹配
v*
的标签: -
从 允许创建 下拉列表中,选择有权创建匹配标签的用户,然后单击 保护:
-
完成后,受保护的标签会显示在 受保护的标签 列表中:
受保护的标签通配符
您可以指定一个保护标签通配符,它会保护所有与通配符匹配的标签。例如:
受保护的标签通配符 | 匹配标签 |
---|---|
v* |
v1.0.0 , version-9.1
|
*-deploy |
march-deploy , 1.0-deploy
|
*gitlab* |
gitlab , gitlab/v1
|
* |
v1.0.1rc2 , accidental-tag
|
两个不同的通配符可能匹配同一个标签。 例如,*-stable
和 production-*
都会匹配一个 production-stable
标签。
在这种情况下,如果这些受保护标签中的任何具有类似 允许创建 的设置,那么 production-stable
也会继承此设置。
如果单击受保护标签的名称,系统会显示所有匹配标签的列表:
防止创建与分支同名的标签
同名的标签和分支可以包含不同的提交。如果您的标签和分支使用相同的名称,则运行 git checkout
命令的用户可能会检查标签 qa
,而不是检查分支 qa
。
为了防止这个问题:
-
确定您不想用作标签的分支名称。
-
如配置受保护的标签中所述,创建受保护的标签:
- 在 名称 中,请提供一个名称,例如
stable
。您还可以创建通配符,例如stable-*
来匹配多个名称,例如stable-v1
和stable-v2
。 - 在 允许创建 中,选择 No one。
- 选择 保护。
- 在 名称 中,请提供一个名称,例如
用户仍然可以使用受保护的名称创建分支,但不能创建标签。
删除受保护的标签
您可以使用 API 或用户界面手动删除受保护的标签。
先决条件:
- 您必须在项目中至少拥有维护者角色。
操作步骤:
- 在顶部栏上,选择 菜单 > 项目 并找到您的项目。
- 在左侧边栏上,选择 仓库 > 标签。
- 在您要删除的标签旁边,选择 删除 ({remove})。
- 在确认对话框中,输入标签名称并选择 是,删除受保护的标签。
只能使用极狐GitLab 从 UI 或 API 删除受保护的标签。 这些保护措施可防止您通过本地 Git 命令或第三方 Git 客户端意外删除标签。