Minikube部署SpringBoot应用无法拉取本地Docker镜像如何解决？

核心原因 #

你宿主机本地构建的Docker镜像存储在宿主机的Docker运行环境中，而minikube集群默认使用自身内置的独立Docker运行环境，二者镜像不互通，因此集群会默认去Docker Hub拉取不存在的镜像。

推荐解决方案 #

方案1：直接将本地镜像导入minikube #

这是最便捷的临时测试方案，操作步骤如下：

1. 确认本地镜像存在，执行命令：
   docker images | grep cicdstudy/apptodocker
2. 执行minikube导入命令，将本地镜像同步到minikube内部环境：
   minikube image load cicdstudy/apptodocker:latest
3. 修改k8s.yaml的Deployment配置，添加镜像拉取策略，避免集群强制去远程拉取镜像：
   在containers字段下添加imagePullPolicy: IfNotPresent，修改后的配置片段如下：

spec:
  containers:
    - name: springboot
      image: cicdstudy/apptodocker:latest
      imagePullPolicy: IfNotPresent
      ports:
        - containerPort: 8080

4. 重新apply配置即可：
   kubectl apply -f k8s.yaml

方案2：直接使用minikube内置Docker环境构建镜像 #

省去镜像导入步骤，适合频繁修改镜像测试的场景：

1. 执行环境变量切换命令，将当前终端的Docker客户端指向minikube内部的Docker服务：
   eval $(minikube docker-env)
   注意：该配置仅对当前终端生效，关闭终端后会自动恢复为宿主机Docker环境
2. 在当前终端重新执行Docker构建命令，镜像会直接生成在minikube内部：
   docker build -t cicdstudy/apptodocker:latest .
3. 同方案1的步骤3，修改Deployment配置添加imagePullPolicy: IfNotPresent，再重新apply配置即可。

验证效果 #

配置生效后执行kubectl get pods，如果返回的pod状态为Running则说明配置生效，镜像拉取成功。如果仍有异常，可执行kubectl describe pod <对应pod名称>查看事件日志排查问题。

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