Nginx Ingress 支持通过流量复制，将集群中的流量复制到其他集群中，常用于仿真测试或压力测试。本文为您介绍如何使用 Nginx Ingress 配置流量复制。

背景信息

Nginx Ingress 的流量复制功能，也被称作请求复制或流量镜像，是一种将集群中的请求流量复制到多个目标集群的能力。支持多种应用场景，包括：

• 压力测试：当用户应用发布新版本时，可以将生产集群中的流量复制到测试集群，使用实际的流量对新版本应用进行压测。这种场景下，能够在不影响生产环境的情况下测试新版本应用的可用性和性能。
• 故障排查：当生产环境出现故障时，为了不影响生产环境的正常运行，可以将生产环境的流量复制到测试环境进行故障排查和处理。

前提条件

• 已创建 2 个集群，本例中为方便描述，定义为集群 A 和集群 B。详情请参见 创建集群。
• 集群中已安装 ingress-nginx 组件，并升级至 v1.8.4-vke.1 版本。

  说明

  【邀测·申请试用】：ingress-nginx 组件的 v1.8.4-vke.1 版本目前处于邀测阶段，如需使用，请提交申请。

• 已连接集群。详情请参见 连接集群。
• 将应用镜像上传至镜像仓库，详情请参见 推送和拉取镜像。

在集群中部署业务

在集群 A 重部署业务

在集群 A 中部署旧版本的应用和服务。操作步骤如下：

1. 使用如下 YAML 配置，创建旧版本应用和服务。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-old
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx-old
  template:
    metadata:
      labels:
        app: nginx-old
    spec:
      containers:
      - name: nginx
        image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v2.0
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: service-old
spec:
  selector:
    app: nginx-old
  ports:
  - name: rule
    protocol: TCP
    port: 80
    targetPort: 80
  type: NodePort

3. 使用如下 YAML 配置，创建 Nginx Ingress，并指向旧版本服务。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-old # 路由规则的名称
spec:
  ingressClassName: nginx # 指定 Ingress Controller
  rules:
    - host: example.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-old # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号

4. 执行以下命令，验证是否可以访问到旧版本服务。其中，<EXTERNAL_IP>为 Nginx Ingress 对外暴露的 IP 地址。

curl -H "Host: example.com" http://<EXTERNAL_IP>

预期结果如下，访问到了后端旧版本的应用。

This is the old version of nginx

在集群 B 中部署业务

在集群 B 中部署新版本的应用和服务。操作步骤如下：

1. 使用如下 YAML 配置，创建新版本的应用和服务。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-new
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx-new
  template:
    metadata:
      labels:
        app: nginx-new
    spec:
      containers:
      - name: nginx
        image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v3.0
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: service-new
spec:
  selector:
    app: nginx-new
  ports:
  - name: rule
    protocol: TCP
    port: 80
    targetPort: 80
  type: NodePort

3. 使用如下 YAML 配置，创建 Nginx Ingress，并指向新版本服务。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-new # 路由规则的名称
spec:
  ingressClassName: nginx # 指定 Ingress Controller
  rules:
    - host: example1.com  # 需要对外提供访问的域名
      http:
        paths:
        - pathType: Prefix # 路径匹配规则，默认为 Prefix（前缀匹配）
          path: / # 请求匹配的路径
          backend:
            service:
              name: service-new # 需要对接的服务名称
              port: 
                number: 80 # 需要对接服务的端口号

4. 执行以下命令，验证是否可以访问到新版本服务。其中，<EXTERNAL_IP>为 Nginx Ingress 对外暴露的 IP 地址。

curl -H "Host: example1.com" http://<EXTERNAL_IP>

预期结果如下，访问到了后端新版本的应用。

This is the new version of nginx

配置流量复制

为了将集群 A（生产集群）上访问旧应用的流量，全部复制到集群 B（测试集群）上，需要在集群 A 上配置流量复制功能。操作步骤如下：

1. 使用 kubectl 连接生产集群 A。
2. 执行以下命令，编辑 Nginx-Ingress。

kubectl  edit ingress ingress-old

3. 在 Nginx Ingress 配置中添加流量复制功能的 Annotation。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-old
  annotations: 
    nginx.ingress.kubernetes.io/mirror-host: example1.com # 流量复制目标域名
    nginx.ingress.kubernetes.io/mirror-target: http://14.xxx.xxx.xxx # 跨集群场景时，填写对应 Nginx Ingress 的 VIP。同集群场景时，填写 service
spec:
  ingressClassName: nginx
  rules:
    - host: example.com
      http:
        paths:
        - pathType: Prefix
          path: /
          backend:
            service:
              name: service-old
              port: 
                number: 80

结果验证

1. 查看集群 B 中，新版本应用的 ingress-nginx-controller 日志，可以看到转发 IP 是集群 A 的 IP 地址。

2. 查询新版本应用的日志request: "GET /_mirror-30b2558b-5eab-42eb-8ffc-9c128a703479 HTTP/1.1。

3. 旧版本的日志查询，调用正常，不影响线上调用。