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 - 当它是一个错误或者我们没有提供最佳的用户体验时

其他可能性

  • 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 - 错误有一个建议的解决方案,可以在没有进一步讨论的情况下实现。

Help wanted - 如果错误需要贡献者的帮助

优先级排序

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

priority/critical-urgent - 某人尽快处理的最高优先级,例如安全问题、用户可见的错误或构建中断。很少使用。

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. 关闭已通过发布解决的错误
  2. 重新确定未通过发布解决的错误的优先级
  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 标记。

谨慎关闭

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

  • 问题已解决
  • 问题是现有问题的重复项
  • 很长一段时间内缺乏信息

在任何这些情况下,我们都力求在关闭问题时友善,并为作者提供操作项,以便在他们需要重新打开问题或仍然需要解决方案时使用。

这些情况的示例回复包括

问题已解决

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

感谢您报告此问题!

然后:关闭问题

重复问题

此问题似乎是 #X 的重复项,您介意我们把对话移到那里吗?

这样我们可以集中处理与该问题相关的内容。如果您认为此问题实际上不是重复的,请使用 /reopen 重新打开它。如果您有其他信息要分享,请将其添加到新问题中。

感谢您报告此问题!

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

缺乏信息

如果一个问题超过四个星期没有活动,并且至少 ping 过一次作者,则可以关闭该问题。

您好 @author – 此问题是否仍然存在?是否有其他详细信息可用?如果有,请随时通过评论 /reopen 来重新打开该问题。此问题将因缺少其他信息且时间已过而被关闭。

可能有所帮助的其他信息

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

* 使用的确切 minikube 启动命令行

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

感谢您分享您的经验!

然后:关闭该问题。


最后修改时间 2023 年 3 月 22 日: site: 更新分类时间 (092a421a0)