它解决什么问题#

Deployment 后面可能有多个 Pod：

1
user-api Pod A: 10.1.0.11
2
user-api Pod B: 10.1.0.12
3
user-api Pod C: 10.1.0.13

客户端不应该记住这些 Pod IP，因为 Pod 随时会变化。Service 通过 label selector 找到这些 Pod，对外提供一个稳定入口。

1
client -> Service -> matching Pods

最小示例#

1
apiVersion: v1
2
kind: Service
3
metadata:
4
  name: user-service
5
spec:
6
  type: ClusterIP
7
  selector:
8
    app: user-service
9
  ports:
10
    - name: http
11
      port: 80
12
      targetPort: 8000

关键字段：

Service 类型#

实际项目例子#

项目里有：

• user-api：把流量转发到 app: user-api 的 Pod。
• admin-api：把流量转发到 app: admin-api 的 Pod。

本地调试时常用 port-forward：

1
kubectl port-forward -n demo svc/user-api 18000:80
2
curl http://localhost:18000/readyz

常用命令#

1
kubectl get svc -n demo
2
kubectl describe svc user-api -n demo
3
kubectl get endpoints -n demo

如果 Service 没有转发到 Pod，优先检查：

• Service 的 selector 是否匹配 Pod 的 labels。
• Pod 是否处于 Ready 状态。
• targetPort 是否等于容器实际监听端口。

相关笔记：pod、k8s deployment、Kubernetes 排障手册