Yapi是我目前遇到最牛的免费接口管理工具,很强大!
安装条件:
nodejs(7.6+) ,默认的 centos 上面的 nodejs 版本是 v6.16.0
mongodb(2.6+),默认是没安装的,得安装下。
git,可以自己安装,暂时没用到。
第一步:升级 NodeJs 版本
之前搜索了很多文章,都是说用 n 工具升级,可是每一个成功的,可能我太菜。
直接下载源码包安装,然后修改环境变量最方便了。
参考文章:https://www.jb51.net/article/150718.htm
1、先去选择版本:https://nodejs.org/download/release/
我们选择了:node-v8.16.0-linux-x64.tar.xz 版本
2、创建安装目录:
# mkdir /usr/local/lib/nodejs
3、进入安装目录,并下载软件源码:
# cd /usr/local/lib/nodejs
# wget https://nodejs.org/download/release/latest-v8.x/node-v8.16.0-linux-x64.tar.xz
4、解压源码包:
# tar -xJvf node-v8.16.0-linux-x64.tar.xz -C /usr/local/lib/nodejs
5、重命名文件夹
# mv /usr/local/lib/nodejs/node-v8.16.0-linux-x64 /usr/local/lib/nodejs/node-v8.16.0
6、配置环境变量
# vim ~/.profile
输入以下内容:
export NODEJS_HOME=/usr/local/lib/nodejs/node-v8.16.0/bin
export PATH=$NODEJS_HOME:$PATH
7、刷新环境变量
# source ~/.profile
8、检查环境版本是否升级成功
# node -v
v8.16.0
9、建立系统的链接,简化调用
系统里面本来就有 node npm npx 命令,所以必须先移除或重命名
# mv /usr/bin/node /usr/bin/node_back
# mv /usr/bin/npm /usr/bin/npm_back
# mv /usr/bin/npx /usr/bin/npx_back
在建立软连接:
# ln -s /usr/local/lib/nodejs/node-v8.16.0/bin/node /usr/bin/node
# ln -s /usr/local/lib/nodejs/node-v8.16.0/bin/npm /usr/bin/npm
# ln -s /usr/local/lib/nodejs/node-v8.16.0/bin/npx /usr/bin/npx
====升级 nodejs 完成====
第二步:安装 MongoDb
参考文章:https://www.cnblogs.com/hujiapeng/p/7008006.html
1、先配置 yum 管理包,设置安装信息
# vim /etc/yum.repos.d/mongodb-org-3.4.repo
写入以下内容:
[mongodb-org-3.4]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.4/x86_64/
gpgcheck=1
enable=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.4.asc
2、Yum 安装
装mongodb(会安装mongodb-org包及其依赖包mongodb-org-server、mongodb-org-mongos、mongodb-org-shell、mongodb-org-tools)
数据库实例默认在 /var/lib/mongo 路径下,日志默认在 /var/log/mongodb 路径下,也可以通过修改 /etc/mongod.conf 文件的storage.dbPath和systemLog.path配置
# yum install -y mongodb-org
注意:安装过程比较慢,主要是下载慢,建议开启 Screen -S MongoDb 窗口后在执行命令安装。
安装过程出现错误:
GPG key retrieval failed: [Errno 14] curl#35 - "Cannot communicate securely with peer: no common encryption algorithm(s)."
直接升级 curl
# yum update curl
再重新安装:
# yum install -y mongodb-org
....
Dependency Installed:
mongodb-org-mongos.x86_64 0:4.0.9-1.el7 mongodb-org-server.x86_64 0:4.0.9-1.el7 mongodb-org-shell.x86_64 0:4.0.9-1.el7 mongodb-org-tools.x86_64 0:4.0.9-1.el7
Complete!
3、开启mongodb服务
# service mongod start
通过查看日志方式,验证服务开启成功,其中有一行为:[thread1] waiting for connections on port 27017
#cat /var/log/mongodb/mongod.log
4、设置开机启动
# chkconfig mongod on
5、其他 MongoDb 命令:
停止mongodb服务:service mongod stop
重启mongodb服务:service mongod restart
删除数据及日志:
rm -r /var/log/mongodb
rm -r /var/lib/mongo
第三步:安装 Yapi
参考文档:https://github.com/YMFE/yapi
或 https://yapi.ymfe.org/devops/index.html
1、npm 安装
# npm install -g yapi-cli --registry https://registry.npm.taobao.org
2、开启安装服务
# yapi server
注意:服务器要开启 9090 端口,否则没法访问安装界面
3、通过浏览器打开 http://x.x.x.x:9090/ 安装界面,点击安装即可。
最后看到成功提示:
.....
> yapi-vendor@1.7.0 install-server /root/my-yapi/vendors > node server/install.js
log: mongodb load success...
初始化管理员账号成功,账号名:"admin@admin.com",密码:"ymfe.org"
部署成功,请切换到部署目录,输入: "node vendors/server/app.js" 指令启动服务器, 然后在浏览器打开 http://127.0.0.1:3000 访问
4、开启 yapi 服务
# node /xxxx/yapi/vendors/server/app.js
又发现问题:我用了 gogs ,也用的是3000 端口,不行。
只能修改配置:
# vim /xxxx/yapi/config.json
"port":"3001" 换端口
再次启动,成功了:
[root@iZ23ugsp2h3Z yapi]# node /xxx/yapi/vendors/server/app.js
log: -------------------------------------swaggerSyncUtils constructor-----------------------------------------------
log: 服务已启动,请打开下面链接访问:
log: mongodb load success...
5、设置 Nginx 代理
server{
listen 80;
server_name yapi.phpriji.cn;
location / {
proxy_pass http://127.0.0.1:3001;
}
access_log /xxx/yapi.phpriji.cn.log;
}