.Net Core微服務網關Ocelot基礎介紹及集成

Posted on by

網關是什麼

簡單來說，網關就是暴露給外部的請求入口。就和門衛一樣，外面的人想要進來，必須要經過門衛。當然，網關並不一定是必須的，後端服務通過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基礎介紹及集成的文章就介紹到這瞭。希望對大傢的學習有所幫助，也希望大傢多多支持WalkonNet。

推薦閱讀：