安装外部数据库postgresql
我是采用的宝塔的postgresql管理器进行安装的,选择的是11.0版
安装好之后,分别添加数据库kong和数据库konga,设立用户名和密码
先设定数据库访问权限为“所有人”,这个在后面会说到
docker安装KONG
docker pull kong:2.1-ubuntu
先获取镜像,目前最新的镜像是kong2.1
获取完镜像后,先建立docker专用网络
docker network kong-net
初始化kong数据库
docker run --rm \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=172.17.0.1" \
-e "KONG_PG_PORT=5432" \
-e "KONG_PG_USER=kong" \
-e "KONG_PG_DATABASE=kong" \
-e "KONG_PG_PASSWORD={数据库密码}" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong" \
kong:2.1-ubuntu kong migrations bootstrap
kong官方文档里,都是采用的docker安装postgresql,然后通过kong-net自动发现,我尝试了,很多情况下,都会连接数据库失败。最根本的原因还是在初始化的时候,官方给的参数说明实际上并不完整和准确。
KONG_PG_HOST:代表数据库地址,这个不能使用官方文档范例里一样的容器名,要用IP。在使用外部数据库的时候,先用ifconfig命令,查看源主机对应docker的IP地址,如果源主机安装了docker后,使用ifconfig命令,会看到docker0的段落内容,里面就有ip_address。
KONG_PG_PORT:数据库端口号,官方以及网络上很多文档,都没有写这个参数,很多时候都会因为缺少这个参数导致连接不上数据库
KONG_CASSANDRA_CONTACT_POINTS:这个后面的值是数据库名,不像官方说明一样是容器名
执行完后,就可以正式创建kong的容器
docker run -d --name kong \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=172.17.0.1" \
-e "KONG_PG_PORT=5432" \
-e "KONG_PG_USER=kong" \
-e "KONG_PG_DATABASE=kong" \
-e "KONG_PG_PASSWORD={数据库密码}" \
-e "KONG_CASSANDRA_CONTACT_POINTS=kong" \
-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 8001:8001 \
-p 8444:8444 \
kong:2.1-ubuntu
在官方说明里,这一段同样缺少了部分参数,查了很多资料才填上这个坑。
至此,KONG的容器就创建好了。
使用命令 curl -i http://localhost:8001 试试看有没有内容输出,如果有很多Json内容输出就代表成功了。
docker安装KONGA
kong的社区版没有UI界面管理,都是命令行式的,不太方便,所以选用KONGA来进行Kong的管理。目前网络上用的比较多的是kong-dashboard,但是这个已经不支持最新版的kong,所以选用了新秀konga。
获取镜像
docker pull pantsel/konga:0.14.9
目前konga的最新版本为0.14.9
初始化数据库
docker run --rm --network=kong-net pantsel/konga:0.14.9 -c prepare -a postgres -u postgresql://{数据库密码}@172.17.0.1:5432/konga
这里的IP地址同上安装kong时的。
执行完后,创建konga容器
docker run --name konga \
--network=kong-net \
-e "DB_ADAPTER=postgres" \
-e "DB_HOST=172.17.0.1" \
-e "DB_PORT=5432" \
-e "DB_USER=konga" \
-e "DB_PASSWORD={数据库密码}" \
-e "DB_DATABASE=konga" \
-e "KONG_HOOK_TIMEOUT=120000" \
-e "NODE_ENV=production" \
-p 1337:1337 \
pantsel/konga:0.14.9
至此konga就安装好了。可以使用http://localhost:1337访问。konga里可以设置访问域名,替代这种带端口号的。我为了简单,使用了反向代理,达到一样的效果。
最后,因为之前设定的数据库的访问权限是所有人,为了安全,我们必须得更改一下这个权限。要变更权限,需要先知道容器的地址是什么,我们可以用如下命令来查看:
docker inspect kong
这个命令可以查看kong这个容器的所有相关信息。我们找到Netsworks段,里面有个之前设定的kong-net,在期间我们可以找到容器的IP地址。
其间的IPAddress就是容器地址。因为我们容器都使用了kong-net,所以所有容器都在一个网段,那么我们就可以设定数据库只开放给这一个网段