Kubernetes部署React应用遭遇ImagePullBackOff错误求助

问题描述 #

在Kubernetes中部署React应用时，Pod出现ImagePullBackOff和ErrImagePull错误。已确认镜像存在于容器仓库、凭证正确且仓库权限配置无误，仍无法解决问题，请求分析错误原因。

相关配置及输出 #

Dockerfile #

//build command:  docker build -t my-simple-app .

FROM node:alpine
ENTRYPOINT ["sh", "/docker-entrypoint.sh"]
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "start"]

kubectl get pods 输出 #

react-app-deployment-7854bbdb98-c4gzf   0/1     ImagePullBackOff   0          17s
react-app-deployment-7854bbdb98-dvzls   0/1     ErrImagePull       0          17s
react-app-deployment-7854bbdb98-vb7pm   0/1     ImagePullBackOff   0          17s

service.yaml #

apiVersion: v1
kind: Service
metadata:
  name: react-app-service
spec:
  selector:
    app: react-app
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8080
  type: LoadBalancer

deployment.yaml #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: react-app-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: react-app
  template:
    metadata:
      labels:
        app: react-app
    spec:
      containers:
        - name: react-app-container
          image: my-simple-app  # Use the image name and tag you built earlier
          ports:
            - containerPort: 3000  # Adjust the port as needed

错误原因分析及解决方案 #

1. 镜像引用不完整（核心问题） #

Deployment中image: my-simple-app仅指定了镜像名，未包含仓库地址和标签：

• Kubernetes默认会尝试从Docker Hub拉取该镜像，若你的镜像仅在本地构建或存储在私有仓库，集群节点无法找到对应镜像，导致拉取失败。
• 解决方案：
  • 给镜像打完整标签，例如推送到私有仓库：docker tag my-simple-app <私有仓库地址>/my-simple-app:v1，再推送镜像：docker push <私有仓库地址>/my-simple-app:v1
  • 更新Deployment中的image字段为完整标签：image: <私有仓库地址>/my-simple-app:v1
  • 若为本地测试环境（如minikube/kind），可直接加载本地镜像到集群：minikube image load my-simple-app 或 kind load docker-image my-simple-app

2. 查看具体拉取错误细节 #

执行kubectl describe pod <pod-name>（替换为实际Pod名称，如react-app-deployment-7854bbdb98-dvzls），查看Events部分的具体错误信息，可定位更精准的问题：

• 节点是否无法访问仓库（网络问题）
• 镜像标签是否拼写错误
• 私有仓库凭证是否未正确关联到集群

3. 额外注意事项（非镜像拉取问题，但影响后续服务） #

Service中targetPort: 8080与容器暴露的containerPort: 3000不匹配，后续服务访问会出现端口不通的问题，建议将Service的targetPort修改为3000。

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