感谢Docker。在没有Docker 面世前,微服务三大件(网关、队列、内存)一直是困扰并让我神往的技术流。技术总归是技术,组件总归是组件。掌握并学习好不是一件困难的事情,最困难的反而都是这些组件的部署安装。
如果想要的是官方安装文档,点击即可跳转
1.创建docker 共享网络
由于kong 需要依赖三方数据库作为存储支持,所以在安装Kong前需要先配置本地数据库。目前Kong支持Cassandra和PostgreSQL两种数据库,通常来讲选用PostgreSQL关系型数据库更估。为了保证Kong以及PostgreSQL网络共享,我们需要先创建一个共享网络。
docker network create kong-net
2.创建PostgreSQL 数据库
docker run -d --name pgsql \
--network=kong-net \
-p 5432:5432 \
-v $HOME/kong/db:/var/lib/postgresql/data \
-e "POSTGRES_USER=root" \
-e "POSTGRES_DB=kong" \
-e "POSTGRES_PASSWORD=qwer1234" \
postgres:9.6
3.初始化数据库环境
docker run --rm \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=pgsql" \
-e "KONG_PG_USER=root" \
-e "KONG_PG_PASSWORD=qwer1234" \
kong:latest kong migrations bootstrap
4.配置kong.yml 文件
创建文件kong.yml,路径如下:$HOME/kong/config/kong.yml。
_format_version: "1.1"
services:
- name: admin-api
url: http://127.0.0.1:8001
routes:
- paths:
- /admin-api
plugins:
- name: key-auth
consumers:
- username: admin
keyauth_credentials:
- key: secret
说明:
- 这里采用了Key Authentiaction,设置
key
为secret
,实际使用时需要将该key设置为复杂难以猜测的字符串。 - 另外为了安全起见,实际使用中运行Kong的服务器不要对外开启8001端口,所有访问Kong的流量都通过8000进来。
5.导入Kong配置:
docker run --rm \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=pgsql" \
-e "KONG_PG_USER=root" \
-e "KONG_PG_PASSWORD=qwer1234" \
-v $HOME/kong/config:/home/kong \
kong:latest kong config db_import /home/kong/kong.yml
6.启动kong
docker run -d --name kong \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=pgsql" \
-e "KONG_PG_USER=root" \
-e "KONG_PG_PASSWORD=qwer1234" \
-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, 0.0.0.0:8444 ssl" \
-p 8000:8000 \
-p 8443:8443 \
-p 127.0.0.1:8001:8001 \
-p 127.0.0.1:8444:8444 \
kong:latest
7.进行本地检验
http://localhost:8001
http://localhost:8000/admin-api?apikey=secret
http://本机IP地址:8000/admin-api?apikey=secret
注:在调用Kong API 时,需要用本机真实IP ,有部分API 是不能使用localhost 或者127.0.0.1
Mac 获取IP可使用命令:ipconfig getifaddr en0
Window 的命令:ipconfig