一、平台介绍
二、环境要求
- nodejs（7.6+)
- mongodb（2.6+）
- git
三、部署
本次部署环境： centos-6.9
git-2.4.8、mongodb-3.2
node-10.16.0、npm-6.9.2
1、环境安装
1.1、nodejs安装
1.1.1、下载二进制包
$ wget https://nodejs.org/dist/v10.16.0/node-v10.16.0-linux-x64.tar.xz
1.1.2、安装
$ sudo xz -d node-v10.16.0-linux-x64.tar.xz
$ sudo tar -xvf node-v10.16.0-linux-x64.tar
$ sudo mv node-v10.16.0 /data/svr/node
1.1.3、配置环境变量
$ echo "export PATH=/data/svr/node/bin:$PATH" >> /etc/profile
$ source /etc/profile
1.1.4、查看是否安装成功
$ node -v
v10.16.0
$ npm version
{ npm: '6.9.0',
ares: '1.15.0',
brotli: '1.0.7',
cldr: '35.1',
http_parser: '2.8.0',
icu: '64.2',
modules: '64',
napi: '4',
nghttp2: '1.34.0',
node: '10.16.0',
openssl: '1.1.1b',
tz: '2019a',
unicode: '12.1',
uv: '1.28.0',
v8: '6.8.275.32-node.52',
zlib: '1.2.11' }
$ npx -v
6.9.0
1.2、git安装
1.2.1、安装依赖
# yum install -y curl-devel expat-devel gettext-devel openssl-devel zlib-devel asciidoc gcc perl-ExtUtils-MakeMaker xmlto
1.2.2、安装
# wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.4.8.tar.gz
# yum remove git -y ps:本机自带git1.7，先卸载哟！
# tar xzf git-2.4.8.tar.gz
# mv git-2.4.8 /data/svr/git
# cd /data/svr/git
# make prefix=/data/svr/git all
# make prefix=/data/svr/git install
# echo "export PATH=$PATH:/data/svr/git/bin" >> /etc/bashrc
# source /etc/bashrc
# git --version
git version 2.4.8
# git clone git://git.kernel.org/pub/scm/git/git.git 建立版本库镜像（选！）
1.3、mongodb安装
# vim /etc/yum.repos.d/MongoDB.repo
[mongodb-org-3.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.2/x86_64/
gpgcheck=0
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-3.2.asc
# yum install -y mongodb-org*
# vim /etc/mongod.conf
# bindIp: 127.0.0.1 # Listen to local interface only, comment to listen on all
注释此行!当然目录那些也可按需更改！
# sudo service mongod start
1.4、yapi安装
# npm install -g yapi-cli --registry https://registry.npm.taobao.org
# yapi server
在浏览器打开 http://0.0.0.0:9090 访问。非本地服务器，请将 0.0.0.0 替换成指定的域名或ip
访问ip：9090 ，ps：防火墙或者云服务器安全组
ps：可能会有相关报错，主要和目录权限有关！修改即可
会有提示信息部署成功！
2、启动
上述部署成功后就会有提示：
初始化管理员账号成功,账号名："****@****.com"，密码："ymfe.org"
部署成功，请切换到部署目录，输入： "node vendors/server/app.js" 指令启动服务器, 然后在浏览器打开 http://127.0.0.1:3000 访问
# cd 部署路径
# node vendors/server/app.js
访问页面，登录！
3、后台启动
ps：由于默认启动方式，是前台启动的方式，当ssh关闭后，启动也会关闭，所以需要采用后台启动的方式。
这里主要采用pm2
# npm install -g pm2
# pm2 start vendors/server/app.js
# pm2 start/restart/stop 文件
3.1、pm2使用
- 查看详细状态信息
pm2 show (appname|id)
-
查看所有启动的进程列表
pm2 list
-
监控每个 node 进程的 cpu 和内存使用情况
pm2 monit
-
显示所有进程的日志信息
pm2 logs
4、版本升级
升级项目版本是非常容易的，并且不会影响已有的项目数据，只会同步 vendors 目录下的源码文件。
# cd {项目目录} # yapi ls //查看版本号列表 # yapi update //更新到最新版本 # yapi update -v {Version} //更新到指定版本
四、yapi数据迁移
1、界面迁移
2、数据库数据迁移
这里主要使用两个命令：mongodump、mongorestore
2.1、数据导出
# mongo
# show dbs;
local 0.000GB
yapi 0.010GB
# exit
导出：
# mongodump -h dbhost -d dbname -o dbdirectory 用法
# mongodump -d yapi -o /home/apps/
-
-h：
MongDB所在服务器地址，例如：127.0.0.1，当然也可以指定端口号：127.0.0.1:27017
-
-d：
需要备份的数据库实例，例如：yapi
-
-o：
备份的数据存放位置，例如：/home/apps，当然该目录需要提前建立，在备份完成后，系统自动在dump目录下建立一个yapi目录，这个目录里面存放该数据库实例的备份数据。
2.2、数据导入
如果在其他主机部署了一个新的yapi，那么最好先把现有的记录删除。
# mongorestore -h dbhost -d dbname --dir backupdirectory
# mongorestore -d yapi --drop --dir /home/apps/yapi
-
--h：
MongoDB所在服务器地址，默认为： localhost:27017
-
-d ：
需要恢复的数据库实例，例如：yapi，当然这个名称也可以和备份时候的不一样，比如test
-
--drop：
恢复的时候，先删除当前数据，然后恢复备份的数据。就是说，恢复后，备份后添加修改的数据都会被删除，慎用哦！
-
backupdirectory：
mongorestore 最后的一个参数，设置备份数据所在位置，例如：/home/apps/yapi。
-
--dir：
指定备份的目录
温馨提示：最好备份恢复时让mongodb以及yapi版本保持一致，不然容易出错。同时最好加上--drop选项，保证恢复的完整性。
