使用ASM网关的流量路由功能

服务网格 ASM(Service Mesh)为网关提供了直观的图形化界面,您可以直接在控制台创建目标规则和虚拟服务,而无需编写YAML文件,大幅简化了流量管理操作。本文介绍如何使用图形化的方式创建流量策略和路由策略。

前提条件

示例说明

本文以Reviews服务为例,使用图形化的方式设置服务的负载均衡、连接池等流量策略,流量策略创建成功后,将自动生成对应目标规则的YAML文件。以Bookinfo服务为例,使用图形化的方式为Bookinfo服务创建/productpage/login等路由策略,从而可以通过/productpage等路径访问到Bookinfo服务。

创建域名

  1. 登录ASM控制台,在左侧导航栏,选择服务网格 > 网格管理

  2. 网格管理页面,单击目标实例名称,然后在左侧导航栏,选择ASM网关 > 入口网关

  3. 入口网关页面,单击目标网关的名称。在网关概览页面左侧导航栏,单击域名/证书

  4. 新建域名页面,按照以下内容进行配置。单击创建

    配置项

    示例

    域名

    *

    协议

    HTTP

    命名空间

    default

    端口名称

    http

    端口

    80

    image

导入上游服务

在ASM网关中导入服务,以关联网关与服务。

  1. 入口网关页面,单击目标网关的名称。在网关概览页面左侧导航栏,单击上游服务

  2. 上游服务页面,单击导入服务。在导入服务页面,选择命名空间,选中reviewsproductpage服务,单击上游服务图标,然后单击确认

    导入服务

创建流量策略

  1. 对服务进行版本管理。

    本文将reviews服务分为v1、v2、v3来进行分组。

    1. 上游服务页面,单击reviews服务右侧操作列下的版本管理

    2. 版本管理页面,单击添加服务版本(子集),输入版本名称为v1,单击添加标签,设置标签名为version,标签值为v1。

    3. 单击添加服务版本(子集),输入版本名称为v2,单击添加标签,设置标签名为version,标签值为v2。

    4. 再次单击添加服务版本(子集),输入版本名称为v3,单击添加标签,设置标签名为version,标签值为v3,然后单击创建

  2. 创建流量策略。

    1. 上游服务页面,单击reviews服务右侧操作列下的流量策略

    2. 流量策略页面,单击添加策略,选择版本流量策略,选择v3版本,打开负载均衡开关,选择简单模式,设置均衡方式随机,然后单击提交

      流量策略

  3. 可选)查看流量策略创建成功后生成的目标规则的YAML文件。

    上游服务页面,单击reviews服务右侧操作列下的查看YAML,在预览对话框,查看YAML文件,确认无误后,单击确认

    说明

    您也可以在网格详情页面左侧导航栏,选择流量管理中心 > 目标规则。在目标规则页面,单击目标规则右侧操作列下的查看YAML。在编辑对话框,查看生成的目标规则的YAML文件。

    展开查看YAML

    apiVersion: networking.istio.io/v1beta1
    kind: DestinationRule
    metadata:
      name: reviews
      namespace: default
      labels:
        provider: asm
    spec:
      host: reviews
      subsets:
        - name: v1
          labels:
            version: v1
        - name: v2
          labels:
            version: v2
        - name: v3
          labels:
            version: v3
          trafficPolicy:
            loadBalancer:
              simple: RANDOM

