K8s 1.18使用临时容器调试Pod遇终端卡死及容器删除问题咨询

问题原因分析 #

终端卡死、无法进入交互式调试的核心原因大概率是仅开启了APIServer的临时容器特性，未在kubelet层面启用，也可能存在以下次要问题：

1. kubelet未配置特性开关：K8s 1.18中临时容器属于Alpha特性，需要APIServer和所有节点的kubelet都添加--feature-gates=EphemeralContainers=true参数，仅配置APIServer会导致临时容器创建后，kubelet无法正确处理终端attach请求。
2. kubectl版本不匹配：必须使用与集群版本一致的1.18版本kubectl，高版本kubectl的alpha debug命令可能与旧集群存在兼容性问题。
3. 镜像命令不兼容：部分busybox镜像未预装bash，指定/bin/bash会导致容器启动失败或无法进入shell，改用/bin/sh更可靠。
4. 未指定目标容器：如果业务Pod包含多个容器，未通过--target参数指定要调试的容器，临时容器可能无法共享目标容器的PID/网络命名空间，导致调试异常。

解决步骤 #

1. 配置kubelet特性开关：
   • 登录集群每个节点，修改kubelet配置（通常在/var/lib/kubelet/config.yaml或启动参数），添加featureGates: EphemeralContainers=true（yaml格式）或启动参数--feature-gates=EphemeralContainers=true。
   • 重启kubelet服务：systemctl restart kubelet。
2. 匹配kubectl版本：
   • 安装1.18版本kubectl，执行kubectl version确认Client与Server版本一致。
3. 调整调试命令：
   改用兼容的命令格式，指定/bin/sh并添加目标容器（若业务Pod有多个容器）：

   kubectl alpha debug <biz_pod> -i -t --image=busybox --target=<biz_container_name> -- /bin/sh
   

4. 检查临时容器状态：
   执行kubectl describe pod <biz_pod>，查看临时容器的State字段是否为Running；若为Waiting或CrashLoopBackOff，查看Events日志排查启动失败原因。

不影响业务Pod的临时容器删除方法 #

K8s 1.18作为Alpha版本，没有直接的kubectl delete ephemeralcontainer命令，可通过以下两种方式安全删除临时容器（不会影响业务容器运行）：

方法1：使用kubectl patch删除 #

kubectl patch pod <biz_pod> -n <namespace> --type json -p '[{"op": "remove", "path": "/spec/ephemeralContainers/<index>"}]'

• 替换<index>为临时容器在ephemeralContainers数组中的下标（从0开始，比如第一个临时容器对应下标0）。
• 示例：删除第一个临时容器

kubectl patch pod my-biz-pod -n default --type json -p '[{"op": "remove", "path": "/spec/ephemeralContainers/0"}]'

方法2：通过API调用删除 #

1. 启动kubectl代理：

kubectl proxy &

2. 发送DELETE请求删除指定临时容器：

curl -X DELETE http://localhost:8001/api/v1/namespaces/<namespace>/pods/<biz_pod>/ephemeralcontainers/<debugger-container-name>

• 替换<namespace>、<biz_pod>、<debugger-container-name>为实际值（比如debugger-pg4vf）。

内容的提问来源于stack exchange，提问作者moluzhui