DAY 03 —— Service 与 Ingress 网络
================================================================
DAY 03 —— Service 与 Ingress 网络
================================================================
【学习目标】
1. 说清 Pod 网络的四条基本要求与 kube-proxy 的作用
2. 掌握 Service 四种类型,能按场景选型
3. 理解 Endpoints / EndpointSlice 与 selector 的关系
4. 会用 Ingress 做七层路由,能装 ingress-nginx 并验证
5. 排掉 90% 的 "Service 访问不通"
----------------------------------------------------------------
一、先理解 Pod 网络
----------------------------------------------------------------
K8s 对网络的四条硬性要求:
1) 所有 Pod 之间可以直接通信,不需要 NAT
2) 所有节点与所有 Pod 之间可以直接通信
3) Pod 看到的自己的 IP == 别人看到的它的 IP
4) Pod 访问外网需要 SNAT(这个由节点负责)
也就是说集群网络是"扁平"的:不管 Pod 在哪台机器,IP 直达。
这个能力不是 K8s 自己实现的,是 CNI 插件(Calico/Flannel/Cilium)实现的(Day 13 详讲)。
关键点:Pod IP 是"易变的"。Pod 重建、漂移、扩缩容都会换 IP。
所以业务之间不能写死 Pod IP,必须走 Service。
----------------------------------------------------------------
二、Service 是什么
----------------------------------------------------------------
Service = 一组 Pod 的稳定访问入口,提供:
- 固定的虚拟 IP(ClusterIP),DNS 名字稳定
- 负载均衡(默认 iptables/IPVS 随机轮询,无会话保持)
- 服务发现(配合 CoreDNS)
实现原理:
apiserver 里创建 Service 对象 → 控制器根据 selector 找到匹配的 Pod,
写入 EndpointSlice → 每个节点的 kube-proxy watch 到变化,
在本机写 iptables/IPVS 规则把 ClusterIP:port DNAT 到某个 Pod IP:port。
所以 Service 不是进程、不转发流量、没有单点。
它不是"代理",是"规则"。这是最常见的理解误区。
----------------------------------------------------------------
三、四种 Service 类型
----------------------------------------------------------------
【ClusterIP】默认,仅集群内可访问
apiVersion: v1
kind: Service
metadata:
name: web
spec:
type: ClusterIP # 可省略,默认就是它
selector:
app: web
ports:
- name: http
port: 80 # Service 自己的端口
targetPort: http # 容器端口,可写数字或容器 port 的名字
protocol: TCP
验证:
kubectl get svc web
kubectl get endpointslice -l kubernetes.io/service-name=web
# 集群内访问(用临时 Pod)
kubectl run t --rm -it --image=curlimages/curl --restart=Never -- \
curl -s -o /dev/null -w '%{http_code}\n' http://web.default.svc.cluster.local
【NodePort】在每个节点上开一个高位端口(默认 30000-32767)
spec:
type: NodePort
ports:
- port: 80
targetPort: 80
nodePort: 30080 # 不写则随机分配
访问:curl http://<任意节点IP>:30080
特点:简单粗暴,适合测试和自建集群对外暴露;端口有限、无七层能力。
【LoadBalancer】云上自动创建 SLB/ELB,裸机需要 MetalLB
spec:
type: LoadBalancer
ports:
- port: 80
targetPort: 80
云上:kubectl get svc web 的 EXTERNAL-IP 会变成公网/内网地址。
裸机:装 MetalLB 并配置 IP 地址池,否则 EXTERNAL-IP 一直 <pending>。
【ExternalName】不代理,只做 CNAME
spec:
type: ExternalName
externalName: db.prod.example.com
用途:把外部依赖伪装成集群内服务,方便后期迁移;不产生 ClusterIP。
选型建议:
- 集群内部服务间调用 → ClusterIP
- 临时对外测试、自建集群 → NodePort
- 云上正式对外 → LoadBalancer + Ingress 组合
- 外部依赖统一入口 → ExternalName
----------------------------------------------------------------
四、Endpoints:Service 到底指向谁
----------------------------------------------------------------
Endpoints(旧)与 EndpointSlice(新,1.21+ 默认,大集群性能更好)记录后端地址。
kubectl get endpoints web
kubectl get endpointslice -l kubernetes.io/service-name=web -o yaml
【最常见的坑】Endpoints 是空的 → Service 一定不通
原因几乎总是:
1) selector 与 Pod 的 label 不匹配(拼写、大小写、命名空间不同)
2) Pod 没 Ready(readinessProbe 失败也会被摘除)
3) Pod 所在命名空间与 Service 不同(selector 只能选同命名空间)
自查命令:
kubectl get pod -l app=web -o wide --show-labels
kubectl get svc web -o jsonpath='{.spec.selector}{"\n"}'
kubectl get endpointslice -l kubernetes.io/service-name=web -o wide
----------------------------------------------------------------
五、无头服务 Headless
----------------------------------------------------------------
clusterIP: None 时不分配虚拟 IP,DNS 直接返回所有 Pod IP(A 记录)。
用途:StatefulSet 稳定标识、客户端自己做负载均衡、gRPC 长连接。
apiVersion: v1
kind: Service
metadata:
name: redis
spec:
clusterIP: None
selector:
app: redis
ports:
- port: 6379
name: redis
验证(会返回 3 个 IP):
kubectl run d --rm -it --image=busybox:1.36 --restart=Never -- \
nslookup redis.default.svc.cluster.local
注意:普通 Service 的 DNS 返回的是一个 ClusterIP;
Headless 返回全部 Pod IP,客户端拿到列表后自己选。
----------------------------------------------------------------
六、几个容易被忽略的字段
----------------------------------------------------------------
1) sessionAffinity(会话保持)
spec:
sessionAffinity: ClientIP
sessionAffinityConfig:
clientIP:
timeoutSeconds: 10800
默认 None(每次随机)。需要粘性会话(老系统 session 存内存)时才开,
更好的方案是把 session 外置到 Redis。
2) externalTrafficPolicy(NodePort/LoadBalancer 生效)
- Cluster(默认):流量可转发到任意节点上的 Pod,会 SNAT,丢失客户端真实 IP
- Local:只转发到本节点的 Pod,保留源 IP,但本节点没 Pod 就不通
需要真实客户端 IP(限流、审计、白名单)时用 Local,并保证每节点都有副本。
3) publishNotReadyAddresses
无头服务在 Pod 未 Ready 时也写入 DNS,常用于集群成员互相发现的场景
(如 StatefulSet 启动时要先互相找到对方才能选主)。
4) 多端口 Service
ports:
- name: http
port: 80
targetPort: 8080
- name: metrics
port: 9090
targetPort: 9090
多端口时每个 port 必须有 name,否则报错。
----------------------------------------------------------------
七、kube-proxy 的两种模式(了解即可)
----------------------------------------------------------------
iptables 模式(默认):
- 为每个 Service 生成一条规则链,随机 DNAT
- 规则多时(几千 Service)更新慢、查找是线性匹配
IPVS 模式:
- 内核四层负载均衡,哈希表查找,大规模性能好
- 支持 rr/lc/wrr 等调度算法
开启方式:kube-proxy 配置 mode: ipvs(需内核模块 ip_vs 等)
eBPF 模式:Cilium 直接替换 kube-proxy 数据面,性能更好但复杂度高。
查看当前模式:
kubectl -n kube-system get cm kube-proxy -o yaml | grep mode
kubectl -n kube-system logs -l k8s-app=kube-proxy --tail=20
----------------------------------------------------------------
八、Ingress:七层路由
----------------------------------------------------------------
Service 是四层(IP+端口),Ingress 是七层(域名/路径/Header)。
Ingress 只是一份"路由规则声明",真正干活的是 Ingress Controller
(最常见的是 ingress-nginx,还有 Traefik、Envoy Gateway、APISIX)。
【装 ingress-nginx】
# 方式一:官方 manifest(简单)
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/baremetal/deploy.yaml
kubectl -n ingress-nginx get svc,pod
# 裸机下 controller 的 Service 是 NodePort,记下端口
kubectl -n ingress-nginx get svc ingress-nginx-controller
# 方式二:Helm(推荐,可配)
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
helm install ingress-nginx ingress-nginx/ingress-nginx \
-n ingress-nginx --create-namespace \
--set controller.service.type=NodePort
【最小 Ingress】
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: web
spec:
ingressClassName: nginx # 1.18+ 必须指定或依赖默认 class
rules:
- host: web.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: web
port:
number: 80
【pathType 三种语义】
- Exact:完全相等
- Prefix:按路径段前缀匹配(/api 匹配 /api、/api/v1,不匹配 /apix)
- ImplementationSpecific:交给 controller 决定(不建议)
【多域名 + 多路径】
spec:
ingressClassName: nginx
tls:
- hosts: [web.example.com]
secretName: web-tls # 提前创建 tls 类型 Secret
rules:
- host: web.example.com
http:
paths:
- path: /
pathType: Prefix
backend: {service: {name: web, port: {number: 80}}}
- host: api.example.com
http:
paths:
- path: /v1
pathType: Prefix
backend: {service: {name: api, port: {number: 8080}}}
- path: /v2
pathType: Prefix
backend: {service: {name: api-v2, port: {number: 8080}}}
【创建 TLS Secret】
kubectl create secret tls web-tls --cert=tls.crt --key=tls.key
【验证】
kubectl get ingress
kubectl describe ingress web
# 本机验证(改 hosts 或用 --resolve)
curl -H 'Host: web.example.com' http://<节点IP>:<nodePort>/
curl --resolve web.example.com:<nodePort>:<节点IP> http://web.example.com:<nodePort>/
【常用注解】
nginx.ingress.kubernetes.io/rewrite-target: / # 路径重写
nginx.ingress.kubernetes.io/proxy-body-size: 100m # 上传大小
nginx.ingress.kubernetes.io/proxy-read-timeout: 300
nginx.ingress.kubernetes.io/ssl-redirect: "true"
nginx.ingress.kubernetes.io/affinity: cookie # 会话保持
----------------------------------------------------------------
九、排障:Service / Ingress 不通
----------------------------------------------------------------
按顺序打这几条,基本能定位:
# 1. 后端到底有没有?
kubectl get endpointslice -l kubernetes.io/service-name=<svc> -o wide
# 空 → 回到第四节查 selector / readiness
# 2. 直连 Pod IP 能不能通?(绕过 Service)
kubectl run t --rm -it --image=curlimages/curl --restart=Never -- \
curl -v --max-time 5 http://<podIP>:<port>
# 不通 → 应用没监听、监听在 127.0.0.1、端口写错、NetworkPolicy 拦了
# 3. Service 层通不通?
kubectl run t --rm -it --image=curlimages/curl --restart=Never -- \
curl -v --max-time 5 http://<svc>.<ns>.svc.cluster.local:<port>
# 4. DNS 有没有问题?
kubectl run d --rm -it --image=busybox:1.36 --restart=Never -- \
nslookup <svc>.<ns>.svc.cluster.local
# 5. Ingress 层
kubectl -n ingress-nginx logs -l app.kubernetes.io/name=ingress-nginx --tail=100
kubectl describe ingress <name>
现象对照:
- 502 Bad Gateway:Ingress 找不到/连不上后端(targetPort 错、Pod 没 Ready)
- 503 Service Unavailable:Endpoints 为空
- 504 Timeout:后端处理太慢或 NetworkPolicy 丢包
- Connection refused:Pod 里没有进程监听该端口
- 超时且无响应:CNI 跨节点不通 / 网络策略拦截
----------------------------------------------------------------
十、端口转发:调试神器
----------------------------------------------------------------
kubectl port-forward pod/web-xxx 8080:80
kubectl port-forward svc/web 8080:80
kubectl port-forward deploy/web 8080:80
# 走 apiserver,不需要 NodePort、不需要网络通,能连上 apiserver 就能用
# 缺点:单连接、性能差,只用于调试
----------------------------------------------------------------
十一、Day 03 自检清单
----------------------------------------------------------------
[ ] 能解释为什么不能直接用 Pod IP 做服务调用
[ ] 能说出 Service 不是代理进程、没有单点
[ ] 四种 Service 类型各写一遍 YAML 并说明适用场景
[ ] 用 NodePort 或 port-forward 真访问到后端
[ ] 能通过 Endpoints 为空反推 selector/readiness 问题
[ ] 装好 ingress-nginx,用域名访问到两个不同后端
[ ] 知道 502/503/504 分别指向哪一层的问题
常见坑:
- selector 写成 app=web 但 Pod 是 app=web-app(标签不匹配,最常见)
- targetPort 写了 Service 的 port 而不是容器端口
- 多端口 Service 忘记给 port 起名字,apply 直接报错
- Ingress 忘了 ingressClassName,规则不生效也没报错
- 裸机 LoadBalancer 一直 pending:没装 MetalLB
- NetworkPolicy 全隔离后忘了放行 DNS,全集群解析失败
- 点赞
- 收藏
- 关注作者
评论(0)