RAP2本地搭建

前言

2018年由于前后端分离，接口协定，于是自己想整一个接口管理后台，寻觅了半天，终于在芸芸众生中寻到了RAP2。这个版本是windows版按装笔记，后续本人还会整理一套linux版本的。

本人写这篇文章只是自己记性不好，参考 https://incoder.org/2018/03/27/rap2/ 的文档搭建的，在这里也只是方便，复述一遍，让自己以后方便安装。

安装参考,常见问题：https://incoder.org/2018/03/27/rap2/

环境要求

• Git
• Node.js 8.9.4+
• MySQL 5.7+
• Redis 4.0+

以上基本工具请根据自身需要，下载对应系统安装包，请自行解决安装配置等问题，点击可到安装教程。

Redis 最好用非安全模式启动
Redis 安装可参考 Linux 常用应用安装；

服务端 delos 环境搭建

构建项目

构建项目前，请确认 Node，Redis，MySQL 服务均能正常使用

克隆GitHub上的项目；

$ git clone https://github.com/thx/rap2-delos.git

环境配置

创建数据库

• Mac or Linux

$ mysql -e 'CREATE DATABASE IF NOT EXISTS RAP2_DELOS_APP DEFAULT CHARSET utf8 COLLATE utf8_general_ci';

• Windows 环境
  进入 mysql 命令后执行

$ CREATE DATABASE IF NOT EXISTS RAP2_DELOS_APP DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

配置文件

目录：rap2-delos/src/config
文件：config.dev.ts;其中 dev，表示开发环境，其他同理
修改：config.dev.ts文件中db对象中username，password参数与本地或者开发环境的数据库信息匹配

启动项目

安装项目依赖包

项目根目录下执行

# 安装项目所需依赖
$ npm install
# 全局安装PM2
$ npm install -g pm2

安装 TypeScript 编译包

$ npm install typescript -g

初始化数据库
项目根目录下执行 (该过程比较慢，耐心等待初始化完成)

$ npm run create-db

编译启动项目
执行 mocha 测试用例和 js 代码规范检查

$ npm run check

• 开发模式
  启动开发模式的服务器 监视并在发生代码变更时自动重启 (第一次运行比较慢，请耐心等待)

$ npm run dev

• 生产模式
  启动生产模式服务器

$ npm start

看到浏览器中如下提示，表示服务端 delos 已经部署成功

RAP2 后端服务已启动，请从前端服务 (rap2-dolores) 访问。 RAP2 back-end server is started, please visit via front-end service (rap2-dolores).

或者在程序控制台出现如下 Log，表示服务端 delos 已经部署成功

客户端 dolores 环境搭建

构建项目

获取源代码

$ git clone https://github.com/thx/rap2-dolores.git

环境配置

配置文件
目录：rap2-dolores/src/config
文件：config.dev.js; 其中 dev，表示开发环境，其他同理
修改：config.dev.js文件，serve地址是 服务端 rap2-dolores 部署成功后的地址，默认：'http://localhost:8080'

启动项目

安装项目依赖包
项目根目录下执行

$ npm install

编译启动项目

• 开发模式
  自动监视改变后重新编译

$ npm run dev

备注：测试用例

$ npm run test

• 生产模式
  编译 React 生产包

$ npm run build

用 serve 命令或 nginx 服务器路由到编译产出的 build 文件夹作为静态服务器即可

$ serve -s ./build -p 80

看到浏览器中出现登录页面，表示部署成功

本人遇到的问题

• 在客户端安装后，总是在过渡动画，出现报错net::ERR_CONNECTION_REFUSED

  本人查阅资料，发现这个报错是是因为请求地址错误的原因，So，我想到了是不是在config.dev.js中后段服务器的地址写错了，然后将地址修改成了，浏览器可访问的‘8080’端口地址。然后问题解决了。

• 前后端服务器用pm2管理进程

后段直接在cmd中

$  npm run start

在前端中

$ pm2 start dispatch.js --name=rap-server-dolores-prod

附录

• Redis 如何后台启动
• Redis 配置文件介绍
• PM2 实用入门指南

本篇搭建文章参考，摘取至 https://incoder.org/2018/03/27/rap2/