基于MSE云原生网关实现全链路灰度

名词解释

• MSE云原生网关：MSE云原生网关是兼容K8s Ingress标准的下一代网关产品，支持ACK容器和Nacos等多种服务发现方式，支持多种认证登录方式快速构建安全防线。更多信息，请参见云原生网关概述。

• 泳道：为相同版本应用定义的一套隔离环境。只有满足了流控路由规则的请求流量才会路由到对应泳道里的打标应用。一个应用可以属于多个泳道，一个泳道可以包含多个应用，应用和泳道是多对多的关系。

• 泳道组：泳道的集合。泳道组的作用主要是为了区分不同团队或不同场景。

• 基线环境：未打标的应用属于基线环境，是其他环境的兜底环境。

场景示例

本文通过模拟真实的调用链路为您演示全链路灰度功能。您无需修改任何业务代码，只需要给入口应用设置流量规则，该流量的标签会通过链路透传到下一个应用中。在每个应用的调用过程中，符合规则的流量会优先调用到对应的灰度应用，如果没有对应的灰度应用则会自动切换回基线应用。

各测试应用部署如下表所示：

测试应用：全链路灰度演示程序.zip，其中包含A、B和C三个后端应用，这三个后端应用既可以用作基线应用的部署，也可以用作灰度应用的部署。

流量分发示意图如下所示：

调用链路如下：

• 正常流量调用链路

  MSE云原生网关->应用sae-a -> 应用sae-b -> 应用sae-c。

• 标签流量调用链路

  • t=g1流量：MSE云原生网关->应用sae-a-a1 -> 应用sae-b -> 应用sae-c-c1。

  • t=g2流量：MSE云原生网关->应用sae-a-a2 -> 应用sae-b-b2 -> 应用sae-c-c2。

前提条件

• 已开通MSE微服务治理专业版或企业版。具体操作，请参见开通MSE微服务治理。

• 已创建MSE云原生网关。具体操作，请参见创建MSE云原生网关。

• 已创建MSE Nacos实例和命名空间。具体操作，请参见创建实例和创建命名空间。

使用限制

• 全链路灰度仅适用于2023年11月08日起新建的微服务应用。

• 全链路灰度功能仅支持在新版控制台使用。

• 由于全链路灰度功能整合了标签路由功能（此处指的是MSE微服务治理的标签路由，与MSE云原生网关的标签路由无关），因此不推荐已经加入全链路灰度的应用配置金丝雀发布和标签路由规则。

  限制项与限制值

  限制项	限制值	备注
  网关服务来源类型	SAE内置Nacos和MSE Nacos	基于MSE云原生网关的全链路灰度目前只支持SAE内置Nacos和MSE Nacos两种来源。
  MSE云原生网关版本	大于等于2.0.6版本	2.0.6以下版本需要升级至最新版本。如何升级版本，请参见升级MSE云原生网关版本。
  Spring Cloud版本	Spring Cloud Edgware及以上版本	无。
  Dubbo版本	2.5.3～2.7.8	Dubbo 3.0及以上版本当前处于灰度中，如有场景需求，请提工单联系MSE技术支持。
  客户端类型	Resttemplate Spring Cloud OpenFeign	无。
  Java应用JDK版本	目前支持JDK 6、7、8版本应用接入	JDK 11版本当前处于灰度中，如有场景需求，请提工单联系MSE技术支持。
  负载均衡类型	Ribbon 2.0.x及以上版本 LoadBalancer 3.0.x及以上版本	无。
  Spring Cloud Gateway版本	Spring Cloud Gateway 2.1.0.RELEASE及以上版本	无。

1. 部署基线应用并为其开通微服务治理功能

1.1 部署基线应用

创建sae-a、sae-b和sae-c三个基线应用。本文只介绍关键步骤，具体的操作步骤，请参见应用部署。

1. 登录SAE控制台，在左侧导航栏选择应用管理 > 应用列表，然后选择目标地域和目标命名空间，最后单击创建应用。

   

2. 在应用基础信息向导页，在基础信息设置区域和容量设置区域配置相关信息，然后单击下一步：高级设置。

   本示例中，选择通过上传代码包的形式部署sae-a、sae-b和sae-c三个基线应用。

3. 找到并展开服务注册发现区域，Nacos注册中心服务发现选择MSE Nacos专业版，并选择目标MSE Nacos实例和命名空间。其余高级配置，请参见高级配置。

   

   重要

   这三个基线应用均使用同一个MSE Nacos实例和命名空间。

4. 单击创建应用。

