Kong 四大參考說明

Kong 的官方有很多詳細的參考說明，比如配置文件、命令行、Admin API、代理、負載均衡，接下來我們簡單看一下，都提供什么內容。

本文主要基于 Kong 1.3 版本進行描述，如有更新，請查看最新文檔。

配置文件

通過對配置文件的 深入理解，可以優化 Kong 集群、使用的數據庫、配置 Nginx ，
官方的參考資料是 Configuration Reference

Kong 在啟動時，可以通過 -c 或者 --conf參數來指定配置文件，比如：

kong start -c /path/to/kong.conf

可以使用 check 命令來校驗配置文件的語法正確性，

$ kong check <path/to/kong.conf>
configuration at <path/to/kong.conf>
 is valid 

Kong 的配置在加載的時候也會去找同名的環境變量，所有也可以通過環境變量來配置 Kong，而且環境變量的優先級高于配置文件。可以通過環境變量來配置 Kong 這樣方便了基于容器的部署和運行。如果要使用環境變量，需要以 KONG_ 字段開頭。

命令行參考

所提供的CLI(命令行接口)允許您啟動、停止和管理 Kong 實例。CLI 可以管理本地節點(如在當前機器上)。可以參考官網文檔
CLI Reference

主要由如下命令

全局標記

所有的命令都可以使用如下參數

• --help ： 打印命令的幫助信息
• --v ： 打開詳情模式
• --vv ： 打開 debug 模式

可用的命令

• kong check 檢查配置文件語法等等
• kong config 使用申明式配置文件。
• kong health 檢查該節點上的 kong 是否在運行
• kong migration 管理 Kong 的數據庫
• kong prepare 此命令準備Kong前綴文件夾及其子文件夾和文件。
• kong quit 優雅的退出 Kong 實例
• kong reload 重載 kong 實例配置
• kong restart 重啟 kong 實例
• kong start 啟動 kong 實例
• kong stop 停止 kong 實例
• kong version 打印版本信息

Admin API 參考

Admin API 的說明可以參考官網文檔：
Admin API Reference

Admin API 接受 2 兩種連接類型在每個終端。
分別是

• application/x-www-from-urlencoded
• application/json

共有 9 個對象，分別是：

• Service Object
• Route Object
• Consumer Object
• Plugin Object-Precedence
• Certificate Object
• CA Certificate Object
• SNI Object
• Upstream Object
• Target Object

Proxy 參考

在本文檔中，我們將通過詳細解釋Kong的路由功能和內部工作原理來介紹它的代理功能。

Kong 公開了幾個接口，可以通過兩個配置屬性進行調整:

• proxy_listen，它定義了一個地址/端口列表，Kong將在這些地址/端口上接受來自客戶機的公共通信，并將其代理到您的上游服務(默認為8000)。
• admin_listen，它還定義了一個地址和端口列表，但是這些應該被限制為只能由管理員訪問，因為它們公開了Kong的配置功能:Admin API(默認情況下為8001)。
  Proxy Reference

Kong 經常用到的術語有：

• client : 指下游客戶向 Kong 代理端口發出請求。
• upstream service ：指自己位于 Kong 后面的 API/Service，客戶端請求被轉發到這些API/Service。
• Service : 顧名思義，服務實體是上游服務的抽象。服務的示例包括數據轉換微服務、計費API等。
• Route : 這是指 Kong 路由實體。Route 是進入 Kong 的入口點，并為要匹配的請求定義規則，然后路由到給定的服務。
• Plugin : 指 Kong 的 “plugins”，它是在代理生命周期中運行的業務邏輯片段。插件可以通過管理 API 進行配置——可以是全局的(所有傳入的流量)，也可以是在特定的路由和服務上配置。

負載均衡參考

Kong 為多個后端服務提供了多種負載平衡請求的方法: 一種簡單的基于 DNS 的方法，另一種是更動態的環形平衡器，該平衡器還允許在不需要DNS服務器的情況下進行服務注冊。

負載均衡可以參考官網文檔
Load Balancing Reference 來了解。

基于 DNS 的負載均衡

當使用基于 DNS 的負載平衡時，后端服務的注冊是在 Kong 之外完成的，而 Kong 只接收來自 DNS 服務器的更新。

如果主機名沒有解析為上游名稱或 DNS 主機文件中的名稱，則使用包含主機名(而不是IP地址)的主機定義的每個服務都將自動使用基于 DNS 的負載平衡。

DNS 記錄 ttl 設置(生存時間)決定信息刷新的頻率。當使用 ttl 為 0 時，每個請求都將使用自己的 DNS 查詢進行解析。這將帶來性能損失，但是更新/更改的延遲將非常低。

A 記錄

一個 A 記錄對應一個或者多個 IP 地址，因此，當主機名解析為 A 記錄時，每個后端服務必須有自己的IP地址。

因為沒有權重信息，所以所有條目在負載平衡器中都將被視為同等權重，并且平衡器將進行直接的循環。

SRV 記錄
SRV記錄包含所有IP地址的權重和端口信息。后端服務可以通過IP地址和端口號的唯一組合來標識。因此，一個IP地址可以在不同的端口上承載相同服務的多個實例。

因為權重信息是可用的，所以每個條目將在負載平衡器中獲得自己的權重，并執行加權循環。

DNS 的優先級

1、前面解析的最后一個成功類型
2、SRV 記錄
3、A記錄
4、CNAME 記錄

這些可以在配置文件的 dns_order 進行配置。

基于 Ring-balancer 的負載均衡

使用 Ring-balancer 時，后端服務的添加和刪除將由 Kong 處理，不需要 DNS 更新。Kong 將作為服務注冊處。節點可以通過一個HTTP請求添加/刪除，并將立即啟動/停止接收流量。

配置 Ring-balancer 工作需要有 Upstream 和 target 兩個實體。

• target ： 帶有后端服務所在端口號的IP地址或主機名，例如。“192.168.100.12:80”。每個目標都獲得一個額外的權重，以指示它獲得的相對負載。IP地址可以是IPv4和IPv6格式。
• upstream ： 一個 virtual hostname，可用于路由的 host 字段，例如一個 upstream 是 weather.v2 會收到服務 host=weather.v2.service 的所有請求。

小結

本來大致講述了 Kong 的配置文件、命令行、代理、負載均衡等內容。