云原生网关-Kong-和Kong-管理UI-的完全安装攻略

jiezi

5 年前

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

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

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

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

 docker network create kong-net

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

我们使用 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.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

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

## 4. 安装 Kong 管理 UI

Kong 企业版提供了管理 UI，开源版本是没有的。但是有很多的开源的管理 UI，其中比较好用的是 Konga。项目地址：https://github.com/pantsel/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

初始化 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 数据库连接全称	–

云原生网关-Kong-和Kong-管理UI-的完全安装攻略

1. 前言

2. Kong 支持的环境

3. 安装 Kong

3.1 构建 Kong 的容器网络

3.2 搭建数据库环境

3.3 初始化或者迁移数据库

3.4 启动 Kong 容器

3.5 验证

4.1 Konga 特性

4.2.2 初始化 Konga 数据库

4.2.3 环境参数

4.2.4 启动 Konga

总结