Ocelot只能用于.NET Core,目前是为netcoreapp2.0构建的,这个文档可能会帮你了解Ocelot是否适合你. .NET Core 2.0 安装NuGet包 使用nuget安装Ocelot和它的依赖.你需要创建一个netcoreapp2.0的项目并安装Ocelot包.然后按照下面的配置部分启动并运行. Install-Package Ocelot 所有版本可以在这里找到. 配置 下面是个很简单的ocelot.json.它不做任何事情,但是可以上Ocelot启动了. { "ReR

路由(Routing) Ocelot主要功能是接收即将发来的请求并转发它们至下游服务.与此同时,以另一个http请求的形式(在将来这可能是任何传输的机制) Ocelot将一个请求的路由描述为另一个路由ReRoute.为了在Ocelot能运行,你需要在配置中设置ReRoute. { "ReRoutes": [ ] } 为了设置ReRoute,你需要在ReRoute的json数组添加如下代码: { "DownstreamPathTemplate": "/api

入门 Ocelot仅适用于.NET Core,目前是根据netstandard2.0构建的,如果Ocelot适合您,这个文档可能会有用. .NET Core 2.1 安装NuGet包 使用nuget安装Ocelot及其依赖项. 您需要创建一个netstandard2.0项目并将其打包到其中. 然后按照下面的“启动”和“配置”部分启动并运行. Install-Package Ocelot 所有版本都可以在这里找到. 配置 以下是一个非常基本的ocelot.json. 它不会做任何事情,但应该让Oc

Ocelot使用一个杰出的项目Butterfly 提供了跟踪功能. 为了使用跟踪,请阅读Butterfly的文档. 在Ocelot中如果你想跟踪一个ReRoute,你需要做如下事情: 在ConfigureServices方法中 services .AddOcelot() .AddOpenTracing(option => { //this is the url that the butterfly collector server is running on... option.Collecto

Ocelot不支持一下几点... 分块编码 - Ocelot将始终获取body大小并返回Content-Length头. 如果这不适合你的场景,只能表示抱歉! 转发host头 - 您发给Ocelot的host头不会转发给下游服务.显然这会打破一切 :( Swagger - 我已经多次看过从Ocelot的ocelot.json构建swagger.json,但它看起来不适合 我有Ocelot就够了.如果您想在Ocelot中使用Swagger,那么您必须生成自己的swagger.json,并在Star

Ocelot的主要功能是接管进入的http请求并把它们转发给下游服务.目前是以另一个http请求的形式(将来可能是任何传输机制). Ocelot将路由一个请求到另一个请求描述为ReRoute.为了在Ocelot做任何工作,都需要在配置中设置一个ReRoute. { "ReRoutes": [ ] } 为了设置ReRoute,你需要如下所示添加一个ReRoute到ReRoutes的json数组. { "DownstreamPathTemplate": "/a

Ocelot支持在运行时通过一个认证的Http API修改配置.有两种方式对其验证, 使用Ocelot的内置IdentityServer(仅用于向管理API验证请求)或将管理API验证挂接到您自己的IdentityServer中. 提供你自己的 IdentityServer 挂接到你自己的IdentityServer,你只需要添加一下代码到你的ConfigureServices 方法中. public virtual void ConfigureServices(IServiceCollecti

Ocelot最近整合了Rafty,这是我在去年一直研究的Raft的一个实现. 这个项目实验性非常强,所以在我认为它没问题之前,请不要在生产环境中使用Ocelot的这个功能. Raft是一种分布式一致性算法,它允许一组服务器(Ocelots)保持本地状态,而不需要一个集中式数据库(例如SQL Server)存储状态. 为了在Ocelot中启用Rafty,您必须对Startup.cs进行以下改动. public virtual void ConfigureServices(IServiceColle

这里有一个配置的列子.其中有两个配置块.一个ReRoutes数组和一个GlobalConfiguration.ReRoutes配置块是一些告诉Ocelot如何处理上游请求的对象.Globalconfiguration有些奇特,可以覆盖ReRoute节点的特殊设置.如果你不想管理大量的ReRoute特定的设置的话,这将很有用. { "ReRoutes": [], "GlobalConfiguration": {} } 这是一个ReRoute配置的例子,你不需要全部都设

为了验证ReRoutes并随后使用Ocelot的任何基于声明的功能,如授权或使用令牌中的值修改请求. 用户必须像往常一样在他们的Startup.cs中注册认证服务,但他们给每个注册提供了一个方案(认证提供商密钥),例如 public void ConfigureServices(IServiceCollection services) { var authenticationProviderKey = "TestKey"; services.AddAuthentication() .A

感谢@catcherwong 的文章激励我最终写出了这个文档 Ocelot支持上游的请求限制,以便您的下游服务不会过载. 此功能是由GitHub上的@geffzhang添加! 非常感谢. 好了,为了让ReRoute获得流量限制,你需要添加下面的json到ReRoute中. "RateLimitOptions": { "ClientWhitelist": [], "EnableRateLimiting": true, "Period&qu

Ocelot允许用户将委托处理程序添加到HttpClient传输中. 这个功能在github #208中提出,我确定它会以各种方式被使用.之后我们在GitHub#264中进行了扩展. 用法 为了将委托处理程序添加到HttpClient传输中,有两件重要的事情要做. 首先,为了创建一个可以用于委托处理程序的类,它必须如下所示. 我们将在asp.net core容器中注册这些处理程序,以便您可以将您已注册的其他服务注入到处理程序的构造函数中. public class FakeHandler : D

Ocelot是一个用.NET Core实现并且开源的API网关,它功能强大,包括了:路由.请求聚合.服务发现.认证.鉴权.限流熔断.并内置了负载均衡器与Service Fabric.Butterfly Tracing集成.这些功能只都只需要简单的配置即可完成,下面我们会对这些功能的配置一一进行说明. 介绍 简单的来说Ocelot是一堆的asp.net core middleware组成的一个管道.当它拿到请求之后会用一个request builder来构造一个HttpRequestMessage

Ocelot 针对的是,使用.net运行微服务和面向服务架构,并且需要一个统一的入口来访问他们系统的人群. 特别是,我想要与IdentityServer和令牌轻松集成. Ocelot是一组有特定顺序的中间件. Ocelot操纵HttpRequest对象进入由其配置指定的状态,直到它到达请求生成器中间件,在该中间件中创建HttpRequestMessage对象,该对象用于向下游服务发出请求.中间件发出请求是Ocelot管道中的最后一件事请. 它不调用下一个中间件. 来自下游服务的响应存储在每个请求

Ocelot允许您指定聚合多个普通ReRoutes的Aggregate ReRoutes(聚合路由),并将其响应映射到一个对象中.一般用于当您有一个客户端向服务器发出多个请求,而这些请求可以合并成一个的时候.此功能允许您通过Ocelot实现前端类型结构的后端. 此功能是问题 79的一部分,并且作为问题 298的一部分进行了进一步改进. 为了设置它,你必须在ocelot.json中做如下的事情. 这里我们已经指定了两个普通的ReRoutes,每一个都有一个Key属性. 然后,我们使用ReRoute

Ocelot允许您指定服务发现提供程序,并使用它来查找Ocelot正在将请求转发给下游服务的主机和端口.目前,这仅在GlobalConfiguration部分中受支持,这意味着所有ReRoute将使用相同的服务发现提供程序,以便在ReRoute级别指定ServiceName. Consul GlobalConfiguration中需要以下内容. 提供者是必需的,如果你没有指定主机和端口,默认使用Consul. "ServiceDiscoveryProvider": { "Ho

如果您在Service Fabric中部署了服务,则通常会使用命名服务来访问它们. 以下示例展示如何设置一个ReRoute以便在在Service Fabric中工作. 最重要的是ServiceName,它由Service Fabric应用程序名称和特定服务名称组成的. 我们还需要将UseServiceDiscovery设置为true,并在GlobalConfiguration中设置ServiceDiscoveryProvider. 这里的例子显示了一个典型的配置. 它假定Service Fabr

Ocelot支持基于声明的授权. 这意味着如果您有要授权的路由,您可以将以下内容添加到您的ReRoute配置中. "RouteClaimsRequirement": { "UserType": "registered" } 在此示例中,授权中间件被调用时,Ocelot将检查用户是否拥有声明类型UserType以及该声明的值是否是registered. 如果不是,那么用户将不会被授权,并且响应将被禁止.

Ocelot额外支持代理websockets.这个功能在问题 212中被提出. 为了是Ocelot代理websocket,你需要做如下事情. 在你的Configure方法中,你要告知应用程序使用WebSockets. Configure(app => { app.UseWebSockets(); app.UseOcelot().Wait(); }) 然后在你的ocelot.json中添加如下代码,用于配置websockets代理一个ReRoute. { "DownstreamPathTem

目前Ocelot使用CacheManager项目提供了一些非常基本的缓存.这是一个了不起的项目,它解决了很多缓存问题. 我会推荐这个软件包来做Ocelot缓存. 如果你看看这里的例子,你可以看到如何设置缓存管理器,然后传入Ocelot的AddOcelotOutputCaching配置方法. 您可以使用CacheManager软件包支持的任何设置,只需传入即可. 无论如何,Ocelot目前支持对下游服务的URL进行缓存,并可以设置一个以秒为单位的TTL使缓存过期. 您也可以通过调用Ocelot的管