首先下载配置的相应软件包:
- 12.04 Precise: https://bintray.com/kong/kong-deb/download_file?file_path=kong-1.3.0.precise.amd64.deb
- 14.04 Trusty: https://bintray.com/kong/kong-deb/download_file?file_path=kong-1.3.0.trusty.amd64.deb
- 16.04 Xenial: https://bintray.com/kong/kong-deb/download_file?file_path=kong-1.3.0.xenial.amd64.deb
- 17.04 Zesty: https://bintray.com/kong/kong-deb/download_file?file_path=kong-1.3.0.zesty.amd64.deb
- 18.04 Bionic: https://bintray.com/kong/kong-deb/download_file?file_path=kong-1.3.0.bionic.amd64.deb
企业试用用户应从其欢迎电子邮件中下载其包,并在步骤1之后将其许可保存到/etc/kong/license.json
。
您也可以通过APT安装Kong;
按照下面页面上“Set Me Up”部分的说明,将分布设置为适当的值(lsb_release -sc)(例如,precise
)和组件到main
。
-
安装Kong 如果要下载程序包,请执行:
$ sudo apt-get update $ sudo apt-get install openssl libpcre3 procps perl $ sudo dpkg -i kong-1.3.0.*.deb
如果您正在使用apt存储库执行:
$ sudo apt-get update $ sudo apt-get install -y apt-transport-https curl lsb-core $ echo "deb https://kong.bintray.com/kong-deb `lsb_release -sc` main" | sudo tee -a /etc/apt/sources.list $ curl -o bintray.key https://bintray.com/user/downloadSubjectPublicKey?username=bintray $ sudo apt-key add bintray.key $ sudo apt-get update $ sudo apt-get install -y kong
-
准备数据库或声明性配置文件
无论是否有数据库,Kong都可以运行。
使用数据库时,您将使用 kong.conf 配置文件在启动时设置Kong的配置属性,并将数据库用作所有已配置实体的存储,例如Kong代理所在的 Routes 和 Services 。
不使用数据库时,您将使用
kong.conf
的配置属性和kong.yml
文件来将实体指定为声明性配置。使用数据库
配置Kong以便它可以连接到您的数据库。Kong支持PostgreSQL 9.5+和Cassandra 3.x.x作为其数据存储。
如果您使用Postgres,请在开始Kong之前配置数据库和用户,即:
CREATE USER kong; CREATE DATABASE kong OWNER kong;
然后执行Kong的数据迁移:
$ kong migrations bootstrap [-c /path/to/kong.conf]
对于Kong 小于0.15的注意事项:如果Kong版本低于0.15(最高0.14),请使用up子命令而不是bootstrap。另请注意,如果Kong 小于0.15,则不应同时进行迁移;只有一个Kong节点应该一次执行迁移。对于0.15,1.0及以上的Kong,此限制被取消。
不使用数据库
如果要在无DB模式下运行Kong,则应首先生成声明性配置文件。以下命令将在当前文件夹中生成
kong.yml
文件。它包含有关如何填写它的说明。$ kong config init
填写
kong.yml
文件后,编辑您的kong.conf
文件。将database
选项设置为off
,将declarative_config
选项设置为kong.yml
文件的路径:database = off declarative_config = /path/to/kong.yml
-
启动Kong
$ kong start [-c /path/to/kong.conf]
-
使用Kong
Kong正在运行
$ curl -i http://localhost:8001/