YApi接口管理平台的部署与应用

2019-07-19 本文已影响0人苏米西

一、平台介绍

二、环境要求

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：可能会有相关报错，主要和目录权限有关！修改即可

1561953386333.png

会有提示信息部署成功！

2、启动

上述部署成功后就会有提示：

初始化管理员账号成功,账号名："****@****.com"，密码："ymfe.org"

部署成功，请切换到部署目录，输入： "node vendors/server/app.js" 指令启动服务器, 然后在浏览器打开 http://127.0.0.1:3000 访问

 # cd 部署路径
 # node vendors/server/app.js

访问页面，登录！

image.png

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选项，保证恢复的完整性。