YApi-高效、易用、功能强大的可视化接口管理平台—部署篇

YApi https://yapi.ymfe.org/ 是由去哪儿网移动架构组(简称YMFE，一群由FE、iOS和Android工程师共同组成的最具想象力、创造力和影响力的大前端团队)开源的可视化接口管理工具，一个可本地部署的、打通先后端及QA的接口管理平台，YApi旨在为开发、产品和测试人员提供更优雅的接口管理服务，能够帮助开发者轻松建立、发布和维护不一样项目，不一样平台的API。有了YApi，咱们能够很方便的测试、管理和维护多个项目的API接口，不像Swagger那样是随应用生和灭的(且线上环境下大多数须关闭)，YApi是一个独立的服务平台。

下面介绍windows下部署YApi接口管理平台的相关步骤。

内网部署

环境要求：

• nodejs（7.6+)
• mongodb（2.6+）

1.安装nodejs

nodejs官网 https://nodejs.org 下载安装包安装。

2.安装mongodb

MongoDB官网 https://www.mongodb.com/download-center/community 下载安装包安装。安装过程当中会提示你安装图形界面管理工具MongoDB Compass，挺慢的，记得把√去掉，之后本身去官网下载安装。

3.安装YApi的部署脚手架

npm install -g yapi-cli
yapi server

效果以下图所示

按照提示打开地址 http://localhost:9090 按照提示部署，效果以下图所示

成功后根据提示访问： 切换到部署目录，输入node vendors/server/app.js指令启动服务器，而后在浏览器打开 http://localhost:3000

管理员帐号：hilanmiao@126.com 密码：ymfe.org

刚进来是空的，你须要建立一个项目,按照教程操做便可。 https://yapi.ymfe.org/documents/index.html

4.服务器管理

若是你使用node vendors/server/app.js指令启动服务器，那么当cmd窗口关闭时，node服务就关了，网站就打不开了。推荐使用 pm2 管理 node 服务器启动，中止，具体使用方法可参考官网的教程，我写个简单的。

记得用管理员身份打开CMD窗口

1. 安装 pm2

npm i -g pm2

2. 安装并配置 pm2-windows-service

pm2-windows-service能够将 pm2 安装成 windows service, 达到开机运行的目的

npm i -g pm2-windows-service

3. 添加pm2环境变量

添加系统环境变量 PM2_HOME=D:\.pm2

右键 [个人电脑] - [属性] - [高级系统设置] - [环境变量] - 新建 [系统变量]

名称PM2_HOME 路径D:\.pm2（这路径根据本身须要定）

4. 安装服务

以管理员权限打开新的命令行窗口,执行如下命令来安装服务

pm2-service-install

Perform environment setup ? 选 n, 继续

此时, PM2服务已安装成功并已启动, 能够经过 Wn+R来查看，输入services.msc便可看到服务

5. 启动node程序

下面用 pm2 来启动咱们本身的服务程序 app.js, 而后告诉 pm2 开机后自动运行我 app.js.继续在管理员命令行下, cd 切换到yapi的vendors/server/到 app.js 所在目录

pm2 start app.js --name yApi

6. 查看服务列表

pm2 list

7. 添加到自启动服务

pm2 save

pm2 save很重要, 它保存当前pm2 正在管理的NodeJS服务, 并在开机后恢复这些服务 至此, 安装配置完成

8. 卸载服务

pm2-service-uninstall

效果以下图所示：

5.结尾提示

服务器重启以后可能须要先启动Mongodb。

cd C:\Program Files\MongoDB\Server\4.0\bin

mongod.exe --config "C:\Program Files\MongoDB\Server\4.0\bin\mongod.cfg --install -serviceName "MongoDB"

net start MongoDB

pm2 restart all

如今命令已经添加到windows服务上了，之后只须要执行 net start MongoDB就能够启动Mongdb了。

如今你能够在浏览器打开 http://localhost:3000 管理你的api了。其余知识如邀请团队成员、pm2 启动 中止等有须要的本身学一下就行了，拜拜。