19 Star 176 Fork 60

vivo / MoonBox

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
quick-start.md 3.89 KB
一键复制 编辑 原始数据 按行查看 历史
xu.kai 提交于 2023-02-20 15:42 . Update quick-start.md

快速开始

Moonbox操作视频

1、项目简介 📹
2、代码简介 📹
3、本地部署 📹
4、功能简介 📹
5、流量录制简介 📹
6、流量回放简介 📹
7、自定义类Mock 📹
8、远程部署 📹

Moonbox平台部署

资源准备

资源类型 资源版本 说明
jdk 1.8 工程使用jdk版本
mysql 5.x 存储配置数据建表语句参考
elasticsearch 7.x(推荐7.16.2) 存储录制和回放 json数据 (es安装文档参考)
虚拟机/容器 2台分别部署moonbox-server和VUE前端资源(server和vue也可以部署在一台机器)

工程下载

月光宝盒是标准的maven工程,因此机器环境需要安装 java 和 maven 并配置好环境变量。 直接从代码仓下载代码到本地,在根目录执行 mvn clean install操作。执行maven工程的打包构建。

代码结构说明如下: 代码结构说明

server部署

Moonbox-server是标准的spring-boot工程,只需要按照spring-boot方式启动部署即可。部署前,需要修Moonbox/Moonbox-server/Moonbox-web/src/main/resource/application.properties 中配置

#mysql
spring.datasource.url=mysql链接地址
spring.datasource.username=mysql数据库名称
spring.datasource.password=mysql数据库密码
#es
config.elasticsearch.nodes=es集群http地址
#其他
moonbox.server.url=moonbox-server所部属机器的ip/域名,方便后续和agent交互

前端部署

1、修改vue.config.js文件中服务器地址,具体为

module.exports.devServer.proxy."/api".target="moonbox-server所部属机器的ip/域名"

2、安装nodejs及配置环境变量,可打开下方链接参考(nodejs版本建议安装12.10.0,版本过高会导致node-sass安装出现问题,如果出现权限问题,windows以管理员方式执行cmd执行命令,nodejs 12.10.0安装路径:https://nodejs.org/download/release/v12.10.0/)

win安装参考

mac安装参考

2、打开cmd或者powershell,cd至client目录

3、npm install

4、npm run dev

系统操作

流量的录制和回放可以在Moonbox管理台上可视化操作,操作详情请见 Moonbox操作手册

关于java进程

moonbox-java-agent 使用 transmittable-thread-local (简称ttl)进行跨线程录制回放,因此需要目标java进程使用ttl线程池或ttl runnable接口。

若目标java代码未使用ttl线程池,可以用java agent方式,在目标java进程启动时添加额外增强

-javaagent:D:\repository\com\alibaba\transmittable-thread-local\2.10.2\transmittable-thread-local-2.10.2.jar

更多请参见使用Java Agent来修饰JDK线程池实现类)

Java
1
https://gitee.com/vivo/MoonBox.git
git@gitee.com:vivo/MoonBox.git
vivo
MoonBox
MoonBox
main

搜索帮助