利用docker搭建rap2接口文档

这个是一篇转载文章，进行简化了

转载文章：https://www.cnblogs.com/rynxiao/p/9080179.html

部署自己的rap2服务

因为rap2在github上面已经开源，而且也提供了部署方案，这里讲一下自己是如何使用docker来进行部署的。

前提

安装docker
安装docker-compose

如果对docker不太熟悉，又想了解一下docker是什么的，不妨看看我之前的文章

涉及到的两个开源仓库：

rap2-delos: 后端数据API服务器，基于Koa + MySQL 戳这里
rap2-dolores: 前端静态资源，基于React 戳这里

后端部署

在后端部署方面，在github上已经给出了使用docker的部署方面，因此，just follow就好。

> mkdir rap2
> cd rap2
> git clone https://github.com/thx/rap2-delos.git
> cd rap2-delos
> docker-compose up -d

运行成功后，需要手动初始化数据库，我们进入对象的容器来操作：

1
2
3

> docker exec -it rap2-delos sh
> node scripts/init
> exit

重新启动服务：

1 2	> docker-compose down > docker-compose up -d

可以看到暴露出来的端口是38080，我们使用curl命令来测试一下是否成功，如果放回Hello RAP!，就说明后端已经部署好了。

前端部署

前端由于没有提供对应的docker部署方法，因此只有我自己来尝试部署了。前端使用的是node进行webpack打包，因此需要一个node的环境，所以我在制作容器的时候需要拉去一个node镜像。

因为部署前端之前没有看后端的部署，所以我前端拉取了一个比较新的版本[10.1.0]，如果想和后端公用一个node镜像，可以使用这个node:8.11.1-alpine镜像。

通过npm run build之后，生成的build文件夹中的只是静态资源文件，因此我还需要起一个服务器，这里我通过全局安装http-server来启动一个服务。

下面是具体的过程：

git仓库拉取

1
2
3

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

创建一个Dockerfile来构建一个新的node版本镜像
1
2
> touch Dockerfile
> vim Dockerfile

Dockerfile中的内容为：

# 拉取10.1.0版本的node镜像
FROM node:10.1.0

# 维护人
MAINTAINER ryn

# 创建工作目录
RUN mkdir -p /home/rap2-dolores
WORKDIR /home/rap2-dolores

# 将代码拷贝至工作目录
COPY . /home/rap2-dolores

# 全局安装http-server服务器
RUN npm install -g http-server

# 全局安装node-sass(一定要带--unsafe-perm，否则会报错)
RUN npm install --unsafe-perm -g node-sass

# 安装依赖
RUN npm install

# 打包
RUN npm run build

使用docker-compose来启动服务

1 2	> touch docker-compose.yml > vim docker-compose.yml

docker-compose.yml中的内容为：

version: '2.2'

services:
  delores:
    # 容器名称
    container_name: rap2-dolores
    
    # 通过Dockerfile来构建本地镜像
    build: .
    
    # 通过images来构建，这里的地址暂不适用，因为src/config中的配置需要根据自己的服务器来动态构建
    # image rynxiao/rap2-dolores-nodejs
    
    # 指定工作目录
    working_dir: /home/rap2-dolores
    
    # 指定生产环境
    environment:
      - NODE_ENV=production
      
    # 启动http-server，并映射端口到容器内部8081上
    command: /bin/sh -c 'http-server ./build -s -p 8081'
    privileged: true
    
    # expose port 38081
    ports:
      - "38081:8081"
更改src/config/config.prod.js中的配置，将接口请求地址指向你的后端服务器，以下是我的配置，各位按需更改。
module.exports = {
  serve: 'http://xxx.xxx.xxx.xx:38080',
  keys: ['some secret hurr'],
  session: {
    key: 'koa:sess'
  }
}

注意上面的xxx.xxx.xxx.xxx是你公网的ip地址，如果你通过端口映射做了二级域名的配置，也可以去掉端口号，直接写你的二级域名就可以了，比如你的二级域名为：http://rap2.xxx.com，那么serve就可以配置为http://rap2.xxx.com。

启动服务

1	> docker-compose up -d

这一步会执行镜像的构建，使用docker ps可以查看最新的构建镜像，使用docker-compose ps可以查看运行的容器

文章目录

部署自己的rap2服务

前提

后端部署

前端部署

启动服务