容器与云原生 / 系统课时

理解 sessionAffinity 的作用

理解 sessionAffinity 的作用

本课解决两个容易混淆的问题:sessionAffinity: ClientIP 到底改变哪一层的选路,以及为什么它不等于应用 Session。你将通过可复现实验观察同一客户端 IP 在粘滞窗口内如何继续命中同一 Service 后端。

学习目标

  • 解释 ClientIP 会话亲和对 Service 后端选择的影响
  • 配置 timeoutSeconds 并验证同一客户端 IP 的粘滞行为
  • 区分会话亲和、长连接复用与应用层 Session

sessionAffinity 改变的是 Service 选路

Service 的会话亲和属于网络数据平面的连接与流量选路语义。默认 sessionAffinity: None 时,新连接可以被转发到不同的就绪后端;设置为 ClientIP 后,Service 代理会依据它实际观察到的客户端源 IP 维持粘滞关系,使来自同一源 IP 的后续连接在有效期内继续选择同一个后端 Pod。

它不会保存 Cookie、登录状态或 HTTP Session,也不会让多个 Pod 自动共享进程内状态。sessionAffinityConfig.clientIP.timeoutSeconds 控制的是客户端 IP 到后端选择的粘滞时长,不是用户登录会话的过期时间。默认值为 10800 秒,也就是 3 小时。

还要避免把长连接复用误判为会话亲和。HTTP keep-alive、HTTP/2 等机制可能让多个请求沿已经建立的连接持续到达同一 Pod;这时即使没有 ClientIP,短时间内也可能看到相同后端。验证会话亲和时,应尽量建立多次独立连接。

ClientIP 会话亲和下的 Service 后端选择与故障表现

配置并验证 ClientIP

下面创建三个会返回自身 Pod 名称的后端,把粘滞窗口缩短为 60 秒,再从同一个测试 Pod 连续发起五次独立 HTTP 请求。因为每次 wget 都重新建立连接,观察结果不依赖 HTTP keep-alive。

bash
kubectl apply -f - >/dev/null <<'YAML'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: web
          image: busybox:1.36
          command:
            - sh
            - -c
            - mkdir -p /www && hostname > /www/index.html && httpd -f -p 8080 -h /www
          ports:
            - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: web-sticky
spec:
  selector:
    app: web
  sessionAffinity: ClientIP
  sessionAffinityConfig:
    clientIP:
      timeoutSeconds: 60
  ports:
    - port: 80
      targetPort: 8080
YAML

kubectl rollout status deployment/web >/dev/null
kubectl get svc web-sticky -o jsonpath='{.spec.sessionAffinity}{" "}{.spec.sessionAffinityConfig.clientIP.timeoutSeconds}{"\n"}'

kubectl delete pod affinity-client --ignore-not-found >/dev/null
kubectl run affinity-client   --restart=Never   --image=busybox:1.36   --command -- sleep 3600 >/dev/null
kubectl wait --for=condition=Ready pod/affinity-client --timeout=60s >/dev/null

kubectl exec affinity-client -- sh -c   'for i in 1 2 3 4 5; do wget -qO- http://web-sticky; sleep 1; done'

kubectl delete pod affinity-client >/dev/null

预期输出

text
ClientIP 60
<POD_NAME>
<POD_NAME>
<POD_NAME>
<POD_NAME>
<POD_NAME>

五次请求都由同一个 affinity-client Pod 发起,因此在常见的集群内访问路径中,Service 数据平面会持续看到同一个客户端源 IP;60 秒粘滞窗口内,五个 <POD_NAME> 应相同。Pod 名称是动态值,实际结果由 Deployment 生成。

亲和关系不是永久绑定

ClientIP 的目标是让同一源 IP 的后端选择保持稳定,而不是把客户端永久锁在某个 Pod。粘滞窗口到期后,新的连接可以重新选择后端;如果原后端不再属于 Service 的可用端点,例如 Readiness 失败后被移出 EndpointSlice,后续连接也需要改选仍可用的端点。

因此,排查“同一客户端总是访问同一 Pod”时,应先确认是否启用了 ClientIP,再区分它与连接复用、应用层 Session 和后端健康状态。会话亲和本身不负责健康检查,也不复制应用状态。

源 IP 决定亲和性的边界

ClientIP 使用的是 Service 数据平面实际看到的源 IP,不一定等于浏览器或最终用户的真实地址。流量经过反向代理、负载均衡器、网关或源地址转换后,多个用户可能以同一个源 IP 到达 Service;反过来,同一用户的出口地址变化也可能失去原有粘滞关系。

因此,只有确实需要“按可见源 IP 稳定选择后端”时才应使用 ClientIP。如果应用依赖本地 Session、缓存或其他状态,更稳妥的设计通常是把状态外置到共享存储,让后端保持无状态,这样扩缩容、滚动更新和故障恢复都不依赖某个客户端持续命中同一个 Pod。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

理解 sessionAffinity 的作用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通