依賴
- gcc
- pcre
- zlib
- openssl
- postgresql9.4+
gcc 安裝
安裝 gcc 編譯環(huán)境:
sudo yum install -y pcre pcre-devel
pcre 安裝
pcre(Perl Compatible Regular Expressions) 是一個(gè) Perl 庫(kù),包括 perl 兼容的正則表達(dá)式,nginx 的 http 庫(kù)使用 pcre 解析正則表達(dá)式。
sudo yum install -y pcre pcre-devel
zlib 安裝
zlib 庫(kù)提供多種壓縮和加壓縮的方式。
sudo yum install -y zlib zlib-devel
openssl 安裝
openssl 是一個(gè)請(qǐng)打的安全套接字層密碼庫(kù),囊括主要的密碼算法、常用的密鑰和證書封裝管理功能及 SSL 協(xié)議。
sudo yum install -y openssl openssl-devel
postgresql 安裝
PostgreSQL是完全由社區(qū)驅(qū)動(dòng)的開源項(xiàng)目,由全世界超過(guò)1000名貢獻(xiàn)者所維護(hù)。它提供了單個(gè)完整功能的版本。可靠性是PostgreSQL的最高優(yōu)先級(jí)。Kong 默認(rèn)使用 postgresql 作為數(shù)據(jù)庫(kù)。
// 添加 rpm
sudo yum install -y https://download.postgresql.org/pub/repos/yum/9.5/redhat/rhel-7-x86_64/pgdg-centos95-9.5-2.noarch.rpm
// 安裝 postgresql 9.5
sudo yum install -y postgresql95-server postgresql95-contrib
// 初始化數(shù)據(jù)庫(kù)
sudo /usr/pgsql-9.5/bin/postgresql95-setup initdb
// 設(shè)置成 centos7 開機(jī)啟動(dòng)服務(wù)
sudo systemctl enable postgresql-9.5.service
// 啟動(dòng) postgresql 服務(wù)
sudo systemctl start postgresql-9.5.service
// 查看 postgresql 狀態(tài)
suso systemctl status postgresql-9.5.service
配置 Postgresql
執(zhí)行完初始化任務(wù)之后,postgresql 會(huì)自動(dòng)創(chuàng)建和生成兩個(gè)用戶和一個(gè)數(shù)據(jù)庫(kù):
linux 系統(tǒng)用戶 postgres:管理數(shù)據(jù)庫(kù)的系統(tǒng)用戶;
postgresql 用戶 postgres:數(shù)據(jù)庫(kù)超級(jí)管理員;
數(shù)據(jù)庫(kù) postgres:用戶 postgres 的默認(rèn)數(shù)據(jù)庫(kù)。
密碼由于是默認(rèn)生成的,需要在系統(tǒng)中修改一下。
sudo passwd postgres
為了安全以及滿足 Kong 初始化的需求,需要在建立一個(gè) postgre 用戶 kong 和對(duì)應(yīng)的 linux 用戶 kong,并新建數(shù)據(jù)庫(kù) kong。
// 新建 linux kong 用戶
sudo adduser kong
// 使用管理員賬號(hào)登錄 psql 創(chuàng)建用戶和數(shù)據(jù)庫(kù)
// 切換 postgres 用戶
// 切換 postgres 用戶后,提示符變成 `-bash-4.2$`
su postgres
// 進(jìn)入 psql 控制臺(tái)
psql
// 此時(shí)會(huì)進(jìn)入到控制臺(tái)(系統(tǒng)提示符變?yōu)?postgres=#')
// 先為管理員用戶postgres修改密碼
\password postgres
// 建立新的數(shù)據(jù)庫(kù)用戶(和之前建立的系統(tǒng)用戶要重名)
create user kong with password '123456';
// 為新用戶建立數(shù)據(jù)庫(kù)
create database kong owner kong;
// 把新建的數(shù)據(jù)庫(kù)權(quán)限賦予 kong
grant all privileges on database kong to kong;
// 退出控制臺(tái)
\q
在 psql 控制臺(tái)下執(zhí)行命令,一定記得在命令后添加分號(hào)。
登錄命令為:
psql -U kong -d kong -h 127.0.0.1 -p 5432
在 work 或者 root 賬戶下登錄 postgresql 數(shù)據(jù)庫(kù)會(huì)提示權(quán)限問(wèn)題。
認(rèn)證權(quán)限配置文件為 /var/lib/pgsql/9.5/data/pg_hba.conf
常見的四種身份驗(yàn)證為:
trust:凡是連接到服務(wù)器的,都是可信任的。只需要提供psql用戶名,可以沒有對(duì)應(yīng)的操作系統(tǒng)同名用戶;
password 和 md5:對(duì)于外部訪問(wèn),需要提供 psql 用戶名和密碼。對(duì)于本地連接,提供 psql 用戶名密碼之外,還需要有操作系統(tǒng)訪問(wèn)權(quán)。(用操作系統(tǒng)同名用戶驗(yàn)證)password 和 md5 的區(qū)別就是外部訪問(wèn)時(shí)傳輸?shù)拿艽a是否用 md5 加密;
ident:對(duì)于外部訪問(wèn),從 ident 服務(wù)器獲得客戶端操作系統(tǒng)用戶名,然后把操作系統(tǒng)作為數(shù)據(jù)庫(kù)用戶名進(jìn)行登錄對(duì)于本地連接,實(shí)際上使用了peer;
peer:通過(guò)客戶端操作系統(tǒng)內(nèi)核來(lái)獲取當(dāng)前系統(tǒng)登錄的用戶名,并作為psql用戶名進(jìn)行登錄。
psql 用戶必須有同名的操作系統(tǒng)用戶名。并且必須以與 psql 同名用戶登錄 linux 才可以登錄 psql 。想用其他用戶(例如 root )登錄 psql,修改本地認(rèn)證方式為 trust 或者 password 即可。
# IPv4 local connections:
host all all 127.0.0.1/32 trust
host all all 0.0.0.0/0 trust
pgsql 默認(rèn)只能通過(guò)本地訪問(wèn),需要開啟遠(yuǎn)程訪問(wèn)。
修改配置文件 var/lib/pgsql/9.5/data/postgresql.conf
,將 listen_address
設(shè)置為 '*'。
#------------------------------------------------------------------------------
# CONNECTIONS AND AUTHENTICATION
#------------------------------------------------------------------------------
# - Connection Settings -
listen_addresses = '*' # what IP address(es) to listen on;
執(zhí)行 sudo systemctl restart postgresql-9.5.service
重啟 postgresql。
kong 安裝
在 kong 安裝這一塊,費(fèi)了很大神,參照官方的安裝方法[https://getkong.org/install/centos/](kong install)最初始終不成功,提示 Error unpacking rpm package kong-0.10.3-1.noarch
。最后不得已在 kong 發(fā)布的版本庫(kù)kong releases中選擇了 kong-0.10.2.el7.noarch.rpm 進(jìn)行安裝。
但后來(lái)更換機(jī)器的情況下得以正常安裝官網(wǎng)步驟安裝。
sudo yum install epel-release
sudo yum install kong-0.10.3.*.noarch.rpm --nogpgcheck
如果出現(xiàn)如下信息表示安裝成功:
下面修改 kong 的配置文件,默認(rèn)配置文件位于 /etc/kong/kong.conf.default
sudo cp /etc/kong/kong.conf.default /etc/kong/kong.conf
將之前安裝配置好的 postgresql 信息填入 kong 配置文件中:
sudo vi /etc/kong/kong.conf
#------------------------------------------------------------------------------
# DATASTORE
#------------------------------------------------------------------------------
# Kong will store all of its data (such as APIs, consumers and plugins) in
# either Cassandra or PostgreSQL.
#
# All Kong nodes belonging to the same cluster must connect themselves to the
# same database.
database = postgres # Determines which of PostgreSQL or Cassandra
# this node will use as its datastore.
# Accepted values are `postgres` and
# `cassandra`.
pg_host = 127.0.0.1 # The PostgreSQL host to connect to.
pg_port = 5432 # The port to connect to.
pg_user = kong # The username to authenticate if required.
pg_password = 123456 # The password to authenticate if required.
pg_database = kong # The database name to connect to.
ssl = off # 如果不希望開放 8443 的 ssl 訪問(wèn)可關(guān)閉
默認(rèn)情況下,kong 并沒有添加到 $PATH 環(huán)境變量中,所以直接 kong start 并不能生效,利用 whereis kong
查看 kong 的命令路徑:
執(zhí)行
/usr/local/bin/kong start
啟動(dòng)空,此時(shí)報(bào)如下問(wèn)題:通過(guò)命令
export KONG_SERF_PATH="/usr/local/bin/serf"
經(jīng) serf 暴露給 kong 以順利啟動(dòng)。至此,再次啟動(dòng) kong
如果啟動(dòng)過(guò)程中,碰到提示 FATAL: Ident authentication failed for user "kong" 的問(wèn)題,請(qǐng)確認(rèn)在配置 postgresql 的認(rèn)證文件時(shí),采用了 password 或者 trust 連接方式。
轉(zhuǎn)載整理自
[1]: centos 6.5 安裝kong
[2]: psql 認(rèn)證失敗
[3]: kong 安裝配置
[4]: postgresql 9.5 安裝
[5]: kong rpm 安裝錯(cuò)誤
[6]: kong 啟動(dòng)錯(cuò)誤