以前在美菜的时候，API管理系统用的Swagger。

现在自己一个人了，准备找个国内做这个的试用下，筛选下决定试试阿里的RAP，先搭建起来再说吧。。。

参考地址：https://github.com/thx/RAP/wiki/deploy_manual_cn

Step1.下载War包：

https://github.com/thx/RAP/releases

将下载的war包修改为ROOT.war后放入tomcat的webapps文件夹中。

Step2.Tomcat(8.5.15):

1.去官网下载Tomcat代码，有9.x版本，还是保险起见，我下载了个8.5.15版本的。

http://tomcat.apache.org/

2.给予权限，我的项目是放在桌面的

cd ~/Desktop/environment

sudo chmod -R 777 apache-tomcat-8.5.15/bin/startup.sh

3.如果你没装过jdk的话，还需要去下载jdk。

http://www.oracle.com/technetwork/java/javase/downloads/index.html

安装成功后就可通过命令行查询java版本：java -version

4.一般下载路径都会在 /Library下面

我的完整路径是:/Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk

然后就是在~/.bash_profile里配置JAVA_HOME和JRE_HOME参数：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk

export JRE_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk/Contents/Home/jre

5.执行tomcat下的bin目录下的startup.sh脚本即可，浏览器输入localhost:8080访问Tomcat首页。

PS:如果需要改变Tomcat的端口，编辑conf文件夹下的server.xml,修改(我的改为8010)：

<Connector port="8010" protocol="HTTP/1.1"

Step3.Redis(3.2.9,只是简单启动了redis-server，细致的配置这里就不讨论了)：

1.官网下载：

https://redis.io/download

2.将解压后的redis文件夹移到 /usr/local目录下。

3.cd到 redis的文件夹内，执行测试命令:sudo make test。

通过后执行:sudo make install。执行安装命令后启动服务:redis-server

Step4.初始化数据库：

1.下载脚本文件：https://github.com/thx/RAP/blob/release/src/main/resources/database/initialize.sql

Mysql环境下执行sql脚本:  Mysql>source (下载的sql脚本完整路径)

2.因最新的mysql的sql_mode设置的比较严格，需要手动配置下SQL_MODE来禁止full_group检查，可以改MySQL配置文件，或者运行如下SQL语句来修改SQL_MODE：

SET@@global.sql_mode='STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION';

Step5.修改基本参数：

1.修改数据库密码：部署ROOT.war文件后，在WEB-INF/classes/config.properties 修改数据库相关信息。

Step6.启动Tomcat，整个RAP服务器搭建完毕！