配置
一个关于Ocelot配置例子在这里。配置有两个部分。一个数组类型的ReRoutes和一个全局配置。ReRoutes是个对象，告诉Ocelot怎么去处理一个上游请求。全局配置有点繁琐（is a hacky）并且允许复写ReRoutes指定的配置。如果你不想管理太多的ReRoutes那些设置那么这是非常有用的。
{
"ReRoutes": [],
"GlobalConfiguration": {}
}
这里是个ReRoute 配置的例子，你无需设置所有下面的这些，但是这些事目前所有可用的：
{
"DownstreamPathTemplate": "/",
"UpstreamPathTemplate": "/",
"UpstreamHttpMethod": [
"Get"
],
"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
},
"UseServiceDiscovery": false,
"DangerousAcceptAnyServerCertificateValidator": false
}
更多关于如何使用这些选项的信息如下：.
多环境（Mutilple environments）
像其他任何asp.net core 项目一样，Ocelot支持配置文件名字例如configuration.dev.json，configuration.test.json 等。为了实现这些，需要添加如下代码
.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将使用指定的环境配置并且如果没有指定环境下的文件，那么就会回到ocelot.json。
你还需要设置响应环境变量如ASPNETCORE_ENVIRONMENT。更多这方面的信息在这里asp.net core docs.
合并配置文件
这个特征是在Issue 296 被要求加入的，它允许用户有多个配置文件来更好的管理复杂配置。
而不是直接增加配置如.AddJsonFile("ocelot.json") 你可以像下面一样调用AddOcelot()
.ConfigureAppConfiguration((hostingContext, config) =>
{
config
.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath)
.AddJsonFile("appsettings.json", true, true)
.AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true)
.AddOcelot()
.AddEnvironmentVariables();
})
在这个场景下Ocelot将寻找任何文件去匹配模式(?i)ocelot.([a-zA-Z0-9]*).json 并且一起合并它们。如果你想设置GlobalConfiguration属性，那么你必须有一个文件并命名为coelot.global.json。
Ocelot合并文件的方式就是加载它们，遍历它们，添加ReRoutes以及AggregateReRoutes ，如果文件是ocelot.global.json，能很好的添加到GlobalConfiguration以及ReRoutes或者AggregateReRoutes。然后Ocelot将合并的配置保存到ocelot.json文件中。当Ocelot运行的时候，这将被用作真正的来源
到目前为止这里没有验证，它只发生在当Ocelot验证最终合并配置的时候。这里有一些事情值得注意当你调查问题的时候。我建议总是检查ocelot.json如果你有任何问题。
在Consul存储配置
如果你添加下面的代码来注册你自己的Ocelot服务，Ocelot将企图在Consul 键值对存储中存储并检索它的配置
services
.AddOcelot()
.AddStoreOcelotConfigurationInConsul();
你还需要在你的ocelot.json添加下面的代码。这样Ocelot会发现你的Consul代理并且交互去加载和存储从Consul的配置。
"GlobalConfiguration": {
"ServiceDiscoveryProvider": {
"Host": "localhost",
"Port": 9500
}
}
在我研究Raft一致性算法，并且发现非常困难，之后我决定新建这个特征。为什么我不用Consul已经给你们的这些优势呢！我猜这意味如果你想重复利用Ocelot，就要依赖Consul
在你的本地Consul代理发出一个新请求之前，这个特性有3秒的ttl缓存。
配置键
如果你使用了Consul配置(或者其他提供器在这个特征里)你可能想配置你的键以便用多个配置。这个特征在 issue 346 被要求。为了指定Key，你需要在配置文件中设置ConfigurationKey属性在ServiceDiscoveryProvider节点，如下：
"GlobalConfiguration": {
"ServiceDiscoveryProvider": {
"Host": "localhost",
"Port": 9500,
"ConfigurationKey": "Oceolot_A"
}
}
在这个例子中，当在Consul查询它的时候，Ocelot将使用Ocelot_A 为你的配置作为键。
如果你没有设置ConfigurationKey，Ocelot将使用字符串InternalConfiguration 作为键。
跟随重定向/使用Cookie容器
在ReRoutes配置中使用HttpHandlerOptions 来设置上游HttpHandler行为：
- AllowAutoRedirect 表明该请求是否应该跟随重定向响应的一个值。如果请求自动遵循来自下游的重定向响应，设置为true。否则为false。默认值为false。
- UseCookieContainer 是一个表明当发送请求时是否处理使用CookieContainer 属性存储服务器cookies 并且用这些cookies。默认值false。请注意，如果你为每一个下游服务使用CookieContainer，Ocelot会缓存HttpClient。这就意味着所有下游服务请求都讲共享一个cookies。Issue 274 被创建是因为用户注意到cookies是可以被共享的。我尝试考虑一种好的方式去处理这个，但是我认为这是不可能的。如果你不缓存client那就是说每个请求都获得一个新的client并因此都有一个新的cookies container。如果你清楚了来自缓存客户端容器的缓存，那么你将获得竞争条件在请求中（并发）。这也就是说后面的请求不会使用来自前一个响应的cookies！总而言之，这是不好的。我建议设置UseCookieContainer 为true 除非你有足够的好理由。只需查看你的响应头并在你的下个请求转发回cookies！
SSL 错误
要忽略SSL警告或者是错误的ID，请再ReRoutes设置一下内容：
"DangerousAcceptAnyServerCertificateValidator": false
我不推荐这么做，我建议创建你自己的凭证信息，然后获取它的信任通过本地/远程匹配，如果你可以的话。