创建路由策略

  1. 创建路由策略。

    1. 创建/productpage路由。

      1. 在网关概览页面左侧导航栏,单击路由管理,然后单击创建

      2. 设置路由信息配置向导,进行相关配置,单击下一步

        配置项

        示例

        路由类型

        本文配置为http

        命名空间

        本文配置为default

        路由名称

        本文配置为productpage-route

        描述

        本文配置为productpage路由

        优先级

        本文配置为3

        说明

        路由配置存在优先级关系,优先级数字越小,表示优先级越高,如果URI被多个路由规则都能进行匹配,优先匹配高优先级。

        匹配规则

        设置URL匹配,只有符合要求的URL才能路由到目标服务。

        打开匹配请求的URI开关,配置匹配方式精确匹配内容/productpage

        说明

        您也可以单击添加Header匹配规则,设置Header匹配。

      3. 设置路由目的地配置向导,进行相关配置,然后单击下一步

        配置项

        示例

        选择上游服务

        设置路由策略生效的服务。此处选择productpage

        端口

        非必填项。设置上游服务中暴露出来的指定端口。上游服务可能暴露多个端口,如果有多个端口,需要进行指定。此处留空。

        版本

        设置路由策略生效的版本。此处留空。

        权重

        设置路由的目标服务的流量权重。此处留空。

      4. 高级选项配置向导,打开故障注入开关,打开请求延时开关,设置延时值4s故障注入百分比100,单击创建

    2. 创建/static路由。

      1. 路由管理页面,单击创建

      2. 设置路由信息配置向导,进行相关配置,单击下一步

        配置项

        示例

        路由类型

        本文配置为http

        命名空间

        本文配置为default

        路由名称

        本文配置为static

        描述

        本文配置为static资源

        优先级

        本文配置为0

        匹配规则

        设置URL匹配,只有符合要求的URL才能路由到目标服务。

        打开匹配请求的URI开关,配置匹配方式前缀匹配内容/static

      3. 创建/static路由的后续步骤与创建/productpage路由相同,具体操作,请参见创建productpage路由

    3. 创建/login路由。

      1. 路由管理页面,单击创建

      2. 设置路由信息配置向导,进行相关配置,然后单击下一步

        配置项

        示例

        路由类型

        本文配置为http

        命名空间

        本文配置为default

        路由名称

        本文配置为login

        描述

        本文配置为登录请求路由

        优先级

        本文配置为0

        匹配规则

        设置URL匹配,只有符合要求的URL才能路由到目标服务。

        打开匹配请求的URI开关,配置匹配方式前缀匹配内容/login

      3. 创建/login路由的后续步骤与创建/productpage路由相同,具体操作,请参见创建productpage路由

    4. 创建/logout路由。

      1. 路由管理页面,单击创建

      2. 设置路由信息配置向导,进行相关配置,然后单击下一步

        配置项

        示例

        路由类型

        本文配置为http

        命名空间

        本文配置为default

        路由名称

        本文配置为logout

        描述

        本文配置为登出路由

        优先级

        本文配置为0

        匹配规则

        设置URL匹配,只有符合要求的URL才能路由到目标服务。

        打开匹配请求的URI开关,配置匹配方式前缀匹配内容/logout

      3. 创建/logout路由的后续步骤与创建/productpage路由相同,具体操作,请参见创建productpage路由

    5. 创建/api/v1/products路由。

      1. 路由管理页面,单击创建

      2. 设置路由信息配置向导,进行相关配置,然后单击下一步

        配置项

        说明

        路由类型

        本文配置为http

        命名空间

        本文配置为default

        路由名称

        本文配置为products-route

        描述

        本文配置为product信息

        优先级

        本文配置为0

        匹配规则

        设置URL匹配,只有符合要求的URL才能路由到目标服务。

        打开匹配请求的URI开关,配置匹配方式前缀匹配内容/api/v1/products

      3. 创建/api/v1/products路由的后续步骤与创建/productpage路由相同,具体操作,请参见创建productpage路由

  2. 验证路由策略是否生效。

    1. 在浏览器地址栏,输入http://{入口网关的IP地址}/productpage

      示例效果如下。访问服务

    2. 在Bookinfo页面右上角,单击Sign in

    3. Please sign in输入任意账号和密码,单击Sign in

      可以看到能够正常登录到Bookinfo。登录bookinfo

      您还可以自行使用/logout/static/api/v1/products访问Bookinfo服务进行验证。

    4. 打开浏览器的开发人员工具,切换到网络标签。

    5. 刷新页面。

      可以看到约4s的延迟。延迟

  3. (可选)查看路由策略创建成功后生成的虚拟服务的YAML文件。

    1. 在网格详情页面左侧导航栏,选择流量管理中心 > 虚拟服务

    2. 虚拟服务页面,单击目标虚拟服务右侧操作列下的查看YAML

    3. 编辑对话框,查看生成的虚拟服务的YAML文件。确认无误后,单击确定

相关操作

查看服务详情

查看导入服务的是否注入Sidecar、地域等信息。

  1. 入口网关页面,单击目标网关的名称。在网关概览页面左侧导航栏,单击上游服务

  2. 上游服务页面,单击目标服务右侧操作列下的服务详情。在服务详情页面,查看服务是否注入Sidecar、地域等信息。

路由下线

下线路由策略,使该路由策略失效。

  1. 入口网关页面,单击目标网关的名称。

  2. 在网关概览页面左侧导航栏,单击路由管理

  3. 路由管理页面,单击目标路由右侧操作列下的下线

  4. 确认对话框,单击确定

  5. 验证路由下线是否成功。

    1. 在浏览器地址栏,输入http://{入口网关的IP地址}/productpage

    2. 在Bookinfo页面右上角,单击Sign in

    3. Please sign in输入任意账号和密码,单击Sign in

      路由下线

      可以看到页面显示找不到网页,说明目标路由策略失效,路由下线成功。

      说明

      您也可以通过以下方式上线路由策略,使路由策略中重新生效:

      路由管理页面,单击目标路由右侧操作列下的上线,然后在确认对话框,单击确定