这篇“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/bug
和kind/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;
L 指的是大号,代表Large;
其中X 并不是指特定的字母,而是Extra
的首发音,表示特别的:
XS 指特别小
XL 指特别大
XXL 指比XL还要大
有两点需要了解:
表示优先级的标签
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标签有什么用”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注天达云行业资讯频道。