网关神器Kong（二）：安装

谁践踏了优雅 2023-01-17 09:26 163阅读 0赞

# 物联网网关神器 Kong（ 二 ） #

上一篇我们已经已经了解了什么是 Kong，本篇就来带领大家了解如何安装 Kong。 接下来我们将使用 Docker 安装。如果你有其他的特殊要求，请参照 [官方文档][Link 1] 。

## Docker 安装 Kong。 ##

首先，你想安装它，就要有 Docker。如果你没有或者不知道什么是Docker，请点击[传送门][Link 2]

### 一、获取镜像 ###

获取 Kong 的docker 镜像

docker pull kong

查看 Docker 镜像

docker images

![img.png][]

### 二、创建网络 ###

需要创建同一个网络用以后面数据库与 Kong 的通信。

docker network create kong-net

![img\_1.png][img_1.png]

### 三、创建数据库 ###

我们将使用 PostgreSQL 来用作 Kong 的配置存储。

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

![img\_4.png][img_4.png]

接下来查看容器状态

docker ps

![img\_5.png][img_5.png]

现在可以看到 PostgreSQL 已经正常启动，并对外开放了 5432 端口。

### 四、初始化数据库结构 ###

我们需要为为刚创建的数据库进行初始化，生成 Kong 所需要的表结构和数据。

docker run --rm --network=kong-net \
      -e "KONG_DATABASE=postgres" \
      -e "KONG_PG_HOST=kong-db" \
      -e "KONG_PG_PASSWORD=kong" \
      -e "KONG_PASSWORD=kong123456" \
      kong kong migrations bootstrap

![img\_6.png][img_6.png]

> Tips: 如果你不理解下面的命令就看这一段。
> 
>     kong kong migrations bootstrap
> 
> 根据 docker run 的规范
> 
>     docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
> 
> 说明第一个 Kong 为容器名，第二个 Kong 为为命令 （ Command ） 后面的为参数。简单来说其流程就是：
> 
>  *  运行一个 Kong 容器。
>  *  进入该容器并执行 `kong migrations bootstrap`命令

### 五、启动 Kong 容器 ###

为了启动 Kong 容器，我们做了那么多的准备工作，现在终于开始运行起来了。

docker run -d --name kong --network=kong-net \
      -e "KONG_DATABASE=postgres" \
      -e "KONG_PG_HOST=kong-db" \
      -e "KONG_PG_PASSWORD=kong" \
      -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 80:8000 \
      -p 443:8443 \
      -p 8001:8001 \
      -p 8444:8444 \
      kong

![img\_7.png][img_7.png]

### 六、测试是否安装成功 ###

curl -i -X GET --url http://<DNSorIP>:8001/services

将 `<DNSorIP>`替换为你的 IP 或 DNS。

如果成功将返回 `HTTP/1.1 200 OK`

![img\_8.png][img_8.png]

## 常规配置 Kong ##

Kong 提供了 Http/Rest 接口，用来动态创建配置文件。

### 配置反向代理 ###

Kong 是基于 Nginx 的，所以它将会基于配置动态构建出 Nginx 的配置文件。

#### Nginx 配置文件 ####

upstream example{ 
        server localhost:8080 weight=100;
    }
    
    server{ 
        listen:80;
        location /hi { 
            proxy_pass http://example
        }
    }

#### 使用 Kong API 进行配置 ####

*  配置upstream
    
        curl -X POST http://<DNSorIP>:8001/upstreams --data "name=example"
    
    ![img\_12.png][img_12.png]
    
    > 相当于配置 Nginx 的 upstream 部分。
    > 
    >     upstream example{ 
    >        
    >     }
 *  配置target
    
        curl -X POST http://<DNSorIP>:8001/upstreams/example/targets --data "target=localhost:6023"  --data "weight=100"
    
    ![img\_13.png][img_13.png]
    
    > 相当于配置 Nginx 的 upstream 内的主机部分。
    > 
    >     upstream example{ 
    >        server localhost:8080 weight=100;
    >     }
 *  配置service
    
        curl -X POST http://<DNSorIP>:8001/services --data "name=hi"  --data "host=example"
    
    ![img\_14.png][img_14.png]
    
    > 相当于配置 Nginx 的 server。
    > 
    >     server{ 
    >       listen:80;
    >     
    >     }
 *  配置route
    
        curl -X POST http://<DNSorIP>:8001/routes --data "paths[]=/hi"  --data "service.id= < service_id >"
    
    >  *  service\_id 为上一步配置 service 时的返回的Id。
    
    ![img\_15.png][img_15.png]
    
    > 相当于配置 Nginx server 内的 location。
    > 
    >     server{ 
    >       listen:80;
    >       location /hi { 
    >           proxy_pass http://example
    >       }
    >     }
    >     ``

#### 访问服务进行测试 ####

我们之前已经运行起了一个 Docker 服务，将端口服务映射到 6023 端口。现在我们可以看到，我们的请求已经经过 Kong API 进行了反向代理到 6023 端口上。  
![img\_23.png][img_23.png]

## 总结 ##

本篇文章我们讲解了利用 Docker 来安装 Kong ，并利用 Kong 的 Rest API 进行了动态配置。让我们来仔细看着这些 API，是不是脑中灵光一显？对，我们可以将Rest API 动态配置的功能做成图形化界面。这样就可以更方便的配置了。 下一篇我们就会接着讲 Kong 的图形化管理界面 - Konga。

[Link 1]: https://konghq.com/install/
[Link 2]: https://www.docker.com/
[img.png]: /images/20221021/9aeefdf7b9f84ca4b4836355f88b7c98.png
[img_1.png]: /images/20221021/82a66ed3b48940eebba57af456e5916f.png
[img_4.png]: /images/20221021/5aba11fbe0754402b27290f9ac40ce11.png
[img_5.png]: /images/20221021/8f7737af8a9640608caeaa70917acbd2.png
[img_6.png]: /images/20221021/48bd3cc3ecec48c4a38fab43a50e20d5.png
[img_7.png]: /images/20221021/42d3022ea45e4c89b7eea8808ba37bc3.png
[img_8.png]: /images/20221021/4586c75661c94f25ac278d7a2af91754.png
[img_12.png]: /images/20221021/0e8daa34a7424738be48578d2e931dbe.png
[img_13.png]: /images/20221021/3d2979065293451fb2f7bc14568ffc5e.png
[img_14.png]: /images/20221021/39a21fc8c35f4e6eb39fa2b973b854a4.png
[img_15.png]: /images/20221021/7372dabb14a0436491379f9253c3998a.png
[img_23.png]: /images/20221021/ed388383580d43108186a1e3f97de6d4.png