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