來,Consul 服務發現入個門(一看就會的那種)
前言
在微服務架構中,對於一個系統,會劃分出多個微服務,而且都是獨立開發、獨立部署,最後聚合在一起形成一個系統提供服務。當服務數量增多時,這些小服務怎麼管理?調用方又怎麼能確定服務的IP和埠?服務掛掉了又怎麼辦?單靠人工處理已經不太現實,使用系統統一管理就是最好的選擇,常用的服務發現產品有:Consul、Zookeeper、Etcd、Eureka等,而對於Consul在.NetCore中是很火很火的,所以接下來肯定先聊它嘍。
正文
Consul是一個支援多數據中心、分散式、高可用的服務發現和配置共享的系統,開箱即用,主要功能如下:
- 服務發現:可以通過Consul客戶端註冊服務,這裡服務可以是API站點、Redis伺服器、MySql伺服器等;當其他客戶端需要使用對應的服務時,Consu可以通過DNS或HTTP的形式將服務返回給所需客戶端;無需再手動指定IP和埠,由Consul統一管理。
- 健康檢查:Consul提供對各服務進行檢查的功能,相關人員可以通過檢查資訊關注各服務的運行情況;而對於的服務的使用者,可以避免訪問不健康的服務,如當一個API站點掛掉了,調用方從Consul中獲取服務資訊時就獲取不到,而是返回健康的服務資訊,從而保證調用API正常。
- 鍵值對存儲:可以存儲鍵值對數據,很適合當配置中心使用。比如有多個服務,每個服務都一些配置資訊,可以將其統一配置在Consul中,避免每一個服務重複配置,很大程度降低了配置錯誤導致的風險。
- 多數據中心:Consul支援多個開箱即用的數據中心,每個數據中心獨立運行。
簡單了解Consul功能之後,接下來就先說說服務發現和健康檢查的應用,大概的一個流程如下圖:
上圖簡單描述
- 各服務通過配置文件或程式碼的形式進行註冊,即把資訊報給Consul;
- Consul根據註冊的資訊,對已經註冊服務進行健康檢查;Grpc、TCP、HTTP方式都可以;
- 客戶端如果需要使用服務資訊,如IP和埠,可以通過Consul進行獲取健康的服務(服務發現);DNS和HTTP兩種方式都可以;
接來從安裝開始,做一個Demo演示,包括服務註冊、服務查看、健康檢查、服務失效之後發郵件通知功能,算是從開發到維護走了一個流程(不過只是演示的那種)。
1. 安裝
Consul的安裝可以說超級簡單,進官網->下載->解壓就完成安裝啦,官網地址://www.consul.io/;
找到下載頁面,選擇適合自己系統的版本,直接下載就行,如下圖:
下載完成之後,直接解壓,然後打開命令行工具,運行一下是否正常,如下圖:
2. 註冊服務
-
配置文件形式
首先肯定需要準備一個配置文件,這裡為了查看Consul運行時監控的服務數據,也可以指定對應數據輸出的目錄,所以還需要一個數據目錄,如下:
config:作為配置文件的存放位置,Conusl啟動時可以指定配置文件位置,然後可以自動載入該目錄下所有json文件;
data:這個就是一個空文件夾,用於存儲Consul運行時產生的數據,這個不是必須的。
有了目錄結構之後,然後在config中創建一個services.json文件,裡面內容如下:
配置資訊見上圖已經做了相關說明,而對於健康檢查,因為上圖配置的是以HTTP的形式檢查API服務是否正常,即能否正常訪問對應地址,當然可以根據場景需要配置檢測方式,比如Grpc、TCP、腳本等。
配置文件準備好了之後,可以直接運行Consul啦,這裡為了快速入門,先以開發模式運行,如下:
命令解析:
agent:運行代理;
-dev:以開發模式運行,快速開啟一個Server,資訊如上圖;
-confile-file:指定Consul配置文件所在的目錄,然後就自動載入該目錄下的所有json文件;
-data-dir : 指定Consul運行時存儲數據的目錄,一般包含服務的狀態及相關資訊;
用配置文件這種方式,程式碼無需更改,只需保證服務運行的時候對應的IP地址、埠、健康檢查的路徑正確即可。由於現在還沒有對應的服務,根據上面配置的的資訊,每個5s會檢查一次,當前檢查的服務肯定是不健康的,Consul控制台會持續輸出如下資訊:
新建一個WebAPI項目,增加一個Health健康檢查的Controller,然後指定埠為5000運行,控制器程式碼如下:
運行之後,Consul 代理就檢測到了,如下:
-
嵌入程式碼形式
程式碼註冊的形式需要引入Consul包,然後在程式碼中指定Consul地址和配置相關服務資訊即可,其他無需改變,註冊程式碼邏輯如下:
先在配置文件中配置相關資訊:
服務註冊程式碼如下:
註冊服務方法完成之後,直接在Startup文件中Configure方法的最後調用即可。然後指定對應埠啟動服務即可,演示設置的埠為6688,這樣服務就註冊完啦,Consul也能檢測到。
3. 查看服務
服務完成註冊之後,肯定是要需要查看或使用,主要有以下三種方式:
-
UI形式
Consul提供對應的頁面查看註冊服務的相關資訊,當然也可以配置相關資訊。當Consul啟動之後,就可以通過//localhost:8500/(這裡演示是本地)這個地址訪問到對應的介面,如下:
介面就不挨個截圖啦,小夥伴自己點點。這個可視化介面還是很給力的。
-
DNS和HTTP形式
同樣也可以通過用命令方式進行查看,有兩種形式,DNS和HTTP。這裡先用HTTP的方式演示,DNS方式留給小夥伴吧,很簡單的。
HTTP形式,直接調用介面即可(當然可以進行許可權控制);
查詢服務常用的介面地址如下:
查詢所有服務:
//localhost:8500/v1/catalog/services根據服務名稱查詢服務,服務名稱就是在註冊服務時指定的名稱:
//localhost:8500/v1/catalog/service/服務名稱當同名稱的服務有多個時,可以根據Tag過濾:
//localhost:8500/v1/catalog/service/服務名稱?tag=test6688查詢其他類型資訊也和上面類似,比如查詢節點資訊、查詢數據中心資訊;
-
程式碼形式
需要依賴Consul包,程式碼如下:
運行結果如下:
當然這種形式也能獲取Consul其他資訊,小夥伴調試一下就知道啦;
4. 監視服務(異常通知相關人員)
對於服務本身,可能因為網路或軟硬體的問題,導致服務掛掉,如果沒有及時恢復,有些業務可能會導致後果比較嚴重,所以當服務掛掉時,及時通知是必須的;這裡演示使用的是郵件的方式,需要簡單設置一下發送郵箱;這裡使用的是QQ郵箱發出,需要開啟QQ郵箱相關服務,在QQ郵箱設置中開啟即可,如下圖:
開啟的時候需發送簡訊進行驗證,然後會獲得一個授權碼,在後面發送郵件時會用到。
為了演示方便,發送郵件通知的邏輯是寫在業務服務中,其實可以單獨出來一個服務專門負責通知即可。程式碼邏輯如下:
增加一個通知介面,供監聽調用,當監聽到服務故障時,就調用該介面發送郵件即可:
程式碼準備好了,現在需要配置監視,只需要在配置目錄下增加監視的配置文件即可,這裡取名為watchs.json,內容如下:
配置文件完成之後,重啟Consul即可,命令和剛開始啟動的一樣; 然後將服務啟動,為了測試方便,服務用命令的方式啟動,方便關閉,命令如下:
dotnet ConsulCodeDemo.dll --urls "//*:6688" # 指定埠啟動
dotnet ConsulConfigDemo.dll # 默認就是5000,所以不用指定啦
註:執行以上命令需要進入對應編譯的文件目錄;
服務正常運行時,在Consul介面中可以看到各服務都是健康狀態,然後將埠為5000的這個服務關掉(因為配置郵件發送的介面在6688上),Consul檢測到就會自動調用介面,發送相關郵件。
相關人員收到資訊就可以及時進行處理。
源碼地址://github.com/zyq025/IDS4Demo/tree/main/ConsulDemo
總結
好了,Consul初探先到這吧,入門還差點,畢竟還有很多沒講,關於常用命令、集群搭建、ACL配置等都沒涉及,所以下一篇來聊聊集群搭建和ACL配置,對於常用命令的使用,一邊搭建環境,一邊進行解釋說明。
一個被程式搞丑的帥小伙,關注”Code綜藝圈”,跟我一起學~~~