环境配置
node版本8.9.4
可根据菜鸟教程安装mongodb
官网下载并安装最新版mongodb 下载地址
下载完安装包后,解压放到一个喜欢的文件夹里,改名为mongodb,方便命令操作与辨认
这里我放在usr-local下,后续路径也会是这个路径,可根据具体安装情况改变
配置环境变量
open -e .bash_profile (因为我这没有这个文件所以我要新建一个)
在mongodb下新建一个空的数据文件data,在data下新建一个db文件夹 在mongodb下新建一个空的日志文件log
mongodb准备工作完成后,开启服务
从mongodb文件夹下的bin进入终端,输入命令
这条命令是开启服务,它会一直运行,只要你要使用Mongodb,这个窗口就不能关
这样便是开启成功了
另开一个终端窗口,创建mongodb的用户名、密码
mongo # 进入mongodb use admin # 进入账号管理
// 创建全局账号,这里是一个管理员账号,不可创建数据库
db.createUser({ user: "admin", pwd: "123456", roles: [{ role: "userAdminAnyDatabase", db: "admin" }] })
// 创建超级管理员(可以创建数据库)
db.createUser({user:"root",pwd:"123456",roles:[{role: 'root', db: 'admin'}]})
鉴于这里是第一次使用,需要把yapi运行起来,没有别的需求,先创建了一个管理员账号
后续登陆可以使用 mongo -u admin -p 123456 # u 即是账号 , p 即是密码
5、把gitlab上yapi代码拉下来,地址 注:yapi二次开发文档
拉下来的代码放在一个空文件夹里,把项目文件夹里的config_example.json复制一份,放在与项目文件夹同级的地方,并改名为config.json
6、打开congfig.json,更改mongodb的用户名、密码,即刚刚创建的管理员账密,
authSource改为admin,目的是通过admin库进行登录认证
db.user 和 db.pass 是 mongodb 的用户名和密码,如果没有开启 mongo 认证功能,可以删除这两个选项。
7、打开yapi项目文件所在终端
7.1 .安装依赖
cd vendors npm install --registry registry.npm.taobao.org # 安装依赖,我用的这个可以成功,如果不成功,可以换成其他的镜像
7.2 初始化 (后续启动可跳过这一步,直接进行 7.3 )
npm run install-server # 安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置
默认输出
初始化管理员账号成功,账号名:"admin@admin.com",密码:"ymfe.org"
7.3 启动服务
npm run dev
启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候
127.0.0.1:3000
运行编译时间可能会久一点,大约半分钟左右
编译完成后,即可根据初始账密登陆yapi
登陆成功之后即可进行后续操作了
这里yapi连接mongodb就成功了,要想看到数据信息可以下载一个可视化工具
8、接下来可以下载一个mongodb可视化工具,查看yapi数据,推荐mongodb官方社区版MongoDB Compass,下载地址:www.mongodb.com/download-ce…
下载安装完成后,即可连接mongodb服务,进行查看
mongodb://是前缀,后面即是mongodb服务地址,点击connect‘,在yapi上操作的项目和接口就可以在可视化工具里的yapi目录里查看到,interface接口信息,project项目信息
问题清单
若启用server服务报错 鉴权失败
解决方案1:请重试创建mongodb的用户名、密码
解决方案2: 确认启动MongoDB服务器的目录是否为 MongoDB/bin/data