TCP 流量迁移

本任务向您展示如何将 TCP 流量从微服务的某个版本迁移到另一个版本。

一个常见的用例是将 TCP 流量从微服务的旧版本逐步迁移到新版本。在 Istio 中，您可以通过配置一系列路由规则来实现此目标，这些规则将一定比例的 TCP 流量从一个目标重定向到另一个目标。

在本任务中，您将向 tcp-echo:v1 发送 100% 的 TCP 流量。然后，您将使用 Istio 的加权路由功能将 20% 的 TCP 流量路由到 tcp-echo:v2。

在您开始之前

• 按照 安装指南 中的说明设置 Istio。

• 查看 流量管理 概念文档。

设置测试环境

1. 要开始，请创建一个命名空间用于测试 TCP 流量切换。

   $ kubectl create namespace istio-io-tcp-traffic-shifting
   

2. 部署 curl 示例应用程序作为用于发送请求的测试源。

   Zip

   $ kubectl apply -f @samples/curl/curl.yaml@ -n istio-io-tcp-traffic-shifting
   

3. 部署 tcp-echo 微服务的 v1 和 v2 版本。

   Zip

   $ kubectl apply -f @samples/tcp-echo/tcp-echo-services.yaml@ -n istio-io-tcp-traffic-shifting
   

应用基于权重的 TCP 路由

1. 将所有 TCP 流量路由到 tcp-echo 微服务的 v1 版本。

$ kubectl apply -f @samples/tcp-echo/tcp-echo-all-v1.yaml@ -n istio-io-tcp-traffic-shifting

$ kubectl apply -f @samples/tcp-echo/gateway-api/tcp-echo-all-v1.yaml@ -n istio-io-tcp-traffic-shifting

2. 确定入站 IP 和端口

$ kubectl wait --for=condition=programmed gtw tcp-echo-gateway -n istio-io-tcp-traffic-shifting
$ export INGRESS_HOST=$(kubectl get gtw tcp-echo-gateway -n istio-io-tcp-traffic-shifting -o jsonpath='{.status.addresses[0].value}')
$ export TCP_INGRESS_PORT=$(kubectl get gtw tcp-echo-gateway -n istio-io-tcp-traffic-shifting -o jsonpath='{.spec.listeners[?(@.name=="tcp-31400")].port}')

3. 通过发送一些 TCP 流量来确认 tcp-echo 服务已启动并正在运行。

   $ export CURL=$(kubectl get pod -l app=curl -n istio-io-tcp-traffic-shifting -o jsonpath={.items..metadata.name})
   $ for i in {1..20}; do \
   kubectl exec "$CURL" -c curl -n istio-io-tcp-traffic-shifting -- sh -c "(date; sleep 1) | nc $INGRESS_HOST $TCP_INGRESS_PORT"; \
   done
   one Mon Nov 12 23:24:57 UTC 2022
   one Mon Nov 12 23:25:00 UTC 2022
   one Mon Nov 12 23:25:02 UTC 2022
   one Mon Nov 12 23:25:05 UTC 2022
   one Mon Nov 12 23:25:07 UTC 2022
   one Mon Nov 12 23:25:10 UTC 2022
   one Mon Nov 12 23:25:12 UTC 2022
   one Mon Nov 12 23:25:15 UTC 2022
   one Mon Nov 12 23:25:17 UTC 2022
   one Mon Nov 12 23:25:19 UTC 2022
   ...
   

   您应该会注意到所有时间戳都有一个 one 前缀，这意味着所有流量都被路由到 tcp-echo 服务的 v1 版本。

4. 使用以下命令将 20% 的流量从 tcp-echo:v1 转移到 tcp-echo:v2

$ kubectl apply -f @samples/tcp-echo/tcp-echo-20-v2.yaml@ -n istio-io-tcp-traffic-shifting

$ kubectl apply -f @samples/tcp-echo/gateway-api/tcp-echo-20-v2.yaml@ -n istio-io-tcp-traffic-shifting

5. 等待几秒钟以使新规则传播，然后确认规则已替换。

$ kubectl get virtualservice tcp-echo -o yaml -n istio-io-tcp-traffic-shifting
apiVersion: networking.istio.io/v1
kind: VirtualService
  ...
spec:
  ...
  tcp:
  - match:
    - port: 31400
    route:
    - destination:
        host: tcp-echo
        port:
          number: 9000
        subset: v1
      weight: 80
    - destination:
        host: tcp-echo
        port:
          number: 9000
        subset: v2
      weight: 20

$ kubectl get tcproute tcp-echo -o yaml -n istio-io-tcp-traffic-shifting
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: TCPRoute
  ...
spec:
  parentRefs:
  - group: gateway.networking.k8s.io
    kind: Gateway
    name: tcp-echo-gateway
    sectionName: tcp-31400
  rules:
  - backendRefs:
    - group: ""
      kind: Service
      name: tcp-echo-v1
      port: 9000
      weight: 80
    - group: ""
      kind: Service
      name: tcp-echo-v2
      port: 9000
      weight: 20
...

6. 向 tcp-echo 微服务发送更多 TCP 流量。

   $ export CURL=$(kubectl get pod -l app=curl -n istio-io-tcp-traffic-shifting -o jsonpath={.items..metadata.name})
   $ for i in {1..20}; do \
   kubectl exec "$CURL" -c curl -n istio-io-tcp-traffic-shifting -- sh -c "(date; sleep 1) | nc $INGRESS_HOST $TCP_INGRESS_PORT"; \
   done
   one Mon Nov 12 23:38:45 UTC 2022
   two Mon Nov 12 23:38:47 UTC 2022
   one Mon Nov 12 23:38:50 UTC 2022
   one Mon Nov 12 23:38:52 UTC 2022
   one Mon Nov 12 23:38:55 UTC 2022
   two Mon Nov 12 23:38:57 UTC 2022
   one Mon Nov 12 23:39:00 UTC 2022
   one Mon Nov 12 23:39:02 UTC 2022
   one Mon Nov 12 23:39:05 UTC 2022
   one Mon Nov 12 23:39:07 UTC 2022
   ...
   

   您现在应该会注意到大约 20% 的时间戳有一个 two 前缀，这意味着 80% 的 TCP 流量被路由到 tcp-echo 服务的 v1 版本，而 20% 被路由到 v2。

了解发生了什么

在此任务中，您使用 Istio 的加权路由功能将 TCP 流量从 tcp-echo 服务的旧版本部分迁移到新版本。请注意，这与使用容器编排平台的部署功能进行版本迁移非常不同，后者使用实例扩展来管理流量。

使用 Istio，您可以允许 tcp-echo 服务的两个版本独立扩展和缩减，而不会影响它们之间的流量分配。

有关使用自动扩展的版本路由的更多信息，请查看博客文章 使用 Istio 进行金丝雀部署。

清理

1. 删除路由规则

$ kubectl delete -f @samples/tcp-echo/tcp-echo-all-v1.yaml@ -n istio-io-tcp-traffic-shifting

$ kubectl delete -f @samples/tcp-echo/gateway-api/tcp-echo-all-v1.yaml@ -n istio-io-tcp-traffic-shifting

2. 删除 curl 示例、tcp-echo 应用程序和测试命名空间

   ZipZip

   $ kubectl delete -f @samples/curl/curl.yaml@ -n istio-io-tcp-traffic-shifting
   $ kubectl delete -f @samples/tcp-echo/tcp-echo-services.yaml@ -n istio-io-tcp-traffic-shifting
   $ kubectl delete namespace istio-io-tcp-traffic-shifting