SuperAPI AI 工具集

okteto-debugging

部署与运维

查看项目

更新于 10-16 02:36

技能介绍

用途:当用户在 Okteto 环境中遇到服务崩溃、不断重启、健康检查失败等异常时,用该技能做只读诊断并输出结构化结论。

主要能力:按顺序执行分诊流程。先用 okteto context show 确认连接并固定命名空间,用 ns=$(okteto context show | jq -r .namespace) 取命名空间,必要时运行 okteto kubeconfig 对齐 kubectl 上下文,并在所有 kubectl 命令中带上 -n "$ns"。再读取 okteto.yaml 获取服务名,用 kubectl get pods -n "$ns" 快照 Pod 状态,按状态匹配处置方案:CrashLoopBackOff 用 kubectl logs <pod> --previous 与 describe 查退出码和探针;OOMKilled 查内存限制并建议提高(约 2 倍,不建议移除限制);镜像拉取失败检查镜像引用与凭据,必要时 okteto build <service>;Pending 超 60 秒查调度约束与配额;Running 但不健康用 okteto logs <service> --tail 200 分析错误;部署失败先跑 okteto validate 再查 okteto logs --deploy;全部就绪但代码未同步用 okteto status(需 okteto up 会话在运行)。

输出格式:每个异常服务输出诊断标题、根因、证据(5-20 行)、修复命令与置信度(高/中/低);全部健康则报告无异常并建议 okteto doctor。

限制:诊断只读,不得用原始 kubectl/helm 改动集群,修复走 okteto build 与 okteto deploy;首次崩溃无 --previous 日志,Pending 无日志应跳过;退出码 137 视为 OOM;不要运行交互式的 okteto up,也不要为避免故障而执行 okteto destroy。kubectl 与 Okteto 上下文可能不一致,结论前需先对齐。