接口管理神器DOClever的搭建及使用

DOClever是一款非常优秀的开源接口管理工具，它集合团队管理，项目管理，接口设计，文档编写，测试，调试，mock数据集成，前后端分离并行开发方案集一身。这在微服务开发盛行的时代，是不多得的开发工具。这里主要记录一些我亲测的DOClever在CentOS7下的搭建步骤及一些入门的mock并行开发使用。

1. 安装及配置node.js环境

1.1 安装node.js

cd /ur/local 
wget https://nodejs.org/dist/v10.13.0/node-v10.13.0-linux-x64.tar.xz
tar xvJf node-v10.13.0-linux-x64.tar.xz
mv node-v10.13.0-linux-x64 ./node

1.2 配置node.js环境变量

vim /etc/profile

# 在文件底部添加如下信息
export NODE_HOME=/usr/local/node  
export PATH=$NODE_HOME/bin:$PATH 

# 重新加载配置文件，使环境变量生效
source /etc/profile 
# node -v 查看node版本

2. 安装及配置 mongodb

cd /usr/local
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-4.0.4.tgz
tar zxvf mongodb-linux-x86_64-4.0.4.tgz
mv mongodb-linux-x86_64-4.0.4 ./mongodb
cd mongodb
mkdir db
mkdir logs
cd bin

# 创建配置文件
vim mongodb.conf 
  
#在mongodb.conf文件添加以下代码
# 端口号
port=27017
# 数据库存储目录
dbpath=/usr/local/mongodb/db
# 日志输出
logappend=true
# 后台运行
fork=true
# 日志目录
logpath=/usr/local/mongodb/logs/mongpdb.log

# 启动mongodb
cd /usr/local/mongodb/bin
./mongod -f mongodb.conf

3. 部署 DOClever

3.1 下载源码及试运行

yum -y install git
git clone https://github.com/sx1989827/DOClever
 
#启动,按提示配置
node /DOClever/Server/bin/www   
 

浏览器输入:http://ip:10000/DOClever

3.2 后台进程守护配置

常规的运行方式，是前台了，非常不方便，我们可以配置它在后台运行。

# 安装cnpm 
npm install -g cnpm 
 
# 安装forever进程守护软件
cnpm install forever -g 
 
# 后台运行
forever start DOClever/Server/bin/www

4. Mock调试开发使用入门

浏览器输入 http://127.0.0.1:10000/DOClever，运行后，进入注册登录界面，先注册一个账户，之后就可以进行登录了，这里还有一个 DOClever总后台管理入口 ，DOClever的线下部署拥有总后台管理功能，可以管理所有用户，项目和团队。登录管理后台，默认用户名，密码均为DOClever，登录进入后，可以修改原密码。
使用DOClever最主要的就是使用它的mock数据功能，对于前端来说，很多时间都是在等待接口的完成，这样会耗费很多时间，如何更好的利用这部分时间进行前后端并行开发呢，于是便有了Mock数据的诞生。
简单来说，Mock数据就是借助一些后端来产生假数据返回给前端，让前端的业务流程可以跑下去。目前市面上也有很多工具专门做mock数据的，其实mockjs就是其中最有名的一款，DOClever同样对其进行了支持。
我们先按照文档中的步骤创建一个简单的接口，之后体会下Mock的过程。
如图，新建一个接口，测试并且运行查看结果：

差点儿忘了，再运行之前我们还要开启mock服务代理，很简单，点一下开关就行，如图：

那么在内网或者开发网络中我们怎么调用呢，也很简单，具体如下：
点击设置，查看我们的mock服务地址：

加入我们mock服务地址为：http://192.168.1.55:10000/mock/5ea2803db4e88214efb78663
那么我们测试请求的接口url就是：
http://192.168.1.55:10000/mock/5ea2803db4e88214efb78663/demo/getTest?name=demo&num=1

这样前端就可以和后端并行开发了！不用再相互等着了。

5. 官方链接

• DOClever官方网站： http://doclever.cn

• DOClever 开源地址： http://doclever.cn/controller/download/download.html

• DOClever 官方文档： http://doclever.cn/controller/read/read.html

• DOClever Github 地址：https://github.com/sx1989827/DOClever

6. 参考博文

• DOClever的安装及使用
• Centos7下搭建部署DoClever接口管理平台