mirror of
https://github.com/nsnail/Ocelot.git
synced 2025-04-20 16:42:50 +08:00
Merge branch 'master' into pitming-feature/MethodTransformer
This commit is contained in:
TomPallister
commit
d879721978
@ -1,10 +1,10 @@
|
||||
[<img src="https://threemammals.com/ocelot_logo.png">](https://threemammals.com/ocelot)
|
||||
[<img src="https://threemammals.com/images/ocelot_logo.png">](https://threemammals.com/ocelot)
|
||||
|
||||
[](https://circleci.com/gh/ThreeMammals/Ocelot/tree/master)
|
||||
|
||||
[](https://coveralls.io/github/ThreeMammals/Ocelot?branch=master)
|
||||
|
||||
[Slack](threemammals.slack.com)
|
||||
[Slack](https://threemammals.slack.com)
|
||||
|
||||
# Ocelot
|
||||
|
||||
|
||||
@ -1,231 +1,281 @@
|
||||
Configuration
|
||||
============
|
||||
|
||||
An example configuration can be found `here <https://github.com/ThreeMammals/Ocelot/blob/master/test/Ocelot.ManualTest/ocelot.json>`_.
|
||||
There are two sections to the configuration. An array of ReRoutes and a GlobalConfiguration.
|
||||
The ReRoutes are the objects that tell Ocelot how to treat an upstream request. The Global
|
||||
configuration is a bit hacky and allows overrides of ReRoute specific settings. It's useful
|
||||
if you don't want to manage lots of ReRoute specific settings.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"ReRoutes": [],
|
||||
"GlobalConfiguration": {}
|
||||
}
|
||||
|
||||
Here is an example ReRoute configuration, You don't need to set all of these things but this is everything that is available at the moment:
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"DownstreamPathTemplate": "/",
|
||||
"UpstreamPathTemplate": "/",
|
||||
"UpstreamHttpMethod": [
|
||||
"Get"
|
||||
],
|
||||
"DownstreamHttpMethod": "".
|
||||
"AddHeadersToRequest": {},
|
||||
"AddClaimsToRequest": {},
|
||||
"RouteClaimsRequirement": {},
|
||||
"AddQueriesToRequest": {},
|
||||
"RequestIdKey": "",
|
||||
"FileCacheOptions": {
|
||||
"TtlSeconds": 0,
|
||||
"Region": ""
|
||||
},
|
||||
"ReRouteIsCaseSensitive": false,
|
||||
"ServiceName": "",
|
||||
"DownstreamScheme": "http",
|
||||
"DownstreamHostAndPorts": [
|
||||
{
|
||||
"Host": "localhost",
|
||||
"Port": 51876,
|
||||
}
|
||||
],
|
||||
"QoSOptions": {
|
||||
"ExceptionsAllowedBeforeBreaking": 0,
|
||||
"DurationOfBreak": 0,
|
||||
"TimeoutValue": 0
|
||||
},
|
||||
"LoadBalancer": "",
|
||||
"RateLimitOptions": {
|
||||
"ClientWhitelist": [],
|
||||
"EnableRateLimiting": false,
|
||||
"Period": "",
|
||||
"PeriodTimespan": 0,
|
||||
"Limit": 0
|
||||
},
|
||||
"AuthenticationOptions": {
|
||||
"AuthenticationProviderKey": "",
|
||||
"AllowedScopes": []
|
||||
},
|
||||
"HttpHandlerOptions": {
|
||||
"AllowAutoRedirect": true,
|
||||
"UseCookieContainer": true,
|
||||
"UseTracing": true,
|
||||
"MaxConnectionsPerServer": 100
|
||||
},
|
||||
"DangerousAcceptAnyServerCertificateValidator": false
|
||||
}
|
||||
|
||||
More information on how to use these options is below..
|
||||
|
||||
Multiple environments
|
||||
^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Like any other asp.net core project Ocelot supports configuration file names such as configuration.dev.json, configuration.test.json etc. In order to implement this add the following
|
||||
to you
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddJsonFile("ocelot.json")
|
||||
.AddJsonFile($"configuration.{hostingContext.HostingEnvironment.EnvironmentName}.json")
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
Ocelot will now use the environment specific configuration and fall back to ocelot.json if there isn't one.
|
||||
|
||||
You also need to set the corresponding environment variable which is ASPNETCORE_ENVIRONMENT. More info on this can be found in the `asp.net core docs <https://docs.microsoft.com/en-us/aspnet/core/fundamentals/environments>`_.
|
||||
|
||||
Merging configuration files
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
This feature was requested in `Issue 296 <https://github.com/ThreeMammals/Ocelot/issues/296>`_ and allows users to have multiple configuration files to make managing large configurations easier.
|
||||
|
||||
Instead of adding the configuration directly e.g. AddJsonFile("ocelot.json") you can call AddOcelot() like below.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddOcelot(hostingContext.HostingEnvironment)
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
In this scenario Ocelot will look for any files that match the pattern (?i)ocelot.([a-zA-Z0-9]*).json and then merge these together. If you want to set the GlobalConfiguration property you must have a file called ocelot.global.json.
|
||||
|
||||
The way Ocelot merges the files is basically load them, loop over them, add any ReRoutes, add any AggregateReRoutes and if the file is called ocelot.global.json add the GlobalConfiguration aswell as any ReRoutes or AggregateReRoutes. Ocelot will then save the merged configuration to a file called ocelot.json and this will be used as the source of truth while ocelot is running.
|
||||
|
||||
At the moment there is no validation at this stage it only happens when Ocelot validates the final merged configuration. This is something to be aware of when you are investigating problems. I would advise always checking what is in ocelot.json if you have any problems.
|
||||
|
||||
You can also give Ocelot a specific path to look in for the configuration files like below.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddOcelot("/foo/bar", hostingContext.HostingEnvironment)
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
Ocelot needs the HostingEnvironment so it knows to exclude anything environment specific from the algorithm.
|
||||
|
||||
Store configuration in consul
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
The first thing you need to do is install the NuGet package that provides Consul support in Ocelot.
|
||||
|
||||
``Install-Package Ocelot.Provider.Consul``
|
||||
|
||||
Then you add the following when you register your services Ocelot will attempt to store and retrieve its configuration in consul KV store.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
services
|
||||
.AddOcelot()
|
||||
.AddConsul()
|
||||
.AddConfigStoredInConsul();
|
||||
|
||||
You also need to add the following to your ocelot.json. This is how Ocelot
|
||||
finds your Consul agent and interacts to load and store the configuration from Consul.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"GlobalConfiguration": {
|
||||
"ServiceDiscoveryProvider": {
|
||||
"Host": "localhost",
|
||||
"Port": 9500
|
||||
}
|
||||
}
|
||||
|
||||
I decided to create this feature after working on the Raft consensus algorithm and finding out its super hard. Why not take advantage of the fact Consul already gives you this!
|
||||
I guess it means if you want to use Ocelot to its fullest you take on Consul as a dependency for now.
|
||||
|
||||
This feature has a 3 second ttl cache before making a new request to your local consul agent.
|
||||
|
||||
Reload JSON config on change
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Ocelot supports reloading the json configuration file on change. e.g. the following will recreate Ocelots internal configuration when the ocelot.json file is updated
|
||||
manually.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
config.AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);
|
||||
|
||||
Configuration Key
|
||||
-----------------
|
||||
|
||||
If you are using Consul for configuration (or other providers in the future) you might want to key your configurations so you can have multiple configurations :) This feature was requested in `issue 346 <https://github.com/ThreeMammals/Ocelot/issues/346>`_! In order to specify the key you need to set the ConfigurationKey property in the ServiceDiscoveryProvider section of the configuration json file e.g.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"GlobalConfiguration": {
|
||||
"ServiceDiscoveryProvider": {
|
||||
"Host": "localhost",
|
||||
"Port": 9500,
|
||||
"ConfigurationKey": "Oceolot_A"
|
||||
}
|
||||
}
|
||||
|
||||
In this example Ocelot will use Oceolot_A as the key for your configuration when looking it up in Consul.
|
||||
|
||||
If you do not set the ConfigurationKey Ocelot will use the string InternalConfiguration as the key.
|
||||
|
||||
Follow Redirects / Use CookieContainer
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Use HttpHandlerOptions in ReRoute configuration to set up HttpHandler behavior:
|
||||
|
||||
1. AllowAutoRedirect is a value that indicates whether the request should follow redirection responses. Set it true if the request should automatically
|
||||
follow redirection responses from the Downstream resource; otherwise false. The default value is false.
|
||||
|
||||
2. UseCookieContainer is a value that indicates whether the handler uses the CookieContainer
|
||||
property to store server cookies and uses these cookies when sending requests. The default value is false. Please note
|
||||
that if you are using the CookieContainer Ocelot caches the HttpClient for each downstream service. This means that all requests
|
||||
to that DownstreamService will share the same cookies. `Issue 274 <https://github.com/ThreeMammals/Ocelot/issues/274>`_ was created because a user
|
||||
noticed that the cookies were being shared. I tried to think of a nice way to handle this but I think it is impossible. If you don't cache the clients
|
||||
that means each request gets a new client and therefore a new cookie container. If you clear the cookies from the cached client container you get race conditions due to inflight
|
||||
requests. This would also mean that subsequent requests don't use the cookies from the previous response! All in all not a great situation. I would avoid setting
|
||||
UseCookieContainer to true unless you have a really really good reason. Just look at your response headers and forward the cookies back with your next request!
|
||||
|
||||
SSL Errors
|
||||
^^^^^^^^^^
|
||||
|
||||
If you want to ignore SSL warnings / errors set the following in your ReRoute config.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"DangerousAcceptAnyServerCertificateValidator": true
|
||||
|
||||
I don't recommend doing this, I suggest creating your own certificate and then getting it trusted by your local / remote machine if you can.
|
||||
|
||||
MaxConnectionsPerServer
|
||||
^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
This controls how many connections the internal HttpClient will open. This can be set at ReRoute or global level.
|
||||
Configuration
|
||||
============
|
||||
|
||||
An example configuration can be found `here <https://github.com/ThreeMammals/Ocelot/blob/master/test/Ocelot.ManualTest/ocelot.json>`_.
|
||||
There are two sections to the configuration. An array of ReRoutes and a GlobalConfiguration.
|
||||
The ReRoutes are the objects that tell Ocelot how to treat an upstream request. The Global
|
||||
configuration is a bit hacky and allows overrides of ReRoute specific settings. It's useful
|
||||
if you don't want to manage lots of ReRoute specific settings.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"ReRoutes": [],
|
||||
"GlobalConfiguration": {}
|
||||
}
|
||||
|
||||
Here is an example ReRoute configuration, You don't need to set all of these things but this is everything that is available at the moment:
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
{
|
||||
"DownstreamPathTemplate": "/",
|
||||
"UpstreamPathTemplate": "/",
|
||||
"UpstreamHttpMethod": [
|
||||
"Get"
|
||||
],
|
||||
"DownstreamHttpMethod": "",
|
||||
"AddHeadersToRequest": {},
|
||||
"AddClaimsToRequest": {},
|
||||
"RouteClaimsRequirement": {},
|
||||
"AddQueriesToRequest": {},
|
||||
"RequestIdKey": "",
|
||||
"FileCacheOptions": {
|
||||
"TtlSeconds": 0,
|
||||
"Region": ""
|
||||
},
|
||||
"ReRouteIsCaseSensitive": false,
|
||||
"ServiceName": "",
|
||||
"DownstreamScheme": "http",
|
||||
"DownstreamHostAndPorts": [
|
||||
{
|
||||
"Host": "localhost",
|
||||
"Port": 51876,
|
||||
}
|
||||
],
|
||||
"QoSOptions": {
|
||||
"ExceptionsAllowedBeforeBreaking": 0,
|
||||
"DurationOfBreak": 0,
|
||||
"TimeoutValue": 0
|
||||
},
|
||||
"LoadBalancer": "",
|
||||
"RateLimitOptions": {
|
||||
"ClientWhitelist": [],
|
||||
"EnableRateLimiting": false,
|
||||
"Period": "",
|
||||
"PeriodTimespan": 0,
|
||||
"Limit": 0
|
||||
},
|
||||
"AuthenticationOptions": {
|
||||
"AuthenticationProviderKey": "",
|
||||
"AllowedScopes": []
|
||||
},
|
||||
"HttpHandlerOptions": {
|
||||
"AllowAutoRedirect": true,
|
||||
"UseCookieContainer": true,
|
||||
"UseTracing": true,
|
||||
"MaxConnectionsPerServer": 100
|
||||
},
|
||||
"DangerousAcceptAnyServerCertificateValidator": false
|
||||
}
|
||||
|
||||
More information on how to use these options is below..
|
||||
|
||||
Multiple environments
|
||||
^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Like any other asp.net core project Ocelot supports configuration file names such as configuration.dev.json, configuration.test.json etc. In order to implement this add the following
|
||||
to you
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddJsonFile("ocelot.json")
|
||||
.AddJsonFile($"configuration.{hostingContext.HostingEnvironment.EnvironmentName}.json")
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
Ocelot will now use the environment specific configuration and fall back to ocelot.json if there isn't one.
|
||||
|
||||
You also need to set the corresponding environment variable which is ASPNETCORE_ENVIRONMENT. More info on this can be found in the `asp.net core docs <https://docs.microsoft.com/en-us/aspnet/core/fundamentals/environments>`_.
|
||||
|
||||
Merging configuration files
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
This feature was requested in `Issue 296 <https://github.com/ThreeMammals/Ocelot/issues/296>`_ and allows users to have multiple configuration files to make managing large configurations easier.
|
||||
|
||||
Instead of adding the configuration directly e.g. AddJsonFile("ocelot.json") you can call AddOcelot() like below.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddOcelot(hostingContext.HostingEnvironment)
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
In this scenario Ocelot will look for any files that match the pattern (?i)ocelot.([a-zA-Z0-9]*).json and then merge these together. If you want to set the GlobalConfiguration property you must have a file called ocelot.global.json.
|
||||
|
||||
The way Ocelot merges the files is basically load them, loop over them, add any ReRoutes, add any AggregateReRoutes and if the file is called ocelot.global.json add the GlobalConfiguration aswell as any ReRoutes or AggregateReRoutes. Ocelot will then save the merged configuration to a file called ocelot.json and this will be used as the source of truth while ocelot is running.
|
||||
|
||||
At the moment there is no validation at this stage it only happens when Ocelot validates the final merged configuration. This is something to be aware of when you are investigating problems. I would advise always checking what is in ocelot.json if you have any problems.
|
||||
|
||||
You can also give Ocelot a specific path to look in for the configuration files like below.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
.ConfigureAppConfiguration((hostingContext, config) =>
|
||||
{
|
||||
config
|
||||
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
|
||||
.AddJsonFile("appsettings.json", true, true)
|
||||
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
|
||||
.AddOcelot("/foo/bar", hostingContext.HostingEnvironment)
|
||||
.AddEnvironmentVariables();
|
||||
})
|
||||
|
||||
Ocelot needs the HostingEnvironment so it knows to exclude anything environment specific from the algorithm.
|
||||
|
||||
Store configuration in consul
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
The first thing you need to do is install the NuGet package that provides Consul support in Ocelot.
|
||||
|
||||
``Install-Package Ocelot.Provider.Consul``
|
||||
|
||||
Then you add the following when you register your services Ocelot will attempt to store and retrieve its configuration in consul KV store.
|
||||
|
||||
.. code-block:: csharp
|
||||
|
||||
services
|
||||
.AddOcelot()
|
||||
.AddConsul()
|
||||
.AddConfigStoredInConsul();
|
||||
|
||||
You also need to add the following to your ocelot.json. This is how Ocelot
|
||||
finds your Consul agent and interacts to load and store the configuration from Consul.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"GlobalConfiguration": {
|
||||
"ServiceDiscoveryProvider": {
|
||||
"Host": "localhost",
|
||||
"Port": 9500
|
||||
}
|
||||
}
|
||||
|
||||
I decided to create this feature after working on the Raft consensus algorithm and finding out its super hard. Why not take advantage of the fact Consul already gives you this!
|
||||
I guess it means if you want to use Ocelot to its fullest you take on Consul as a dependency for now.
|
||||
|
||||
This feature has a 3 second ttl cache before making a new request to your local consul agent.
|
||||
|
||||
Reload JSON config on change
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Ocelot supports reloading the json configuration file on change. e.g. the following will recreate Ocelots internal configuration when the ocelot.json file is updated
|
||||
manually.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
config.AddJsonFile("ocelot.json", optional: false, reloadOnChange: true);
|
||||
|
||||
Configuration Key
|
||||
-----------------
|
||||
|
||||
If you are using Consul for configuration (or other providers in the future) you might want to key your configurations so you can have multiple configurations :) This feature was requested in `issue 346 <https://github.com/ThreeMammals/Ocelot/issues/346>`_! In order to specify the key you need to set the ConfigurationKey property in the ServiceDiscoveryProvider section of the configuration json file e.g.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"GlobalConfiguration": {
|
||||
"ServiceDiscoveryProvider": {
|
||||
"Host": "localhost",
|
||||
"Port": 9500,
|
||||
"ConfigurationKey": "Oceolot_A"
|
||||
}
|
||||
}
|
||||
|
||||
In this example Ocelot will use Oceolot_A as the key for your configuration when looking it up in Consul.
|
||||
|
||||
If you do not set the ConfigurationKey Ocelot will use the string InternalConfiguration as the key.
|
||||
|
||||
Follow Redirects / Use CookieContainer
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Use HttpHandlerOptions in ReRoute configuration to set up HttpHandler behavior:
|
||||
|
||||
1. AllowAutoRedirect is a value that indicates whether the request should follow redirection responses. Set it true if the request should automatically
|
||||
follow redirection responses from the Downstream resource; otherwise false. The default value is false.
|
||||
|
||||
2. UseCookieContainer is a value that indicates whether the handler uses the CookieContainer
|
||||
property to store server cookies and uses these cookies when sending requests. The default value is false. Please note
|
||||
that if you are using the CookieContainer Ocelot caches the HttpClient for each downstream service. This means that all requests
|
||||
to that DownstreamService will share the same cookies. `Issue 274 <https://github.com/ThreeMammals/Ocelot/issues/274>`_ was created because a user
|
||||
noticed that the cookies were being shared. I tried to think of a nice way to handle this but I think it is impossible. If you don't cache the clients
|
||||
that means each request gets a new client and therefore a new cookie container. If you clear the cookies from the cached client container you get race conditions due to inflight
|
||||
requests. This would also mean that subsequent requests don't use the cookies from the previous response! All in all not a great situation. I would avoid setting
|
||||
UseCookieContainer to true unless you have a really really good reason. Just look at your response headers and forward the cookies back with your next request!
|
||||
|
||||
SSL Errors
|
||||
^^^^^^^^^^
|
||||
|
||||
If you want to ignore SSL warnings / errors set the following in your ReRoute config.
|
||||
|
||||
.. code-block:: json
|
||||
|
||||
"DangerousAcceptAnyServerCertificateValidator": true
|
||||
|
||||
I don't recommend doing this, I suggest creating your own certificate and then getting it trusted by your local / remote machine if you can.
|
||||
|
||||
MaxConnectionsPerServer
|
||||
^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
This controls how many connections the internal HttpClient will open. This can be set at ReRoute or global level.
|
||||
|
||||
React to Configuration Changes
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Resolve IOcelotConfigurationChangeTokenSource from the DI container if you wish to react to changes to the Ocelot configuration via the Ocelot.Administration API or ocelot.json being reloaded from the disk. You may either poll the change token's HasChanged property, or register a callback with the RegisterChangeCallback method.
|
||||
|
||||
Polling the HasChanged property
|
||||
-------------------------------
|
||||
|
||||
.. code-block:: csharp
|
||||
public class ConfigurationNotifyingService : BackgroundService
|
||||
{
|
||||
private readonly IOcelotConfigurationChangeTokenSource _tokenSource;
|
||||
private readonly ILogger _logger;
|
||||
public ConfigurationNotifyingService(IOcelotConfigurationChangeTokenSource tokenSource, ILogger logger)
|
||||
{
|
||||
_tokenSource = tokenSource;
|
||||
_logger = logger;
|
||||
}
|
||||
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
|
||||
{
|
||||
while (!stoppingToken.IsCancellationRequested)
|
||||
{
|
||||
if (_tokenSource.ChangeToken.HasChanged)
|
||||
{
|
||||
_logger.LogInformation("Configuration updated");
|
||||
}
|
||||
await Task.Delay(1000, stoppingToken);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Registering a callback
|
||||
----------------------
|
||||
|
||||
.. code-block:: csharp
|
||||
public class MyDependencyInjectedClass : IDisposable
|
||||
{
|
||||
private readonly IOcelotConfigurationChangeTokenSource _tokenSource;
|
||||
private readonly IDisposable _callbackHolder;
|
||||
public MyClass(IOcelotConfigurationChangeTokenSource tokenSource)
|
||||
{
|
||||
_tokenSource = tokenSource;
|
||||
_callbackHolder = tokenSource.ChangeToken.RegisterChangeCallback(_ => Console.WriteLine("Configuration changed"), null);
|
||||
}
|
||||
public void Dispose()
|
||||
{
|
||||
_callbackHolder.Dispose();
|
||||
}
|
||||
}
|
||||
@ -14,7 +14,7 @@ Then add the following to your ConfigureServices method.
|
||||
s.AddOcelot()
|
||||
.AddKubernetes();
|
||||
|
||||
If you have services deployed in kubernetes you will normally use the naming service to access them. Default usePodServiceAccount = True, which means that ServiceAccount using Pod to access the service of the k8s cluster needs to be ServiceAccount based on RABC authorization
|
||||
If you have services deployed in kubernetes you will normally use the naming service to access them. Default usePodServiceAccount = True, which means that ServiceAccount using Pod to access the service of the k8s cluster needs to be ServiceAccount based on RBAC authorization
|
||||
|
||||
.. code-block::csharp
|
||||
public static class OcelotBuilderExtensions
|
||||
|
||||
@ -1,13 +1,13 @@
|
||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||
<PropertyGroup>
|
||||
<TargetFramework>netcoreapp3.1</TargetFramework>
|
||||
</PropertyGroup>
|
||||
<ItemGroup>
|
||||
<Folder Include="wwwroot\"/>
|
||||
<Folder Include="wwwroot\" />
|
||||
</ItemGroup>
|
||||
<ItemGroup>
|
||||
<PackageReference Include="Microsoft.AspNetCore.App"/>
|
||||
<PackageReference Include="Ocelot" Version="12.0.1"/>
|
||||
<PackageReference Include="Ocelot.Administration" Version="0.1.0"/>
|
||||
<PackageReference Include="Ocelot" Version="14.0.3" />
|
||||
<PackageReference Include="Ocelot.Administration" Version="14.0.3" />
|
||||
|
||||
</ItemGroup>
|
||||
</Project>
|
||||
@ -1,19 +1,14 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.IO;
|
||||
using System.Linq;
|
||||
using System.Threading.Tasks;
|
||||
using Microsoft.AspNetCore;
|
||||
using Microsoft.AspNetCore.Hosting;
|
||||
using Microsoft.AspNetCore.Hosting;
|
||||
using Microsoft.Extensions.Configuration;
|
||||
using Microsoft.Extensions.Logging;
|
||||
using Ocelot.Administration;
|
||||
using Ocelot.DependencyInjection;
|
||||
using Ocelot.Middleware;
|
||||
using Ocelot.Administration;
|
||||
using System.IO;
|
||||
|
||||
namespace AdministrationApi
|
||||
{
|
||||
public class Program
|
||||
public class Program
|
||||
{
|
||||
public static void Main(string[] args)
|
||||
{
|
||||
|
||||
@ -27,7 +27,13 @@
|
||||
}
|
||||
|
||||
app.UseAuthentication();
|
||||
app.UseMvc();
|
||||
app.UseRouting();
|
||||
app.UseAuthorization();
|
||||
app.UseEndpoints(endpoints =>
|
||||
{
|
||||
endpoints.MapDefaultControllerRoute();
|
||||
endpoints.MapControllers();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
@ -0,0 +1,14 @@
|
||||
namespace Ocelot.Configuration.ChangeTracking
|
||||
{
|
||||
using Microsoft.Extensions.Primitives;
|
||||
|
||||
/// <summary>
|
||||
/// <see cref="IChangeToken" /> source which is activated when Ocelot's configuration is changed.
|
||||
/// </summary>
|
||||
public interface IOcelotConfigurationChangeTokenSource
|
||||
{
|
||||
IChangeToken ChangeToken { get; }
|
||||
|
||||
void Activate();
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,74 @@
|
||||
namespace Ocelot.Configuration.ChangeTracking
|
||||
{
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using Microsoft.Extensions.Primitives;
|
||||
|
||||
public class OcelotConfigurationChangeToken : IChangeToken
|
||||
{
|
||||
public const double PollingIntervalSeconds = 1;
|
||||
|
||||
private readonly ICollection<CallbackWrapper> _callbacks = new List<CallbackWrapper>();
|
||||
private readonly object _lock = new object();
|
||||
private DateTime? _timeChanged;
|
||||
|
||||
public IDisposable RegisterChangeCallback(Action<object> callback, object state)
|
||||
{
|
||||
lock (_lock)
|
||||
{
|
||||
var wrapper = new CallbackWrapper(callback, state, _callbacks, _lock);
|
||||
_callbacks.Add(wrapper);
|
||||
return wrapper;
|
||||
}
|
||||
}
|
||||
|
||||
public void Activate()
|
||||
{
|
||||
lock (_lock)
|
||||
{
|
||||
_timeChanged = DateTime.UtcNow;
|
||||
foreach (var wrapper in _callbacks)
|
||||
{
|
||||
wrapper.Invoke();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Token stays active for PollingIntervalSeconds after a change (could be parameterised) - otherwise HasChanged would be true forever.
|
||||
// Taking suggestions for better ways to reset HasChanged back to false.
|
||||
public bool HasChanged => _timeChanged.HasValue && (DateTime.UtcNow - _timeChanged.Value).TotalSeconds < PollingIntervalSeconds;
|
||||
|
||||
public bool ActiveChangeCallbacks => true;
|
||||
|
||||
private class CallbackWrapper : IDisposable
|
||||
{
|
||||
private readonly ICollection<CallbackWrapper> _callbacks;
|
||||
private readonly object _lock;
|
||||
|
||||
public CallbackWrapper(Action<object> callback, object state, ICollection<CallbackWrapper> callbacks, object @lock)
|
||||
{
|
||||
_callbacks = callbacks;
|
||||
_lock = @lock;
|
||||
Callback = callback;
|
||||
State = state;
|
||||
}
|
||||
|
||||
public void Invoke()
|
||||
{
|
||||
Callback.Invoke(State);
|
||||
}
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
lock (_lock)
|
||||
{
|
||||
_callbacks.Remove(this);
|
||||
}
|
||||
}
|
||||
|
||||
public Action<object> Callback { get; }
|
||||
|
||||
public object State { get; }
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,16 @@
|
||||
namespace Ocelot.Configuration.ChangeTracking
|
||||
{
|
||||
using Microsoft.Extensions.Primitives;
|
||||
|
||||
public class OcelotConfigurationChangeTokenSource : IOcelotConfigurationChangeTokenSource
|
||||
{
|
||||
private readonly OcelotConfigurationChangeToken _changeToken = new OcelotConfigurationChangeToken();
|
||||
|
||||
public IChangeToken ChangeToken => _changeToken;
|
||||
|
||||
public void Activate()
|
||||
{
|
||||
_changeToken.Activate();
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,30 @@
|
||||
namespace Ocelot.Configuration.ChangeTracking
|
||||
{
|
||||
using System;
|
||||
using Microsoft.Extensions.Options;
|
||||
using Ocelot.Configuration.Repository;
|
||||
|
||||
public class OcelotConfigurationMonitor : IOptionsMonitor<IInternalConfiguration>
|
||||
{
|
||||
private readonly IOcelotConfigurationChangeTokenSource _changeTokenSource;
|
||||
private readonly IInternalConfigurationRepository _repo;
|
||||
|
||||
public OcelotConfigurationMonitor(IInternalConfigurationRepository repo, IOcelotConfigurationChangeTokenSource changeTokenSource)
|
||||
{
|
||||
_changeTokenSource = changeTokenSource;
|
||||
_repo = repo;
|
||||
}
|
||||
|
||||
public IInternalConfiguration Get(string name)
|
||||
{
|
||||
return _repo.Get().Data;
|
||||
}
|
||||
|
||||
public IDisposable OnChange(Action<IInternalConfiguration, string> listener)
|
||||
{
|
||||
return _changeTokenSource.ChangeToken.RegisterChangeCallback(_ => listener(CurrentValue, ""), null);
|
||||
}
|
||||
|
||||
public IInternalConfiguration CurrentValue => _repo.Get().Data;
|
||||
}
|
||||
}
|
||||
@ -4,18 +4,21 @@ using Ocelot.Configuration.File;
|
||||
using Ocelot.Responses;
|
||||
using System;
|
||||
using System.Threading.Tasks;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
|
||||
namespace Ocelot.Configuration.Repository
|
||||
{
|
||||
public class DiskFileConfigurationRepository : IFileConfigurationRepository
|
||||
{
|
||||
private readonly IOcelotConfigurationChangeTokenSource _changeTokenSource;
|
||||
private readonly string _environmentFilePath;
|
||||
private readonly string _ocelotFilePath;
|
||||
private static readonly object _lock = new object();
|
||||
private const string ConfigurationFileName = "ocelot";
|
||||
|
||||
public DiskFileConfigurationRepository(IWebHostEnvironment hostingEnvironment)
|
||||
public DiskFileConfigurationRepository(IWebHostEnvironment hostingEnvironment, IOcelotConfigurationChangeTokenSource changeTokenSource)
|
||||
{
|
||||
_changeTokenSource = changeTokenSource;
|
||||
_environmentFilePath = $"{AppContext.BaseDirectory}{ConfigurationFileName}{(string.IsNullOrEmpty(hostingEnvironment.EnvironmentName) ? string.Empty : ".")}{hostingEnvironment.EnvironmentName}.json";
|
||||
|
||||
_ocelotFilePath = $"{AppContext.BaseDirectory}{ConfigurationFileName}.json";
|
||||
@ -56,6 +59,7 @@ namespace Ocelot.Configuration.Repository
|
||||
System.IO.File.WriteAllText(_ocelotFilePath, jsonConfiguration);
|
||||
}
|
||||
|
||||
_changeTokenSource.Activate();
|
||||
return Task.FromResult<Response>(new OkResponse());
|
||||
}
|
||||
}
|
||||
|
||||
@ -1,4 +1,5 @@
|
||||
using Ocelot.Responses;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using Ocelot.Responses;
|
||||
|
||||
namespace Ocelot.Configuration.Repository
|
||||
{
|
||||
@ -10,6 +11,12 @@ namespace Ocelot.Configuration.Repository
|
||||
private static readonly object LockObject = new object();
|
||||
|
||||
private IInternalConfiguration _internalConfiguration;
|
||||
private readonly IOcelotConfigurationChangeTokenSource _changeTokenSource;
|
||||
|
||||
public InMemoryInternalConfigurationRepository(IOcelotConfigurationChangeTokenSource changeTokenSource)
|
||||
{
|
||||
_changeTokenSource = changeTokenSource;
|
||||
}
|
||||
|
||||
public Response<IInternalConfiguration> Get()
|
||||
{
|
||||
@ -23,6 +30,7 @@ namespace Ocelot.Configuration.Repository
|
||||
_internalConfiguration = internalConfiguration;
|
||||
}
|
||||
|
||||
_changeTokenSource.Activate();
|
||||
return new OkResponse();
|
||||
}
|
||||
}
|
||||
|
||||
@ -1,9 +1,12 @@
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
|
||||
namespace Ocelot.DependencyInjection
|
||||
{
|
||||
using Microsoft.AspNetCore.Http;
|
||||
using Microsoft.Extensions.Configuration;
|
||||
using Microsoft.Extensions.DependencyInjection;
|
||||
using Microsoft.Extensions.DependencyInjection.Extensions;
|
||||
using Microsoft.Extensions.Options;
|
||||
using Ocelot.Authorisation;
|
||||
using Ocelot.Cache;
|
||||
using Ocelot.Claims;
|
||||
@ -112,6 +115,8 @@ namespace Ocelot.DependencyInjection
|
||||
Services.TryAddSingleton<IDownstreamAddressesCreator, DownstreamAddressesCreator>();
|
||||
Services.TryAddSingleton<IDelegatingHandlerHandlerFactory, DelegatingHandlerHandlerFactory>();
|
||||
Services.TryAddSingleton<ICacheKeyGenerator, CacheKeyGenerator>();
|
||||
Services.TryAddSingleton<IOcelotConfigurationChangeTokenSource, OcelotConfigurationChangeTokenSource>();
|
||||
Services.TryAddSingleton<IOptionsMonitor<IInternalConfiguration>, OcelotConfigurationMonitor>();
|
||||
|
||||
// see this for why we register this as singleton http://stackoverflow.com/questions/37371264/invalidoperationexception-unable-to-resolve-service-for-type-microsoft-aspnetc
|
||||
// could maybe use a scoped data repository
|
||||
@ -215,7 +220,7 @@ namespace Ocelot.DependencyInjection
|
||||
{
|
||||
// see: https://greatrexpectations.com/2018/10/25/decorators-in-net-core-with-dependency-injection
|
||||
var wrappedDescriptor = Services.First(x => x.ServiceType == typeof(IPlaceholders));
|
||||
|
||||
|
||||
var objectFactory = ActivatorUtilities.CreateFactory(
|
||||
typeof(ConfigAwarePlaceholders),
|
||||
new[] { typeof(IPlaceholders) });
|
||||
@ -229,7 +234,7 @@ namespace Ocelot.DependencyInjection
|
||||
|
||||
return this;
|
||||
}
|
||||
|
||||
|
||||
private static object CreateInstance(IServiceProvider services, ServiceDescriptor descriptor)
|
||||
{
|
||||
if (descriptor.ImplementationInstance != null)
|
||||
|
||||
@ -15,4 +15,4 @@ using System.Runtime.InteropServices;
|
||||
[assembly: ComVisible(false)]
|
||||
|
||||
// The following GUID is for the ID of the typelib if this project is exposed to COM
|
||||
[assembly: Guid("d6df4206-0dba-41d8-884d-c3e08290fdbb")]
|
||||
[assembly: Guid("d6df4206-0dba-41d8-884d-c3e08290fdbb")]
|
||||
|
||||
@ -1,5 +1,6 @@
|
||||
using Ocelot.Configuration.File;
|
||||
using System;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using TestStack.BDDfy;
|
||||
using Xunit;
|
||||
|
||||
@ -54,6 +55,33 @@ namespace Ocelot.AcceptanceTests
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void should_trigger_change_token_on_change()
|
||||
{
|
||||
this.Given(x => _steps.GivenThereIsAConfiguration(_initialConfig))
|
||||
.And(x => _steps.GivenOcelotIsRunningReloadingConfig(true))
|
||||
.And(x => _steps.GivenIHaveAChangeToken())
|
||||
.And(x => _steps.GivenThereIsAConfiguration(_anotherConfig))
|
||||
.And(x => _steps.GivenIWait(MillisecondsToWaitForChangeToken))
|
||||
.Then(x => _steps.TheChangeTokenShouldBeActive(true))
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void should_not_trigger_change_token_with_no_change()
|
||||
{
|
||||
this.Given(x => _steps.GivenThereIsAConfiguration(_initialConfig))
|
||||
.And(x => _steps.GivenOcelotIsRunningReloadingConfig(false))
|
||||
.And(x => _steps.GivenIHaveAChangeToken())
|
||||
.And(x => _steps.GivenIWait(MillisecondsToWaitForChangeToken)) // Wait for prior activation to expire.
|
||||
.And(x => _steps.GivenThereIsAConfiguration(_anotherConfig))
|
||||
.And(x => _steps.GivenIWait(MillisecondsToWaitForChangeToken))
|
||||
.Then(x => _steps.TheChangeTokenShouldBeActive(false))
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
private const int MillisecondsToWaitForChangeToken = (int) (OcelotConfigurationChangeToken.PollingIntervalSeconds*1000) - 100;
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
_steps.Dispose();
|
||||
|
||||
@ -1,4 +1,6 @@
|
||||
namespace Ocelot.AcceptanceTests
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
|
||||
namespace Ocelot.AcceptanceTests
|
||||
{
|
||||
using Caching;
|
||||
using Configuration.Repository;
|
||||
@ -54,6 +56,7 @@
|
||||
private IWebHostBuilder _webHostBuilder;
|
||||
private WebHostBuilder _ocelotBuilder;
|
||||
private IWebHost _ocelotHost;
|
||||
private IOcelotConfigurationChangeTokenSource _changeToken;
|
||||
|
||||
public Steps()
|
||||
{
|
||||
@ -216,6 +219,11 @@
|
||||
_ocelotClient = _ocelotServer.CreateClient();
|
||||
}
|
||||
|
||||
public void GivenIHaveAChangeToken()
|
||||
{
|
||||
_changeToken = _ocelotServer.Host.Services.GetRequiredService<IOcelotConfigurationChangeTokenSource>();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// This is annoying cos it should be in the constructor but we need to set up the file before calling startup so its a step.
|
||||
/// </summary>
|
||||
@ -1135,6 +1143,11 @@
|
||||
_ocelotClient = _ocelotServer.CreateClient();
|
||||
}
|
||||
|
||||
public void TheChangeTokenShouldBeActive(bool itShouldBeActive)
|
||||
{
|
||||
_changeToken.ChangeToken.HasChanged.ShouldBe(itShouldBeActive);
|
||||
}
|
||||
|
||||
public void GivenOcelotIsRunningWithLogger()
|
||||
{
|
||||
_webHostBuilder = new WebHostBuilder();
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,35 @@
|
||||
namespace Ocelot.UnitTests.Configuration.ChangeTracking
|
||||
{
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using Shouldly;
|
||||
using TestStack.BDDfy;
|
||||
using Xunit;
|
||||
|
||||
public class OcelotConfigurationChangeTokenSourceTests
|
||||
{
|
||||
private readonly IOcelotConfigurationChangeTokenSource _source;
|
||||
|
||||
public OcelotConfigurationChangeTokenSourceTests()
|
||||
{
|
||||
_source = new OcelotConfigurationChangeTokenSource();
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void should_activate_change_token()
|
||||
{
|
||||
this.Given(_ => GivenIActivateTheChangeTokenSource())
|
||||
.Then(_ => ThenTheChangeTokenShouldBeActivated())
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
private void GivenIActivateTheChangeTokenSource()
|
||||
{
|
||||
_source.Activate();
|
||||
}
|
||||
|
||||
private void ThenTheChangeTokenShouldBeActivated()
|
||||
{
|
||||
_source.ChangeToken.HasChanged.ShouldBeTrue();
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,91 @@
|
||||
using Xunit;
|
||||
|
||||
namespace Ocelot.UnitTests.Configuration.ChangeTracking
|
||||
{
|
||||
using System;
|
||||
using Shouldly;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using TestStack.BDDfy;
|
||||
|
||||
public class OcelotConfigurationChangeTokenTests
|
||||
{
|
||||
[Fact]
|
||||
public void should_call_callback_with_state()
|
||||
{
|
||||
this.Given(_ => GivenIHaveAChangeToken())
|
||||
.And(_ => AndIRegisterACallback())
|
||||
.Then(_ => ThenIShouldGetADisposableWrapper())
|
||||
.Given(_ => GivenIActivateTheToken())
|
||||
.Then(_ => ThenTheCallbackShouldBeCalled())
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public void should_not_call_callback_if_it_is_disposed()
|
||||
{
|
||||
this.Given(_ => GivenIHaveAChangeToken())
|
||||
.And(_ => AndIRegisterACallback())
|
||||
.Then(_ => ThenIShouldGetADisposableWrapper())
|
||||
.And(_ => GivenIActivateTheToken())
|
||||
.And(_ => AndIDisposeTheCallbackWrapper())
|
||||
.And(_ => GivenIActivateTheToken())
|
||||
.Then(_ => ThenTheCallbackShouldNotBeCalled())
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
private OcelotConfigurationChangeToken _changeToken;
|
||||
private IDisposable _callbackWrapper;
|
||||
private int _callbackCounter;
|
||||
private readonly object _callbackInitialState = new object();
|
||||
private object _callbackState;
|
||||
|
||||
private void Callback(object state)
|
||||
{
|
||||
_callbackCounter++;
|
||||
_callbackState = state;
|
||||
_changeToken.HasChanged.ShouldBeTrue();
|
||||
}
|
||||
|
||||
private void GivenIHaveAChangeToken()
|
||||
{
|
||||
_changeToken = new OcelotConfigurationChangeToken();
|
||||
}
|
||||
|
||||
private void AndIRegisterACallback()
|
||||
{
|
||||
_callbackWrapper = _changeToken.RegisterChangeCallback(Callback, _callbackInitialState);
|
||||
}
|
||||
|
||||
private void ThenIShouldGetADisposableWrapper()
|
||||
{
|
||||
_callbackWrapper.ShouldNotBeNull();
|
||||
}
|
||||
|
||||
private void GivenIActivateTheToken()
|
||||
{
|
||||
_callbackCounter = 0;
|
||||
_callbackState = null;
|
||||
_changeToken.Activate();
|
||||
}
|
||||
|
||||
private void ThenTheCallbackShouldBeCalled()
|
||||
{
|
||||
_callbackCounter.ShouldBe(1);
|
||||
_callbackState.ShouldNotBeNull();
|
||||
_callbackState.ShouldBeSameAs(_callbackInitialState);
|
||||
}
|
||||
|
||||
private void ThenTheCallbackShouldNotBeCalled()
|
||||
{
|
||||
_callbackCounter.ShouldBe(0);
|
||||
_callbackState.ShouldBeNull();
|
||||
}
|
||||
|
||||
private void AndIDisposeTheCallbackWrapper()
|
||||
{
|
||||
_callbackState = null;
|
||||
_callbackCounter = 0;
|
||||
_callbackWrapper.Dispose();
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -3,6 +3,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
using Microsoft.AspNetCore.Hosting;
|
||||
using Moq;
|
||||
using Newtonsoft.Json;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using Ocelot.Configuration.File;
|
||||
using Ocelot.Configuration.Repository;
|
||||
using Shouldly;
|
||||
@ -16,6 +17,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
public class DiskFileConfigurationRepositoryTests : IDisposable
|
||||
{
|
||||
private readonly Mock<IWebHostEnvironment> _hostingEnvironment;
|
||||
private readonly Mock<IOcelotConfigurationChangeTokenSource> _changeTokenSource;
|
||||
private IFileConfigurationRepository _repo;
|
||||
private string _environmentSpecificPath;
|
||||
private string _ocelotJsonPath;
|
||||
@ -35,7 +37,9 @@ namespace Ocelot.UnitTests.Configuration
|
||||
_semaphore.Wait();
|
||||
_hostingEnvironment = new Mock<IWebHostEnvironment>();
|
||||
_hostingEnvironment.Setup(he => he.EnvironmentName).Returns(_environmentName);
|
||||
_repo = new DiskFileConfigurationRepository(_hostingEnvironment.Object);
|
||||
_changeTokenSource = new Mock<IOcelotConfigurationChangeTokenSource>(MockBehavior.Strict);
|
||||
_changeTokenSource.Setup(m => m.Activate());
|
||||
_repo = new DiskFileConfigurationRepository(_hostingEnvironment.Object, _changeTokenSource.Object);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
@ -70,6 +74,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
.When(_ => WhenISetTheConfiguration())
|
||||
.Then(_ => ThenTheConfigurationIsStoredAs(config))
|
||||
.And(_ => ThenTheConfigurationJsonIsIndented(config))
|
||||
.And(x => AndTheChangeTokenIsActivated())
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
@ -117,7 +122,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
{
|
||||
_environmentName = null;
|
||||
_hostingEnvironment.Setup(he => he.EnvironmentName).Returns(_environmentName);
|
||||
_repo = new DiskFileConfigurationRepository(_hostingEnvironment.Object);
|
||||
_repo = new DiskFileConfigurationRepository(_hostingEnvironment.Object, _changeTokenSource.Object);
|
||||
}
|
||||
|
||||
private void GivenIHaveAConfiguration(FileConfiguration fileConfiguration)
|
||||
@ -210,6 +215,11 @@ namespace Ocelot.UnitTests.Configuration
|
||||
}
|
||||
}
|
||||
|
||||
private void AndTheChangeTokenIsActivated()
|
||||
{
|
||||
_changeTokenSource.Verify(m => m.Activate(), Times.Once);
|
||||
}
|
||||
|
||||
private FileConfiguration FakeFileConfigurationForSet()
|
||||
{
|
||||
var reRoutes = new List<FileReRoute>
|
||||
@ -222,11 +232,11 @@ namespace Ocelot.UnitTests.Configuration
|
||||
{
|
||||
Host = "123.12.12.12",
|
||||
Port = 80,
|
||||
}
|
||||
},
|
||||
},
|
||||
DownstreamScheme = "https",
|
||||
DownstreamPathTemplate = "/asdfs/test/{test}"
|
||||
}
|
||||
DownstreamPathTemplate = "/asdfs/test/{test}",
|
||||
},
|
||||
};
|
||||
|
||||
var globalConfiguration = new FileGlobalConfiguration
|
||||
|
||||
@ -9,6 +9,7 @@ using Ocelot.Errors;
|
||||
using Ocelot.Responses;
|
||||
using Shouldly;
|
||||
using System.Collections.Generic;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using TestStack.BDDfy;
|
||||
using Xunit;
|
||||
|
||||
@ -21,7 +22,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
private Mock<IInternalConfigurationRepository> _configRepo;
|
||||
private Mock<IInternalConfigurationCreator> _configCreator;
|
||||
private Response<IInternalConfiguration> _configuration;
|
||||
private object _result;
|
||||
private object _result;
|
||||
private Mock<IFileConfigurationRepository> _repo;
|
||||
|
||||
public FileConfigurationSetterTests()
|
||||
@ -104,8 +105,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
|
||||
private void ThenTheConfigurationRepositoryIsCalledCorrectly()
|
||||
{
|
||||
_configRepo
|
||||
.Verify(x => x.AddOrReplace(_configuration.Data), Times.Once);
|
||||
_configRepo.Verify(x => x.AddOrReplace(_configuration.Data), Times.Once);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@ -5,6 +5,8 @@ using Ocelot.Responses;
|
||||
using Shouldly;
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using Moq;
|
||||
using Ocelot.Configuration.ChangeTracking;
|
||||
using TestStack.BDDfy;
|
||||
using Xunit;
|
||||
|
||||
@ -16,10 +18,13 @@ namespace Ocelot.UnitTests.Configuration
|
||||
private IInternalConfiguration _config;
|
||||
private Response _result;
|
||||
private Response<IInternalConfiguration> _getResult;
|
||||
private readonly Mock<IOcelotConfigurationChangeTokenSource> _changeTokenSource;
|
||||
|
||||
public InMemoryConfigurationRepositoryTests()
|
||||
{
|
||||
_repo = new InMemoryInternalConfigurationRepository();
|
||||
_changeTokenSource = new Mock<IOcelotConfigurationChangeTokenSource>(MockBehavior.Strict);
|
||||
_changeTokenSource.Setup(m => m.Activate());
|
||||
_repo = new InMemoryInternalConfigurationRepository(_changeTokenSource.Object);
|
||||
}
|
||||
|
||||
[Fact]
|
||||
@ -28,6 +33,7 @@ namespace Ocelot.UnitTests.Configuration
|
||||
this.Given(x => x.GivenTheConfigurationIs(new FakeConfig("initial", "adminath")))
|
||||
.When(x => x.WhenIAddOrReplaceTheConfig())
|
||||
.Then(x => x.ThenNoErrorsAreReturned())
|
||||
.And(x => AndTheChangeTokenIsActivated())
|
||||
.BDDfy();
|
||||
}
|
||||
|
||||
@ -71,6 +77,11 @@ namespace Ocelot.UnitTests.Configuration
|
||||
_result.IsError.ShouldBeFalse();
|
||||
}
|
||||
|
||||
private void AndTheChangeTokenIsActivated()
|
||||
{
|
||||
_changeTokenSource.Verify(m => m.Activate(), Times.Once);
|
||||
}
|
||||
|
||||
private class FakeConfig : IInternalConfiguration
|
||||
{
|
||||
private readonly string _downstreamTemplatePath;
|
||||
@ -111,4 +122,4 @@ namespace Ocelot.UnitTests.Configuration
|
||||
public HttpHandlerOptions HttpHandlerOptions { get; }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user