在当今的软件开发中，API 网关已成为微服务架构中不可或缺的一环。它不仅简化了服务间的通信、提供了统一的入口，还能在安全、监控、限流等方面发挥巨大作用。
今天，我们就来聊聊如何通过 Docker 快速部署 KONG —— 一个流行的开源 API 网关。
KONG 简介
KONG 是基于 Nginx 和 OpenResty （Nginx + Lua）的云原生、高性能、可扩展的微服务 API 网关。它以插件形式提供丰富的功能，包括但不限于：
身份认证（如 JWT、basic-auth）
安全性（如 IP 黑白名单）
监控
流量控制
KONG 与 Nginx 和 OpenResty 的关系
为了更好地理解 KONG，我们首先要明白它与 Nginx、OpenResty 的关系：
Nginx：是一个高性能的 HTTP 服务器和反向代理，以及一个 IMAP/POP3 代理服务器。
OpenResty：是在 Nginx 上集成了 Lua-nginx-module，允许使用 Lua 脚本语言扩展 Nginx 的能力。
KONG：则是在 OpenResty 基础上，加入了自定义框架和一系列企业级功能实现的 API 网关。
Docker 安装 KONG
安装 KONG 的一种便捷方式是使用 Docker。下面，我们将详细介绍如何通过 Docker 进行安装。
步骤 1：创建容器网络
首先创建一个 Docker 网络，以便容器间可以互相通信。
docker network create kong-net
复制代码
步骤 2：搭建数据库
KONG 支持 Cassandra 和 PostgreSQL 数据库。这里，我们以 PostgreSQL 为例。
# 创建一个数据卷docker volume create kong-volume# 查看所有的数据卷docker volume ls
docker run -d --name kong-database \--network=kong-net \-p 5432:5432 \-e "POSTGRES_USER=konguser" \-e "POSTGRES_DB=kong" \-e "POSTGRES_PASSWORD=kongpwd" \# 挂载卷以便持久化数据到宿主机-v kong-volume:/var/lib/postgresql/data \postgres:9.6
复制代码
步骤 3：数据库初始化
使用 docker run --rm 来初始化数据库，该命令执行后会退出容器而保留内部的数据卷。并且，要注意：一定要跟你声明的网络、数据库类型、host 名称一致。
docker run --rm --network=kong-net \# 如果使用的是 Cassandra 时，则需要设定为 cassandra 我这里使用的是 PostgreSQL 因此则设定为 postgres-e "KONG_DATABASE=postgres" \-e "KONG_PG_HOST=kong-database" \-e "KONG_PG_USER=konguser" \-e "KONG_PG_PASSWORD=kongpwd" \# 企业版才会用到这个配置，非企业版设定此参数也无所谓-e "KONG_PASSWORD=test" \kong/kong-gateway:3.4.1.1 kong migrations bootstrap
复制代码
步骤 4：启动 KONG
一切准备就绪后，我们可以启动 KONG 容器了。
docker run -d --name kong-gateway \--network=kong-net \-e "KONG_DATABASE=postgres" \-e "KONG_PG_HOST=kong-database" \-e "KONG_PG_USER=konguser" \-e "KONG_PG_PASSWORD=kongpwd" \-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" \-e "KONG_ADMIN_GUI_URL=http://localhost:8002" \# 仅仅企业版需要设定证书-e KONG_LICENSE_DATA \-p 8000:8000 \-p 8443:8443 \-p 8001:8001 \-p 8444:8444 \-p 8002:8002 \-p 8445:8445 \-p 8003:8003 \-p 8004:8004 \kong/kong-gateway:3.4.1.1
复制代码
步骤 5：检查 KONG 是否运行正常
最后，我们来检查 KONG 是否成功运行。
curl -i -X GET --url http://{YOUR_SERVER_IP}:8001/services
# 你也可以通过浏览器访问以下地址查看 KONG 管理界面http://{YOUR_SERVER_IP}:8002
复制代码
至此，你已经成功地在 Docker 上部署了 KONG。
安装 Konga
Konga 是一个开源的 KONG 管理界面，可以帮助我们更方便地管理和监控 KONG。
# 拉取最新版本的 Kongadocker pull pantsel/konga
复制代码
通过以下命令预装 Konga 所需的数据库：
# 这里的 172.18.0.2 要是 kong-database 容器的 IP 地址# konguser 和 kongpwd 是前面安装 PostgreSQL 是用到的账号和密码，konga 数据库专门为 Konga 设定（执行这条命令时，如果 konga 数据库不存在，则会自动创建）docker run --rm pantsel/konga \--network=kong-net \-c prepare \-a postgres \-u postgresql://konguser:kongpwd@172.18.0.2:5432/konga
复制代码
安装 Konga：
docker run -d --name konga \-p 1337:1337 \--network kong-net \-e "NODE_ENV=production" \-e "DB_ADAPTER=postgres" \-e "DB_HOST=kong-database" \-e "DB_PORT=5432" \-e "DB_USER=konguser" \-e "DB_PASSWORD=kongpwd" \-e "DB_DATABASE=konga" \pantsel/konga
复制代码
可以通过浏览器访问 http://{YOUR_SERVER_IP}:1337 来检测安装是否成功。第一次访问时，需要注册管理员账号，通过注册之后，然后在 CONNECTIONS 中添加 Kong 服务的管理路径 http://kong-gateway:8001 （因为这几个容器都连接了 kong-net 网络，因此这里可以通过容器名称作为 IP 地址，亦即这里的 kong-gateway） 即可管理 Kong。
如果需要清除所有容器时
docker kill kong-gatewaydocker kill kong-databasedocker kill kongadocker container rm kong-gatewaydocker container rm kong-databasedocker container rm kongadocker network rm kong-netdocker volume rm kong-volume
复制代码
通过本文的步骤，你应该能够成功地在 Docker 中安装和运行 KONG API 网关以及 Konga 管理界面。KONG 提供了强大的 API 管理功能，而 Konga 则提供了一个用户友好的界面来管理 KONG 的各个方面。
希望这篇文章能帮助你快速入门 KONG，赶快动手试试吧！
评论