mirror of
https://github.com/nsnail/Ocelot.git
synced 2025-04-21 05:12:50 +08:00
3ac9b3bd87
* hacked together load balancing reroutes in fileconfig * some renaming and refactoring * more renames * hacked away the old config json * test for issue 213 * renamed key * dont share ports * oops * updated docs * mvoed docs around * port being used
113 lines
4.3 KiB
ReStructuredText
113 lines
4.3 KiB
ReStructuredText
Routing
|
|
=======
|
|
|
|
Ocelot's primary functionality is to take incomeing http requests and forward them on
|
|
to a downstream service. At the moment in the form of another http request (in the future
|
|
this could be any transport mechanism.).
|
|
|
|
Ocelot's describes the routing of one request to another as a ReRoute. In order to get
|
|
anything working in Ocelot you need to set up a ReRoute in the configuration.
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"ReRoutes": [
|
|
]
|
|
}
|
|
|
|
In order to set up a ReRoute you need to add one to the json array called ReRoutes like
|
|
the following.
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"DownstreamPathTemplate": "/api/posts/{postId}",
|
|
"DownstreamScheme": "https",
|
|
"DownstreamHostAndPorts": [
|
|
{
|
|
"Host": "localhost",
|
|
"Port": 80,
|
|
}
|
|
],
|
|
"UpstreamPathTemplate": "/posts/{postId}",
|
|
"UpstreamHttpMethod": [ "Put", "Delete" ]
|
|
}
|
|
|
|
The DownstreamPathTemplate, Scheme and DownstreamHostAndPorts make the URL that this request will be forwarded to.
|
|
|
|
DownstreamHostAndPorts is an array that contains the host and port of any downstream services that you wish to forward requests to. Usually this will just contain one entry but sometimes you might want to load balance
|
|
requests to your downstream services and Ocelot let's you add more than one entry and then select a load balancer.
|
|
|
|
The UpstreamPathTemplate is the URL that Ocelot will use to identity which DownstreamPathTemplate to use for a given request. Finally the UpstreamHttpMethod is used so
|
|
Ocelot can distinguish between requests to the same URL and is obviously needed to work :)
|
|
|
|
You can set a specific list of HTTP Methods or set an empty list to allow any of them. In Ocelot you can add placeholders for variables to your Templates in the form of {something}.
|
|
The placeholder needs to be in both the DownstreamPathTemplate and UpstreamPathTemplate. If it is Ocelot will attempt to replace the placeholder with the correct variable value from the Upstream URL when the request comes in.
|
|
|
|
You can also do a catch all type of ReRoute e.g.
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"DownstreamPathTemplate": "/api/{everything}",
|
|
"DownstreamScheme": "https",
|
|
"DownstreamHostAndPorts": [
|
|
{
|
|
"Host": "localhost",
|
|
"Port": 80,
|
|
}
|
|
],
|
|
"UpstreamPathTemplate": "/{everything}",
|
|
"UpstreamHttpMethod": [ "Get", "Post" ]
|
|
}
|
|
|
|
This will forward any path + query string combinations to the downstream service after the path /api.
|
|
|
|
At the moment without any configuration Ocelot will default to all ReRoutes being case insensitive.
|
|
In order to change this you can specify on a per ReRoute basis the following setting.
|
|
|
|
.. code-block:: json
|
|
|
|
"ReRouteIsCaseSensitive": true
|
|
|
|
This means that when Ocelot tries to match the incoming upstream url with an upstream template the
|
|
evaluation will be case sensitive. This setting defaults to false so only set it if you want
|
|
the ReRoute to be case sensitive is my advice!
|
|
|
|
Catch All
|
|
^^^^^^^^^
|
|
|
|
Ocelot's routing also supports a catch all style routing where the user can specify that they want to match all traffic if you set up your config like below the request will be proxied straight through (it doesnt have to be url any placeholder name will work).
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"DownstreamPathTemplate": "/{url}",
|
|
"DownstreamScheme": "https",
|
|
"DownstreamHostAndPorts": [
|
|
{
|
|
"Host": "localhost",
|
|
"Port": 80,
|
|
}
|
|
],
|
|
"UpstreamPathTemplate": "/{url}",
|
|
"UpstreamHttpMethod": [ "Get" ]
|
|
}
|
|
|
|
The catch all has a lower priority than any other ReRoute. If you also have the ReRoute below in your config then Ocelot would match it before the catch all.
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"DownstreamPathTemplate": "/",
|
|
"DownstreamScheme": "https",
|
|
"DownstreamHostAndPorts": [
|
|
{
|
|
"Host": "10.0.10.1",
|
|
"Port": 80,
|
|
}
|
|
],
|
|
"UpstreamPathTemplate": "/",
|
|
"UpstreamHttpMethod": [ "Get" ]
|
|
}
|