yapi 权限_YApi接口管理平台的部署与应用

一、平台介绍

二、环境要求

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