今天介绍下Yapi的接口管理工具的部署。
一、准备工作
-
1.1 环境
操作系统:CentOS 7 (CentOS-7-x86_64-Minimal-1708) 环境要求:nodejs(7.6+),mongodb(2.6+)
二、部署nodejs
部署nodejs尽可能选择偶数版本,因为偶数版本官方有较长的维护时间,故这次选择8.x。
获取资源
curl -sL https://rpm.nodesource.com/setup_8.x | bash -
安装
yum install -y nodejs
查看node版本
node -v
查看npm版本
npm -v
三、部署mongodb
mongodb奇数版(如3.5)是开发版本,故选择安装v3.4。
- 3.1 添加yum源
修改文件mongodb-3.4.repo
vim /etc/yum.repos.d/mongodb-3.4.repo
添加下面的内容,wq保存。
[mongodb-org-3.4]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/RedHat/$releasever/mongodb-org/3.4/x86_64/
gpgcheck= 0
enabled=1
- 3.2 安装
yum install -y mongodb-org
- 3.3 禁用selinux
官方教程有提到selinux对mongodb会产生负面影响,故选择禁用。
修改config文件
vim /etc/selinux/config
将SELINUX=enforcing改为SELINUX=disabled,wq保存。
重启OS
reboot
-
3.4 关闭防火墙
由于需要做数据迁移,所以直接省事将防火墙直接关了。
- 3.5 启动
service mongod restart
四、部署YApi
- 4.1 安装
npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server
根据提示,浏览器访问 http://部署YApi服务器的IP:9090。
填写完信息后,点击“开始部署”。(大概等待1分钟)
- 4.2 初始化账号
yapi-vendor@1.7.0 install-server /etc/my-yapi/vendors
node server/install.js
- 4.2 修改配置
这里我们不急着根据提示进行启动,有些参数我们可以通过修改配置达到。
修改config.json
vim /root/my-yapi/config.json
修改下面的内容(邮箱可以不用163的),wq保存。
{
"port": "80",
"adminAccount": "yizitadmin@yizit.cn",
"db": {
"servername": "127.0.0.1",
"DATABASE": "yapi",
"port": "27017"
},
"mail": {
"enable": true,
"host": "smtp.163.com",
"port": 465,
"from": "可用于发送邮件的163邮箱",
"auth": {
"user": "163邮箱",
"pass": "163邮箱对应的密码或授权码"
}
}
}
-
4.3 启动
切换到部署目录下
cd /etc/my-yapi
启动服务
node vendors/server/app.js
由于修改了配置,所以直接访问 http://部署YApi服务器的IP/login。
(ps:没有进行4.2修改配置的话是访问http://部署YApi服务器的IP:3000/login)
初始化账号:`部署填写的邮箱` , 密码:"ymfe.org"
登录后可以进行修改。
五、用supervisor的部署YApi的守护进程
-
5.1 编写/etc/supervisor/conf.d/yapi.ini
[program:yapi] directory = /etc/my-yapi command=node vendors/server/app.js user =root autostart=true autorestart=true startsecs=5 stderr_logfile=/etc/my-yapi/err.log stdout_logfile=/etc/my-yapi/out.log
-
5.2 加载supervisor配置并重启服务。
sudo supervisord -c /etc/supervisor/supervisord.conf
sudo supervisorctl -c /etc/supervisor/supervisord.conf -
5.3 查看运行状态
注意:
1.由于我是在测试机上部署环境,9090,3000不对外开放,所以我做了反向代理,
最后的proxy配置如下:
server {
listen 80;
server_name yapi.co;
location / {
charset utf-8;
#开启http1.1,支持长连接
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
#反向代理到3000端口
proxy_pass http://127.0.0.1:3000;
}
}
参考:
1.https://www.cnblogs.com/hu-qi/p/yapi.html
2.https://www.linuxidc.com/Linux/2018-01/150513.htm
来源:51CTO
作者:阿泽Aze
链接:https://blog.51cto.com/onebig/2386082