Minikube 问题分类

如何在 minikube 仓库中对问题进行分类

社区问题分类会**每周三**举行,时间为**太平洋时间上午 11:05 至 11:55**。

所有社区成员都欢迎并鼓励加入我们,帮助我们对 minikube 进行问题分类!

问题分类是维护 minikube 仓库健康状况的重要组成部分。一个组织良好的仓库能够让维护者优先处理功能请求、修复错误,并尽快响应遇到工具困难的用户。

问题分类包括:

  • 标记问题
  • 回应问题
  • 关闭问题

如果您有兴趣帮助 minikube 问题分类,本文档涵盖了分类的基本知识。

此外,如果您有兴趣参加我们的每周问题分类会议,请填写此表格以表达您的兴趣。谢谢!

日常问题分类

日常问题分类有两个目标:

  1. 对新问题的响应速度
  2. 当明确请求的信息已提供时的响应速度

未处理项列表位于http://tinyurl.com/mk-tparty/daily-triage - 它包括:

  1. 没有 `kind/` 或 `triage/` 标签的问题
  2. 没有 `priority/` 标签的问题
  3. 用户已跟进的 `triage/needs-information` 问题,现在需要回应。

分类

问题分类最重要的级别是定义其类型。我们通常希望每个问题至少有一个以下标签,有些问题可能属于多个类别:

  • `kind/support` - 大多数新入问题的默认标签
  • `kind/bug` - 当出现 bug 或我们未能提供最佳用户体验时

其他可能性:

  • `kind/feature` - 识别新功能请求
  • `kind/flake` - 用于不稳定的集成或单元测试
  • `kind/cleanup` - 清理/重构代码库
  • `kind/documentation` - minikube 文档的更新或补充
  • `kind/ux` - 涉及改善用户体验的问题
  • `kind/security` - minikube 中存在安全漏洞时

如果问题特定于某个操作系统、虚拟机管理程序、容器、插件或 Kubernetes 组件:

os/[操作系统] - 当问题似乎特定于某个操作系统时

  • os/linux
  • os/macos
  • os/windows

co/[驱动] - 当问题似乎特定于某个驱动时

  • co/hyperkit
  • co/hyperv
  • co/kvm2
  • co/none-driver
  • co/docker-driver
  • co/podman-driver
  • co/virtualbox

co/[kubernetes 组件] - 当问题似乎特定于某个 k8s 组件时

  • co/apiserver
  • co/etcd
  • co/coredns
  • co/dashboard
  • co/kube-proxy
  • co/kubeadm
  • co/kubelet
  • co/kubeconfig

其他有用的标签:

是否发生了可以对类似问题进行去重的**事件**?

  • ev/CrashLoopBackoff
  • ev/Panic
  • ev/Pending
  • ev/kubeadm-exit-1

可疑的**根本原因**

  • cause/vm-environment
  • cause/invalid-kubelet-options

需要帮助吗?

`Good First Issue` - bug 有建议的解决方案,无需进一步讨论即可实现。

`Help wanted` - 如果 bug 可以获得贡献者的帮助

优先级

如果问题不是 `kind/support`,则需要一个优先级标签

`priority/critical-urgent` - 某人 ASAP 的首要任务,例如安全问题、用户可见的错误或构建中断。很少使用。

`priority/important-soon`:在接下来的两个版本(8 周)内

`priority/important-longterm`:从现在起 2-4 个版本

`priority/backlog`:同意这是一个好主意,但目前没有人可用。考虑标记为 `help wanted`

`priority/awaiting-more-evidence`:可能更有用,但目前还没有足够的支持。

每周问题分类

每周问题分类有三个目标:

  1. 处理未回应的问题
  2. 审查和关闭 PR
  3. 关闭陈旧问题

未处理项列表可以在http://tinyurl.com/mk-tparty/weekly-triage找到。

发布后分类

发布后问题分类在主要版本发布后(大约每 4-6 周)进行。它专注于:

  1. 关闭已由该版本解决的 bug
  2. 重新确定未由该版本解决的 bug 的优先级
  3. 告知用户我们是否认为仍然存在问题

这包括审查:

  1. 过去 2 天内未触及的每个问题
  2. 长期问题的重新评估
  3. 短期问题的重新评估

回应问题

需要更多信息

请求更多信息的示例回应

我还没有找到明确的方法来重现此问题。您介意添加一些额外细节吗?以下是一些可能有用的信息:

* 使用的精确 `minikube start` 命令行

* `minikube start` 命令的完整输出,最好带上 `--alsologtostderr -v=4` 以获取额外日志。

* `minikube logs` 的完整输出

* `kubectl get po -A` 的完整输出

感谢您分享您的经验!

然后:用 `triage/needs-information` 标记。

问题可能已解决

如果您认为某个版本可能已解决了问题,请询问作者是否已解决他们的问题:

您能否检查一下 minikube 是否解决了这个问题?我们对处理方式进行了一些更改,并改进了 minikube 日志输出,以帮助我们调试此类棘手情况。

然后:用 `triage/needs-information` 标记。

谨慎关闭

问题通常需要因以下原因关闭:

  • 问题已处理
  • 问题是现有问题的重复
  • 长期缺乏信息

在任何这些情况下,我们都旨在友好地关闭问题,并向作者提供操作项,以防他们需要重新打开问题或仍然需要解决方案。

针对这些情况的示例回应包括:

问题已处理

@作者:我相信这个问题现在已由 minikube v1.4 解决,因为它。如果您在 minikube v1.4 或更高版本中仍然看到此问题,请通过评论 `/reopen` 重新打开此问题。

感谢您报告此问题!

然后:关闭问题

重复问题

此问题似乎是 #X 的重复,您介意我们将讨论转移到那里吗?

这样我们可以集中与该问题相关的内容。如果您认为此问题并非重复,请使用 `/reopen` 重新打开。如果您有更多信息要分享,请将其添加到新问题中。

感谢您报告此问题!

然后:用 `triage/duplicate` 标记并关闭问题。

信息不足

如果一个问题在超过四周内不活跃,并且作者至少被 ping 过一次,那么该问题可以被关闭。

嗨,@作者 – 这个问题还在发生吗?有更多详细信息吗?如果有,请随时通过评论 `/reopen` 重新打开此问题。由于没有可用信息且已过去一段时间,此问题将被关闭。

可能有用的额外信息:

* 问题是否发生在最新的 minikube 版本中

* 使用的精确 minikube start 命令行

* 附上 minikube 日志的完整输出,运行 `minikube logs --file=logs.txt` 以创建日志文件

感谢您分享您的经验!

然后:关闭问题。


最后修改于 2023 年 3 月 22 日:站点:更新问题分类时间 (092a421a0)