在Windows 下如何使用 AspNetCore Api 和 consul

標籤：丟失   停止   nts   closed   dex   老師   view   parse   瞭解   

一、概念： 什麼 是consul:

 Consul 是有多個組件組成的一個整體，作用和Eureka,Zookeeper相當，都是用來做服務的發現與治理。

 

C onsul 的 特性：

          1、 服務的發現：consul可以把註冊到其中的服務提供給使用者，也可以主動探索服務，在consul的用戶端介面中使用者可以得到，服務的資訊，比如IP連接埠等資訊，在用戶端介面中可以很容易的找到註冊的服務，

          2、 健全狀態檢查：這裡健全狀態檢查就是檢查服務是否在良好的運行，這裡判斷服務是否運行良好，可以用Web服務的狀態進行判斷，也可以用伺服器的利用狀態進行判斷，可以根據這些狀態來判斷那些服務是良好啟動並執行那些是不健康的（）這裡不健康可以是伺服器的利用率）從而根據這些判斷路由遠離不健康的服務。

         3、 KVStore：就是KEY/Value的儲存，在使用中可以根據KV的儲存功能做很多事情比如，動態的進行配置，進行一些特徵的標記，協調，管理的選舉，KV儲存的API是基於HTTP的。

         4、 多資料中心：consul支援多哦資料中心，意味著我們這是用consul的過程中不必擔心多做更多的工作來進行擴充。

 

        Consul是一個分布式的高可用的系統。每一個向consul註冊的的服務，在服務無本身都會運行一個（agents）代理，運行代理的最終目的是為了對當前服務進行健全狀態檢查，以便通知Consul系統，當前節點的健康與否，在consul的特性（健全狀態檢查）我們已經舉過例子。

        每個資料中心運行一個領事伺服器叢集。當提出跨資料中心服務發現或配置請求時，本地(agents)伺服器將請求轉寄到遠端資料中心並返回結果。

 

     （白話）進行健康檢查就是為了決定能不能用這個節點服務，這個節點的服務是否是所有已知節點中效能最好的，不是最好的換一個就是了。在使用的過程中每一個伺服器運行時建議類比出多個可以導致服務失敗、資料丟失的情境，然後為每一個服務推薦用作安全的伺服器。在這個過程中有一個最大的功臣就是代理（agents），代理實現了和伺服器之間的交流。

瞭解更多：https://www.consul.io/intro/index.html

 

二、 Consul 的 安裝：

 

　　1、  Consul的 下載：

 

　　　　地址： https://www.consul.io/

 

 　　　　

　　　　　　　　點擊DOWNLOAO 進入下載頁面如下：

 　　　　　　　　

　　　　　　　　我下載的是win版本並且已解壓，大小非常的小

　　　　　　　　

 

　　2、安裝運行：

 　　　安裝命令為：Consul.exe agent -dev   開發人員模式安裝   Ctrl+ C 可以停止運行 如：

　　　

      　　

             開發人員模式安裝只適用於單個伺服器的環境，不用於生產，開發人員模式不儲存任何的狀態。

 

　　　　安裝成功後，我們可以看到，輸出的日誌資訊中包含了。Client addr: 用戶端地址為，127.0.0.1:8500，DNS為8600 我們可以在瀏覽器中進行訪問，

　　　　訪問結果如下：

　　　　

　　　　在頁面中我們可以看到我們的服務、 consul 在會預設把自己註冊成為一個服務節點，介面中向我們展示了自己的運行狀態，IP伺服器等資訊

　　　　我們還可以通過命令來進行查看 服務的資訊

　　　　命令： consul members 是輸出：

 　　　　

 

　　　　圖中向我們輸出了我們自己更加詳細的資訊，地址、狀態、角色、版本資訊

　　　　在後期我們使用的過程中我們會添加很多的服務，這個時候的輸出可能更多，因為服務的資訊是通過通訊協議擷取以及註冊的，為了避免consul視圖中的服務狀態，和伺服器上的狀態保持一致，就需要通過HttpApi將服務的狀態發送給consul中的管理(agent) 結合上文中consul的特性3KVStore我們可以更好的理解。

　　　　官方翻譯

 

　　　　中斷代理之後，您應該看到它離開叢集並關閉。通過優雅地離開，領事通知其他叢集成員節點已離開。如果您強制終止代理進程，叢集的其他成員將檢測到節點失敗。當成員離開時，其服務和檢查將從目錄中刪除。當一個成員失敗時，它的健康狀態被簡單地標記為關鍵，但它不會從目錄中刪除。領事將自動嘗試重新串連到失敗的節點，允許它從某些網路條件中恢複，而不再與左側節點聯絡。此外，如果代理作為伺服器運行，那麼優雅的休假對於避免可能導致影響協商一致協議的可用性中斷非常重要。

 

 

 三、Consul的簡單使用：

 　　　　1、建立一個AspNetCoreAPI項目：

　　　　　　如：

 　　　　　　　　

　　　　2、在項目中的Startup中Configure方法中實現註冊：

　　　　　　　　

　　　　　　　　代碼如下：　　　

 public void Configure(IApplicationBuilder app, IHostingEnvironment env)        {            if (env.IsDevelopment())            {                app.UseDeveloperExceptionPage();            }            app.UseMvc();            String ip = Configuration["ip"];//部署到不同伺服器的時候不能寫成127.0.0.1或者0.0.0.0，因為這是讓服務消費者調用的地址            int port = int.Parse(Configuration["port"]);//擷取服務連接埠            var client = new ConsulClient(ConfigurationOverview); //回調擷取            var result = client.Agent.ServiceRegister(new AgentServiceRegistration()            {                ID = "ServerNameFirst" + Guid.NewGuid(),//服務編號保證不重複                Name = "ServerFirst",//服務的名稱                Address = ip,//服務ip地址                Port = port,//服務連接埠                Check = new AgentServiceCheck //健全狀態檢查                {                    DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(5),//服務啟動多久後反註冊                    Interval = TimeSpan.FromSeconds(10),//健全狀態檢查時間間隔，或者稱為心跳間隔（定時檢查服務是否健康）                    HTTP = $"http://{ip}:{port}/api/Health",//健全狀態檢查地址                    Timeout = TimeSpan.FromSeconds(5)//服務的註冊時間                }            });        }

View Code

 

/// <summary>        /// 擷取Consul的執行個體        /// </summary>        /// <param name="obj"></param>        private static void ConfigurationOverview(ConsulClientConfiguration obj)        {            //consul的地址            obj.Address = new Uri("http://127.0.0.1:8500");            //資料中心命名            obj.Datacenter = "dc1";        }

View Code

 

 

 3、啟動：首先確保Consul已啟動，我們運行項目註冊

 　　　　

　　　　步驟如下：

        　　　　編譯Api 成功後我們通過命令列的方式運行：

             　　　　執行命令：dotnet 項目DLL --ip 設定ip -- port 設定連接埠(dotnet Framework.WebApi.dll --ip 127.0.0.1 --port 5001)  敲擊斷行符號運行項目

  　　　　　　　　　　　　同一個項目我們可以運行多個在命令運行時設定不同連接埠就可以運行了

                                         

　　　　　　　　　　　　

　　　　　　　　　　　　重新整理consul用戶端我們可以看到我們的服務註冊成功了

　　　　　　　　　　　　結果如下：

 　　　　　　　　　　　　

 

 

文章參考：如鵬網楊中科老師的AspNetCore 微服務普及推廣內容：

　　　　　　　　　　　　　　有不足之處 希望大家指出相互學習

 

在Windows 下如何使用 AspNetCore Api 和 consul