配置请求路由

此任务将演示如何根据权重和HTTP header配置动态请求路由。

前提条件

请注意：本文档假设示例应用程序通过kubernetes进行部署。所有的示例命令行都采用规则yaml文件（例如samples/bookinfo/kube/route-rule-all-v1.yaml）指定的kubernetes版本。如果在不同的环境下运行本任务，请将kube修改为运行环境中相应的目录（例如，对基于Consul的运行环境，目录就是samples/bookinfo/consul/route-rule-all-v1.yaml）。

基于内容的路由

BookInfo示例部署了三个版本的reviews服务，因此需要设置一个缺省路由。否则当多次访问该应用程序时，会发现有时输出会包含带星级的评价内容，有时又没有。出现该现象的原因是当没有为应用显式指定缺省路由时，Istio会将请求随机路由到该服务的所有可用版本上。

请注意：本文档假设还没有设置任何路由规则。如果已经为示例应用程序创建了存在冲突的路由规则，则需要在下面的命令中使用 replace 关键字代替 create。

  1. 将所有微服务的缺省版本设置为v1。

    1. istioctl create -f samples/bookinfo/kube/route-rule-all-v1.yaml

    请注意：在kubernetes中部署Istio时，可以在上面及其它所有命令行中用 kubectl 代替 istioctl。但是目前 kubectl 不提供对命令输入参数的验证。

    可以通过下面的命令来显示所有以创建的路由规则。

    1. istioctl get routerules -o yaml
    1. apiVersion: config.istio.io/v1alpha2
    2. kind: RouteRule
    3. metadata:
    4.   name: details-default
    5.   namespace: default
    6.   ...
    7. spec:
    8.   destination:
    9.     name: details
    10.   precedence: 1
    11.   route:
    12.   - labels:
    13.       version: v1
    14. ---
    15. apiVersion: config.istio.io/v1alpha2
    16. kind: RouteRule
    17. metadata:
    18.   name: productpage-default
    19.   namespace: default
    20.   ...
    21. spec:
    22.   destination:
    23.     name: productpage
    24.   precedence: 1
    25.   route:
    26.   - labels:
    27.       version: v1
    28. ---
    29. apiVersion: config.istio.io/v1alpha2
    30. kind: RouteRule
    31. metadata:
    32.   name: ratings-default
    33.   namespace: default
    34.   ...
    35. spec:
    36.   destination:
    37.     name: ratings
    38.   precedence: 1
    39.   route:
    40.   - labels:
    41.       version: v1
    42. ---
    43. apiVersion: config.istio.io/v1alpha2
    44. kind: RouteRule
    45. metadata:
    46.   name: reviews-default
    47.   namespace: default
    48.   ...
    49. spec:
    50.   destination:
    51.     name: reviews
    52.   precedence: 1
    53.   route:
    54.   - labels:
    55.       version: v1
    56. ---

    由于路由规则是通过异步方式分发到代理的，过一段时间后规则才会同步到所有pod上。因此需要等几秒钟后再尝试访问应用。

  2. 在浏览器中打开BookInfo应用程序的 URL(http://$GATEWAY_URL/productpage)。

    可以看到BookInfo应用程序的productpage页面。

    请注意productpage页面显示的内容中不包含带星的评价信息，这是为reviews:v1服务不会访问ratings服务。

  3. 将来自特定用户的请求路由到reviews:v2。

    把来自测试用户”jason”的请求路由到reviews:v2，以启用ratings服务。

    1. istioctl create -f samples/bookinfo/kube/route-rule-reviews-test-v2.yaml

    确认规则已创建：

    1. istioctl get routerule reviews-test-v2 -o yaml
    1. apiVersion: config.istio.io/v1alpha2
    2. kind: RouteRule
    3. metadata:
    4.   name: reviews-test-v2
    5.   namespace: default
    6.   ...
    7. spec:
    8.   destination:
    9.     name: reviews
    10.   match:
    11.     request:
    12.       headers:
    13.         cookie:
    14.           regex: ^(.*?;)?(user=jason)(;.*)?$
    15.   precedence: 2
    16.   route:
    17.   - labels:
    18.       version: v2

  4. 以”jason”用户登录productpage页面。

    此时应该可以在每条评价后面看到星级信息。请注意如果以别的用户登录，还是只能看到reviews:v1版本服务呈现出的内容，即不包含星级信息的内容。

理解原理

在这个任务中，我们首先使用Istio将100%的请求流量都路由到了BookInfo服务的v1版本。
然后再设置了一条路由规则，该路由规则基于请求的header（例如一个用户cookie）选择性地将特定的流量路由到了reviews服务的v2版本。

一旦reviews服务的v2版本经过测试后满足要求，我们就可以使用Istio将来自所有用户的流量一次性或者渐进地路由到v2版本。我们将在另一个单独的任务中对此进行尝试。

清理

  • 删除路由规则

    1. istioctl delete -f samples/bookinfo/kube/route-rule-all-v1.yaml
    2. istioctl delete -f samples/bookinfo/kube/route-rule-reviews-test-v2.yaml

  • 如果不打算尝试后面的任务，请参照 BookInfo cleanup 中的步骤关闭应用程序。

下一步