Kubernetes Gateway API：HTTP请求镜像详解

蘑菇大人。

460人浏览 · 2026-02-27 08:31:16

蘑菇大人。 · 2026-02-27 08:31:16 发布

Kubernetes Gateway API：HTTP请求镜像详解

什么是HTTP请求镜像？

HTTP请求镜像是Kubernetes Gateway API中的一项实用功能，简单来说，它可以将请求复制到多个后端服务，同时只使用原始后端的响应。这意味着你可以在不影响生产流量的情况下，测试新服务的表现。

为什么需要请求镜像？

无损测试：在不影响用户体验的情况下测试新服务
真实流量：使用生产环境的真实流量进行测试
性能评估：评估新服务在实际负载下的表现
蓝绿部署：为平滑的版本切换提供数据支持

工作原理

请求镜像的工作流程其实很简单：

客户端发送请求到Gateway
Gateway将请求转发到主要后端服务
同时，Gateway复制请求并发送到镜像后端服务
Gateway等待并返回主要后端服务的响应
镜像后端服务的响应被Gateway忽略

配置指南

基础配置

apiVersion: gateway.networking.k8s.io/v1  # API版本
kind: HTTPRoute                           # 资源类型，用于定义HTTP流量路由
metadata:
  name: http-filter-mirror                # 路由名称
  labels:
    gateway: mirror-gateway               # 标签，用于关联Gateway
spec:
  parentRefs:                             # 父资源引用，指向使用的Gateway
  - name: mirror-gateway                  # Gateway名称
  hostnames:
  - mirror.example                        # 绑定的域名
  rules:
  - backendRefs:                          # 主要后端服务引用
    - name: foo-v1                        # 主要后端服务名称
      port: 8080                          # 服务端口
    filters:
    - type: RequestMirror                 # 过滤器类型，指定为请求镜像
      requestMirror:
        backendRef:                       # 镜像后端服务引用
          name: foo-v2                    # 镜像后端服务名称
          port: 8080                      # 服务端口

提示：这个配置会将所有发送到mirror.example的请求，同时转发到foo-v1和foo-v2，但只返回foo-v1的响应。

按比例镜像

如果你不想镜像所有请求，可以设置百分比：

apiVersion: gateway.networking.k8s.io/v1  # API版本
kind: HTTPRoute                           # 资源类型
metadata:
  name: mirror-route                      # 路由名称
  namespace: default                      # 命名空间
spec:
  parentRefs:
  - name: example-gateway                 # Gateway名称
  rules:
  - matches:
    - path:
        type: PathPrefix                  # 路径匹配类型，前缀匹配
        value: /                          # 匹配路径
    filters:
    - type: RequestMirror                 # 过滤器类型
      requestMirror:
        backendRef:
          name: mirror-service            # 镜像服务名称
          port: 80                        # 服务端口
        percentage: 10                    # 镜像百分比，只镜像10%的请求
    backendRefs:
    - name: primary-service               # 主要服务名称
      port: 80                            # 服务端口

特定路径镜像

只对特定路径进行镜像，比如API路径：

apiVersion: gateway.networking.k8s.io/v1  # API版本
kind: HTTPRoute                           # 资源类型
metadata:
  name: path-mirror-route                 # 路由名称
  namespace: default                      # 命名空间
spec:
  parentRefs:
  - name: example-gateway                 # Gateway名称
  rules:
  - matches:
    - path:
          type: PathPrefix                # 路径匹配类型
          value: /api                     # 只匹配/api路径
    filters:
    - type: RequestMirror                 # 过滤器类型
      requestMirror:
        backendRef:
          name: api-mirror-service        # API镜像服务名称
          port: 80                        # 服务端口
        percentage: 100                   # 镜像百分比，100%镜像
    backendRefs:
    - name: api-service                   # 主要API服务名称
      port: 80                            # 服务端口

生产环境配置

在生产环境中，配置需要更加谨慎：

apiVersion: gateway.networking.k8s.io/v1  # API版本
kind: HTTPRoute                           # 资源类型
metadata:
  name: production-mirror-route           # 路由名称
  namespace: production                   # 生产环境命名空间
  labels:
    app: production                       # 应用标签
    environment: prod                     # 环境标签
  annotations:
    description: "生产环境请求镜像配置"  # 描述注解
    team: "平台团队"                       # 负责团队注解
spec:
  parentRefs:
  - name: production-gateway              # 生产环境Gateway
    namespace: gateway-system             # Gateway所在命名空间
  hostnames:
  - api.example.com                       # 生产域名
  rules:
  - matches:
    - path:
        type: PathPrefix                  # 路径匹配类型
        value: /v1                        # API v1路径
    - path:
        type: PathPrefix                  # 路径匹配类型
        value: /v2                        # API v2路径
    filters:
    - type: RequestMirror                 # 过滤器类型
      requestMirror:
        backendRef:
          name: staging-api-service       # 测试环境服务
          namespace: staging              # 测试环境命名空间
          port: 8080                      # 服务端口
        percentage: 20                    # 镜像百分比，从低开始
    backendRefs:
    - name: production-api-service        # 生产API服务
      port: 8080                          # 服务端口