极狐GitLab 是 GitLab 在中国的发行版，关于中文参考文档和资料有：

• 极狐GitLab 中文文档
• 极狐GitLab 中文论坛
• 极狐GitLab 官网

里程碑 (BASIC ALL)

极狐GitLab 中的里程碑是一种跟踪议题和合并请求的方法，这些请求是为了在特定时间段内实现更广泛的目标而创建的。
里程碑允许您组织议题并将请求合并到一个有凝聚力的组中，并具有可选的开始日期和可选的截止日期。

作为发布的里程碑

里程碑可以用于跟踪发布：

1.设置里程碑截止日期以代表您的发布日期，并将里程碑开始日期留空。
2.将里程碑标题设置为您发布的版本，例如 Version 9.4。
3.通过从议题的右侧边栏中关联所需的里程碑，将议题添加到您的版本中。

此外，您可以将里程碑与发布功能集成。

项目里程碑和群组里程碑

里程碑可以属于项目或群组。

您只能将 项目里程碑 分配给该项目中的议题或合并请求。

您可以将 群组里程碑 分配给该群组中任何项目的任何议题或合并请求。

您还可以在仪表盘里程碑列表中查看您有权访问的所有里程碑。

要查看您有权访问的项目里程碑和群组里程碑，请选择左侧边栏中的 计划 > 里程碑。

有关项目和组里程碑 API 的信息，请参阅：

• 项目里程碑 API
• 群组里程碑 API

查看项目或群组里程碑

查看里程碑列表：

1.在左侧栏中，选择 搜索或转到 并找到您的项目或群组。
2.选择 计划 > 里程碑。

在项目中，系统显示属于该项目的里程碑。在一个群组中，系统显示属于该群组的里程碑以及该群组中的所有项目。

查看已关闭议题的项目中的里程碑

如果项目议题跟踪关闭，您可以通过转到其 URL 来访问里程碑页面。
操作步骤：

1.转到您的项目。
2.添加：/-/milestones 到您的项目 URL，例如https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/milestones。

另外，该项目的议题在群组的里程碑页面中可见。
这个体验的提升可以在议题339009里跟踪

查看所有里程碑

您可以在整个极狐GitLab 命名空间中查看您有权访问的所有里程碑。您可能看不到某些里程碑，因为它们位于您不属于的项目或群组中。

为此:

1.请左侧边栏中选择 搜索或者转到

2.选择 您的工作

3.在左侧栏，选择 里程碑。

查看里程碑详情

要查看有关里程碑的更多信息，请在里程碑列表中选择要查看的里程碑的标题。

里程碑视图显示标题和描述。这些下方还有显示以下内容的选项卡：

• 议题：显示分配给里程碑的所有议题。它们显示在如下三列中：

  • 未启动的议题（开放和未分配）
  • 处理中的议题（开放和已分配）
  • 已完成的议题（已关闭）

• 合并请求：显示分配给里程碑的所有合并请求。它们显示在如下四列中：

  • 正在进行的工作（开放和未分配）
  • 等待合并（开放和未分配）
  • 拒绝（已关闭）
  • 已合并

• 参与者：显示分配给里程碑的议题的所有指派人。

• 标记：显示分配给里程碑的议题中使用的所有标记。

燃尽图

里程碑视图包含一个燃尽图和燃起图，显示完成里程碑的进度。

里程碑侧边栏

里程碑视图上的里程碑侧栏显示以下内容：

• 完成百分比，计算方法为已关闭议题的数量除以议题总数。
• 开始日期和截止日期。
• 在分配给里程碑的所有议题和合并请求上花费的总时间。
• 分配给里程碑的所有议题的总议题权重。
• 总共、已打开、已关闭和已合并的合并请求数量。
• 链接到关联的发布。
• 你可以复制到剪切板的合并请求引用。
  

创建里程碑

于 15.0 版本，所需的最小用户角色从开发者更改为报告者。

可以在项目或群组级别创建里程碑。
先决条件：

• 对于里程碑所属的项目或群组，您必须至少具有报告者角色。

创建里程碑：

1.在左侧边栏中，选择 搜索或转到 并找到您的项目或 搜索或 转到 并找到您的群组。
2.在左侧边栏中，选择 计划 > 里程碑。
3.选择 新建里程碑。
4.输入标题。
5.可选。输入描述、开始日期和截止日期。
6.选择 新建里程碑。

