yapi部署文档

windows 下 yapi部署文档

1. 安装nodejs
2. 安装mongodb
3. 安装yapi

介绍

随着 web 技术的发展，先后端分离成为愈来愈多互联网公司构建应用的方式。先后端分离的优点是一套 Api 可被多个客户端复用，分工和协做被细化，大大提升了编码效率，但同时也带来一些“反作用”:

1. 接口文档不可靠。不少小伙伴管理接口文档，有使用 wiki 的，有 word 文档的，甚至还有用聊天软件口口相传的，后端接口对于前端就像一个黑盒子，常常遇到问题是接口因未知缘由增长参数了，参数名变了，参数被删除了。
2. 测试数据生成方案没有统一出口。咱们都有这样的经历，前端开发功能依赖后端，解决方案有本身在代码注入 json 的，还有后端工程师临时搭建一套测试数据服务器，这种状况下势必会影响工做效率和代码质量，也不能及时进行更新。
3. 资源分散，没法共享。接口调试每一个开发者单独维护一套 Postman 接口集，每一个人没法共用其余人的接口集，存在大量重复填写请求参数工做，最重要的是 postman 无法跟接口定义关联起来，致使后端没有动力去维护接口文档。 基于此，咱们在前端和后端之间搭建了专属桥梁—— YApi 接口管理平台

安装mongodb

• 安装mongodb 到 D:\Mongo
• mongodb 安装目录下建立几个文件夹具体以下

1. 数据库路径（data目录）

2. 日志路径（logs目录）

3. 日志文件（mongo.log文件）

4. 建立配置文件mongo.conf，文件内容以下：路径修改成对应路径

#数据库路径  
dbpath=D:\Mongo\data  
#日志输出文件路径  
logpath=D:\Mongo\logs\mongo.log  
#错误日志采用追加模式  
logappend=true  
#启用日志文件，默认启用  
journal=true  
#这个选项能够过滤掉一些无用的日志信息，若须要调试使用请设置为false  
quiet=true  
#端口号 默认为27017  
port=27017   

5） 建立并启动MongoDB服务，执行下面命令

mongod --config "D:\Mongo\mongo.conf" --install --serviceName "MongoDB"

net start MongoDB

安装yapi

1. 克隆项目到本地
2. 使用命令进入项目所在目录
3. 首次使用先运行npm install -g yapi-cli --registry https://registry.npm.taobao.org
4. 运行yapi server
5. 访问http:\ip:9090进行yapi部署
6. 切换到部署目录，输入node vendors/server/app.js
7. 访问http:\ip:3000

注意

• 若是内网安装 能够先在外网安装好后而后拷贝代码和mongodb 数据文件到内网
• 内网环境 antd 的图标没法看到
• mongodb-win32-x86_64-2008plus-ssl-3.4.10-signed mongodb 若是是3.6安装时候须要官网下载 补丁