.Net Core微服务网关Ocelot基础介绍及集成
网关是什么
简单来说,网关就是暴露给外部的请求入口。就和门卫一样,外面的人想要进来,必须要经过门卫。当然,网关并不一定是必须的,后端服务通过http也可以很好的向客户端提供服务。但是对于业务复杂、规模庞大的项目来说,使用网关有很多无法舍弃的好处,比如可以进行统一的请求聚合来节省流量、降低耦合度,可以赋予项目熔断限流的能力提高可用性等等。
ocelot是什么
ocelot是.net core实现的开源的api网关项目,开源地址:https://github.com/threemammals/ocelot
ocelot除了十分契合.net开发者以外,功能强大,包含:路由、认证、请求聚合、限流熔断、服务发现、鉴权,还有内置负载均衡器、consul集成等等。
当然了,api网关不止这一款,市面上还有kong之类的,随自己喜好就好。
ocelot集成
首先明确一点,网关应该作为独立进程存在。那么我们先新建一个.net core3.1项目,然后添加nuget包:
关于版本,选择当前所能支持的最新版即可。
添加好nuget包以后,需要修改startup:
// this method gets called by the runtime. use this method to add services to the container. public void configureservices(iservicecollection services) { services.addocelot(); //services.addcontrollers(); } // this method gets called by the runtime. use this method to configure the http request pipeline. public void configure(iapplicationbuilder app, iwebhostenvironment env) { app.useocelot().wait(); //if (env.isdevelopment()) //{ // app.usedeveloperexceptionpage(); //} //app.usehttpsredirection(); //app.userouting(); //app.useauthorization(); //app.useendpoints(endpoints => //{ // endpoints.mapcontrollers(); //}); }
这里不要惊讶,因为走了网关就不会再走默认的管道了。useocelot().wait() 表示设置ocelot所有的中间件,而ocelot也提供了很多集成中间件的库,就像这些:
现在,想要让ocelot成功运行,还需要新增配置文件,并在program新增配置文件的引用:
public static ihostbuilder createhostbuilder(string[] args) => host.createdefaultbuilder(args) .configureappconfiguration(config => { config.addjsonfile("ocelotconfig.json", optional: false, reloadonchange: true); }) .configurewebhostdefaults(webbuilder => { webbuilder.usestartup<startup>(); });
配置文件:
{ "routes": [ { "downstreampathtemplate": "/{url}", //服务地址--url变量 "downstreamscheme": "http", "downstreamhostandports": [ { "host": "123.123.123.123", "port": 5050 //服务端口 } ], "upstreampathtemplate": "/mj/{url}", //网关地址--url变量 "upstreamhttpmethod": [ "get", "post" ] } ] }
这是一份简单的转发配置,downstream和upstream开头的配置项就是下游、上游相关项。这里要说一句,在微服务架构中,客户端——服务端通常理解为上游——下游,这里自行替换一下。
上面的配置文件做了一件事,接收上游请求时,把请求路径中含有【/mj/所有】的请求转发到ip【http://123.123.123.123:5050/所有】并回传结果,支持http的get、post方法,其实这就是最基本的路由。
来测试一下,启动项目并写好请求路径:
可以看到,ocelot成功把本地请求按照路由规则转发给远程服务器,并回发了结果。一个网关最基本的功能有了。
截图中所请求的远程服务,是我前几篇文章基于consul搭建起来的项目,有兴趣可以去看看。
关于ocelot更高级的应用,比如熔断限流、身份认证等,都是通过配置来完成的,我会整理后发出来,同时也建议仔细阅读官方文档,地址:https://ocelot.readthedocs.io/en/latest/
到此这篇关于.net core微服务网关ocelot基础介绍及集成的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持。