kong网关安装与启动

kong安装

kong介绍

kong安装

kong支持在多个环境下安装，这里就列出在ubuntu和docker下怎么安装，其他的安装的方式请参照官方指南

ubuntu

ubuntu下安装kong

• 离线安装

1. 下载对应版本的离线包
2. 安装依赖组件
   apt-get install openssl libpcre3 procps perl
3. 安装kong
   dpkg -i kong-1.4.2.*.deb

• apt-get方式在线安装

2. 安装依赖组件
   apt-get install -y apt-transport-https curl lsb-core
3. 添加仓库地址
   echo "deb https://kong.bintray.com/kong-deblsb_release -scmain" | sudo tee -a /etc/apt/sources.list
4. 下载bintray.key
   curl -o bintray.key https://bintray.com/user/downloadSubjectPublicKey?username=bintray
5. 添加bintray.key到本地trusted数据库
   apt-key add bintray.key
6. 再次更新apt库
   apt-get update
7. 安装kong
   apt-get install -y kong
8. 查看kong版本
   kong version

ubuntu下启动kong

• 不使用DB启动kong

1. 生成kong的配置文件kong.yml

mkdir -p /apps/kong
cd /apps/kong
kong config init

2. 修改配置

vim /apps/kong/kong.conf

# 添加以下内容
database = off
declarative_config = /apps/kong/kong.yml

3. 启动kong
   kong start -c /apps/kong/kong.conf
4. 测试kong是否启动成功
   curl -i http://localhost:8001/services
5. 效果如图所示：

• 使用DB启动Kong

kong支持PostgreSQL9.5+和Cassandra 3.x.x 作为他的数据库，这里我们以PostgreSQL为例：

1. 生成kong的配置文件kong.yml

mkdir -p /apps/kong
cd /apps/kong
kong config init

2. 准备数据库

# 创建用户
CREATE USER kong;

# 创建数据库并指定归属用户
CREATE DATABSE kong OWNER kong;

# 修改用户密码
ALTER USER kong WITH PASSWORD '123456';

3. 修改kong的配置，让kong能够连接上你的数据库，配置详情参考Kong官网

vim /apps/kong/kong.conf

#添加以下内容
declarative_config = /apps/kong/kong.yml

# 数据库连接配置
database = postgres
pg_host = 127.0.0.1
pg_port = 5432
pg_timeout = 5000
pg_user = kong
pg_password = 123456
pg_database = kong

3. 先执行数据迁移

## 如果你的kong版本>=0.15，请使用以下指令
kong migrations bootstrap -c /apps/kong/kong.conf

## 如果你的kong版本<0.15，请使用以下指令
kong migrations up -c /apps/kong/kong.conf

4. 启动kong
   kong start -c /apps/kong/kong.conf
5. 测试kong是否启动成功
   curl -i http://localhost:8001/services
6. 效果如图所示：

Docker

docker下安装并启动kong

kong支持在多个环境下安装，当然最方便快捷的方式就是在docker安装的方式了，直接拉取官方的镜像，运行起来即可。关于docker的安装和介绍，参照Docker入门—介绍和安装Docker

1. 分别拉取kong和PostgreSQL的镜像

docker pull kong

docker pull postgres

2. 创建kong的网络
   docker network create kong-net
3. 启动数据库

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

4. 准备数据库

# 借用临时的容器来初始化数据库
docker run --rm \
     --network=kong-net \
     -e "KONG_DATABASE=postgres" \
     -e "KONG_PG_HOST=kong-database" \
     -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
     kong kong migrations bootstrap

5. 启动kong

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

6. 测试kong是否启动成功
   curl -i http://localhost:8001/services
7. 效果如图所示：