摘要
微服務(wù)架構(gòu),restful接口必然是分散的,如何統(tǒng)一這些分散的API對(duì)外提供統(tǒng)一的訪問(wèn)地址呢?Spring Cloud官方是spring cloud zuul,但是我們公司用的是kong,一開(kāi)始接觸到kong感到陌生,后來(lái)自己搭建了一次,覺(jué)得它就是個(gè)nginx。
kong api gateway的官方地址: https://getkong.org
docker命令行安裝步驟
- 安裝Kong的數(shù)據(jù)庫(kù)
sudo docker run -d --name kong-database \
-p 5432:5432 \
-e "POSTGRES_USER=kong" \
-e "POSTGRES_DB=kong" \
postgres:9.5
-e:設(shè)置容器的環(huán)境變量
- 準(zhǔn)備kong的數(shù)據(jù)庫(kù) ,這個(gè)命令會(huì)對(duì)數(shù)據(jù)庫(kù)進(jìn)行初始化
sudo docker run --rm \
--link kong-database:kong-database \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-database" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
kong:latest kong migrations up
--rm: 啟動(dòng)運(yùn)行命令就自動(dòng)刪除該容器
- 啟動(dòng)kong
sudo docker run -d --name kong \
--link kong-database:kong-database \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=kong-database" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
-e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
-e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
-e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_LISTEN=0.0.0.0:8001" \
-e "KONG_ADMIN_LISTEN_SSL=0.0.0.0:8444" \
-p 8000:8000 \
-p 8443:8443 \
-p 8001:8001 \
-p 8444:8444 \
kong:latest
- 安裝kong-dashboard
sudo docker run -d -p 8089:8080 -link kong pgbi/kong-dashboard start --kong-url http://kong:8001
瀏覽器訪問(wèn) http://<本機(jī)IP>:8089 即可。

rancher下的安裝步驟
1.點(diǎn)擊創(chuàng)建服務(wù)

2.將下面的docker-compose編排文件,保存到本地,命名為docker-compose.yml,然后在rancher中打開(kāi)即可。
version: '2'
services:
kong-database:
image: postgres:9.5
environment:
POSTGRES_DB: kong
POSTGRES_USER: kong
stdin_open: true
tty: true
ports:
- 5432:5432/tcp
labels:
io.rancher.container.pull_image: always
kong-dashboard:
image: pgbi/kong-dashboard
stdin_open: true
tty: true
links:
- kong:kong
ports:
- 8090:8080/tcp
command:
- start
- --kong-url
- http://kong:8001
labels:
io.rancher.container.pull_image: always
kong:
image: kong:latest
environment:
KONG_ADMIN_ACCESS_LOG: /dev/stdout
KONG_ADMIN_ERROR_LOG: /dev/stderr
KONG_ADMIN_LISTEN: 0.0.0.0:8001
KONG_ADMIN_LISTEN_SSL: 0.0.0.0:8444
KONG_CASSANDRA_CONTACT_POINTS: kong-database
KONG_DATABASE: postgres
KONG_PG_HOST: kong-database
KONG_PROXY_ACCESS_LOG: /dev/stdout
KONG_PROXY_ERROR_LOG: /dev/stderr
stdin_open: true
tty: true
links:
- kong-database:kong-database
ports:
- 8000:8000/tcp
- 8443:8443/tcp
- 8001:8001/tcp
- 8444:8444/tcp
labels:
io.rancher.container.pull_image: always
3.等待一會(huì),kong這個(gè)容器可能要重啟兩次,大約一分鐘就好,之后刪除kong-test,這個(gè)是為了初花數(shù)據(jù)庫(kù)用的。瀏覽器訪問(wèn)http://<本機(jī)IP>:8090.
kong的使用
nginx代理配置
由于kong本身就是一個(gè)nginx,但是它默認(rèn)監(jiān)聽(tīng)的端口是8090(這個(gè)8090是我自己映射的,容器默認(rèn)是8000,具體端口要看你自己怎么映射哦,你也可以直接映射到80,),并不是80,我們對(duì)外的時(shí)候不可能提供8090這個(gè)端口的,所以需要在物理機(jī)上再加一層nginx,把訪問(wèn)80端口的APi轉(zhuǎn)發(fā)到8090.nginx配置如下:
server {
listen 80;
server_name <你的域名>;
#ssl on;
access_log /var/log/nginx/kong_dashboard_access.log;
error_log /var/log/nginx/kong_dashboard_error.log;
location / {
proxy_connect_timeout 300s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
client_max_body_size 500m;
proxy_pass http://localhost:8090/;
proxy_set_header X-Real-IP $remote_addr; # pass on real client's IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
API的配置
kong要代理服務(wù),一種是通過(guò)域名或IP的方式代理多個(gè)服務(wù)。而當(dāng)前我們的服務(wù)是部署在docker容器上的,這時(shí)我們可以采用容器鏈接的方式。
kong:
image: kong:latest
environment:
KONG_ADMIN_ACCESS_LOG: /dev/stdout
KONG_ADMIN_ERROR_LOG: /dev/stderr
KONG_ADMIN_LISTEN: 0.0.0.0:8001
KONG_ADMIN_LISTEN_SSL: 0.0.0.0:8444
KONG_CASSANDRA_CONTACT_POINTS: kong-database
KONG_DATABASE: postgres
KONG_PG_HOST: kong-database
KONG_PROXY_ACCESS_LOG: /dev/stdout
KONG_PROXY_ERROR_LOG: /dev/stderr
stdin_open: true
tty: true
links:
- kong-database:kong-database
external_links:
- huijubao/staticWeb:staticweb
- huijubao/message:message
- huijubao/product:product
- huijubao/task:task
- huijubao/payment:payment
- huijubao/app:app
- huijubao/route:route
- huijubao/crm:crm
- huijubao/policy:policy
ports:
- 8000:8000/tcp
- 8443:8443/tcp
- 8001:8001/tcp
- 8444:8444/tcp
labels:
io.rancher.container.pull_image: always
添加了一系列的external_links容器鏈接。這些容器在rancher中的關(guān)系如下:

也可以選擇升級(jí)容器,如下圖:

api的配置如下:
