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