路由规则

Dubbo支持的路由类型及配合方式

基本思想

基于路由链，采用Pipeline的处理方式，如下图所示：

route-rule1.png

可以把路由链的逻辑简单的理解为 target = rn(…r3(r2(r1(src))))。对于每一个 router 内部的逻辑，可以抽象为输入地址 addrs-in 与 router 中按全量地址 addrs-all 实现切分好的 n 个互不相交的地址池 addrs-pool-1 … addrs-pool-n 按实现定义好的规则取交集作为输出 addrs-out。以此类推，完成整个路由链的计算。

route-rule2.png

另外一方面，如果 router(n) 需要执行 fallback 逻辑的时候，那么需要经过 router(n) 就应该决定好 fallback 逻辑

fallback 处理原则

由于多个 router 之间多个条件组件之后，很容易出现地址被筛选为空的情况，那么我们需要针对这情况进行 fallback 处理，保证业务在正确性的前提下，能够顺利找到有效地址。

首先我们看一下以下规则

  1. apiVersion: service.dubbo.apache.org/v1alpha1
  2. kind: VirtualService
  3. metadata:
  4.   name: demo-route
  5. spec:
  6.   hosts:
  7.   - demo  // 统一定义为应用名 
  8.   dubbo:
  9.   - service:
  10.     - exact: com.taobao.hsf.demoService:1.0.0
  11.     - exact: com.taobao.hsf.demoService:2.0.0
  12.     routedetail:
  13.     - name: sayHello-String-method-route
  14.       match: 
  15.       - method:
  16.           name_match: 
  17.             exact: "sayHello"
  18.             .....
  19.           argp:
  20.           - string
  21.       route:
  22.       - destination:
  23.           host: demo
  24.           subset: v1
  25.         fallback:
  26.           destination:
  27.             host: demo
  28.             subset: v2
  29.           fallback:
  30.             destination:
  31.               host: demo
  32.               subset: v3
  34.       - name: sayHello-method-route
  35.         match: 
  36.         - method:
  37.             name_match: 
  38.               exact: "s-method"
  39.         route:
  40.         - destination:
  41.             host: demo
  42.             subset: v2
  43.           fallback:
  44.             destination:
  45.               host: demo
  46.               subset: v3
  48.       - name: interface-route 
  49.         route:
  50.         - destination: 
  51.           host: demo
  52.           subset: v3
  54.   - service:
  56.       ....
  57. ---
  58. apiVersion: service.dubbo.apache.org/v1alpha1
  59. kind: DestinationRule
  60. metadata:
  61.   name: demo-route
  62. spec:
  63.   host: demo
  64.   subsets:
  65.   - name: v1
  66.     labels:
  67.       sigma.ali/mg: v1-host
  69.   - name: v2
  70.     labels:
  71.       sigma.ali/mg: v2-host
  73.   - name: v3
  74.     labels:
  75.       sigma.ali/mg: v3-host

我们以脚本路由为例，这个脚本路由的匹配条件是遵循一个原则的，就是匹配的范围是从精确到广泛的一个过程，在这个示例来说，就是 sayHello(string)参数 -> sayHello 方法 -> 接口级路由 的一个匹配查找过程。

那么如果我们已经满足某个条件，但是选到的 subset 地址为空，我们将如何进行 fallback 处理呢？

以匹配 sayHello(string)参数 条件为例，我们选择到的是 v1 subset,如果是空，我们可以向上一级是寻找地址，也就是方法级去寻找地址，具体的配置为下

  1.        - name: sayHello-String-method-route
  2.          match: 
  3.           - method:
  4.              name_match: 
  5.                exact: "sayHello"
  6.                .....
  7.              argp:
  8.               - string
  9.          route:
  10.           - destination:
  11.               host: demo
  12.               subset: v1
  13.             fallback:
  14.               destination:
  15.                 host: demo
  16.                 subset: v2
  17.               fallback:
  18.                 destination:
  19.                   host: demo
  20.                   subset: v3

