如何使用本地Docker镜像通过kubectl debug调试K8s Pod？

错误原因分析 #

你遇到的错误是因为kubectl debug默认会尝试从Docker Hub远程拉取镜像，而你自定义的my-local-docker-image仅存在于本地Docker仓库中，K8s无法在远程仓库找到该镜像，因此触发拉取失败报错。

直接解决方法 #

在kubectl debug命令中添加--image-pull-policy=Never参数，强制K8s使用本地已存在的镜像，不再尝试远程拉取：

kubectl debug -it foo --image=my-local-docker-image --image-pull-policy=Never

参数说明：

• --image-pull-policy=Never：K8s仅使用本地节点上已有的镜像，若本地不存在目标镜像则直接报错，不会发起远程仓库拉取请求。

额外检查步骤 #

1. 确认本地镜像存在：执行以下命令验证本地是否有目标镜像

docker images | grep my-local-docker-image

2. 确保Docker Desktop的Kubernetes集群处于正常运行状态（可在Docker Desktop界面的Kubernetes标签页确认集群状态）

附你的Pod配置文件 #

apiVersion: v1
kind: Pod
metadata:
  name: foo
spec:
  containers:
    - name: app
      image: nginx:alpine
      ports:
        - containerPort: 80
      resources:
        limits:
          memory: "256Mi"
    - name: sidecar
      image: curlimages/curl:8.3.0
      command: ["/bin/sleep", "3650d"]
      resources:
        limits:
          memory: "128Mi"

内容的提问来源于stack exchange，提问作者Victor Polo De Gyves Montero