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

名词解释

• 云原生API网关：云原生API网关是兼容K8s Ingress标准的下一代网关产品，将传统的API网关、流量网关、微服务网关、安全网关功能合并，支持ACK容器服务和Nacos等多种服务发现方式，支持多种认证登录方式快速构建安全防线。具体介绍，请参见什么是云原生API网关。

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

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

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

场景示例

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

各测试应用如下所示：

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

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

正常流量调用链路：

API服务网关 -> 应用sae-a -> 应用sae-b -> 应用sae-c。

标签流量调用链路：

• t=g1流量：API服务网关 -> 应用sae-a-a1 -> 应用sae-b -> 应用sae-c-c1。

• t=g2流量：API服务网关 -> 应用sae-a-a2 -> 应用sae-b-b2 -> 应用sae-c-c2。

前提条件

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

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

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

使用限制

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

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

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

  限制项与限制值

  限制项	限制值	备注
  网关服务来源类型	MSE Nacos和K8s Service	基于云原生API网关的全链路灰度目前只支持MSE Nacos和K8s Service两种来源。
  云原生API网关版本	大于等于2.0.1版本	对于2.0.1以下的版本，需要在云原生API网关控制台的实例页面手动升级引擎版本。
  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. 部署基线应用并为其开通微服务治理功能

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. 创建云原生API网关路由

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

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

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

   说明

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

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

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

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

   4. 服务来源选择MSE Nacos。

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

      

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

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

4. 单击保存。

4. 创建泳道组及泳道

5. 结果验证

#测试命令
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]