CentOS 安装部署 Yapi

5,637 阅读3分钟

之前自己部署过 easy-mock,还专门整了篇博客 <Windows 本地安装部署 Easy Mock>,但现在大搜车已经两年多没有对 easy-mock 进行有效 commit 了,最重要的是,easy-mock 对 NodeJs@10.x 及以上的版本不支持,这就比较坑了,所以我找了一下有没有其他的 Api 管理/Mock 平台 YApi,准备以后转战 YApi 了,我把 YApi 部署到我自己的服务器上,以后就用它了。

CentOS 版本: 7.6

Nginx 版本: 1.16.1

Yapi 版本: 1.19.1

MongoDB 版本: 4.2.6

1. MongoDB 配置

1.1 配置 yum 并安装 MongoDB

MongoDB 和其他挺多直接用 yum 安装的软件不一样,它不能直接用 yum install,这种方式安装的 MongoDB 版本很低,需要先配置一下 yum:

# 创建 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

1.2 MongoBD 常用命令

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 相关文件

1.3 MongoDB 配置

然后我们修改配置文件,让 MongoDB 在外部也可以访问

# 修改 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 的话,就只可以进行本地连接。

如果你 mongod 访问的时候抱如下的情况:

image-20200503152859106

那你需要新建一个 /data/db 数据目录 mkdir /data/db ,然后再访问就可以了。

1.4 卸载 MongoDB

这里保留一下卸载的方法,以后可能换其他方式安装 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       # 删除数据文件

2. Yapi 安装部署

2.1 本地部署

首先安装官方提供的 yapi-cli 工具,顺带安上 pm2 回头启服务的时候可以用来守护和管理进程:

npm install -g yapi-cli pm2 --registry https://registry.npm.taobao.org
yapi server

然后进行可视化配置,我是下面这样配置的:

image-20200503152036407

点击「开始部署」,就开始 Yapi 部署的过程了,经过两三分钟的等待,看到最后几行提示了管理员账户名和密码,记下来后面有用

image-20200503154305831

然后

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 运行的脚本状态:

image-20200503171421872

现在到浏览器访问 <你服务器ip>:9001 (注意这里的端口是你刚刚自己设置的端口号)就可以访问到 Yapi 的服务目录了,目录看起来跟官网比较类似

image-20200503161917956

这样就完成了本地的部署了~ 👏

注册一个新账号,登录后就可以正常使用了。

2.2 安装 cross-request 插件

安装上 Yapi 之后,还需要在浏览器安装一个 cross-request 插件,来进行页面跨域请求。

首先我们去 https://github.com/YMFE/cross-request 仓库,下载 zip 包并解压缩。

image-20200503164553266

然后在 Chrome 右上角三个点的菜单中选择 更多工具 -> 扩展程序 -> 加载以解压的扩展程序 -> 选中压缩包内容,记得先把右上角 开发者模式 打开。

image-20200503164926925

然后查看 接口 -> 运行 就可以发送命令了~

⚠️ 注意: 安装完之后,解压缩的插件文件夹不能删除!!!

后面的使用,可以参考官方文档: YApi-教程

但要提一句的是,我在将 swagger2.0 的接口文档导入 Yapi 的时候,发现出现了一点问题 😅,这里给 Yapi 的仓库提了 <导入swagger2.0版本的配置文件后接口的编辑按钮点击进入空白页 · Issue #1739> 这样一个 issue,希望官方早点解决呀~


网上的帖子大多深浅不一,甚至有些前后矛盾,在下的文章都是学习过程中的总结,如果发现错误,欢迎留言指出~

参考文档:

  1. Install MongoDB Community Edition on Red Hat or CentOS — MongoDB Manual
  2. Linux Centos 7安装MongoDB(简单!详细!)

PS:本人博客地址 Github - SHERlocked93/blog,也欢迎大家关注我的公众号【前端下午茶】,一起加油吧~

另外可以加入「前端下午茶交流群」微信群,长按识别下面二维码即可加我好友,备注加群,我拉你入群~