上QQ阅读APP看书,第一时间看更新
1.4 Kong网关安装指南
在本节中,笔者会带大家一起安装Kong网关。这里提供在Mac、Linux和Docker三种环境中Kong网关的安装指南,读者可以选择适合自己的环境进行安装。
1.4.1 在Mac环境中安装Kong网关
对于Mac环境,我们选用Homebrew工具安装。首先安装Homebrew(如已安装,请忽略),过程如下所示:
# 安装Homebrew,如果已经安装请忽略 $ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)" $ brew tap kong/kong $ brew install kong
安装完成后,我们还需要准备两个配置文件,一个是启动项配置文件。用户可以从https://raw.githubusercontent.com/Kong/kong/master/kong.conf.default下载配置模块,并更改配置文件名为kong.conf。修改kong.conf配置文件内容如代码清单1-1所示。
代码清单1-1 kong.conf配置文件
726 ... 727 database = off 728 ... 908 ... 909 declarative_config = /pwd/to/kong.yml # 根据kong.yml文件的位置填写绝对路径 910 ...
另一个是kong.yml文件,需要使用kong config init命令生成。该配置文件内容可以为空,但文件本身不可缺失。当一切准备就绪后,使用kong start-c kong.conf命令启动Kong服务,在浏览器中输入http://127.0.0.1:8001可以查看服务是否启动成功,效果如图1-9所示。
图1-9 Kong服务启动页面
1.4.2 在Linux环境中安装Kong网关
对于Linux环境,我们选用rpm包安装,命令如下:
$ wget https://bintray.com/kong/kong-rpm/download_file? file_path=centos/7/kong-2.0.5.el7.amd64.rpm $ rpm -ivh kong-2.0.5.el7.amd64.rpm
安装完成后,我们可以效仿在Mac环境中的启动流程继续操作,验证步骤也类似。
1.4.3 在Docker环境中安装Kong网关
Docker可以跨系统运行,非常适合企业在前期资源不足的情况下搭建环境。如果读者之前没有使用过Docker,可以根据附录A安装。已经安装过Docker软件的读者可根据代码清单1-2安装Kong网关。
程序清单1-2 安装Kong网关
$ docker network create kong-net $ docker run -d --name kong-database \ --network=kong-net \ -p 5432:5432 \ -e "POSTGRES_USER=kong" \ -e "POSTGRES_DB=kong" \ -e "POSTGRES_PASSWORD=kong" \ postgres:9.6 $ docker run --rm \ --network=kong-net \ -e "KONG_DATABASE=postgres" \ -e "KONG_PG_HOST=kong-database" \ -e "KONG_PG_USER=kong" \ -e "KONG_PG_PASSWORD=kong" \ -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \ kong:2.0.5 kong migrations bootstrap $ docker run -d --name kong \ --network=kong-net \ -e "KONG_DATABASE=postgres" \ -e "KONG_PG_HOST=kong-database" \ -e "KONG_PG_USER=kong" \ -e "KONG_PG_PASSWORD=kong" \ -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:2.0.5
安装完成后,我们使用相同方法进行验证。