YApi部署纪要（超详细部署教程 针对linux系统）

YApi部署纪要（详细教程 针对linux）
本人操作系统centos6.5

网站：
https://github.com/YMFE/yap

由于给出的自动安装报错（新版本1.4.1依赖的mongodb版本太高，安装时会产生bug），在此手动下载1.3.23进行zip安装。
下载包链接：
https://github.com/YMFE/yapi/releases

环境准备
操作系统：centos 7
环境要求：
nodejs>7.6
mongodb>2.6
git

一.安装nodejs

获取资源（部署nodejs尽可能选择偶数版本，因为偶数版本官方有较长的维护时间，故这次选择8.x。）
curl -sL https://rpm.nodesource.com/setup_8.x | bash -

安装
yum install -y nodejs

查看版本
node -v

查看npm版本
npm -v

二.安装mongodb

更新yum源，非必须但是更新一下无害
yum -y update

添加mongodb源文件，在/etc/yum.repos.d 创建一个 mongodb-org.repo 文件
touch /etc/yum.repos.d/mongodb-org.repo

编辑mongodb-org.repo文件
vim /etc/yum.repos.d/mongodb-org.repo

添加文件内容
[mongodb-org-3.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.2.asc

安装mongodb
yum install -y mongodb-org

启动mongodb
service mongod start

设置开机启动
chkconfig mongod on

打开moMongoDB(可忽略)
/bin/mongo

配置远程访问

修改mongod.conf配置文件
vim/etc/mongod.conf

注释 bindIp: 127.0.0.1
#bindIp: 127.0.0.1

重启mongod
service mongod restart

三.安装git
官方推荐，在内网部署的时候安装git，可以根据自己所需安装
yum -y install git

内网部署教程：
https://yapi.ymfe.org/devops/index.html

我采用的是命令行部署：
mkdir yapi
cd yapi
git clone https://github.com/YMFE/yapi.git vendors
//或者下载 zip 包解压到 vendors 目录（我采用是解压zip包，解压后重命名为vendors）
cp vendors/config_example.json ./config.json
//复制完成后请修改相关配置（关键一项，之后详细说明）
cd vendors
npm install --production --registry https://registry.npm.taobao.org
npm run install-server
//安装程序会初始化数据库索引和管理员账号，管理员账号名可在 config.json 配置
node server/app.js
//启动服务器后，请访问 127.0.0.1:{config.json配置的端口}，初次运行会有个编译的过程，请耐心等候

配置文件：
{
“port”: “3000”, //访问端口号
“adminAccount”: "[email protected]", //管理员账户
“db”: {
“servername”: “mongodb ip”, //数据库服务器ip
“DATABASE”: “yapi”, //数据库名
“port”: 27017,
“user”: “”, //没用户密码空着即可
“pass”: “”,
“authSource”: “”
},
“mail”: {
“enable”: true,
“host”: “smtp.126.com”, //126邮箱smtp服务器地址
“port”: 25, //126邮箱smtp端口号
“from”: “自己发送邮件的邮箱”,
“auth”: {
“user”: “自己发送邮件的邮箱名称，一般为邮箱全称”,
“pass”: “邮箱授权码或密码”
}
}
}

注：我的126配置授权码可用，密码不行，略坑，部署时在这里卡了很久。

要保证后台保持进程，需要安装pm2。
全局安装：
npm install -g pm2

启动：
cd vendors
pm2 start server/app.js --watch

pm2使用参考文档：
http://imweb.io/topic/57c8cbb27f226f687b365636

参考本文档基本可以完成部署。
部署中其他问题我参考了链接：
https://www.cnblogs.com/hu-qi/p/yapi.html

其他部署参考：
https://www.jianshu.com/p/5bda5556c149