编辑里程碑

于 15.0 版本，所需的最小用户角色从开发者更改为报告者。

先决条件：

• 对于里程碑所属的项目或群组，您必须至少具有报告者角色。

要编辑里程碑：

1.在左侧边栏中，选择 搜索或转到 并找到您的项目或群组。
2.选择 计划 > 里程碑

3.选择一个里程碑标题
4.在右上角，选择 里程碑操作 ({ellipsis_v})，然后选择 编辑。
5.编辑标题、开始日期、截止日期或描述。
6.选择 保存更改。

关闭里程碑

历史记录：

在极狐GitLab 15.0版本把最小用户角色从开发者更改为报告者

先决条件：

• 你在里程碑所属的项目或者群组里必须至少要有报告者角色。

要关闭里程碑：

1.在左侧栏，选择 搜索或转到 并找到你的项目或群组。
2.选择 计划 > 里程碑。
3.可以：

• 找到你想要关闭的里程碑右侧，选择里程碑操作（{ellipsis_v}）> 关闭

• 选择里程碑标题，然后选择 关闭。

删除里程碑

在极狐GitLab 15.0 版本，所需的最小用户角色从开发者更改为报告者。

先决条件：

• 对于里程碑所属的项目或群组，您必须至少具有报告者角色。

删除里程碑：

1.在左侧边栏中，选择 搜索或转到 并找到您的项目或群组。
2.选择 计划 > 里程碑。
3.可以：

• 找到要删除的里程碑，选择 里程碑操作 ({ellipsis_v}) > 删除。
• 选择里程碑标题，然后选择 里程碑操作 ({ellipsis_v}) > 删除。

5.选择删除里程碑。

将项目里程碑提升为群组里程碑

如果您要扩展群组中的项目数量，您可能希望在该群组的项目之间共享相同的里程碑。您还可以将项目里程碑提升为群组里程碑，以便将它们提供给同一群组中的其他项目。

提升里程碑，会将该群组中具有相同名称的所有项目中的所有项目里程碑合并为一个群组里程碑。

之前分配给这些项目里程碑的所有议题和合并请求都将分配给新的群组里程碑。

WARNING:此操作无法撤消，并且更改是永久性的。

先决条件：

• 您必须至少具有该群组的报告者角色。

提升项目里程碑：

1.在左侧边栏中，选择 搜索或转到 并找到您的项目。
2.选择 计划 > 里程碑。
3.可以：

• 选择 提升至群组里程碑 ({level-up})。
• 选择里程碑标题，然后选择 里程碑操作 ({ellipsis_v}) > 提升。

4.选择 提升里程碑。

为议题或合并请求分配里程碑

每个问题和合并请求都可以分配一个里程碑。

里程碑在右侧边栏中的每个议题和合并请求页面上都可见。
它们在议题看板上也可见。

要分配或取消分配里程碑：

1.查看议题或合并请求。
2.在右侧边栏的 里程碑 旁边，选择 编辑。
3.在 分配里程碑 列表中，通过输入里程碑的名称来搜索里程碑。您可以从项目里程碑和群组里程碑中进行选择。
4.选择您要分配的里程碑。

要分配或者取消分配一个里程碑，你也可以：

• 您还可以在评论或者描述中使用 /assign 快速操作。

• 在面板里拖动一个议题到一个里程碑列表

• 从议题列表里批量编辑议题

按里程碑过滤议题和合并请求

在列表页面中过滤

从项目和群组议题/合并请求列表页面，您可以按群组和项目里程碑过滤

在议题看板中过滤

从项目议题看板，您可以按群组里程碑和项目里程碑进行过滤：

• 搜索和过滤栏
• 议题看板配置

从群组议题看板，您可以仅按群组里程碑进行过滤：

• 搜索和过滤栏
• 议题看板配置

特殊里程碑过滤器

按里程碑过滤时，除了选择特定的项目里程碑或群组里程碑外，您还可以选择特殊的里程碑过滤器。

• 无：显示没有指定里程碑的议题或合并请求。

• 任何：显示具有指定里程碑的议题或合并请求。

• 即将到来的：显示已分配为开放的里程碑并在未来具有最近截止日期的议题或合并请求。

• 已开始：显示具有开放分配里程碑且开始日期早于今天的议题或合并请求。