router.md

Configuring Router

Router is a set of L7 load-balancing rules that can route between your services. It can add header-based routing, path-based routing, cookies, and other rules. Routing uses the Gloo feature under the hood, so ensure that is enabled before continuing! See Install Docs to learn how to enable this feature. It will be enabled by default.

Create Routers

To create a router:

$ rio [-n $namespace] route add $name to $target

Note: $name will be the router name. $target can point to individual services or a group of services. The target service has to be in the same namespace as the router.

For example, to point to app demo and version v1:

$ rio route add prod to demo@v1

To point to all weighted versions of app demo:

$ rio route add prod to demo

Add Path-Based Match

Creating a route with path-based matching supports: exact match: foo; prefix match: foo*; and regular expression match: regexp(foo.*).

$ rio route add $name/path to $target

# to add prefix
$ rio route add $name/path'*' to $target

# to add regular expression match
$ rio route add $name/regexp'(foo[1-9])' to $target

Try to access the routes you just created to test if routes are configured properly

$ curl https://route.xxx.on-rio.io/path
$ curl https://route.xxx.on-rio.io/path-test
$ curl https://route.xxx.on-rio.io/foo1 

Point to Different Port

Create a route to a different port:

$ rio route add $name to $target,port=8080

Add Header-Based Route

Creating a route with header-based matching supports: exact match: foo; prefix match: foo*; and regular expression match: regexp(foo.*).

$ rio route add --header USER=test $name to $target
$ rio route add --header USER=test'*' $name to $target
$ rio route add --header USER=regexp'(test[1-9])' $name to $target

Access url to test if routes are configured properly

$ curl -H'USER: test' https://route.xxx.on-rio.io
$ curl -H'USER: test-foo' https://route.xxx.on-rio.io
$ curl -H'USER: test1' https://route.xxx.on-rio.io

Route Based on HTTP Method

Create route based on HTTP method:

$ rio route add --method POST $name to $target

Sending POST requests to get traffic go through. Instead, GET request will get 404.

$ curl -i -X POST https://route.xxx.on-rio.io
$ curl -i -X GET https://route.xxx.on-rio.io

Manipulate headers

Add, set, or remove headers:

$ rio route add --add-header FOO=BAR $name to $target
$ rio route add --set-header FOO=BAR $name to $target
$ rio route add --remove-header FOO=BAR $name to $target

Rewrite to host/path

Rewrite host header and path:

$ rio route add --rewrite-host foo $name to $target
$ rio route add --rewrite-path /path $name to $target

Redirect

Redirect to another service:

$ rio route add $name redirect $target_service/path

To add a https redirect

$ rio route add --https-redirect $name to $target

If you want to https redirect on your public domain, register domain to this router

$ rio domain add foo.bar $name 

Timeout

Add timeout:

$ rio route add --timeout-seconds $value $name to $target

Fault injection

Add fault injection:

$ rio route add --fault-httpcode 502 --fault-delay-milli-seconds 1000 --fault-percentage 80 $name to $target

Retry logic

Add retry logic:

$ rio route add --retry-attempts 5 --retry-timeout-seconds 1 $name to $target

Split traffic in router

Create router to different revision and different weight:

$ rio route add $name to $service@v0,weight=50 $service@v1,weight=50

Insert Rules

Insert a router rule instead of append so that it will be evaluated first:

$ rio route add --insert $name to $target