YApi介绍
YApi是国内开源的一款面向开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API。
支持私有化部署、开源免费、无缝兼容swagger.json格式标准。
安装顺序
下面我就介绍一下在CentOS中私有化部署的操作流程,由于官方文档存在问题,我这里会着重指出一些注意事项。
安装必备环境
安装nodejs与npm
注意:YApi支持nodejs版本为 7.6 - 12,14以上启动会报错。
- 安装node.js和npm包管理
yum install nodejs
yum install npm
- 安装node n进行版本管理,这里我们切换到12.13.0这个nodejs版本
npm install -g n
n 12.13.0
安装MongoDB
注意:YApi支持的MongoDB版本要大于2.6
- 安装MongoDB程序
yum install -y mongodb-org
- 配置MongoDB,修改置文件 mongodb.conf
vi mongodb.conf
# 设置数据文件的存放目录,改成你自己的数据盘
dbpath = /usr/local/mongodb/mongodb3.2.4/bin/data/test/db
# 设置日志文件的存放目录及其日志文件名,改成你自己的数据盘
logpath = /usr/local/mongodb/mongodb3.2.4/bin/data/test/logs/mongodb.log
# 设置端口号(默认的端口号是 27017)
port = 27017
# 设置为以守护进程的方式运行,即在后台运行
fork = true
# nohttpinterface = true
nohttpinterface = true
按英文状态下的“:wq”保存并退出;
- 启动MongoDB服务
1)启动
systemctl start mongod
2)重启
systemctl restart mongod
3)关闭
systemctl stop mongod
安装git
yum -y install git
安装YApi-CLI脚手架
- 安装
npm install -g yapi-cli --registry https://registry.npm.taobao.org
- 启动
yapi server
YApi-CLI默认访问端口是9090,如果9090已被占用,可以手动修改启动端口。正常来说不用修改。
- 找到yapi-cli的路径
/usr/lib/node_modules/yapi-cli/src/commands
- 编辑server.js
vi server.js
- 修改监听端口
修改 app.listen(9090)
通过YApi-CLI可视化界面安装YApi
- 浏览器访问你的服务器9090端口,打开可视化部署页面
注意:部署版本不要选择1.10.1和1.10.2,这两个版本会调用阿里内网地址,部署会失败。必须选择1.9.3以下版本。
- 点击开始部署后,会看到执行日志
启动与运行
安装完成后,我们可以敲命令启动YApi后台程序了。
node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候
运行成功后,我们通过浏览器访问YApi,如下图所示:
通过pm2管理yapi服务
但是通过命令启动的YAPI服务,一关掉终端就停止运行了,所以我们需要使用PM2来将YAPI作为后台服务运行。
安装pm2
npm install -g pm2
使用pm2启动yapi服务
pm2 start opt/yapi/my-yapi/vendors/server/app.js
至此,YAPI的整个部署流程我们就走完了,如果在部署的过程中,有什么问题可以在我的博客留言,我会尽量帮助大家解决。
PS:如何配置邮件提醒
找到并修改config.json配置文件中邮件发送配置内容
修改完成后,重启YApi即可。