以前本身部署過 easy-mock,還專門整了篇博客 <Windows 本地安裝部署 Easy Mock>,但如今大搜車已經兩年多沒有對 easy-mock 進行有效 commit 了,最重要的是,easy-mock 對 NodeJs@10.x 及以上的版本不支持,這就比較坑了,因此我找了一下有沒有其餘的 Api 管理/Mock 平臺 YApi,準備之後轉戰 YApi 了,我把 YApi 部署到我本身的服務器上,之後就用它了。html
CentOS 版本: 7.6
前端
Nginx 版本: 1.16.1
node
Yapi 版本: 1.19.1
git
MongoDB 版本: 4.2.6
github
MongoDB 和其餘挺多直接用 yum 安裝的軟件不同,它不能直接用 yum install
,這種方式安裝的 MongoDB 版本很低,須要先配置一下 yum:mongodb
# 建立 yum 配置文件
vim /etc/yum.repos.d/mongodb-org-4.2.repo
# 在文件中填入如下內容,而後 :wq 退出
[mongodb-org-4.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/4.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.2.asc
# 退出後就可使用 yum 進行安裝了
yum install -y mongodb-org
複製代碼
systemctl start mongod.service # 開啓 MongoDB
systemctl enable mongod # 開機自啓
systemctl list-unit-files|grep mongod # 查看 MongoDB 是否是開機自啓
service mongod restart # 重啓
service mongod stop # 中止
service mongod start # 運行
rpm -ql mongodb-org-server # 查看 MongoDB 相關文件
複製代碼
而後咱們修改配置文件,讓 MongoDB 在外部也能夠訪問npm
# 修改 MongoDB 配置文件
vim /etc/mongod.conf
# 找到這裏,修改後 :wq
net:
port: 27017
bindIp: 0.0.0.0 # 原來是 127.0.0.1,只容許本地鏈接,改爲 0.0.0.0 容許外部鏈接,若是隻須要本地鏈接就不用改
security: # 爲了安全,啓用身份驗證
authorization: "enabled" # disable or enabled
# 保存後重啓服務
service mongod restart
複製代碼
修改完配置以後,在網頁上訪問 <你的服務器地址>:27017
就能夠訪問到了,若是不修改 bindIp
的話,就只能夠進行本地鏈接。vim
若是你 mongod
訪問的時候抱以下的狀況:api
那你須要新建一個 /data/db
數據目錄 mkdir /data/db
,而後再訪問就能夠了。跨域
這裏保留一下卸載的方法,之後可能換其餘方式安裝 MongoDB:
systemctl disable mongod # 中止開機自啓
service mongod stop # 中止服務
sudo yum erase $(rpm -qa | grep mongodb-org) # 刪除安裝包
sudo rm -r /var/log/mongodb # 刪除日誌文件
sudo rm -r /var/lib/mongo # 刪除數據文件
複製代碼
首先安裝官方提供的 yapi-cli
工具,順帶安上 pm2
回頭啓服務的時候能夠用來守護和管理進程:
npm install -g yapi-cli pm2 --registry https://registry.npm.taobao.org
yapi server
複製代碼
而後進行可視化配置,我是下面這樣配置的:
點擊「開始部署」,就開始 Yapi 部署的過程了,通過兩三分鐘的等待,看到最後幾行提示了管理員帳戶名和密碼,記下來後面有用
而後
cd <部署路徑> # 剛剛的配置是 /usr/share/my-Yapi
node vendors/server/app.js # 跑起來
# 推介用 pm2 跑,這裏給 yapi 賦一個引用名稱,之後操做方便,並設置當超過 200MB 內存上限後自動重啓
pm2 start /usr/share/my-yapi/vendors/server/app.js -n yapi --max-memory-restart 500M
pm2 stop yapi # pm2 中止
pm2 list # pm2 查看運行狀態
複製代碼
此時能夠看到 pm2 運行的腳本狀態:
如今到瀏覽器訪問 <你服務器ip>:9001
(注意這裏的端口是你剛剛本身設置的端口號)就能夠訪問到 Yapi 的服務目錄了,目錄看起來跟官網比較相似
這樣就完成了本地的部署了~ 👏
註冊一個新帳號,登陸後就能夠正常使用了。
安裝上 Yapi 以後,還須要在瀏覽器安裝一個 cross-request 插件,來進行頁面跨域請求。
首先咱們去 https://github.com/YMFE/cross-request
倉庫,下載 zip
包並解壓縮。
而後在 Chrome 右上角三個點的菜單中選擇 更多工具 -> 擴展程序 -> 加載以解壓的擴展程序 -> 選中壓縮包內容
,記得先把右上角 開發者模式
打開。
而後查看 接口 -> 運行
就能夠發送命令了~
⚠️ 注意: 安裝完以後,解壓縮的插件文件夾不能刪除!!!
後面的使用,能夠參考官方文檔: YApi-教程
但要提一句的是,我在將 swagger2.0 的接口文檔導入 Yapi 的時候,發現出現了一點問題 😅,這裏給 Yapi 的倉庫提了 <導入swagger2.0版本的配置文件後接口的編輯按鈕點擊進入空白頁 · Issue #1739> 這樣一個 issue,但願官方早點解決呀~
網上的帖子大多深淺不一,甚至有些先後矛盾,在下的文章都是學習過程當中的總結,若是發現錯誤,歡迎留言指出~
參考文檔:
PS:本人博客地址 Github - SHERlocked93/blog,也歡迎你們關注個人公衆號【前端下午茶】,一塊兒加油吧~
另外能夠加入「前端下午茶交流羣」微信羣,長按識別下面二維碼便可加我好友,備註加羣,我拉你入羣~