Minikube 问题分类
社区问题分类会**每周三**举行,时间为**太平洋时间上午 11:05 至 11:55**。
- 环聊链接:https://meet.google.com/sss-wdet-gwe
- Google 群组:https://groups.google.com/forum/#!forum/minikube-dev
所有社区成员都欢迎并鼓励加入我们,帮助我们对 minikube 进行问题分类!
问题分类是维护 minikube 仓库健康状况的重要组成部分。一个组织良好的仓库能够让维护者优先处理功能请求、修复错误,并尽快响应遇到工具困难的用户。
问题分类包括:
- 标记问题
- 回应问题
- 关闭问题
如果您有兴趣帮助 minikube 问题分类,本文档涵盖了分类的基本知识。
此外,如果您有兴趣参加我们的每周问题分类会议,请填写此表格以表达您的兴趣。谢谢!
日常问题分类
日常问题分类有两个目标:
- 对新问题的响应速度
- 当明确请求的信息已提供时的响应速度
未处理项列表位于http://tinyurl.com/mk-tparty/daily-triage - 它包括:
- 没有 `kind/` 或 `triage/` 标签的问题
- 没有 `priority/` 标签的问题
- 用户已跟进的 `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`:可能更有用,但目前还没有足够的支持。
每周问题分类
每周问题分类有三个目标:
- 处理未回应的问题
- 审查和关闭 PR
- 关闭陈旧问题
未处理项列表可以在http://tinyurl.com/mk-tparty/weekly-triage找到。
发布后分类
发布后问题分类在主要版本发布后(大约每 4-6 周)进行。它专注于:
- 关闭已由该版本解决的 bug
- 重新确定未由该版本解决的 bug 的优先级
- 告知用户我们是否认为仍然存在问题
这包括审查:
- 过去 2 天内未触及的每个问题
- 长期问题的重新评估
- 短期问题的重新评估
回应问题
需要更多信息
请求更多信息的示例回应
我还没有找到明确的方法来重现此问题。您介意添加一些额外细节吗?以下是一些可能有用的信息:
* 使用的精确 `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` 以创建日志文件
感谢您分享您的经验!
然后:关闭问题。