K8部署镜像拉取失败求助：无法获取docker4nitin/tg_bot:v2镜像

一、节点网络连通性验证 #

• 登录K8s集群任意工作节点，直接用Docker命令拉取镜像，确认节点本身能否访问Docker Hub：

  docker pull docker4nitin/tg_bot:v2
  

  如果该命令也失败，说明节点存在网络问题：
  • 测试节点到Docker Hub registry的连通性：

    curl -I https://registry-1.docker.io
    

    预期返回HTTP/1.1 200 OK，否则检查节点防火墙、安全组是否放行443端口，或是否需要配置代理。
  • 检查DNS解析：

    nslookup registry-1.docker.io
    

    若无法解析，需修复节点DNS配置（比如更换为8.8.8.8或本地DNS服务器）。

二、K8s部署配置检查 #

• 确认deployment.yml中镜像名称完全正确，包括大小写、tag（v2）无拼写错误。
• 若该镜像为Docker Hub私有镜像，需配置镜像拉取密钥：
  1. 创建Docker Hub认证密钥：

     kubectl create secret docker-registry regcred --docker-server=docker.io --docker-username=<你的Docker Hub用户名> --docker-password=<你的密码> --docker-email=<你的邮箱>
     

  2. 在deployment的spec.template.spec字段下添加密钥引用：

     imagePullSecrets:
       - name: regcred
     

三、节点镜像服务重置 #

• 清理节点Docker缓存，避免损坏的缓存导致拉取失败：

  docker system prune -a
  

• 重启节点Docker服务（适配systemd系统）：

  systemctl restart docker
  

  完成后再次尝试拉取镜像。

四、K8s事件与日志排查 #

• 查看deployment的事件详情，获取更精准的错误信息：

  kubectl describe deployment <你的deployment名称>
  

• 查看节点kubelet日志，追踪镜像拉取的完整过程：

  journalctl -u kubelet -f
  

  日志中会记录拉取超时的具体触发环节，比如DNS失败、TCP连接超时等。

五、调整镜像拉取超时参数 #

如果是网络延迟导致的超时，可在deployment.yml中为容器配置更长的拉取超时（K8s 1.20及以上版本支持）：

spec:
  containers:
  - name: tg-bot
    image: docker4nitin/tg_bot:v2
    imagePullTimeoutSeconds: 60  # 延长至60秒，可根据实际情况调整

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