VirtualService

入站流量的規(guī)則

VirtualService

VirtualService是用來處理入站流量的規(guī)則，也就是說用來描述哪些入站流量適用于該路由規(guī)則。

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:

• 屬性說明

• Router類型如下：

DubboRoute

DubboRoute是VirtualService中的屬性，用來描述路由策略的邊界。

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo: #DubboRoute
  - name:
    service:
    fault:
    mirror:
    retries:
    timeout:
    routedetail:

• 屬性說明

DubboRouteDetail

DubboRouteDetail用來描述詳細(xì)的路由規(guī)則

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail: #DubboRouteDetail
    - name:
      match:
      route:
      mirror:
      retries:
      timeout:

• 屬性說明

DubboMatchRequest

DubboMatchRequest用來描述請(qǐng)求的匹配規(guī)則

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match: #DubboMatchRequest
      - name:
        method:
        sourceLabels:
        attachments:
        headers:
        threshold:

• 屬性說明

由于 headers 、attachemes 、method 之間可能存在字段一樣重復(fù)的情況，TODO 進(jìn)一步細(xì)化

DubboMethodMatch

DubboMethodMatch是用來實(shí)現(xiàn)方法的匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method: #DubboMethodRequest
        - name_match:
          argc:
          args:
          argp:
          headers:

• 屬性說明

DubboMethodArg

DubboMethodArg用來實(shí)現(xiàn)方法參數(shù)的匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args: #DubboMethodArg
          - index:
            str_value:
            type:
            num_value:
            bool_value:
            reserve:

• 屬性說明

DubboAttachmentMatch

DubboAttachmentMatch用來對(duì)任意對(duì)象的完全匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - attachments: #DubboAttachmentMatch
          eagleeyecontext:
          dubbocontext:

• 屬性說明

ListStringMatch

ListStringMatch是一組StringMatch集合，任何一個(gè) StringMatch匹配則匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args:
          - index: 1
            str_value:  #ListStringMatch
              oneof:
              - regex: "*abc*"
              - exact: parameter-1

• 屬性說明

StringMatch

StringMatch用來描述字符串匹配規(guī)則

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - service: #StringMatch
    - exact: org.apache.dubbo.demoService:1.0.0
    - prefix: org.apache.dubbo.hello
    - regex: org.apache.dubbo.*Service:2.0.0

• 屬性說明

ListDoubleMatch

ListDoubleMatch是一組DoubleMatch集合，任何一個(gè) DoubleMatch匹配則匹配參數(shù)

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args:
          - index: 1
            type: java.lang.Double
            num_value: #ListDoubleMatch
              oneof:
              - range:
                  start: 1
                  end: 100
                  

• 屬性說明

DoubleMatch

DoubleMatch用于匹配 int, long, double類型的數(shù)值

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args:
          - index: 1
            type: java.lang.Double
            num_value:
              oneof: #DoubleMatch[]
              - range:
                  start: 1
                  end: 100
              #假設(shè)當(dāng)前輸入的Double類型的參數(shù)值為x，
              #則下面表達(dá)式的意思是：x%mode=exact, 
              #即當(dāng)x%10=6才匹配
              - exact: 6
                mode: 10
                  

• 屬性說明

DoubleRangeMatch

DoubleRangeMatch是對(duì)double值的范圍進(jìn)行匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args:
          - index: 1
            type: java.lang.Double
            num_value:
              oneof:
              - range: #DoubleRangeMatch
                  start: 1.2
                  end: 1000.5
                  

• 屬性說明

BoolMatch

BoolMatch用來對(duì)true, false的完全匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args: 
          - index: 1
            type: java.lang.Boolean
            bool_value: #BoolMatch
              - exact: true

• 屬性說明

ObjectMatch（未實(shí)現(xiàn)）

ObjectMatch用來對(duì)任意對(duì)象的完全匹配

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - match:
      - method:
        - args: 
          - index: 1
            type: java.lang.String
            str_value:
              oneof:
              - regex: "*abc*"
              - exact: parameter-1

• 屬性說明

DubboRouteDestination

DubboRouteDestination用來描述流量到目標(biāo)地址的策略

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - route: #DubboRouteDestination
        destination:
        weight: 50

• 屬性說明

DubboDestination

DubboDestination用來描述路由流量的目標(biāo)地址

• 使用示例

apiVersion: service.dubbo.apache.org/v1alpha1
kind: VirtualService
metadata:
  name: demo/StandardRouter
spec:
  hosts:
  dubbo:
  - routedetail:
    - route: #DubboRouteDestination
        destination:
          host:
          subnet:
          port:
          fallback:

• 屬性說明