RAP2是阿里开源的接口管理平台,最近搭建了一下,将部署文档整理如下:
如果途中遇坑会在文章末尾记录下来嘻嘻
首先,确定环境是否部署好。
RAP2所需的环境为:
node.js 8.9.4+
mysql 5.7+
redis 4.0+
centos 6.5(后来搭建的时候升至最新了)
确定以上服务是否部署好如下:
centos 6.6
cat /etc/issue
node.js
[root@product-C local]# node -v
v8.11.4
mysql 5.7
[root@product-C local]# service mysqld status
mysqld (pid 12488) is running...
[root@product-C local]# chkconfig --list
redis 4.0
[root@localhost bin]# whereis redis-cli
redis-cli: /usr/local/bin/redis-cli
[root@localhost bin]# whereis redis-server
redis-server: /usr/local/bin/redis-server
确认完毕后,就可以开始部署RAP2了
由于 客户端:rap2-dolores 是建立在 服务端:rap2-delos 基础上,因此先搭建服务端应用
服务端delos环境搭建
构建项目
git clone https://github.com/thx/rap2-delos.git
环境配置
修改配置
git clone 下载之后,修改这几个文件的配置config.dev.ts、config.local.ts、config.prod.ts,位置在rap2-delos/src/config。三个文件都照如下修改好:
import { IConfigOptions } from "../types";
let config: IConfigOptions = {
version: '2.3',
serve: {
port: 8888 //你自己设置的端口,我是设置的8888
}, keys: ['some secret hurr'],
session: {
key: 'rap2:sess'
},
db: {
dialect: 'mysql',
host: 'localhost', //mysql服务器的ip,这里我是用的本地的mysql
port: 3306,
username: 'root', //mysql用户名
password: 'root', //mysql密码
database: 'RAP2_DELOS_APP', //rap2的后台数据库名
pool: {
max: 5,
min: 0,
idle: 10000
},
logging: false
},
redis:{
host: 'localhost',
port: 6379
}
}
export default config
创建数据库
修改完成之后,在上述配置的数据库上建立rap2的数据库:RAP2_DELOS_APP。
DROP DATABASE RAP2_DELOS_APP;
CREATE DATABASE IF NOT EXISTS RAP2_DELOS_APP DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
启动项目
安装项目依赖包
项目根目录下执行
安装项目所需依赖
npm install
全局安装PM2
npm install -g pm2
可能会出现什么gcc版本过低等问题,可百度去升级。
安装TypeScript编译包
npm install typescript -g
如果下载缓慢,请使用淘宝npm镜像
编译
npm run build,修改了项目的代码之后一定重新编译,不然修改不起作用。
一定要先编译,如果先初始化数据库,会提示dist目录不存在
初始化数据库
项目根目录下执行(该过程比较慢,耐心等待初始化完成)
npm run create-db
编译启动项目
执行mocha测试用例和js代码规范检查,可以检查项目的配置,代码的正确性。
npm run check
运行
开发模式
启动开发模式的服务器 监视并在发生代码变更时自动重启(第一次运行比较慢,请耐心等待)
npm run dev
正常结果截图:
生产模式
启动生产模式服务器
npm start
看到浏览器中如下提示,表示服务端delos已经部署成功
浏览器访问效果截图:
客户端dolores环境搭建
构建项目
获取源代码
git clone https://github.com/thx/rap2-dolores.git
环境配置
配置文件
目录:rap2-dolores/src/config
文件:config.dev.ts;其中dev,表示开发环境,其他同理
修改:config.dev.ts文件,serve地址是 服务端 rap2-delos 部署成功后的地址,默 认:'http://localhost:8080',修改成后端服务器的ip(rap2.msq.com)+之前配置的端口(8888);
启动项目
安装项目依赖包
项目根目录下执行
npm install
如果下载缓慢,请使用淘宝npm镜像
编译启动项目
开发模式
自动监视改变后重新编译
npm run dev
备注:测试用例
npm run test
生产模式
编译React生产包
npm run build
用serve命令或nginx服务器路由到编译产出的build文件夹作为静态服务器即可
serve -s ./build -p 80
正常启动截图:
用nginx指向localhost:8082
浏览器访问截图:
ps:配置nginx后要修改host:服务器Ip rap2.msq.com。(暂不做)
遇到的问题
在进入MySQL的时候,发现会报以下错误:
find / -name mysql.sock
ln –s /data/mysqld/mysql.sock /var/lib/mysql/
做一个软连接即可解决
在安装项目依赖包的时候,发现npm命令无效
也是做一个软连接即可解决
ln -s /data/nodejs/bin/npm /usr/local/bin/
安装依赖的时候出现了npm WARN saveError ENOENT: no such file or directory
后来发现没有在项目根目录执行
在安装依赖npm install的过程中出了下面的错误信息,也不算安装错误吧,应该说是因为权限问题安装的不完整。
解决方案
1.先判断环境问题,用node -v, npm -v查看版本号,判断是否安装了node环境。
2.尝试使用下面命令越过权限安装
sudo npm install
3.如果第二步骤安装成功就可以了,如果出现下面的错误
sudo: npm:找不到命令
办法是输入下面的命令
[root@localhost rap2-delos]# sudo ln -s /usr/local/bin/node /usr/bin/node
[root@localhost rap2-delos]# sudo ln -s /usr/local/lib/node /usr/lib/node
[root@localhost rap2-delos]# sudo ln -s /usr/local/bin/npm /usr/bin/npm
[root@localhost rap2-delos]# sudo ln -s /usr/local/bin/node-waf /usr/bin/node-waf
觉得npm慢可以走一下淘宝提供的捷径 npm install -g cnpm --registry=https://registry.npm.taobao.org
好了,接下来安装
[root@localhost rap2-delos]# npm install
搞定。
安装后,因为之前安装失败,有创建node_modules目录
用命令删除即可
rm -f /node_modules
之后,又出现了这个警告,百度得知,原因是因为: fsevent是mac osx系统的,在win或Linux下使用了所以会有警告,忽略即可。意思就是你已经安装成功了。
全局安装PM2的时候,会报一下警告,是因为没有用管理员权限运行
发现安装PM2成功之后,仍是无法找到命令,以下有一个通用方法解决:
解决方法:
用一个通用的命令配置环境变量
echo -e "export PATH=PATH" >> ~/.bashrc && source ~/.bashrc
上面的命令中使用 npm prefix -g 获取node安装目录
再执行命令 ~$ serve -v
成功
安装其他命令 也能成功执行
npm run dev error [npm ERR! code ELIFECYCLE]后来没有解决
但是可以用以下简单粗暴的方法试一试: node_modules安装问题,执行以下:
rm -rf node_modules
rm package-lock.json
npm cache clear --force
npm install
安装成功后,发现除了首页,在其他页面刷新都会出现404的问题
原因:
使用nginx解决,方法如下:
首先安装nginx,可以源码自己编译安装也可以直接yum安装。这里为了方便快速,直接用yum安装
但是发现直接安装会有以下错误:
后来百度一下,说缺少EPEL(epel是社区强烈打造的免费开源发行软件包版本库,系统包含大概有1万多个软件包)
版本寻找地址:http://fedoraproject.org/wiki/EPEL
我需要的是适用于6.x,我直接找到源后wget下载到当前目录:
wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
然后进行安装:
rpm -ivh epel-release-6-8.noarch.rpm
最后进行安装yum install nginx 解决问题。
在运行npm run test的时候,会报以下错误:
经过多方百度,后来问了大佬,得到了解决,超开心的
方法: 将console.log代替alert
完美解决
参考:
https://blog.csdn.net/msqplt/article/details/81450300 https://incoder.org/2018/03/27/rap2/ https://blog.csdn.net/yyzzhc999/article/details/79992505 http://www.1314yq.com/server/263.html https://blog.csdn.net/weixin_39690767/article/details/80025538 https://blog.csdn.net/weixin_37281289/article/details/79871923 https://blog.csdn.net/weixin_41004350/article/details/81737354