RAP2环境搭建整理（超详细）

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=$(npm prefix -g)/bin:$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