什么是rap2
先来说说起因,在上一个星期的分享会上,谈到前后端联调上,有同事提到了rap2
,特意去了解了一下,觉得使用这个东西来进行前后端的接口联调来真是太方便了,对比我们之前公司内部开发的API Cloud
来说,我更偏向使用rap2
。
RAP通过GUI工具帮助WEB工程师更高效的管理接口文档,同时通过分析接口结构自动生成Mock数据、校验真实接口的正确性,使接口文档成为开发流程中的强依赖。有了结构化的API数据,RAP可以做的更多,而我们可以避免更多重复劳动。
上面是摘自https://github.com/thx/RAP淘宝阿里妈妈对rap1
的描述,看了图一下子就能明白,后端制定API
返回数据格式,前端通过接口地址在线mock,避免了前后端因为进度不一致而出现单方面等待的现象。
使用rap2
可以直接使用淘宝提供的在线服务来生成在线的接口地址,通过申请一个账号后,即可在里面进行接口的编写、测试等等...这里不再赘述。
部署自己的rap2服务
因为rap2在github上面已经开源,而且也提供了部署方案,这里讲一下自己是如何使用docker
来进行部署的。
前提
- 安装docker
- 安装docker-compose
涉及到的两个开源仓库:
rap2-delos: 后端数据API服务器,基于Koa + MySQL 戳这里
rap2-dolores: 前端静态资源,基于React 戳这里
或者使用本人的github仓库 Rynxiao/rap2-docker,已经包含了这两个仓库,并加入了配置。
后端部署
在后端部署方面,在github
上已经给出了使用docker
的部署方面,因此,just follow就好。
> mkdir rap2 > cd rap2 > git clone https://github.com/thx/rap2-delos.git > cd rap2-delos > docker-compose up -d
运行成功后,需要手动初始化数据库,我们进入对象的容器来操作:
> docker exec -it rap2-delos sh > node scripts/init > exit
重新启动服务:
> docker-compose down > docker-compose up -d
可以看到暴露出来的端口是38080
,我们使用curl
命令来测试一下是否成功,如果放回Hello RAP!
,就说明后端已经部署好了。
> curl localhost:38080
前端部署
前端由于没有提供对应的docker
部署方法,因此只有我自己来尝试部署了。前端使用的是node进行webpack打包,因此需要一个node的环境,所以我在制作容器的时候需要拉去一个node镜像。
因为部署前端之前没有看后端的部署,所以我前端拉取了一个比较新的版本[10.1.0],如果想和后端公用一个node镜像,可以使用这个node:8.11.1-alpine
镜像。
通过npm run build
之后,生成的build
文件夹中的只是静态资源文件,因此我还需要起一个服务器,这里我通过全局安装http-server
来启动一个服务。
下面是具体的过程:
1. git仓库拉取
> cd rap2 > git clone https://github.com/thx/rap2-dolores.git > cd rap2-dolores
2. 创建一个Dockerfile来构建一个新的node版本镜像
> 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
3. 使用docker-compose来启动服务
> 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
。
启动服务
> docker-compose up -d
这一步会执行镜像的构建,使用docker ps
可以查看最新的构建镜像,使用docker-compose ps
可以查看运行的容器
至此,我们就可以使用http://{youdomain}:38081
来访问rap2了。
nginx做二级域名转换
你可能希望上使用http://rap2.{youdomain}.com
来访问刚刚我们创建的rap2服务,这里我使用nginx做地址转换,步骤如下:
在腾讯云/万网中加一条A类记录
我使用的是腾讯云,阿里云的添加方法也大致类似,这里请大家自行谷歌。
在nginx中增加一个server配置
> cd /usr/local/nginx-1.13.9/conf > mkdir sites-enabled > cd sites-enabled > vim rap2.{youdomain}.com.conf
rap2.{youdomain}.com.conf中的内容如下:
server { listen 80; server_name rap2.{youdomain}.cn; access_log logs/rap2-site.log; location / { proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Real-Ip $remote_addr; proxy_set_header X-Forwarded-For $remote_addr; proxy_pass http://127.0.0.1:38081/; } }
其实就是做了一个端口转换。接下来在nginx.conf中进行引入
# nginx.conf http模块 include /usr/local/nginx-1.13.9/conf/sites-enabled/*.conf; # 重启nginx nginx -s reload
然后我们就可以使用rap2.{youdomain}.com
来访问rap2服务了
注:{youdomain}替换为自己的域名
小结
算是对之前学习的docker进行练手,通过实践还是学到了一些自己不太熟悉的领域的一些知识,记录共勉之。也希望大家多多支持。
《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。
更新动态
- 凤飞飞《我们的主题曲》飞跃制作[正版原抓WAV+CUE]
- 刘嘉亮《亮情歌2》[WAV+CUE][1G]
- 红馆40·谭咏麟《歌者恋歌浓情30年演唱会》3CD[低速原抓WAV+CUE][1.8G]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[320K/MP3][193.25MB]
- 【轻音乐】曼托凡尼乐团《精选辑》2CD.1998[FLAC+CUE整轨]
- 邝美云《心中有爱》1989年香港DMIJP版1MTO东芝首版[WAV+CUE]
- 群星《情叹-发烧女声DSD》天籁女声发烧碟[WAV+CUE]
- 刘纬武《睡眠宝宝竖琴童谣 吉卜力工作室 白噪音安抚》[FLAC/分轨][748.03MB]
- 理想混蛋《Origin Sessions》[320K/MP3][37.47MB]
- 公馆青少年《我其实一点都不酷》[320K/MP3][78.78MB]
- 群星《情叹-发烧男声DSD》最值得珍藏的完美男声[WAV+CUE]
- 群星《国韵飘香·贵妃醉酒HQCD黑胶王》2CD[WAV]
- 卫兰《DAUGHTER》【低速原抓WAV+CUE】
- 公馆青少年《我其实一点都不酷》[FLAC/分轨][398.22MB]
- ZWEI《迟暮的花 (Explicit)》[320K/MP3][57.16MB]