Ocelot简易教程(二)之快速开始2
為什么這篇的標題叫“Ocelot簡易教程(二)之快速開始2”呢,因為很多朋友跟我說上一篇“ Ocelot簡易教程(二)之快速開始1”內(nèi)容太少了,只是簡單介紹Ocelot的一些簡單配置,讓Ocelot能跑起來!所以才有了這篇快速開始2.在這篇文章中,我會一步一步記錄怎么跑起來一個Ocelot項目,并簡單的介紹一下Ocelot怎么實現(xiàn)接口間的負載均衡!此篇文章的代碼我會放在我的github上面。后續(xù)深入的記錄Ocelot的使用的時候也會沿用這次的代碼。
本文作者:依樂祝
原文地址:https://www.cnblogs.com/yilezhu/p/9638417.html
一步一步開始
演示項目概述
這次的演示項目因為要實現(xiàn)Ocelot的負載均衡的功能,因此至少需要三個項目:Ocelot網(wǎng)關(guān),OrderApi,GoodApi .名字隨便取的,可能博主認為這樣起名字比較順口,沒有其他特別的含義。
新建上面的三個asp.net core web api項目
相信看這篇文章的朋友至少應(yīng)該懂a(chǎn)sp.net core了吧,不然你也接觸不到Ocelot的。所以,這里假設(shè)大家都會創(chuàng)建asp.net core web api(因為真的沒什么技術(shù)含量)。創(chuàng)建后的項目接口如下圖所示:
給OcelotDemo網(wǎng)關(guān)項目添加Ocelot包以及配置文件
首先給OcelotDemo添加Nuget包,可以右鍵“管理Nuget”包,然后搜索Ocelot添加,如下圖所示:
也可以通過命令?Install-Package Ocelot進行安裝。方式隨你喜歡。
然后給OcelotDemo項目新建一個json文件,新建的方式就是,右鍵OcelotDemo項目,然后選擇“添加”-》“新建項”,在彈出的窗口里面找到j(luò)son文件,并寫好文件的名字即可,(當然,也可以用快捷鍵?Ctrl+Shilt+A)如下圖所示:
當然,你還需要右鍵你剛剛設(shè)置的ocelot.json文件,并設(shè)置“復(fù)制到輸出目錄”的屬性為“始終復(fù)制”如下所示:
接下來,可以按照我寫的非常簡單的配置進行配置。
{ ?"ReRoutes": [{"DownstreamPathTemplate": "/api/{everything}","DownstreamScheme": "http","DownstreamHostAndPorts": [{"Host": "localhost","Port": 1001},{"Host": "localhost","Port": 1002}],"UpstreamPathTemplate": "/{everything}","UpstreamHttpMethod": [ "Get", "Post" ],"LoadBalancerOptions": {"Type": "RoundRobin"}}],"GlobalConfiguration": {} }上面配置,有兩個節(jié)點,分別是ReRoutes數(shù)組,以及GlobalConfiguration。這里簡單做一下闡述:
ReRoutes:告訴Ocelot如何處理上游的請求。
DownstreamPathTemplate:下游的路由模板,即真實處理請求的路徑模板
DownstreamScheme:請求的方式,如:http,htttps
DownstreamHostAndPorts:下游的IP以及端口,可以有多個(如果使用負載均衡),方便實現(xiàn)負載均衡,當然你也可以使用服務(wù)發(fā)現(xiàn),實現(xiàn)下游服務(wù)的自動注冊與發(fā)現(xiàn),這篇文章不會講解。
UpstreamPathTemplate:上游請求的模板,即用戶真實請求的鏈接
UpstreamHttpMethod:上游請求的http方法,是個數(shù)組,你可以寫多個。
LoadBalancerOptions:負載均衡選項(DownstreamHostAndPorts有多個的時候才能看到效果),有三種方式
LeastConnection : 將請求發(fā)往最空閑的那個服務(wù)器
RoundRobin :輪流發(fā)送
NoLoadBalance :不啟用負載均衡,總是發(fā)往第一個請求或者服務(wù)發(fā)現(xiàn)的那個服務(wù)器
GlobalConfiguration:顧名思義就是全局配置,此節(jié)點的配置允許覆蓋ReRoutes里面的配置,你可以在這里進行通用的一些配置信息。
OcelotDemo中添加Ocelot支持。
首先在OcelotDemo項目的Program.cs中加載上一步我們添加的Ocelot的配置文件,如下所示:
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>WebHost.CreateDefaultBuilder(args).ConfigureAppConfiguration((hostingContext, config) =>{config.SetBasePath(hostingContext.HostingEnvironment.ContentRootPath).AddJsonFile("appsettings.json", true, true).AddJsonFile($"appsettings.{hostingContext.HostingEnvironment.EnvironmentName}.json", true, true).AddJsonFile("Ocelot.json").AddEnvironmentVariables();}).UseUrls("http://localhost:1000").UseStartup<Startup>();然后,在Startup.cs中,添加Ocelot服務(wù)并啟用Ocelot中間件,這里你需要在Startup.cs文件中引入下面兩個命名空間:
using Ocelot.DependencyInjection;using Ocelot.Middleware;然后,分別在ConfigureServices中注冊O(shè)celot服務(wù)以及Configure中啟用Ocelot中間件:
public void ConfigureServices(IServiceCollection services){services.AddOcelot();//注入Ocelot服務(wù)services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);} ? ? ? ?// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.public void Configure(IApplicationBuilder app, IHostingEnvironment env){ ? ? ? ? ? ?if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}app.UseOcelot().Wait();//使用Ocelot中間件app.UseMvc();}這時候,Ocelot的配置基本完成了,下面我們驗證下Ocelot有沒有正常工作,以及我們配置的負載均衡,有沒有起作用吧。
結(jié)合我們上面的配置,可以知道改造的目的就是為了如下的測試,我們做出如下假設(shè):
為了驗證上游模板/{everything} 對應(yīng)下游模板/api/{everything} 我們請求的路徑即為http://localhost:1000/Values 并且把GoodApi以及GoodApi響應(yīng)路徑分別設(shè)置為:http://localhost:1001/api/Values?,http://localhost:1003/api/Values?并得到正確的響應(yīng)
為了驗證Ocelot項目起作用,我們請求ocelotDemo項目的路徑values,應(yīng)該返回GoodApi,或者OrderApi項目中values控制器的值,而不是返回ocelotDemo中values控制器的值
為了驗證Ocelot負載均衡起作用,我們連續(xù)訪問ocelotDemo項目的路徑values,則返回的結(jié)果應(yīng)該是輪流返回GoodApi以及OrderApi的值。
下面我們利用?dotnet run命令分別啟動三個項目,當然你也可以多項目啟動。然后訪問OcelotDemo項目的Url并訪問Values控制器,完整路徑“http://localhost:1000/Values”,看到
OcelotDemo的Url:http://localhost:1000
GoodApi的Url:http://localhost:1001
OrderApi的Url:http://localhost:1002
我們第一次訪問http://localhost:1000/Values 得到如下結(jié)果:
測試Ocelot項目以及負載均衡有沒有起作用
這里,首先分別對三個項目的ValuesController控制器做如下改造:
OcelotDemo項目ValuesController中的Get方法改造如下:
明我們的假設(shè)1以及假設(shè)2都是沒問題的。也就是說我們的Ocelot已經(jīng)在起作用了,而且根據(jù)上下游路由進行了映射。
接下來我們刷新下頁面,得到如下結(jié)果:
說明我們的假設(shè)3即Ocelot的負載均衡也起作用了。當然,你可以多刷新幾次,可以看到返回的結(jié)果在GoodApi與Order Api之間來回切換。因為我們的負載均衡策略就是輪詢啊!
源碼鏈接
Github地址:https://github.com/yilezhu/OcelotDemo
最后
這篇文章主要是為了讓記錄如何快速的開始使用Ocelot。關(guān)于Ocelot的配置很多都沒有描述,包括限流以及熔斷策略,以及多配置文件自動加載功能,等等。這個超出了快速開始的范圍,當然這些高級的用法會在下面的系列文章中會一一記錄。
本文使用的是Ocelot最新版本,為了保持技術(shù)上的跟進,因此沒有使用上篇文章介紹的老版本,所以演示都是通過最新的ocelot版本來跟進的!
總結(jié)
關(guān)于其本篇文章只是記錄了,如何快速的成功的使用ocelot,并進行了簡單的配置,配置中又引入了一個負載均衡的策略,最后通過代碼進行了相關(guān)的實現(xiàn)以及測試他的一些配置,我會在下面的文章中進行闡述。這里只是對上篇文章“Ocelot簡易教程(二)之快速開始1”的補充!感謝大家的閱讀!
相關(guān)文章:
AspNetCore中使用Ocelot之 IdentityServer4
Ocelot-基于.NET Core的開源網(wǎng)關(guān)實現(xiàn)
.NET Core微服務(wù)之基于Ocelot+IdentityServer實現(xiàn)統(tǒng)一驗證與授權(quán)
Swagger如何訪問Ocelot中帶權(quán)限驗證的API
Ocelot.JwtAuthorize:一個基于網(wǎng)關(guān)的Jwt驗證包
.NET Core微服務(wù)之基于Ocelot實現(xiàn)API網(wǎng)關(guān)服務(wù)
.NET Core微服務(wù)之基于Ocelot實現(xiàn)API網(wǎng)關(guān)服務(wù)(續(xù))
.NET微服務(wù)體系結(jié)構(gòu)中為什么使用Ocelot實現(xiàn)API網(wǎng)關(guān)
Ocelot簡易教程(一)之Ocelot是什么
Ocelot簡易教程(二)之快速開始1
原文地址:?https://www.cnblogs.com/yilezhu/p/9563188.html
.NET社區(qū)新聞,深度好文,歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結(jié)
以上是生活随笔為你收集整理的Ocelot简易教程(二)之快速开始2的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: .net core实践系列之短信服务-A
- 下一篇: NetCore使用Jwtbearer给W