容器与云原生 / 系统课时

Ingress 流量控制

Ingress 流量控制

这一节以 ingress-nginx 为例,把常见的入口策略集中到一个 Ingress:重写请求路径、限制请求体大小、按客户端限速,并通过 Cookie 保持会话。重点是先确认控制器能力,再验证注解确实落到目标 Ingress。

学习目标

  • 区分 Kubernetes Ingress 标准字段与控制器专有注解。
  • 为路径重写、请求体限制、访问限速和会话保持配置 ingress-nginx 注解。
  • 通过对象查询检查配置,并理解这些策略的生效边界。

先确认控制器能力

Ingress API 只定义主机、路径和后端等通用路由能力,重写、限速、粘性会话等通常由具体控制器扩展。下面的注解属于 ingress-nginx;如果你的 IngressClass 指向其他控制器,不能直接照搬。

bash
kubectl get ingressclass nginx -o jsonpath='{.spec.controller}{"\n"}'

预期输出:

text
k8s.io/ingress-nginx

如果输出不是这个控制器标识,应查阅当前控制器的配置文档,换成它支持的字段或注解,而不是假设 Kubernetes 会统一解释这些键。

配置四类入口策略

示例假设 demo 命名空间已有 web Service,端口为 80。客户端访问 /api/... 时,正则捕获剩余路径并重写为后端的根路径;请求体上限设为 1m;单个客户端限制为每秒 5 个请求;会话保持使用名为 route 的 Cookie。

Ingress 请求进入后的四类控制策略

创建 ingress-control.yaml:

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web-control
  namespace: demo
  annotations:
    nginx.ingress.kubernetes.io/use-regex: "true"
    nginx.ingress.kubernetes.io/rewrite-target: "/$2"
    nginx.ingress.kubernetes.io/proxy-body-size: "1m"
    nginx.ingress.kubernetes.io/limit-rps: "5"
    nginx.ingress.kubernetes.io/affinity: "cookie"
    nginx.ingress.kubernetes.io/session-cookie-name: "route"
spec:
  ingressClassName: nginx
  rules:
    - host: app.example.com
      http:
        paths:
          - path: /api(/|$)(.*)
            pathType: ImplementationSpecific
            backend:
              service:
                name: web
                port:
                  number: 80

这些配置分别承担不同职责:

能力 关键配置 生效含义
路径重写 use-regex、rewrite-target /api/users 转发给后端时使用 /users
请求体限制 proxy-body-size: "1m" 控制器拒绝超过约 1 MiB 的请求体
访问限速 limit-rps: "5" ingress-nginx 按客户端来源进行速率限制
会话保持 affinity: "cookie" 控制器通过 Cookie 让后续请求尽量回到同一后端

应用并检查注解

应用配置:

bash
kubectl apply -f ingress-control.yaml
kubectl get ingress web-control -n demo

预期输出:

text
ingress.networking.k8s.io/web-control created
NAME          CLASS   HOSTS             ADDRESS   PORTS   AGE
web-control   nginx   app.example.com   <IP>      80      <TIME>

随后读取实际保存到对象中的四类核心注解:

bash
kubectl get ingress web-control -n demo -o jsonpath='{.metadata.annotations.nginx\.ingress\.kubernetes\.io/rewrite-target}{"\n"}{.metadata.annotations.nginx\.ingress\.kubernetes\.io/proxy-body-size}{"\n"}{.metadata.annotations.nginx\.ingress\.kubernetes\.io/limit-rps}{"\n"}{.metadata.annotations.nginx\.ingress\.kubernetes\.io/affinity}{"\n"}'

预期输出:

text
/$2
1m
5
cookie

这一步只能证明 API 对象保存了配置;如果控制器不兼容这些注解,还需要查看控制器事件或实际请求行为。

验证流量行为

先验证重写和会话 Cookie。把 <IP> 替换为 Ingress 入口地址;后端需要能返回请求路径或提供可识别的业务响应。

bash
curl -i --resolve app.example.com:80:<IP> http://app.example.com/api/health

预期输出:

text
HTTP/1.1 200 OK
Set-Cookie: route=<VALUE>
<BACKEND_RESPONSE>

<VALUE>、响应头细节和正文取决于控制器版本与后端实现。若后端会回显请求路径,应观察到它收到的是 /health,而不是 /api/health。

请求体限制和速率限制更适合用受控测试验证:先在测试环境发送略大于 1 MiB 的请求体,再以稳定并发逐步提高请求速率,同时观察控制器返回码、访问日志和后端实际收到的请求数。不要直接在生产入口用突发压测验证限速。

配置边界与排错顺序

出现“注解写了但没效果”时,按控制器归属、注解拼写、路径匹配、最终生成配置的顺序检查。尤其要注意正则重写中的捕获组:这里的 /$2 依赖路径 /api(/|$)(.*) 的第二个捕获组,改了正则却没有同步修改重写目标,会把请求改写到错误路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

Ingress 流量控制

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

登录哪都通