微服務系列之閘道器(二) konga設定操作

2022-09-07 12:01:18

1.konga核心物件

  Kong 的四大核心物件:upstream,target,service,route。下面分別說:

(1)upstream,字面意思上游,實際專案理解是對某一個服務的一個或者多個請求地址的抽象入口,新建upstream可設定基本資訊,被動/主動健康檢查。

(2)trarget,目標,實際就是上游upstream的一個多個實際的某服務的請求地址(ip:port或者域名),在upstream詳情裡新增設定target。

(3)service,服務,對實際服務(比如使用者服務)的抽象概念,通過host繫結upstream,新增服務可設定的欄位如下

Service 物件設定欄位:

  1. name(必填):服務名稱.
  2. tags(可選):可選地向服務新增標記
  3. url(可選):將協定、主機、埠和路徑立即設定成簡短的屬性。這個屬性是隻寫的(管理API從來不「返回」url)
  4. protocol(必填):該協定用於與upstream通訊。它可以是http(預設)或https。
  5. host(必填):upstream伺服器的主機。
  6. port(必填):upstream伺服器埠。預設為80
  7. path(可選):在向upstream伺服器請求中使用的路徑。預設為空。
  8. retries(可選):在代理失敗的情況下執行的重試次數。預設值是5。
  9. connect_timeout(可選):建立到upstream伺服器的連線的超時時間。預設為60000。
  10. write_timeout(可選):將請求傳送到upstream伺服器的兩個連續寫操作之間的超時時間。預設為60000。
  11. read_timeout(可選):將請求傳送到upstream伺服器的兩個連續讀取操作之間的超時時間。預設為60000。

(4)route,路由,通過設定一定的匹配規則,來將使用者端的請求,匹配到對應的service上,可設定如下規則:

  1. name(可選) :定義名稱
  2. tags(可選) :向路由新增標記
  3. protocols(可選) : 這條路線應該允許的協定列表。
  4. methods(半可選) :與此路由相匹配的HTTP方法列表。例如: [「GET」, 「POST」].至少有一個主機、路徑或方法必須被設定。用表單編碼引數是methods[]=GET&methods[]=OPTIONS。使用JSON,使用陣列。
  5. hosts(半可選):與此路徑匹配的域名列表。例如:example.com. 至少有一個主機、路徑或方法必須被設定。用表單編碼引數是 hosts[]=foo.com&hosts[]=bar.com。使用JSON,使用陣列。
  6. paths(半可選):與此路徑相匹配的路徑列表。例如: /my-path.至少有一個主機、路徑或方法必須被設定。用表單編碼引數是 paths[]=/foo&paths[]=/bar. 使用JSON,使用陣列。
  7. Regex priority(可選) : 當多個路由同時使用正規表示式匹配某個給定請求時,用來選擇哪個路由解析該請求的數位。當兩個路由匹配路徑並且具有相同的regex_優先順序時,將使用較舊的路由(最低建立位置)。注意,非regex路由的優先順序不同(較長的非regex路由在較短的路由之前匹配)。預設為0。
  8. strip_path(可選) :當通過其中一條路徑匹配路由時,從上游upstream請求URL中去掉匹配字首。預設值為true。
  9. preserve_host(可選) :當通過一個主機域名匹配一條路由時,在upstream請求頭中使用請求主機頭。預設設定為false,upstream主機頭將是服務主機的主機頭。

上述是konga的4個核心物件,當用戶端的真實請求來臨時流程是這樣的,請求首先來到route如匹配上service,就轉發到對應的service,service通過host找到所繫結的upstream,upstream拿到其下的所有target,如果是多個目標,就進行負載均衡分發。

2.konga設定

部署一個.net core api服務,並用docker啟動,(docker部署.net core方法傳送門:https://www.cnblogs.com/saltlight-wangchao/p/16646005.html)

upsteam上游設定

基本功能,給起個名字,下面給這個上游,增加target

下面新建個service,

 

最後點選新建好的服務詳情進去,給這個服務建立路由匹配規則

由此,kong閘道器的一個測試服務已經設定完畢,kong的監聽使用者端的埠是8000,注意不是8001。下面用postman通關閘道器來請求測試服務介面