以前本身部署过 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,也欢迎你们关注个人公众号【前端下午茶】,一块儿加油吧~
另外能够加入「前端下午茶交流群」微信群,长按识别下面二维码便可加我好友,备注加群,我拉你入群~