共计 3520 个字符，预计需要花费 9 分钟才能阅读完成。
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-net3.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.63.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:latest3.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.64.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 有所帮助。
关注公众号：Felordcn 获取更多资讯