極狐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
快速操作。 -
在面板里拖動一個議題到一個里程碑列表
-
從議題列表里批量編輯議題
按里程碑過濾議題和合并請求
在列表頁面中過濾
從項目和群組議題/合并請求列表頁面,您可以按群組和項目里程碑過濾
在議題看板中過濾
從項目議題看板,您可以按群組里程碑和項目里程碑進行過濾:
- 搜索和過濾欄
- 議題看板配置
從群組議題看板,您可以僅按群組里程碑進行過濾:
- 搜索和過濾欄
- 議題看板配置
特殊里程碑過濾器
按里程碑過濾時,除了選擇特定的項目里程碑或群組里程碑外,您還可以選擇特殊的里程碑過濾器。
-
無:顯示沒有指定里程碑的議題或合并請求。
-
任何:顯示具有指定里程碑的議題或合并請求。
-
即將到來的:顯示已分配為開放的里程碑并在未來具有最近截止日期的議題或合并請求。
-
已開始:顯示具有開放分配里程碑且開始日期早于今天的議題或合并請求。