此时我们选到的地址是 v2 方法级地址，如果 v2 还是没有地址，根据规则的定义，我们是可以 fallback 到 v3 接口级。

假设我们有一个方法匹配时，如果没有地址，需要不进行 fallback，直接报错，我们可以这样配置

  1. apiVersion: service.dubbo.apache.org/v1alpha1
  2. kind: VirtualService
  3. metadata:
  4.   name: demo-route
  5. spec:
  6.   hosts:
  7.   - demo  // 统一定义为应用名 
  8.   dubbo:
  9.   - service:
  10.     - exact: com.taobao.hsf.demoService:1.0.0
  11.     - exact: com.taobao.hsf.demoService:2.0.0
  12.     routedetail:
  13.       - name: sayHello-String-method-route
  14.         match: 
  15.         - method:
  16.             name_match: 
  17.               exact: "sayHello"
  18.               .....
  19.             argp:
  20.             - string
  21.         route:
  22.         - destination:
  23.             host: demo
  24.             subset: v1
  25.           fallback:
  26.             destination:
  27.               host: demo
  28.               subset: v2
  29.             fallback:
  30.               destination:
  31.                 host: demo
  32.                 subset: v3
  34.       - name: sayHello-method-route
  35.         match: 
  36.         - method:
  37.             name_match: 
  38.               exact: "s-method"
  39.         route:
  40.         - destination:
  41.             host: demo
  42.             subset: v2
  43.           fallback:
  44.             destination:
  45.               host: demo
  46.               subset: v3
  47.       - name: some-method-route
  48.         match: 
  49.         - method:
  50.             name_match: 
  51.               exact: "some-method"
  52.         route:
  53.         - destination:
  54.             host: demo
  55.             subset: v4
  57.       - name: interface-route 
  58.         route:
  59.         - destination: 
  60.           host: demo
  61.           subset: v3
  63.   - service:
  65.       ....
  66. ---
  67. apiVersion: service.dubbo.apache.org/v1alpha1
  68. kind: DestinationRule
  69. metadata:
  70.   name: demo-route
  71. spec:
  72.   host: demo
  73.   subsets:
  74.   - name: v1
  75.     labels:
  76.       sigma.ali/mg: v1-host
  78.   - name: v2
  79.     labels:
  80.       sigma.ali/mg: v2-host
  82.   - name: v3
  83.     labels:
  84.       sigma.ali/mg: v3-host

从这个规则我们看出来匹配到 some-method 条件时对应的是 v4 subset，那么 v4 为空时，因为没有配置 fallback ，此时会直接报错

fallback 处理原则总结

  • 我们应该在 VirtualService route 中配置好 Destination 的 fallback 处理逻辑
  • 在 fallback subset 时，如果对应的 subset 也配置有 fallback subset 时，也应递归处理；fallback subset 之间的关系也应该是从具体到广泛
  • 我们在编写匹配条件时，应该遵循从 具体条件到广泛条件 的原则

RouteChain 的组装模式 (目前未实现)

route-rule3.png

我们看到上面的图，在路由的过程当中，我们是 Pipeline 的处理方式，Pipeline 的 Router 节点存在顺序，并且每个 Router 都有一个唯一对应的 VirtualService 和 多个 相应的 DestinationRule 进行描述。

以 Nacos 上存着的路由规则配置为例，配置的格式如下：

  1. DataId: Demo.rule.yaml
  2. GROUP: HSF
  4. content:
  6. VirtualService A
  7. ---
  8. DestinationRule A1
  9. ---
  10. DestinationRule A2 
  11. ---
  12. VirtualService B
  13. ---
  14. DestinationRule B
  15. ---
  16. VirtualService C
  17. ---
  18. DestinationRule C
  19. ---
  20. ...

VirtualService A 与 DestinationRule A1 、DestinationRule A2 组成一个 Router A，VirtualService B 与 DestinationRule B 组成 Router B,以此类推，完成整个 router 链的组装。

VirtualService

入站流量的规则

DestinationRule

目标地址规则

最后修改 September 21, 2021: Bug fix miss mialbox (#953) (57cf51b)