kubernetes的Issue和PR标签有什么用

这篇“kubernetes的Issue和PR标签有什么用”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“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/bugkind/cleanup两个标签。

表示领域的标签

领域标签用于标识Isuue或Pull Request的领域,比如kubelet、etcd、kubectl等。 表示领域的标签都使用area/xxx格式。

Kubernetes领域众多,每个领域都需要一个标签,当前已有80多个标签。 一般情况下从标签名字上就可以很直观的看出其所属的领域,常用的标签列举如下:

标签 含义 备注
are/kubectl kubectl领域问题
are/apiserver apiserver领域问题
are/kubelet kubelet领域问题

表示修改量的标签

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;

    kubernetes的Issue和PR标签有什么用
  • 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标签有什么用”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注云行业资讯频道。

赞(0)
未经允许不得转载:主机测评网 » kubernetes的Issue和PR标签有什么用
分享到: 更多 (0)