1.konga核心物件
Kong 的四大核心物件:upstream,target,service,route。下面分別說:
(1)upstream,字面意思上游,實際專案理解是對某一個服務的一個或者多個請求地址的抽象入口,新建upstream可設定基本資訊,被動/主動健康檢查。
(2)trarget,目標,實際就是上游upstream的一個多個實際的某服務的請求地址(ip:port或者域名),在upstream詳情裡新增設定target。
(3)service,服務,對實際服務(比如使用者服務)的抽象概念,通過host繫結upstream,新增服務可設定的欄位如下
Service 物件設定欄位:
- name(必填):服務名稱.
- tags(可選):可選地向服務新增標記
- url(可選):將協定、主機、埠和路徑立即設定成簡短的屬性。這個屬性是隻寫的(管理API從來不「返回」url)
- protocol(必填):該協定用於與upstream通訊。它可以是http(預設)或https。
- host(必填):upstream伺服器的主機。
- port(必填):upstream伺服器埠。預設為80
- path(可選):在向upstream伺服器請求中使用的路徑。預設為空。
- retries(可選):在代理失敗的情況下執行的重試次數。預設值是5。
- connect_timeout(可選):建立到upstream伺服器的連線的超時時間。預設為60000。
- write_timeout(可選):將請求傳送到upstream伺服器的兩個連續寫操作之間的超時時間。預設為60000。
- read_timeout(可選):將請求傳送到upstream伺服器的兩個連續讀取操作之間的超時時間。預設為60000。
(4)route,路由,通過設定一定的匹配規則,來將使用者端的請求,匹配到對應的service上,可設定如下規則:
- name(可選) :定義名稱
- tags(可選) :向路由新增標記
- protocols(可選) : 這條路線應該允許的協定列表。
- methods(半可選) :與此路由相匹配的HTTP方法列表。例如: [「GET」, 「POST」].至少有一個主機、路徑或方法必須被設定。用表單編碼引數是methods[]=GET&methods[]=OPTIONS。使用JSON,使用陣列。
- hosts(半可選):與此路徑匹配的域名列表。例如:example.com. 至少有一個主機、路徑或方法必須被設定。用表單編碼引數是 hosts[]=foo.com&hosts[]=bar.com。使用JSON,使用陣列。
- paths(半可選):與此路徑相匹配的路徑列表。例如: /my-path.至少有一個主機、路徑或方法必須被設定。用表單編碼引數是 paths[]=/foo&paths[]=/bar. 使用JSON,使用陣列。
- Regex priority(可選) : 當多個路由同時使用正規表示式匹配某個給定請求時,用來選擇哪個路由解析該請求的數位。當兩個路由匹配路徑並且具有相同的regex_優先順序時,將使用較舊的路由(最低建立位置)。注意,非regex路由的優先順序不同(較長的非regex路由在較短的路由之前匹配)。預設為0。
- strip_path(可選) :當通過其中一條路徑匹配路由時,從上游upstream請求URL中去掉匹配字首。預設值為true。
- 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通關閘道器來請求測試服務介面