簡介

YApi 是高效、易用、功能強大的 api 管理平臺，旨在為開發、產品、測試人員提供更優雅的介面管理服務。可以幫助開發者輕鬆建立、釋出、維護 API，YApi 還為使用者提供了優秀的互動體驗，開發人員只需利用平臺提供的介面資料寫入工具以及簡單的點選操作就可以實現介面的管理。
YApi 的一些客戶:
去哪兒,攜程,藝龍,京東,唯品支付,鏈家網,快手,便利蜂
YApi 是去哪兒公司的產品,以上摘自去哪兒YApi官網,下邊是我搭建過程中的記錄:

環境要求

nodejs（7.6+)
mongodb（2.6+）
安裝這2個,YApi官網沒有介紹,需求自己去摸索,我的安裝過程:

安裝nodejs

cd /usr/local/

wget http://nodejs.org/dist/v8.0.0/node-v8.0.0-linux-s390x.tar.gz
tar zxvf node-v8.0.0-linux-s390x.tar.gz

重新命名為node
mv node-v8.1.4-linux-x64 node
配置環境變數
vim /etc/profile
新增:

export NODE_HOME=/usr/local/node  
export PATH=$NODE_HOME/bin:$PATH 

生效:
source /etc/profile

使用命令檢視版本，出現相應版本號則表示成功
node -v
npm -v
**注意:
有的系統需要使用
sudo node -v才能執行**

mongdb安裝

vi /etc/yum.repos.d/mongodb-org-3.2.repo
repo檔案內容如下：

[mongodb-org-3.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.2.asc

安裝所有的mongodb元件：

yum install -y mongodb-org

啟動:
service mongod start
[
 
[email protected] vendors]# mongo
> use admin   #切換到admin資料庫
switched to db admin
#建立dba使用者
> db.createUser(
... ...   {
... ...     user: "dba",
... ...     pwd: "dba",
... ...     roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
... ...   }
... ... )
#建立yapi資料庫
> use yapi
switched to db yapi
給yapi資料庫新增test1使用者,許可權為讀寫
> db.createUser(
... ...     {
... ...       user: "test1",
... ...       pwd: "test1",
... ...       roles: [
... ...          { role: "readWrite", db: "yapi" }  
... ...       ]
... ...     }
... ... )

安裝YApi

官網安裝說明:http://yapi.qunar.com/devops.html
[[email protected] local]# pwd
/usr/local
[[email protected] local]# mkdir yapi
[[email protected] local]# cd yapi
[[email protected] yapi]git clone https://github.com/YMFE/yapi.git vendors //或者下載 zip 包解壓到 vendors 目錄
[[email protected] yapi]cp vendors/config_example.json ./config.json //複製完成後請修改相關配置,注意config.json中可以配置埠及mongdb相關的資料庫及賬號密碼,參考上面的安裝mongdb的步驟
[[email protected] yapi]cd vendors
[[email protected] vendors]sudo npm install –production –registry https://registry.npm.taobao.org

[[email protected] vendors]# sudo npm run install-server

[email protected] install-server /usr/local/yapi/vendors
node server/install.js

log: mongodb load success…
初始化管理員賬號成功,賬號名：”[email protected]”，密碼：”ymfe.org”
[[email protected] vendors]# sudo node server/app.js
load websocket…
log: the server is start at port 3000
log: mongodb load success…

啟動方式優化

以上啟動的方式,如果關閉SecureCRT視窗,那麼node的服務就停止了,如何讓node服務在後臺執行呢?
使用pm2 管理 node 伺服器啟動，停止及後臺執行
pm2使用介紹:http://imweb.io/topic/57c8cbb27f226f687b365636

安裝pm2:
linux命令列中執行:

[[email protected] vendors]npm install -g pm2
啟動:
[[email protected] vendors]# pm2 start server/app.js 
[PM2] Starting /usr/local/yapi/vendors/server/app.js in fork_mode (1 instance)
[PM2] Done.
┌──────────┬────┬──────┬───────┬────────┬─────────┬────────┬─────┬───────────┬──────┬──────────┐
│ App name │ id │ mode │ pid   │ status │ restart │ uptime │ cpu │ mem       │ user │ watching │
├──────────┼────┼──────┼───────┼────────┼─────────┼────────┼─────┼───────────┼──────┼──────────┤
│ app      │ 0  │ fork │ 24282 │ online │ 0       │ 0s     │ 1%  │ 12.3 MB   │ root │ disabled │
└──────────┴────┴──────┴───────┴────────┴─────────┴────────┴─────┴───────────┴──────┴──────────┘
 Use `pm2 show <id|name>` to get more details about an app

這樣node就在後臺運行了,即使關閉了SecureCRT視窗,服務還在執行中

異常問題解決

今天出現yapi登陸不了的問題,解決方式如下:

[root@CENTSVR247 yapi]# pwd
/usr/local/yapi
[root@CENTSVR247 yapi]# cd vendors/
[root@CENTSVR247 vendors]# pm2 stop server/app.js
[root@CENTSVR247 vendors]# pm2 start server/app.js

服務好了,可以登陸了,懷疑是不是這臺伺服器上安裝了docker引起的,在上面這些操作之前,把所有docker程序都kill了

幾個有用的命令:

[root@CENTSVR247 vendors]# pm2 list   查詢所有nodejs的程序
#pm2 show <id|name>
[root@CENTSVR247 vendors]# pm2 show app   顯示某個程序的詳細資訊,包括日誌檔案