1,选择安装介质
本次选择Centos7
2,下载介质
wget https://bintray.com/kong/kong-rpm/download_file?file_path=centos/7/kong-1.3.0.el7.amd64.rpm
可以将下载的文件重命名为kong-1.3.0.el7.amd64.rpm
3,安装依赖
sudo yum install -y openssl libpcre3 procps perl
4,安装介质
sudo yum install epel-release
sudo yum install kong-1.3.0.el7.amd64.rpm --nogpgcheck
5,创建需要的数据库及账号(Postgresql)
CREATE USER kong WITH ENCRYPTED PASSWORD 'kong';
CREATE DATABASE kong OWNER kong;
GRANT ALL PRIVILEGES ON DATABASE kong TO kong;
ALTER USER kong WITH PASSWORD ‘kong’;
6,调整配置文件(kong.conf)
Kong附带一个默认配置文件,可以在/etc/kong/kong.conf.default中找到。要开始配置kong,可以复制此文件
cp /etc/kong/kong.conf.default /etc/kong/kong.conf
如果您的配置中的所有值都被注释掉,kong将使用默认设置进行操作。启动时,Kong查找若干可能包含配置文件的默认位置:
/etc/kong/kong.conf
/etc/kong.conf
注:通过在CLI中使用-c/--conf参数指定配置文件的自定义路径,可以覆盖此行为:
kong start --conf /path/to/kong.conf
配置格式很简单:只需取消注释任何属性(注释由字符定义)并根据需要进行修改。为了方便起见,布尔值可以指定为on/off或true/false
7,远程连接配置
方法1,修改kong的配置文件kong.conf
找到admin_listen,将其127.0.0.1,改为自己需要的(或者直接改成0.0.0.0,另外前边的注释记得放开)
方法2,配置环境变量(推荐)
export KONG_ADMIN_LISTEN=0.0.0.0:8001,0.0.0.0:8444 ssl
8,初始化需要的表
kong migrations bootstrap [-c /path/to/kong.conf]
9,启动Kong
kong start -c --vv
常用命令:
1)kong start
2)kong stop
3)kong reload
4)kong check
安装Konga
1,先决条件
1) Kong运行实例
2) Nodejs >= 8 (推荐8.11.3)
在/usr/local/nodejs下下
wget https://nodejs.org/dist/v9.3.0/node-v9.3.0-linux-x64.tar.xz
解压
tar -xvf node-v9.3.0-linux-x64.tar.xz
建立连接
ln -sf /usr/local/nodejs/node-v9.3.0-linux-x64/bin/node /usr/bin/node
ln -sf /usr/local/nodejs/node-v9.3.0-linux-x64/bin/npm /usr/bin/npm
ln -sf /usr/local/nodejs/node-v9.3.0-linux-x64/bin/npm /usr/bin/npx
3) npm
2,安装依赖
npm i gulp –g
npm i sails-postgresql #如果计划使用postgres数据库
npm i sails-mysql #如果计划使用mysql数据库
npm i sails-mongo #如果计划使用MongoDB数据库
npm i sails- sqlserver #如果计划使用SqlServer数据库
npm run bower-deps #建议执行,避免前端出现没找到angular的情况
3,下载文件
假设安装路径:/data/microservice/konga
$ git clone https://github.com/pantsel/konga.git
$ cd konga
$ npm i #执行安装操作,并下载依赖包
提示:npm i 指令执行时候dtrace-provider模块提示异常,可先执行以下指令
npm i dtrace-provider -g --unsafe-perm
解压后Konga的目录结构如下:
Konga解压
4,设置配置文件
1)在konga的根目录下,拷贝文件“.env_example”,生成“.env”
cp .env_example .env
注:通过 “ll –a”或“ls –a”命令可以看到该隐藏的文件
默认内容如下:
PORT=1337
NODE_ENV=production
KONGA_HOOK_TIMEOUT=120000
DB_ADAPTER=postgres
DB_URI=postgresql://localhost:5432/konga
KONGA_LOG_LEVEL=warn
TOKEN_SECRET=some_secret_token
这里主要关注的是PORT和DB_ADAPTER以及DB_URI三个配置项。PORT是我们页面的访问端口,DB_ADAPTER指定使用的数据存储介质,可以是“mysql”、“mongo”、“postgres”、“sqlserver”, 如果没有设置默认为“localDiskDb”。 DB_URI则为对应配置数据库的访问地址。
这些配置的参数将会在config/connections.js中使用,如下:
postgres: {
adapter: 'sails-postgresql',
url: process.env.DB_URI,
host: process.env.DB_HOST || 'localhost',
user: process.env.DB_USER || 'postgres',
password: process.env.DB_PASSWORD || 'admin1!',
port: process.env.DB_PORT || 5432,
database: process.env.DB_DATABASE ||'konga_database',
// schema: process.env.DB_PG_SCHEMA ||'public',
poolSize: process.env.DB_POOLSIZE || 10,
ssl: process.env.DB_SSL ? true : false // If set, assume it's true
}
注意:需要手动在postgresql中创建库konga,其它的数据库一样。
5,启动Konga
1) 开发环境(development)
npm start
2) 生产环境(production)
在MySQL或PostgreSQL适配器的情况下,在生产模式下运行时,Konga将不会执行DB迁移。您可以通过调用 $ node ./bin/konga.js prepare手动执行迁移(切换到konga根路径),传递数据库连接所需的参数。
node ./bin/konga.js prepare --adapter postgres --uri postgresql://localhost:5432/konga
执行启动
nohup npm run production > konga.log 2>&1 &