通过Docker方式部署Kong

感谢Docker。在没有Docker 面世前，微服务三大件（网关、队列、内存）一直是困扰并让我神往的技术流。技术总归是技术，组件总归是组件。掌握并学习好不是一件困难的事情，最困难的反而都是这些组件的部署安装。

如果想要的是官方安装文档，点击即可跳转

1.创建docker 共享网络
由于kong 需要依赖三方数据库作为存储支持，所以在安装Kong前需要先配置本地数据库。目前Kong支持Cassandra和PostgreSQL两种数据库，通常来讲选用PostgreSQL关系型数据库更估。为了保证Kong以及PostgreSQL网络共享，我们需要先创建一个共享网络。

docker network create kong-net

2.创建PostgreSQL 数据库

docker run -d --name pgsql \
               --network=kong-net \
               -p 5432:5432 \
               -v $HOME/kong/db:/var/lib/postgresql/data \
               -e "POSTGRES_USER=root" \
               -e "POSTGRES_DB=kong" \
               -e "POSTGRES_PASSWORD=qwer1234" \
               postgres:9.6

3.初始化数据库环境

docker run --rm \
     --network=kong-net \
     -e "KONG_DATABASE=postgres" \
     -e "KONG_PG_HOST=pgsql" \
     -e "KONG_PG_USER=root" \
     -e "KONG_PG_PASSWORD=qwer1234" \
     kong:latest kong migrations bootstrap

4.配置kong.yml 文件
创建文件kong.yml，路径如下：$HOME/kong/config/kong.yml。

_format_version: "1.1"
services:
- name: admin-api
  url: http://127.0.0.1:8001
  routes:
    - paths:
      - /admin-api
  plugins:
  - name: key-auth
consumers:
- username: admin
  keyauth_credentials:
  - key: secret

说明：

• 这里采用了Key Authentiaction，设置key为secret，实际使用时需要将该key设置为复杂难以猜测的字符串。
• 另外为了安全起见，实际使用中运行Kong的服务器不要对外开启8001端口，所有访问Kong的流量都通过8000进来。

5.导入Kong配置：

docker run --rm \
    --network=kong-net \
    -e "KONG_DATABASE=postgres" \
    -e "KONG_PG_HOST=pgsql" \
    -e "KONG_PG_USER=root" \
    -e "KONG_PG_PASSWORD=qwer1234" \
    -v $HOME/kong/config:/home/kong \
    kong:latest kong config db_import /home/kong/kong.yml

6.启动kong

docker run -d --name kong \
     --network=kong-net \
     -e "KONG_DATABASE=postgres" \
     -e "KONG_PG_HOST=pgsql" \
     -e "KONG_PG_USER=root" \
     -e "KONG_PG_PASSWORD=qwer1234" \
     -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 127.0.0.1:8001:8001 \
     -p 127.0.0.1:8444:8444 \
     kong:latest

7.进行本地检验

http://localhost:8001
http://localhost:8000/admin-api?apikey=secret
http://本机IP地址:8000/admin-api?apikey=secret
注：在调用Kong API 时，需要用本机真实IP ，有部分API 是不能使用localhost 或者127.0.0.1
Mac 获取IP可使用命令：ipconfig getifaddr en0
Window 的命令：ipconfig