无法在Minikube集群中拉取本地Docker镜像问题求助

核心问题分析 #

Minikube运行在独立的隔离环境（虚拟机/容器）中，其内部Kubernetes集群的网络与本地主机Docker环境不互通。你本地启动的registry，即使和minikube容器加入同一网络，集群内的Pod也无法直接通过localhost或registry容器IP访问到镜像仓库，这是拉取失败的主要原因。另外你的Dockerfile还存在一个潜在运行时问题，后续也需要修复。

分步解决方案 #

一、解决镜像拉取问题（两种可选方法） #

方法1：使用Minikube内置Registry（推荐）

Minikube自带registry插件，无需额外维护本地registry：

1. 启用内置registry：

minikube addons enable registry

2. 切换到Minikube的Docker环境，确保构建的镜像直接在集群内可用：

eval $(minikube docker-env)

3. 重新构建镜像：

docker build -t my-image .

4. 修改my-deployment.yaml，指定镜像拉取策略为Never（避免Kubernetes去远程仓库拉取），同时修正命令路径：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-container
        image: my-image:latest
        imagePullPolicy: Never
        command: ["python", "/code/process_file.py"]

5. 重新应用Deployment：

kubectl apply -f my-deployment.yaml

方法2：让Minikube访问本地registry

如果坚持使用自己启动的registry，需完成以下配置：

1. 获取Minikube能访问到的本地主机IP：

minikube ssh "route -n | grep ^0.0.0.0 | awk '{print \$2}'"

2. 修改registry启动命令，允许非HTTPS访问（Kubernetes默认拒绝未加密的仓库）：

docker run -d -p 5000:5000 --name registry \
  -e REGISTRY_HTTP_TLS_DISABLED=true \
  registry:2

3. 配置Minikube信任这个非安全registry：

minikube ssh "echo '{\"insecure-registries\": [\"<你的主机IP>:5000\"]}' > /etc/docker/daemon.json"
minikube ssh "systemctl restart docker"

4. 重新打标签并推送镜像：

docker tag my-image <你的主机IP>:5000/my-image:latest
docker push <你的主机IP>:5000/my-image:latest

5. 修改Deployment的镜像地址为上述主机IP，然后重新应用。

二、修复Dockerfile运行时问题 #

你的Dockerfile将文件复制到了/code/目录，但容器默认工作目录是/，直接执行python process_file.py会找不到文件，二选一修复即可：

• 方法A：修改Dockerfile，设置工作目录：

FROM python:3.9
WORKDIR /code
COPY process_file.py .

• 方法B：在Deployment的command中指定完整文件路径（如前文示例）。

验证操作 #

1. 查看Pod状态，确认是否启动成功：

kubectl get pods

2. 查看Pod日志，验证脚本是否正常执行：

kubectl logs <你的Pod名称>

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