里程碑

里程碑帮助跟踪和组织工作在极狐GitLab#

里程碑：

• 将相关议题和合并请求分组，以跟踪目标的进展。
• 支持基于时间的计划，具有可选的开始和截止日期。
• 与迭代一起工作以跟踪并行时间框。
• 跟踪发布并生成发布证据。
• 应用于项目和群组。

里程碑可以属于项目或群组。项目里程碑仅适用于该项目中的议题和合并请求。群组里程碑适用于该群组项目中的任何议题或合并请求。

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

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

里程碑作为发布#

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

1. 设置里程碑截止日期以表示发布的发布日期。如果您没有定义发布周期的开始日期，则可以将里程碑开始日期留空。
2. 将里程碑标题设置为发布的版本，例如 Version 9.4。
3. 通过从议题的右侧边栏中选择里程碑，将议题添加到您的发布中。

此外，要在创建发布时自动生成发布证据，请将里程碑与发布功能集成。

项目里程碑和群组里程碑#

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

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

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

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

查看项目或群组里程碑#

要查看里程碑列表：

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

在项目中，极狐GitLab 显示属于该项目的里程碑。在群组中，极狐GitLab 显示属于该群组的里程碑以及该群组中的所有项目和子群组的里程碑。

查看关闭议题功能的项目中的里程碑#

如果项目关闭了议题跟踪功能，关闭议题功能，要进入里程碑页面，请输入其 URL。

为此：

1. 前往您的项目。
2. 在项目 URL 后添加：/-/milestones。例如 https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/milestones。

或者，该项目的议题在群组的里程碑页面中可见。

查看所有里程碑#

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

为此：

1. 在左侧边栏，选择 搜索或前往。
2. 选择 您的工作。
3. 在左侧边栏，选择 里程碑。

查看里程碑详情#

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

里程碑视图显示标题和描述。标题和描述下方的标签显示以下内容：

• 议题：显示分配给里程碑的所有议题。议题显示在三个名为：
  • 未开始的议题（开放和未分配）
  • 正在进行的议题（开放和已分配）
  • 已完成的议题（已关闭）
• 合并请求：显示分配给里程碑的所有合并请求。合并请求显示在四个名为：
  • 工作进行中（开放和未分配）
  • 等待合并（开放和已分配）
  • 已拒绝（已关闭）
  • 已合并
• 参与者：显示分配给里程碑的议题的所有受托人。
• 标签：显示分配给里程碑的议题中使用的所有标签。

燃尽图#

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

里程碑侧边栏#

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

• 完成百分比，计算为已关闭议题数量除以议题总数。
• 开始日期和截止日期。
• 分配给里程碑的所有议题和合并请求的总时间花费。
• 分配给里程碑的所有议题的总议题权重。
• 总计、开放、已关闭和已合并的合并请求数量。
• 链接到相关发布。
• 您可以复制到剪贴板的里程碑参考。

创建一个里程碑#

您可以在项目或群组中创建一个里程碑。

先决条件：

• 您必须至少拥有里程碑所属项目或群组的计划者角色。

要创建一个里程碑：

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

编辑一个里程碑#

先决条件：

• 您必须至少拥有里程碑所属项目或群组的计划者角色。

要编辑一个里程碑：

1. 在左侧边栏，选择 搜索或前往 并找到您的项目或群组。
2. 选择 计划 > 里程碑。
3. 选择一个里程碑的标题。
4. 在右上角，选择 里程碑操作 (
   ) 然后选择 编辑。
5. 编辑标题、开始日期、截止日期或描述。
6. 选择 保存更改。

关闭一个里程碑#

先决条件：

• 您必须至少拥有里程碑所属项目或群组的计划者角色。

要关闭一个里程碑：

1. 在左侧边栏，选择 搜索或前往 并找到您的项目或群组。
2. 选择 计划 > 里程碑。
3. 任选其一：
   • 在您要关闭的里程碑旁边，选择 里程碑操作 (
     ) > 关闭。
   • 选择里程碑标题，然后选择 关闭。

删除一个里程碑#

先决条件：

• 您必须至少拥有里程碑所属项目或群组的计划者角色。

要删除一个里程碑：

1. 在左侧边栏，选择 搜索或前往 并找到您的项目或群组。
2. 选择 计划 > 里程碑。
3. 任选其一：
   • 在您要删除的里程碑旁边，选择 里程碑操作 (
     ) > 删除。
   • 选择里程碑标题，然后选择 里程碑操作 (
     ) > 删除。
4. 选择 删除里程碑。

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

如果您正在扩大群组中的项目数量，您可能希望在该群组的项目中共享相同的里程碑。您可以将项目里程碑提升到父群组，以使它们对同一群组中的其他项目可用。

提升里程碑将合并该群组中所有具有相同名称的项目里程碑为一个群组里程碑。所有先前分配给这些项目里程碑的议题和合并请求将分配给新的群组里程碑。

先决条件：

• 您必须至少拥有群组的计划者角色。

要提升项目里程碑：

1. 在左侧边栏，选择 搜索或前往 并找到您的项目。
2. 选择 计划 > 里程碑。
3. 任选其一：
   • 在您要提升的里程碑旁边，选择 里程碑操作 (
     ) > 提升。
   • 选择里程碑标题，然后选择 里程碑操作 (
     ) > 提升。
4. 选择 提升里程碑。

将里程碑分配给议题或合并请求#

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

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

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

您还可以通过以下方式分配或取消分配里程碑：

• 在评论或描述中使用 /milestone 快速操作
• 在板中将议题拖动到里程碑列表
• 从议题列表中批量编辑议题

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

列表页面中的过滤器#

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

议题板中的过滤器#

在项目议题板中，您可以在以下位置按群组里程碑和项目里程碑进行过滤：

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

在群组议题板中，您只能在以下位置按群组里程碑进行过滤：

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

特殊里程碑过滤器#

在按里程碑进行过滤时，除了选择特定项目里程碑或群组里程碑之外，您还可以选择一个特殊里程碑过滤器。

• None: 显示没有分配里程碑的议题或合并请求。
• Any: 显示有分配里程碑的议题或合并请求。
• Upcoming: 显示分配了开放里程碑且未来最近的截止日期的议题或合并请求。
• Started: 显示分配了开放里程碑且开始日期早于今天的议题或合并请求。

"Upcoming" 和 "Started" 过滤器（已弃用）#

"Upcoming" 和 "Started" 特殊过滤器的行为计划在即将到来的极狐GitLab 主要版本 18.0 中发生变化。