共計 2114 個字符,預計需要花費 6 分鐘才能閱讀完成。
這篇“kubernetes 的 Issue 和 PR 標簽有什么用”文章的知識點大部分人都不太理解,所以丸趣 TV 小編給大家總結了以下內容,內容詳細,步驟清晰,具有一定的借鑒價值,希望大家閱讀完這篇文章能有所收獲,下面我們一起來看看這篇“kubernetes 的 Issue 和 PR 標簽有什么用”文章吧。
一般標簽標簽含義備注 good first issue 指示該 issue 適合由新貢獻者參與參照 help wanted 指導文檔 help wanted 指示該 issue 需要幫助必須滿足 help wanted 指導文檔 needs-kind 指示該 issue 需要指定一個類型標簽
lgtm 指示該 PR 可以合入了
表示類型的標簽
類型標簽用于標識 Isuue 或 Pull Request 的類別,比如文檔、bug、新特性、技術負債等等。表示類型的標簽格式為 kind/xxx(其中 xxx 指代某種類別)。
下表展示了社區常用的標簽:
標簽含義備注 kind/design 指示該 issue 涉及到設計
kind/documentation 指示該 issue 涉及到文檔
kind/feature 指示該 issue 涉及到新特性
kind/cleanup 指示該 issue 屬于代碼清理、技術負債類型
kind/bug 指示該 issue 涉及到 bug
kind/flake 指示該 issue 涉及到 flaky test 有可能這個問題由 Flake 測試報出的 kind/api-change 指示該 issue 源于 API 變更
kind/failing-test 指示該 issue 持續或經常出現
needs-kind 指示該 PR 缺少一個類型標簽
類型標簽可以用在 Issue 中,也可以用在 Pull Request 中,但在 Issue 中并不是必須的,相反,如果一個 Pull Request 沒有任何一個 kind/xxx 標簽,那么機器人會自動給該 Pull Request 打上一個 needs-kind 標簽,以提醒審核者打上某個類型的標簽。
另外,kind/xxx 標簽之間并不是互斥的,意思是同一個 Issue 或 Pull Request 中可以出現多個 kind/xxx 標簽,比如同一個 Pull Request 可能在解決了一個 bug 的同時還做了一些代碼清理工作,那么這個 Pull Request 就可能會同時擁有 kind/bug 和 kind/cleanup 兩個標簽。
表示領域的標簽
領域標簽用于標識 Isuue 或 Pull Request 的領域,比如 kubelet、etcd、kubectl 等。表示領域的標簽都使用 area/xxx 格式。
Kubernetes 領域眾多,每個領域都需要一個標簽,當前已有 80 多個標簽。一般情況下從標簽名字上就可以很直觀的看出其所屬的領域,常用的標簽列舉如下:
標簽含義備注 are/kubectlkubectl 領域問題
are/apiserverapiserver 領域問題
are/kubeletkubelet 領域問題
表示修改量的標簽
size/xxx 用來表示一個 Pull Request 的修改量,以便 reviewer 可以直觀的看到修改大小。
每個 Pull Request 被創建后,機器人都會跟據代碼修改量來給該 Pull Request 打上 size/xxx 標簽。
每個標簽及其代碼修改量如下所示:標簽 | 含義 | 備注 ——– | —— | —— size/XS | 修改 0 - 9 行 | size/S | 修改 10-29 行 | size/M | 修改 30-99 行 | size/L | 修改 100-499 行 | size/XL | 修改 500-999 行 | size/XXL | 修改超過 1000 行 |
這些尺碼的英文釋義跟服裝尺碼一致:
S 指的是小號,代表 Small;
M 指的是中號,代表 Medium;
L 指的是大號,代表 Large;
其中 X 并不是指特定的字母,而是 Extra 的首發音,表示特別的:
XS 指特別小
XL 指特別大
XXL 指比 XL 還要大
有兩點需要了解:
size/xxx 標簽僅適用于 Pull Request,因為 Issue 并不涉及到代碼修改;
size/xxx 標簽是由機器人自動計算代碼修改量并設置的,不需要人工干預;
表示優先級的標簽
priority/xxx 用來標識 Pull Request 的優先級,機器人會先處理優先級高的 Pull Request,優先安排自動化測試。
kubernetes 社區定義了以下幾個優先級:
標簽含義備注 priority/awaiting-more-evidence 低優先級,暫時擱置
priority/backlog 一般優先級
priority/important-longterm 重要,但需要較長的周期才可以完成
priority/important-soon 高優先級,應該盡快處理
priority/critical-urgent 最高優先級
needs-priority 需要一個優先級標簽
當 Pull Request 沒有 priority/xxx 標簽時,機器人會自動打上 needs-priority 標簽,意思是需要一個優先級標簽。
以上就是關于“kubernetes 的 Issue 和 PR 標簽有什么用”這篇文章的內容,相信大家都有了一定的了解,希望丸趣 TV 小編分享的內容對大家有幫助,若想了解更多相關的知識內容,請關注丸趣 TV 行業資訊頻道。