接口管理神器DOClever的搭建及使用(CentOS7下部署)

接口管理神器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接口管理平臺