前言
Yapi是去哪儿网开源的一款接口管理工具。接口的文档的管理是一件比较痛苦的事情,后端开发不得不使用很长的时间去维护繁杂冗余的文档,而前端开发也因为文档的不精确也浪费开发时间。
工作中接口返回的参数值包含很多的异常场景,前端不得不写一大串的判断逻辑。配合前段调试需要模拟很多场景,比较费时费力,而且很多场景到了项目后期才能调试,在提交测试时时间就会显得很紧张。
总结起来文档式的接口管理方式浪费心里和时间,Aapi这款工具的旨意将接口作为一个公共的可视化的方式打通前段、后台、测试环节,整合在一块,共同使用维护,降低接口的维护成本。
这款工具免费开源,部署简单,还具有官方文档。
环境准备
操作系统:centos 8
环境要求:
nodejs>7.6
mongodb>2.6
git
安装nodejs
获取资源(部署nodejs尽可能选择偶数版本,因为偶数版本官方有较长的维护时间,故这次选择8.x。)
curl -sL https://rpm.nodesource.com/setup_8.x | bash -
安装
yum install -y nodejs
查看版本
node -v
查看npm版本
npm -v
安装mongodb
更新yum源(非必须)
yum -y update
添加mongodb源文件,在/etc/yum.repos.d 创建一个 mongodb-org.repo 文件
touch /etc/yum.repos.d/mongodb-org.repo
编辑mongodb-org.repo文件
vim /etc/yum.repos.d/mongodb-org.repo
添加文件内容
安装mongodb
yum install -y mongodb-org
启动mongodb
service mongod start
设置开机启动
chkconfig mongod on
打开moMongoDB(可忽略)
/bin/mongo
配置远程访问
vim /etc/mongod.conf
注释 bindIp: 127.0.0.1
#bindIp: 127.0.0.1
重启mongod
service mongod restart
image.png
安装git
安装git
yum -y install git
部署YApi环境
准备环境搭建完成后,开始搭建YApi,安装命令,此处安装使用可视化部署[推荐]
执行 yapi server 启动可视化部署程序,输入相应的配置和点击开始部署,就能完成整个网站的部署。部署完成之后,可按照提示信息,执行 node/{网站路径/server/app.js} 启动服务器。在浏览器打开指定url, 点击登录输入您刚才设置的管理员邮箱,默认密码(ymfe.org) 登录系统(默认密码可在个人中心修改)。
npm install -g yapi-cli --registry https://registry.npm.taobao.org
安装后的目录结构如下:
image.png
启动YApi
yapi server
实例截图:
image.png
执行 yapi server 启动可视化部署程序,浏览器打开提示窗口上的地址,非本地服务器,将0.0.0.0替换指定的域名或IP,进入部署页面。
实例截图
image.png
根据项目实际需要可以修改部署信息,点击【开始部署】,完成部署任务
部署成功截图
image.png
image.png
4.根据部署日志截图上的提示信息,启动服务
cd my-yapi/ #我的是root/my-yapi,看部署的时候各位的设置
node vendors/server/app.js
启动服务:node vendors/server/app.js
image.png
浏览器打开部署日志上的访问地址http://127.0.0.1:3000就可以访问搭建的YApi工具了(非本地服务器,将127.0.0.1替换指定的域名或IP),此时YApi环境搭建完成
image.png
服务器管理
由于服务一停止,网站就挂了。所以可以用pm2永久守护这个yapi进程。
推荐使用 pm2 管理 node 服务器启动,停止
安装
npm install -g pm2
切换到yapi的vendors目录
cd my-yapi/vendors
执行
pm2 start server/app.js --watch
image.png