Kubernetes无法拉取私有Docker镜像及Minikube本地仓库拉取问题

Hey，我看到你碰到了两个和Kubernetes拉取私有Docker镜像相关的问题——一个是通用K8s集群的拉取失败，另一个是Minikube环境下的特殊情况。结合你给出的私有仓库创建命令，我来一步步帮你解决：

一、通用Kubernetes集群无法拉取私有镜像的解决步骤 #

你的私有仓库配置了htpasswd认证，所以K8s必须持有正确的凭证才能访问它，核心是创建并引用镜像拉取Secret：

1. 创建镜像拉取Secret
   Kubernetes使用docker-registry类型的Secret存储私有仓库的认证信息，执行以下命令（替换成你的仓库实际地址）：

   kubectl create secret docker-registry regcred \
     --docker-server=localhost:5000 \  # 如果是远程仓库就写实际域名/IP:5000
     --docker-username=zordon \
     --docker-password=examplePassword \
     --docker-email=your-email@example.com  # 邮箱可选，但建议填写
   

   这个命令会在当前命名空间创建名为regcred的Secret，保存你的仓库账号密码。

2. 在Pod/Deployment中引用Secret
   不管是直接定义Pod还是用Deployment，都需要在spec里添加imagePullSecrets字段，告诉K8s用这个凭证拉取镜像：

   apiVersion: v1
   kind: Pod
   metadata:
     name: private-pod
   spec:
     containers:
     - name: private-container
       image: localhost:5000/your-image:tag  # 替换成你私有仓库里的镜像地址
     imagePullSecrets:
     - name: regcred  # 刚才创建的Secret名称
   

3. 排查常见问题

   • 验证节点网络与认证：在任意K8s节点上执行curl -u zordon:examplePassword http://<仓库IP>:5000/v2/_catalog，如果能返回镜像列表，说明网络和认证没问题。
   • 检查镜像标签：确保Pod里写的镜像标签和你推送到仓库的完全一致，K8s不会自动补全latest标签。
   • 确认Secret的命名空间：如果你的Pod在特定命名空间，要在对应命名空间创建Secret，或者引用时指定命名空间（建议保持同命名空间）。

二、Minikube环境下无法拉取本地私有仓库镜像的特殊处理 #

Minikube自带独立的Docker daemon，和宿主机Docker环境隔离，所以需要额外配置：

1. 获取宿主机在Minikube网络中的IP
   宿主机的localhost:5000在Minikube容器里无法直接访问，先获取宿主机的Minikube内网IP：

   minikube ssh "route -n | grep UG | awk '{print $2}'"
   

   后续镜像地址要用这个IP，比如192.168.49.1:5000/my-app:v1。

2. 配置Minikube信任非HTTPS私有仓库
   你的私有仓库是HTTP协议，Minikube的Docker daemon默认拒绝不安全仓库，需要添加到信任列表：

   minikube config set insecure-registries <宿主机IP>:5000
   # 重启Minikube使配置生效
   minikube stop && minikube start
   

3. 创建并引用镜像拉取Secret
   和通用K8s步骤一致，在Minikube集群里创建regcred Secret，然后在Deployment/Pod中引用，注意镜像地址要用宿主机的Minikube内网IP。

4. 可选：直接在Minikube的Docker环境构建镜像
   如果是本地构建镜像，可切换到Minikube的Docker环境，直接构建推送，拉取更顺畅：

   eval $(minikube docker-env)
   # 此时执行docker命令会直接操作Minikube的Docker daemon
   docker build -t <宿主机IP>:5000/your-image:tag .
   docker push <宿主机IP>:5000/your-image:tag
   

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