Docker Desktop Kubernetes部署api_service镜像遇ImagePullBackOff问题排查

1. 镜像拉取失败（ImagePullBackOff） #

从kubectl describe的Events日志能明确看到，Kubernetes持续尝试拉取api_service镜像但失败，触发了Back-off pulling image的错误。核心原因是：
Kubernetes默认会优先从远程镜像仓库（比如Docker Hub）拉取镜像，而你的api_service是本地Docker构建的镜像，集群节点无法识别它。

解决方法二选一：

方法A：给本地镜像添加本地仓库标签 #

执行Docker命令给镜像打标签，让K8s能从本地仓库寻址：

docker tag api_service localhost/api_service:latest

然后修改Deployment中的image字段：

image: localhost/api_service:latest

方法B：强制使用本地镜像 #

在Deployment的容器配置里添加镜像拉取策略，跳过远程拉取尝试：

containers:
- name: api_service
  image: api_service
  imagePullPolicy: Never  # 强制使用本地镜像，无镜像则报错
  # 或用 imagePullPolicy: IfNotPresent（本地有则用本地，无则尝试远程）
  ports:
  - containerPort: 5001

2. Service配置缺失Selector匹配规则 #

你的Service YAML中spec.selector字段为空，这会导致Service无法关联到后端Pod——Service必须通过selector匹配Pod的标签，才能将流量转发到对应的容器。

修正后的Service配置：

apiVersion: v1
kind: Service
metadata:
  name: my-api-service
spec:
  selector:
    app: my-api-service  # 与Deployment中Pod的labels.app完全匹配
  ports:
    - protocol: TCP
      port: 5001
      targetPort: 5001

额外注意：YAML资源分隔符 #

原配置中Deployment和Service写在同一个文件里，但没有用---分隔，可能导致Kubernetes解析出错。修正后的完整YAML需添加分隔符：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-api-service
spec:
  selector:
    matchLabels:
      app: my-api-service
  replicas: 1 
  template:
    metadata:
      labels:
        app: my-api-service
    spec:
      containers:
      - name: api_service
        image: localhost/api_service:latest
        imagePullPolicy: Never
        ports:
        - containerPort: 5001
---
apiVersion: v1
kind: Service
metadata:
  name: my-api-service
spec:
  selector:
    app: my-api-service
  ports:
    - protocol: TCP
      port: 5001
      targetPort: 5001

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