Api 文档管理系统 RAP1环境搭建

前后端分离的路上,一款强大的API管理工具,可以降低沟通成本,大大提高开发效率,节省的时间,让我们去做更有意义的事情。

API管理工具有很多,选择适合自身需求的就是最好

这里以阿里妈妈出品的RAP产品;目前RAP分为: RAP1RAP2

虽然RAP1不再添加新功能,只做维护工作,介于RAP2目前还不是很成熟,本篇文章先讲RAP1的搭建过程(虽然官方Wiki已经有很详细的部署教程,但在部署过程中还是遇到一些问题,因此就记录下来)

如果你不需要搭建,可以直接访问RAP1提供的服务http://rapapi.org

项目构建

  • 系统环境:Windows 10 x64
  • 应用工具:GitIDEAJDK1.8+Tomcat8+MySQLRedis3+

这里Git,IDEA,JDK1.8,Tomcat8,MySQL不再赘述安装步骤以及环境配置

安装基本工具

Redis

由于Redis 官方并未支持Windows系统,因此借助MicrosoftArchive团队所提供的Windows Redis安装包,这里下载最新的Redis-x64-3.2.100.msi

  • 以管理员身份运行安装包Redis-x64-3.2.100.msi

    1. 添加环境变量
      env
    2. 默认6379端口
      port
    3. 检查Redis服务,是否已经启动
      serve

    其他默认即可,不要设置Memory Limit

构建项目

获取源代码

1
2
git clone git@github.com:thx/RAP.git
git checkout release

确保您正确的切换到release分支,否则会出现少包,因为master分支引用一些不对外公开的内部组件,不提供给外部用户使用

导入到IDEA

IDEA==>Open==>RAP

初始化数据库

执行脚本文件:RAP\src\main\resources\database\initialize.sql

修改配置文件

文件:RAP\src\main\resources\database\config.properties
修改:数据库用户名密码
update

启动项目

  1. Edit config
    config
  2. Create Tomcat
    create
  3. Deploy war
    deploy
  4. Deploy success
    success

注意成功部署后,请注册新账号登录

至此,RAP1的本机部署已经完成。

其他

  • RAP1学习中心
    部分同学无法查看视频,请异步至issues
  • RAP1 Wiki文档
  • Mockjs
  • RAP2环境搭建教程