共计 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 行业资讯频道。