KongA 是 Kong 的一个 GUI 工具。GitHub 地址是 https://github.com/pantsel/konga 。
KongA 概述
KongA 带来的一个最大的便利就是可以很好地通过UI观察到现在 Kong 的所有的配置,并且可以对于管理 Kong 节点情况进行查看、监控和预警,KongA 主要特性如下:
- 多用户管理
- 管理多个 Kong 节点
- 电子邮件异常信息通知
- 管理所有Kong Admin API
- 使用快照备份,还原和迁移Kong节点
- 使用运行状况检查监控节点和API状态
- 轻松的数据库集成(MySQL,postgresSQL,MongoDB)
KongA 当前最新版本是 v0.14.1(update:2019.01.28),KongA 从 v0.14.0 开始,只支持 Kong 大于 v1.0.0 的版本。如果 Kong 的版本低于 v1.0.0 ,需要使用 konga:legacy 分支去构建发布版本。
KongA 的使用依赖如下内容:
- 一个安装好,处于运行状态的 Kong
- Nodejs >= 8 (推荐使用 8.11.3 LTS 版本)
- Npm
KongA 的安装参考它在 GitHub 上的 Installation 即可。
如果使用 Docker 进行安装的话,使用 Kong 创建的 Docker 网络,启动命令如下:
docker run -p 1337:1337 \
--network kong-net \
--name konga \
-e "NODE_ENV=production" \
pantsel/konga:0.14.1
启动后访问 1337 端口 即可访问 KongA 首页,并且可以注册自己的 KongA 账号。
这样启动的 KongA 可以快速使用,但是如果重新部署数据就丢失了,KongA 和 Kong 一样都可以使用外部数据库来做到数据持久化存储。在启动 KongA 的时候连接数据库,并且设置好数据库连接参数。
KongA 基本使用
创建用户
启动 KongA 以后,首先注册账户,如图所示:
添加 Kong
在 KongA 里需要先添加 Kong 才能使用。
KongA 左侧的菜单栏分为两大类,分别是 API GATEWAY 和 APPLICATION。在 APPLICATION 下有一个 CONNECTIONS 选项,在这个选项里新建一个 Kong 的连接,点击NEW CONNECTION
后选择认证类型,认证类型可以选择DEFAULT、KEY AUTH、JWT AUTH ,如果选择 DEFAULT 填入如下信息:
- NAME :Kong 的名称,用来标识不同的 Kong。
- KONG ADMIN URL :填入 Kong 的 admin url,用来连接 Kong。
填好以后点击 CREATE CONNECTION
来创建 Kong。
KongA 的配置。
KongA 连接好 Kong 以后,剩下的就是管理 Kong 了,主要需要配置 Services 、Routes、Upstream 三个部分。
Services 主要是配置 upstream 的地址,
Routes 主要配置请求到来之后不同的 path 路径按照不同的路由转发
Upstream 主要配置 url 的代理最后转发到的机器上,可以是一个,也可以是多个按照权重进行分配。除了转发以为,还可以配置健康检查。
小结
本文主要讲解了 KongA 的简单使用。