配置文件校驗
kong可以通過命令check檢驗文件配置的完整性,命令如下:
kong check /usr/local/kong/etc/kong.conf
configuration at /usr/local/kong/etc/kong.conf is valid
其中/usr/local/kong/etc/kong.conf為您要校驗配置文件的路徑。kong的check命令會檢測當前設置的環境變量相關的設置,如果您的設置無效,該命令將報錯。
配置文件加載
kong的可以通過參數 -c 或 -conf 指定加載配置文件信息,例如
kong start --conf /usr/local/kong/etc/kong.conf
或 kong start --c /usr/local/kong/etc/kong.conf
當然也可以通過kong start直接啟動kong,未指定參數-c 或 -conf指定配置信息,則默認按如下順序查加載配置文件信息。
/etc/kong/kong.conf
/etc/kong.conf
如果您想通過kong start 直接啟動加載默認配置,可以把配置信息放入以上目錄即可。
配置文件的格式很簡單:注釋由字符 # 定義。布爾值可以被指定為 on/off 或者true/false。
此外,您還可以在調試模式下使用CLI來更深入地了解Kong啟動的屬性:
$ kong start -c <kong.conf> --vv
2016/08/11 14:53:36 [verbose] no config file found at /etc/kong.conf2016/08/11 14:53:36 [verbose] no config file found at /etc/kong/kong.conf2016/08/11 14:53:36 [debug] admin_listen = "0.0.0.0:8001"2016/08/11 14:53:36 [debug] database = "postgres"2016/08/11 14:53:36 [debug] log_level = "notice"
[...]
環境變量
Kong在加載配置文件中相關屬性內容時,Kong會通過在環境變量中尋找同名的屬性配置信息。這就意味著可以完全通過環境變量配置Kong。
示例如下:
要想使用環境變量覆蓋Kong配置文件配置信息,首先要在環境變量中聲明一個以KONG_開頭的同名變量配置。
例如Kong的配置文件kong.conf的其中一個屬性配置如下:
log_levellog_levellog_level = debug
我們通過通過在環境變量中配置KONG_LOG_LEVEL的值來覆蓋上面的log_level的配置信息,如下:
export KONG_LOG_LEVEL=error