1.2 为基线应用开通微服务治理功能

在应用列表页面，单击应用名称，在左侧导航栏选择微服务治理 > 应用概览，单击开启微服务治理。

开启过程需要1~2分钟，请您耐心等待。

2. 部署灰度应用

基于基线应用部署灰度应用：

• 其中基线应用sae-a部署两个灰度应用，分别为sae-a-a1应用和sae-a-a2应用。

• 其中基线应用sae-b部署一个灰度应用，为sae-b-b1。

• 其中基线应用sae-c部署两个灰度应用，分别为sae-c-c1应用和sae-c-c2应用。

具体操作步骤，如下所示。

1. 在应用列表页面，单击基线应用右侧的图标，然后单击创建灰度应用。

   说明

   如果您没有开启基线应用的微服务治理功能，则无法创建灰度应用。开启步骤，请参见为基线应用开通微服务治理功能。

2. 在应用基本信息向导页，配置以下信息，然后单击下一步：高级设置。

   1. 在基础信息设置区域，设置灰度应用名称并选择以镜像或代码包的方式部署灰度应用。具体操作，请参见应用部署。

      说明

      • 灰度应用的命名空间配置会自动继承基线应用的相关配置，因此您无需对其进行额外修改。

      • 应用部署方式也会自动继承基线应用的部署方式。在本示例中，您无需重新上传代码包进行部署，但在实际的生产环境中，请根据需要进行相应的配置调整。

   2. 在灰度标签区域，设置标签值。本示例灰度应用标签的配置，请参见场景示例。

      

   3. 在容量设置区域，配置单个实例的资源规格和实例数量。

3. 在高级设置向导页，根据实际需求配置相关功能。具体操作，请参见高级配置。

   说明

   灰度应用的服务发现功能会自动继承基线应用的相关配置，因此您无需对其进行额外修改。

4. 单击创建应用。

3. 创建MSE云原生网关路由

1. 灰度应用创建完成后，返回应用列表页面，单击左侧导航栏的命名空间，然后在命名空间页面，单击基线应用和灰度应用所在的命名空间名称。

2. 进入目标命名空间后，在左侧导航栏单击网关路由，然后单击创建网关路由。

3. 在创建路由页面创建MSE云原生网关路由。本文只介绍关键步骤，详细配置说明，请参见为应用设置路由规则（MSE）。

   说明

   本文中的配置仅适用于本示例。在生产环境中，请根据实际需求进行相应的配置调整。

   1. 选择网关类型为MSE云原生网关。

   2. 网关实例选择在前提条件中已创建的网关实例。

   3. 路径（Path）选择为前缀是/。

   4. 服务来源选择MSE Nacos。

   5. MSE Nacos实例和MSE Nacos命名空间选择与基线应用相同的MSE Nacos实例和命名空间。

      

   6. 使用场景选择单服务场景。

   7. 后端服务的应用名称选择为sae-a，服务名称选择为sc-A，服务协议为HTTP，服务端口为20001。

4. 单击保存。

4. 创建泳道组及泳道

4.1 创建泳道组

1. MSE云原生网关创建成功后，返回命名空间页面，在左侧导航栏选择微服务治理 > 全链路灰度，在全链路灰度页面选择目标命名空间，然后单击创建泳道组及泳道。

   

2. 在弹出的创建泳道组面板，配置以下参数信息，然后单击确定。

   1. 自定义泳道组名称。

   2. 入口类型选择MSE云原生网关。

   3. 泳道组流量入口选择在前提条件中创建的云原生API网关实例。

   4. 泳道组涉及应用选择所有的基线应用。

   

4.2 创建泳道

在整个泳道组内，支持创建基于按内容灰度的泳道和基于按比例灰度的泳道。然而，一旦第一个泳道创建成功，后续创建的泳道将无法更改灰度模式。

以下表格中的示例均为本文场景的配置示例。在实际的生产环境中，请根据具体需求进行相应的调整。

5. 结果验证

5.1 灰度流量验证

#测试命令
curl 8.130.XX.XX/a
# 测试结果
A[192.168.XX.XX][config=base] -> B[192.168.XX.XX] -> C[192.168.XX.XX]
A${tag}[192.168.XX.XX][config=base] -> B[192.168.XX.XX] -> C${tag}[192.168.XX.XX]

5.2 微服务治理可观测

在SAE控制台的全链路灰度页面，在泳道组及涉及的应用区域单击目标应用，在应用QPS监控区域，可查看对应泳道基线版本和灰度版本的流量情况。选择回放时间，展示所选时间对应的指标数据。