【kong系列二】之 kong安装

上一节提到，我们可以从以下列表，选择其中一种适合的方式进行安装

1. 安装方式列表

• Kong Docker: A Dockerfile for running Kong in Docker.
• Kong Packages: Pre-built packages for Debian, Red Hat, and OS X distributions (shipped with each release).
• Kong Vagrant: A Vagrantfile for provisioning a development ready environment for Kong.
• Kong Homebrew: Homebrew Formula for Kong.
• Kong CloudFormation: Kong in a 1-click deployment for AWS EC2
• Kong AWS AMI: Kong AMI on the AWS Marketplace.
• Kong on Microsoft Azure: Run Kong using Azure Resource Manager.
• Kong on Heroku: Deploy Kong on Heroku in one click.
• Kong and Instaclustr: Let Instaclustr manage your Cassandra cluster.

更多安装方式请访问：https://getkong.org/install/

2.安装kong

1).pkg方式安装

mac上安装，最快捷方式：下载pkg包https://github.com/Mashape/kong/releases/download/0.10.3/kong-0.10.3.osx.pkg

直接打开pkg安装包进行界面引导安装。

安装完毕，kong --help  测试安装是否成功。

2).homebrew方式安装

选择mac OS X home-brew方式安装（home-brew如何安装请自行google）。

Install (stable)   稳定版

$ brew tap mashape/kong

$ brew install kong

Install devel (release candidates)  候选发布版

$ brew tap mashape/kong

$ brew install --devel kong

Install HEAD (unstable)  不稳定版，抢先版

$ brew tap mashape/kong

$ brew install --HEAD kong

安装完毕,简单校验kong

$ kong --help   #查看命令帮助。

$ kong start

3).安装过程可能会出现错误

错误一：Error: parent directory is world writable but not sticky

/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib/ruby/2.0.0/tmpdir.rb:92:in `mktmpdir'

/usr/local/Homebrew/Library/Homebrew/utils/fork.rb:6:in `safe_fork'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:675:in `build'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:306:in `install'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:546:in `install_dependency'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:513:in `block in install_dependencies'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:513:in `each'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:513:in `install_dependencies'

/usr/local/Homebrew/Library/Homebrew/formula_installer.rb:246:in `install'

/usr/local/Homebrew/Library/Homebrew/cmd/install.rb:341:in `install_formula'

/usr/local/Homebrew/Library/Homebrew/cmd/install.rb:226:in `block in install'

/usr/local/Homebrew/Library/Homebrew/cmd/install.rb:224:in `each'

/usr/local/Homebrew/Library/Homebrew/cmd/install.rb:224:in `install'

/usr/local/Homebrew/Library/Homebrew/brew.rb:95:in `<main>'

解决：sudo chmod +t /private/tmp/   

错误二：

Error: The `brew link` step did not complete successfully

The formula built, but is not symlinked into /usr/local

Could not symlink bin/nginx

Target /usr/local/bin/nginx

is a symlink belonging to nginx. You can unlink it:

  brew unlink nginx

To force the link and overwrite all conflicting files:

  brew link --overwrite openresty

To list all files that would be deleted:

  brew link --overwrite --dry-run openresty

解决：不用理会。

错误三：

安装完毕后，使用kong --help 查看帮助，帮助正常输出，则安装成功。

但有可能会出现下面错误：

/usr/bin/env: ‘resty’: No such file or directory

解决：

1.进入$ cd /usr/local/bin 

2.创建软链接 $ ln -s ../Cellar/openresty/1.11.2.2/bin/resty /usr/local/bin/resty

3.再次使用 kong --help查看帮助

说明：

Homebrew的安装路径及文件夹

根目录：/usr/local

-bin          用于存放所安装程序的启动链接（相当于快捷方式）

-Cellar       所以brew安装的程序，都将以[程序名/版本号]存放于本目录下

-etc          brew安装程序的配置文件默认存放路径

-Library      Homebrew 系统自身文件夹

遗憾的是，home-brew方式安装，最后启动时总是报错：

/usr/local/bin/KONG:7: module 'kong.cmd.init' not found:No LuaRocks module found for kong.cmd.init

no field package.preload['kong.cmd.init']

有兴趣的同学，可以参考：https://github.com/Mashape/kong/issues/2646 该issu中的解决方法。

3.brew安装postgreSql

brew install postgresql -v

初始化数据库

initdb /usr/local/var/postgres -E utf8

指定 "/usr/local/var/postgres"为 PostgreSQL 的配置数据存放目录，设置数据编码是 utf8

启动 PostgreSQL：

pg_ctl -D /usr/local/var/postgres -l /usr/local/var/postgres/server.log start

关闭 PostgreSQL：

pg_ctl -D /usr/local/var/postgres stop -s -m fast

创建一个 PostgreSQL 用户

createuser kong -P

#Enter password for new role:

#Enter it again:

执行

changledeMacBook-Pro:postgres changle$ createuser kong -P

Enter password for new role:

Enter it again:

创建成功后，我们拥有了postgreSQL的账户和密码user/pwd: kong/kong

创建一个DB

createdb kong -O kong -E UTF8 -e

执行

changledeMacBook-Pro:postgres changle$ createdb kong -O kong -E UTF8 -e

CREATE DATABASE kong OWNER kong ENCODING 'UTF8';

连接数据库测试

psql -U username -d dbname -h 127.0.0.1

执行：psql -U kong -d kong -h 127.0.0.1

连接成功。

关于PostgreSQL的操作，请参考附加内容。

4.启动kong

kong start

hangledeMacBook-Pro:local changle$ kong start

Kong started

changledeMacBook-Pro:local changle$ curl http://127.0.0.1:8001/apis

{"data":[],"total":0}

5.安装kong dashboard

安装步骤，请参考git 地址：https://github.com/PGBI/kong-dashboard

附加内容：PostgreSQL 数据库操作

显示已创建的数据库：

\l  

在不连接进 PostgreSQL数据库的情况下，也可以在终端上查看显示已创建的列表：

psql -l

连接数据库

\c dbname

显示数据库表

\d  

创建一个名为 test 的表

CREATE TABLE test(id int, text VARCHAR(50));

插入一条记录

INSERT INTO test(id, text) VALUES(1, 'sdfsfsfsdfsdfdf');

查询记录

SELECT * FROM test WHERE id = 1;

更新记录

UPDATE test SET text = 'aaaaaaaaaaaaa' WHERE id = 1;

删除指定的记录

DELETE FROM test WHERE id = 1;

删除表

DROP TABLE test;

删除数据库

DROP DATABASE dbname;

或者利用 dropdb 指令，在终端上删除数据库

dropdb -U user dbname

退出连接

\q 

其他安装方式，请参看文章开头#安装方式列表

参考文献

参考文献1： /usr/bin/env: ‘resty’: No such file or directory问题的解决方法https://www.36nu.com/post/235.html 

参考文献2：home-brew安装konghttps://github.com/Mashape/homebrew-kong

参考文献3：brew 安装报错parent directory is world writable but not sticky http://www.cnblogs.com/imbin/p/6028875.html

参考文献4：Mac下 PostgreSQL的安装与使用http://www.cnblogs.com/shineqiujuan/p/4703304.html