微服務系列之網關(二) konga配置操作

2022 年 9 月 7 日
筆記
微服務

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,如果是多個目標，就進行負載均衡分發。