【CentOS 7.2】Orange 0.6.4 安装与配置

---------2017-08-25 重新编辑格式---------

Orange是一个简单易用的开源API Gateway，它集成了Openresty、Nginx和lor，使用Lua语言开发了nginx插件，可以实现后端服务API路由设置以及反向代理、负载均衡，此外还提供一些API监控功能，但是API鉴权尚不完善，不支持精细的权限配置。配合Docker使用，可以组成轻量级低负载的微服务架构，适合初创公司使用。通过API网关实现对外统一的接口契约格式，使得后端的开发语言对前端完全透明，实现多种后端语言共同开发，例如使用PHP支持一些需要快速上线的业务，而使用Java支持一些持久稳定的业务等，此外在集成其它采购的软件，如OA、CMS等系统时，也可以起到隔离差异和统一访问的作用。

一、安装依赖

（1）安装OpenSSL（Openresty依赖库）

[root@local ~]# yum install openssl-devel

（2）安装PCRE（Openresty依赖库）

[root@local ~]# yum install pcre-devel

（3）编译安装Openresty（Orange依赖）

[root@local ~]# wget https://openresty.org/download/openresty-1.11.2.3.tar.gz [root@local ~]# ./configure -j2 --with-http_stub_status_module

编译安装

[root@local ~]# gmake
[root@local ~]# gmake install

或者

[root@local ~]# make
[root@local ~]# make install

默认安装目录为

/usr/local/openresty

.bash_profile配置环境变量：

PATH=$PATH:$HOME/bin:/usr/local/openresty/bin:/usr/local/openresty/nginx/sbin

*注：

笔者使用Openresty官方提供yum安装源安装之后，检查orange安装状态时，Nginx出现如下错误，原因未知，因此最终还是选择了编译安装。此外，使用yum安装只生成openresty执行文件，而不会生成resty文件，需要自行创建软连接”ln -s”。

[root@local ~]# orange help
nginx:invalid option: "/usr/local/bin/orange"

（4）编译安装lor框架（Orange依赖）

[root@local ~]# git clone https://github.com/sumory/lor.git [root@local ~]# cd lor
[root@local ~]# make install

默认安装目录为：/usr/local/lor

可执行文件：/usr/local/bin/lord

二、安装Orange

[root@local ~]# git clone https://github.com/sumory/orange.git [root@local ~]# cd orange
[root@local ~]# make install

由于Orange 是免安装使用，也可以使用start.sh直接启动，因此，实际安装的只是命令行工具，检查命令行工具如下。

[root@beijing5 openresty]# orange help
Orangev0.6.4, OpenResty/Nginx API Gateway.
Usage:orange COMMAND [OPTIONS]
Thecommands are:
stop       Stop current Orange
version    Show the version ofOrange
restart    Restart Orange
reload     Reload the config of Orange
store      Init/Update/Backup Orange store
help       Show help tips
start      Start the Orange Gateway

默认安装目录为：/usr/local/orange

可执行文件：/usr/local/bin/orange

三、配置Orange

Orange有两个主要的配置文件orange.conf和nginx.conf，可以在执行”make install”之前，先修改好两个配置文件。

（1）配置文件orange.conf

主要修改数据库连接相关的配置，并设置dashboard密码登录，初始密码admin/orange_admin。

{
"plugins":[
"stat",
"monitor",
"redirect",
"rewrite",
"rate_limiting",
"property_rate_limiting",
"basic_auth",
"key_auth",
"signature_auth",
"waf",
"divide",
"kvstore"
],
"store":"mysql",
"store_mysql":{
"timeout":5000,
"connect_config":{
"host": "192.168.1.107",
"port": 3306,
"database": "orange",
"user": "orange_dba",
"password": "orange_passwd",
"max_packet_size": 1048576
},
"pool_config":{
"max_idle_timeout": 10000,
"pool_size": 3
},
"desc":"mysql configuration"
},
"dashboard":{
"auth":true,
"session_secret":"y0ji4pdj61aaf3f11c2e65cd2263d3e7e5",
"whitelist":[
"^/auth/login$",
"^/error/$"
]
},
"api":{
"auth_enable":true,
"credentials":[
{
"username":"api_username",
"password":"api_password"
}
]
}
}

（2）配置文件nginx.conf

可以直接使用默认配置文件启动，然后再根据实际业务修改，建议把所有的error_log输出级别设置为warn，如下

error_log./logs/error.log warn;

否则会输出大量的日志记录，此外建议设置crontab定时任务对日志按天切分。

另外，建议将nginx.conf默认的server配置和新增的server配置拆分到几个文件中，例如main.conf、dashboard.conf、default.upstream.conf、api.conf，然后在主配置文件里引入，如下

include/usr/local/orange/conf/conf.d/*.conf;