1.konga核心對象 Kong 的四大核心對象:upstream,target,service,route。下麵分別說: (1)upstream,字面意思上游,實際項目理解是對某一個服務的一個或者多個請求地址的抽象入口,新建upstream可配置基本信息,被動/主動健康檢查。 (2)trarget ...
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通關網關來請求測試服務介面