SuperAPI AI 工具集

helm-debugging

测试与质量

查看项目

更新于 10-15 23:49

技能介绍

用途:在 Helm 部署或升级失败时提供系统化排查指引,包括模板渲染错误、值类型错误、YAML 解析失败、资源已存在、镜像拉取失败、CRD 缺失、超时与 Hook 失败等场景。

主要能力:区分适用边界——发布本身卡在 pending-install/upgrade 时改用发布恢复技能;Pod 崩溃或节点级调试用 kubectl 调试技能;从零编写或重构 chart 用 chart 开发技能。提供分层校验流程:先本地静态检查,再本地渲染,然后服务端 dry-run,最后实际安装并做部署后测试。

必要用法:所有 kubectl 与 helm 命令都应显式指定上下文,避免误操作其他集群,例如 kubectl --context=prod-cluster get pods -n prod、helm --kube-context=prod-cluster status myapp -n prod。分层校验命令依次为 helm lint ./mychart --strict、helm template myapp ./mychart --debug --values values.yaml、helm install myapp ./mychart --namespace prod --values values.yaml --dry-run --debug、helm install myapp ./mychart --namespace prod --values values.yaml --atomic --wait、helm test myapp --namespace prod --logs。另可用 helm get manifest、helm get values(含 --all)、helm status --show-resources、helm get all 检查已部署资源,用 --debug 与 --v=6 提高日志级别。

适用场景:模板报 nil pointer、cannot unmarshal string into Go value、resource already exists、ImagePullBackOff、no matches for kind、timed out waiting for the condition、pre-upgrade hooks failed 等常见故障。

限制:资料未提供该技能的安装方式、收费模式或版本要求;具体故障的详细修复步骤需参考其 REFERENCE.md,本简介不展开。