更新时间:2023-08-31 GMT+08:00

使用灰度发布

为保障新特性平稳上线,可以先选择少部分用户试用,待新特性成熟以后,再让所有用户使用。灰度发布可以保证整体系统的稳定,在初始灰度的时候就可以发现、调整问题,以减少其影响。

基于Servicecomb Java Chassis和Spring Cloud Huawei框架注册到微服务引擎的微服务,使用灰度功能只需通过配置下发即可使用。

Servicecomb Java Chassis依赖handler-router和Spring Cloud Huawei依赖spring-cloud-starter-huawei-router实现微服务灰度能力,下发规则遵守如下规范:

servicecomb:
    routeRule:  
      provider: | #服务名
        - precedence: 2 #优先级
          match:        #匹配策略
            headers:          #header匹配
              region:            
                exact: 'providerRegion'

              type:         
                exact: gray
          route: #路由规则
            - weight: 100 #权重值
              tags:
                version: 1.0.0
              
        - precedence: 1
          route:
            - weight: 20
              tags:
                version: 0.0.1
                canaryProperty: group-a
            - weight: 80
              tags:
                version: 0.0.2

上述配置的具体含义如下:

  • 匹配特定请求由match配置,匹配条件是headers。headers中的字段的匹配支持精准匹配。如果未定义match,则可匹配任何请求。
  • 转发权重定义在routeRule.{targetServiceName}.route下,由weight配置,weight数值表示百分数,需要满足加和等于100,不满足100的部分会用最新版本填充。
  • 服务分组定义在routeRule.{targetServiceName}.route下,由tags配置,version是特殊的tag,表示微服务版本。还可以配置其他属性,这些属性在实例的属性里面定义。
  • 优先级数量越大优先级越高。

Servicecomb Java Chassis依赖darklaunch实现的微服务灰度能力,也是当前微服务引擎页面下发的规则,遵守如下规范:

{
  "policyType":"RULE",
  "ruleItems":[
    {
      "groupName":"self_rule_test",
      "groupCondition":"version=0.0.1",
      "policyCondition":"name=11111",
      "versions":["0.0.1"]
     }],
   "empty":false
}

上述配置的具体含义如下:

  • policyCondition路由规则匹配条件,本条规则匹配的是请求参数为name,值为11111时匹配当前路由规则。
  • groupName路由规则名称。
  • groupCondition规则的目标分组,本条路由规则在匹配到name=11111的条件下,路由到version=0.0.1的微服务实例。
  • 配置项固定为:cse.darklaunch.policy.${serviceName}。

Spring Cloud Huawei

Spring Cloud Huawei使用灰度发布,需要在项目中增加如下依赖。如果项目中已经直接或者间接引入依赖,无需重复引入。

<dependency>
  <groupId>com.huaweicloud</groupId>
  <artifactId>spring-cloud-starter-huawei-router</artifactId>
</dependency>

灰度规则依赖的headers参数设置:

  • 1.10.7及之后版本header参数需要在配置文件中设置,用户请求当中的header不会透传到下游服务:
    spring:
      cloud:
        servicecomb:
          context:
            headerContextMapper:
              canary: canary
  • 1.10.7之前的版本设置header参数:请求中设置的header参数进行透传。

Java Chassis

Java Chassis使用灰度发布,需要在项目中增加如下依赖。如果项目中已经直接或者间接引入依赖,无需重复引入。

<dependency>
  <groupId>org.apache.servicecomb</groupId>
  <artifactId>handler-router</artifactId>
</dependency>

或者

<dependency>
    <groupId>org.apache.servicecomb</groupId>
    <artifactId>darklaunch</artifactId>
</dependency>

并在配置文件中增加配置项:

servicecomb.router.type: router

Java Chassis默认不会传递非参数header到各个微服务,如果灰度发布依赖于非参数header,可以增加如下配置项:

servicecomb.router.header: canaryHeader1,canaryHeader2

Java Chassis会将这些非参数header用于灰度发布的匹配。

如果请求经过Edge Service转发,Edge Service也需要增加灰度发布相关的配置。