云原生网关 Kong 和Kong 管理UI 的彻底安装攻略

1. 前言

上一文咱们对Kong网关的简单介绍，今天咱们来搭建Kong的环境。以便于之后对Kong的进一步了解和学习。

2. Kong支持的环境

从上图来看Kong对Linux、MacOS、容器、云 支持的仍是比较全面的。鉴于大部分国内开发者使用的是Windows环境。本文依然使用Docker进行安装。建议对Docker不太了解的同窗学习相关的知识。也能够关注个人公众号：Felordcn 来及时获取相关的知识。

3. 安装Kong

你的机器中必须有Docker环境，这个是前提。假设你已经具有了必须的环境。Kong的安装其实仍是不复杂的，有些文章可能介绍的不是那么清楚。Kong 安装有两种方式一种是没有数据库依赖的DB-less 模式，另外一种是with a Database 模式。咱们这里使用第二种带Database的模式，由于这种模式功能更全。

3.1 构建Kong的容器网络

首先咱们建立一个Docker自定义网络，以容许容器相互发现和通讯。在下面的建立命令中kong-net是咱们建立的Docker网络名称，固然你可使用你认为合适的名称。

docker network create kong-net

3.2 搭建数据库环境

Kong 目前使用Cassandra(Facebook开源的分布式的NoSQL数据库) 或者PostgreSql,你能够执行如下命令中的一个来选择你的Database。请注意定义网络 --network=kong-net 。

• Cassandra容器：

docker run -d --name kong-database \
           --network=kong-net \
           -p 9042:9042 \
           cassandra:3

• PostgreSQL容器：

docker run -d --name kong-database \
           --network=kong-net \
           -p 5432:5432 \
           -e "POSTGRES_USER=kong" \
           -e "POSTGRES_DB=kong" \
           postgres:9.6

这里有个小问题。若是你使用的是PostgreSQL，想挂载卷持久化数据到宿主机。经过 -v 命令是很差用的。这里推荐你使用 docker volume create 命令来建立一个挂载。若是你想知道更多可关注个人公众号：Felordcn 或者经过https://felord.cn 来获取更多信息。

docker volume create kong-volume

而后上面的PostgreSQL就能够经过 - v kong-volume:/var/lib/postgresql/data 进行挂载了。

docker run -d --name kong-database \
           --network=kong-net \
           -p 5432:5432 \
           - v kong-volume:/var/lib/postgresql/data
           -e "POSTGRES_USER=kong" \
           -e "POSTGRES_DB=kong" \
           postgres:9.6

3.3 初始化或者迁移数据库

咱们使用docker run --rm来初始化数据库，该命令执行后会退出容器而保留内部的数据卷（volume）。

docker run --rm \
 --network=kong-net \
 -e "KONG_DATABASE=postgres" \
 -e "KONG_PG_HOST=kong-database" \
 -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
 kong:latest kong migrations bootstrap

这个命令咱们仍是要注意的，必定要跟你声明的网络，数据库类型、host名称一致。同时注意Kong的版本号，本文是在Kong 1.3 版本下完成的。

3.4 启动Kong容器

3.3步骤完成初始化或者迁移数据库后，咱们就能够启动一个链接到数据库容器的Kong容器，请务必保证你的数据库容器启动状态，同时检查全部的环境参数 -e 是不是你定义的环境。

docker run -d --name kong \
 --network=kong-net \
 -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, 0.0.0.0:8444 ssl" \
 -p 8000:8000 \
 -p 8443:8443 \
 -p 8001:8001 \
 -p 8444:8444 \
 kong:latest

3.5 验证

可经过 curl -i http://localhost:8001/ 或者浏览器调用 http://localhost:8001/ 来验证Kong Admin 是否联通 。

4. 安装Kong 管理UI

Kong 企业版提供了管理UI，开源版本是没有的。可是有不少的开源的管理 UI ，其中比较好用的是Konga。项目地址：https://github.com/pantsel/konga

4.1 Konga 特性

Konga 主要是用 AngularJS 写的，运行于nodejs服务端。具备如下特性：

• 管理全部Kong Admin API对象。
• 支持从远程源（数据库，文件，API等）导入使用者。
• 管理多个Kong节点。使用快照备份，还原和迁移Kong节点。
• 使用运行情况检查监视节点和API状态。
• 支持电子邮件和闲置通知。
• 支持多用户。
• 易于数据库集成（MySQL，postgresSQL，MongoDB，SQL Server）。

4.2 docker安装Konga

一样咱们今天经过Docker来安装Konga。安装步骤一样遵循配置数据库，初始化数据库，启动容器的流程。

4.2.1 Konga数据库容器

上面在4.1特性介绍中咱们介绍了Konga支持的数据库类型。这里咱们依然使用PostgreSQL。请注意我新定义了挂载卷konga-postgresql 。

docker run -d --name konga-database  \ 
                    --network=kong-net  \
                    -p 5433:5432 \
                    -v  konga-postgresql:/var/lib/postgresql/data  \
                    -e "POSTGRES_USER=konga"  \
                    -e "POSTGRES_DB=konga" \
                    -e "POSTGRES_PASSWORD=konga"  \
                    postgres:9.6

4.2.2 初始化Konga数据库

初始化 PostgreSQL 数据库。

docker run --rm  --network=kong-net  \
                       pantsel/konga:latest 
                       -c prepare 
                       -a postgres
                       -u postgres://konga@konga-database:5432/konga

相关命令解读：

命令	描述	默认
-c	执行的命令，这里咱们执行的是prepare	-
-a	adapter 简写 ，能够是postgres 或者mysql	-
-u	db url 数据库链接全称	-

到此Konga的数据库环境就搞定了。

4.2.3 环境参数

Konga 还有一些可配置的环境参数：

4.2.4 启动Konga

经过如下命令就能够启动Konga容器了

docker run -d -p 1337:1337  \
               --network kong-net  \
               -e "DB_ADAPTER=postgres"  \
               -e "DB_URI=postgres://konga@konga-database:5432/konga"  \
               -e "NODE_ENV=production"  \
               -e "DB_PASSWORD=konga" \
               --name konga \
               pantsel/konga

运行完后，若是成功能够经过http://localhost:1337 连接到控制台。经过注册后进入，而后在dashboard面板里面添加Kong的管理Api路径http://yourdomain 。这里添加 http://ip:8001 。注意请不要使用localhost、127.0.0.1 、0.0.0.0 有可能联通不上Kong。成功后就会出现 上面4. 所显现的界面。

总结

今天对Kong的安装、Konga的安装进行了详细的介绍。但愿对你进一步了解和学习Kong有所帮助。

关注公众号：码农小胖哥 获取更多资讯