Kubernetes无法识别本地Docker镜像：部署YAML文件是否存在错误？

首先明确一点：你的YAML配置文件语法上没有任何错误，Deployment和Service的定义完全符合Kubernetes规范。出现镜像拉取失败的问题，大概率是镜像的运行时兼容性或拉取策略的实际执行逻辑导致的，我们一步步来排查解决：

可能的原因及对应方案 #

1. 再次确认目标节点的镜像状态
   虽然你提到Pod被调度到了本地构建镜像的worker节点，但还是建议你亲自登录到knode2节点，执行sudo docker images确认flaskapp1:latest镜像确实存在，且镜像ID和你看到的4004bc4ea926完全一致——避免出现你在其他节点查看镜像的乌龙情况。

2. 容器运行时不兼容问题
   如果你的Kubernetes集群使用containerd作为容器运行时（现在很多集群默认用它替代Docker），那你用docker build构建的镜像只存在于Docker的本地存储中，containerd无法直接读取。这就会出现“明明节点有镜像，但K8s还是去远程拉取”的矛盾情况。
   解决步骤：

   • 在构建镜像的机器上执行：docker save flaskapp1:latest -o flaskapp1.tar，把镜像导出为tar包
   • 通过scp等工具将tar包传到knode2节点
   • 在knode2上执行：ctr images import flaskapp1.tar，将镜像导入到containerd的存储中
   • 最后删除故障Pod：kubectl delete pod flaskapp-55dbdfd6cf-952v8，Deployment会自动创建新Pod，此时就能正常使用本地镜像了。

3. ImagePullPolicy执行偏差
   你设置的imagePullPolicy: IfNotPresent理论上会优先使用本地镜像，但有时候K8s会因为镜像元数据（比如digest值）不匹配，依然尝试去远程仓库拉取。这种情况下，可以直接把拉取策略改成Never，强制K8s只使用本地镜像：
   修改Deployment中的容器配置：

   containers:
   - name: flaskapp
     image: flaskapp1:latest
     imagePullPolicy: Never  # 替换原有的IfNotPresent
     ports:
     - containerPort: 8080
   

   应用修改后的配置：kubectl apply -f your-deployment-file.yaml，再重启Pod即可。

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