Skip to content

灰度发布

使用灰度发布可以实现版本的零中断升级。假设微服务A当前是v1版本，v1版本存在一个实例，现在需要升级到到v2版本。首先配置一个灰度 发布规则，将100%的流量指向v1版本；配置规则生效后，部署v2版本；v2版本启动完毕，配置10%的流量到v2版本；当v2版本 运行稳定，配置100%的流量到v2版本；停止v1版本的实例。

  • 前提条件：灰度发布依赖负载均衡管理模块， 参考负载均衡 。

使用灰度发布，需要在项目中引入如下依赖：

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

在配置文件中增加配置项：

配置项名 描述
servicecomb.routeRule.[targetService] 目标服务的路由管理规则
servicecomb.router.type 填写'router'
servicecomb.router.header 从HTTP请求头中提取额外的可以用于匹配HTTP Header信息。 以逗号分隔的多个 Header 名称。
  • 说明：路由规则里面的 headers 来源分为如下几部分：（1）servicecomb.router.header 配置的 Header 信息；（2）Invocation Arguments，即 业务接口的参数列表。关于Invocation Arguments和Swagger Arguments的差异，请参考 Invocation 类。 Invocation Arguments的优先级 高于 servicecomb.router.header。

灰度发布规则示例如下：

servicecomb:
    routeRule:  
      provider: | #服务名
        - precedence: 2 #优先级
          match:        #匹配策略
            headers:          #header匹配
              region:            
                regex: 'regoin[0-9]*'
                caseInsensitive: false # 是否区分大小写，默认为false，区分大小写
              type:         
                exact: gray
          route: #路由规则
            - weight: 100 #权重值
              tags:
                version: {version1}
                app: {appId}
        - precedence: 1
          route:
            - weight: 20
              tags:
                version: 0.01
                tags: tag
            - weight: 80
              tags:
                version: 0.02

规则说明

  • 匹配特定请求由match配置，匹配条件是headers。
  • Header中的字段的匹配支持正则匹配、精准匹配。
  • 如果未定义match，则可匹配任何请求。
  • 转发权重定义在routeRule.{targetServiceName}.route下，由weight配置，weight数值表示百分数，需要满足加和等于100，不满足100的部分会用最新版本填充。
  • 服务分组定义在routeRule.{targetServiceName}.route下，由tags配置，配置内容有version和app。
  • caseInsensitive 配置条件是否区分大小写，默认false区分大小写，true则不区分大小写。
  • 优先级数量越大优先级越高。

匹配流程

对于上面的示例配置，所有访问provider服务的请求，首先尝试与优先级为2的第一个的match规则进行匹配 header：header存在key为region的按照正则规则区分大小写匹配，存在key为type的进行字符串精准匹配。若匹配 match成功则按照route的配置分配100%的流量到version和tags对应的实例。若匹配match失败则进入下个优先级为1的规则。不同规则优先级不能相等。

异常情况的处理

如果因为规则配置错误，或者没有match到任何一条规则，流量会直接跳过灰度规则，相当于没有灰度发布配置。

如果已经匹配了match，因为对应的version或者tags找不到实例，则剩余流量自动转发到目前的最新版本。