Labels

Labels
Labels

Labels

原文：https://docs.gitlab.com/ee/user/project/labels.html

Overview
Project labels and group labels
Assign and unassign labels
Label management
Scoped labels
- Workflows with scoped labels
- Scoped labels with nested scopes
Subscribing to labels
Label priority
Troubleshooting
- Some label titles end with _duplicate<number>

Labels

Overview

随着您在 GitLab 中问题，合并请求和史诗数量的增长，跟踪这些项目变得越来越困难. 尤其是随着您的组织从只有几个人发展到成百上千. 标签就是在这里出现的.它们可以帮助您组织和标记工作，以便您可以跟踪和找到您感兴趣的工作项.

标签是发行板的关键部分. 使用标签，您可以：

使用颜色和描述性标题（例如bug ， feature request或docs对史诗，问题和合并请求进行分类.
动态过滤和管理史诗，问题和合并请求.
搜索问题列表，合并请求和史诗以及问题面板 .

Project labels and group labels

GitLab 中有两种类型的标签：

项目标签只能分配给该项目，并且只能合并该项目中的请求.
可以将组标签分配给选定组或其子组中的任何项目中的问题并合并请求.
- 也可以将它们分配给所选组或其子组中的史诗.

Assign and unassign labels

每个问题，合并请求和史诗都可以分配任意数量的标签. 标签在右侧栏中管理，您可以在其中根据需要分配或取消分配标签.

要将标签分配给问题，请合并请求或史诗：

在侧边栏的标签部分，点击编辑，然后：
- 在列表中，单击所需的标签. 每个标签都带有复选标记.
- 通过输入搜索查询并单击搜索来查找标签（），然后点击它们. 您可以反复搜索并添加更多标签.
单击X或标签部分之外的任何位置，然后将应用标签.

您也可以使用/assign @username快速操作来分配标签.

Label management

具有 Reporter 或更高权限级别的用户可以创建和编辑标签.

Project labels

通过转到项目并单击问题>标签来查看项目标签列表. 该列表包括在项目级别定义的所有标签，以及从直接父组继承的所有标签. 您可以通过在顶部输入搜索查询并点击搜索（）.

要创建一个新的项目标签：

导航到项目中的” 问题”>”标签 “.
单击新建标签按钮.
- 输入标题.
- （可选）输入描述.
- （可选）通过单击可用颜色来选择背景颜色，或输入特定颜色的十六进制颜色值.
单击创建标签以创建标签.

您也可以从发布或合并请求中创建新的项目标签. 在问题或合并请求的右侧栏中的标签部分：

Click Edit.
Click 创建项目标签.
- 填写名称字段. 请注意，如果以此方式创建标签，则无法指定描述. 您可以稍后通过编辑标签来添加描述（请参见下文）.
- （可选）通过单击可用颜色来选择颜色，或输入特定颜色的十六进制颜色值.
Click Create.

创建标签后，您可以通过点击铅笔（），或通过单击三个点（）旁边的” 订阅”按钮，然后选择” 删除” .

Promote a project label to a group label

如果您以前创建了项目标签，现在想使其可用于同一组中的其他项目，则可以将其升级为组标签.

如果同一组中的其他项目具有相同标题的标签，则它们将全部与新的组标签合并. 如果存在具有相同标题的组标签，则它也会被合并.

所有发行，合并请求，发行板列表，发行板过滤器以及带有旧标签的标签订阅都将分配给新的组标签.

警告： 警告：提升标签是永久性的操作，不能撤消.

要将项目标签提升为组标签：

导航到项目中的” 问题”>”标签 “.
单击三个点（）旁边的订阅按钮，然后选择升级为组标签 .

Group labels

通过转到组并单击问题>标签来查看组标签列表. 该列表包括仅在组级别定义的所有标签. 它没有列出项目中定义的任何标签. 您可以通过在顶部输入搜索查询并点击搜索（）.

要创建组标签 ，请导航到组中的” 问题”>”标签” ，并按照与创建项目标签相同的过程进行操作.

Create group labels from epics

您可以从 Epic 侧边栏创建组标签. 您创建的标签将属于该史诗所属的直接组. 该过程与根据发布或合并请求创建项目标签的过程相同.

Generate default labels

如果项目或组没有标签，则可以从标签列表页面生成一组默认的项目或组标签. 如果列表为空，该页面将显示一个” 生成默认标签集”按钮，单击该按钮会将以下默认标签添加到项目中：

bug
confirmed
critical
discussion
documentation
enhancement
suggestion
support

Scoped labels

Introduced in GitLab Premium 11.10.

范围标签允许团队使用标签功能来注释问题，合并请求和具有互斥标签的史诗. 通过防止某些标签一起使用，可以启用更复杂的工作流程.

当标签标题中使用特殊的双冒号（ :: :）语法时，该标签将成为作用域，例如：

issue，merge request 或 epic 不能具有形式为key::value且具有相同key两个范围标签. 使用相同的key添加一个新标签，但是使用不同的value将导致以前的key标签被新标签替换.

用例示例：

一个问题被标识为低优先级，并向其添加了priority::low项目标签.
经过更多审查后，问题优先级增加了，并添加了priority::high标签.
manbetx 客户端打不开会自动删除priority::low标签，因为一个问题不应同时具有两个优先级标签.

Workflows with scoped labels

假设您要在问题中创建一个自定义字段，以跟踪功能所针对的操作系统平台，而每个问题只应针对一个平台. 然后，您将创建三个标签platform::iOS ， platform::Android ， platform::Linux . 在给定的问题上应用这些标签中的任何一个都会自动删除以platform::开头的任何其他现有标签.

可以将相同的模式应用于代表团队的工作流状态. 假设您具有标签以下标签workflow::development ， workflow::review和workflow::deployed . 如果一个问题已经应用了标签workflow::development ，并且开发人员想要将该问题推进到workflow::review ，他们将简单地应用该标签，然后workflow::development标签将被自动删除. 当您在整个标签列表中移动的问题这种行为已经存在问题板，但现在，谁可能无法在一个问题板上工作的团队成员直接将仍然能够推进工作流程中的问题始终国家本身.

在有关将范围标签用于自定义字段和工作流的视频中演示了此功能.