SandBox-repeater安装使用记录

缺乏、安全感 2023-01-01 04:54 60阅读 0赞

# SandBox简介 #

JVM沙箱容器，一种JVM的非侵入式运行期`AOP`解决方案。  
底层运行原理是结合了`ASM`框架中JVM的`agent、attach`机制注入目标程序  
更详细的介绍说明请参考：[https://github.com/alibaba/jvm-sandbox][https_github.com_alibaba_jvm-sandbox]

# SandBox-Repeater简介 #

基于`SandBox`基础上开发出的录制回放`Module`,目前该`Module`已经支持的插件类型有：`http、dubbo、ibatis、mybatis、java、redis、hibernate、spring-data-jpa`

# 获取sandBox #

## 1. 全量包下载址 ##

[http://sandbox-ecological.oss-cn-hangzhou.aliyuncs.com/sandbox-1.2.1-bin.tar][http_sandbox-ecological.oss-cn-hangzhou.aliyuncs.com_sandbox-1.2.1-bin.tar]

## 2. 源码下载地址 ##

[https://github.com/alibaba/jvm-sandbox][https_github.com_alibaba_jvm-sandbox]

sandBox的完整项目的文件目录如下  
![在这里插入图片描述][20201231152336921.png]

# 获取repeater #

## 1.全量包下载址 ##

[http://sandbox-ecological.oss-cn-hangzhou.aliyuncs.com/repeater-stable-bin.tar][http_sandbox-ecological.oss-cn-hangzhou.aliyuncs.com_repeater-stable-bin.tar]

## 2.源码下载地址 ##

[https://github.com/alibaba/jvm-sandbox-repeater][https_github.com_alibaba_jvm-sandbox-repeater]

`repeater`的文件目录如下  
![在这里插入图片描述][20201231152421818.png]

# 安装repeater #

将`repeater`目录下所有文件及文件夹拷贝到`SandBox\sandBox-module`目录下即可

# 启动`sandbox-repeater` #

## 1. 启动目标程序 `repeater-bootstrap` ##

(作者提供的`springboot demo`程序,该项目也包含了远程录制回放及配置相关的功能)  
在`repeater`目录下运行

java  -jar repeater-bootstrap.jar

## 2. 获取目标程序进程`id` ##

由于目标程序启动默认端口号为8001，所以使用以下命令获取pid

netstat -ano |findstr 8001

## 3. 启动`sandbox` ##

运行以下命令（这里标红的需要手动更改为当前运行环境的信息）

java -Xms128M -Xmx128M -Xnoclassgc -ea -Xbootclasspath/a:javaHome\lib\tools.jar -jar sandboxHome\lib\sandbox-core.jar targetpid sandboxHome\lib\sandbox-agent.jar home=sandboxHome;token=timestamp;server.ip=0.0.0.0;server.port=1111;namespace=default;

## 修改信息对照表 ##

<table> 
 <thead> 
  <tr> 
   <th>javaHome</th> 
   <th>当前机器jdk安装目录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>sandboxHome</td> 
   <td>sandBox 的根文件目录</td> 
  </tr> 
  <tr> 
   <td>targetpid</td> 
   <td>被注入的目标进程id,当前是12508</td> 
  </tr> 
  <tr> 
   <td>token</td> 
   <td>任意时间戳字符串 如:303515824929</td> 
  </tr> 
  <tr> 
   <td>server.port</td> 
   <td>sandBox-mgr服务绑定的端口号</td> 
  </tr> 
  <tr> 
   <td>server.ip</td> 
   <td>sandBox-mgr服务器绑定IP(默认为本地ip)</td> 
  </tr> 
 </tbody> 
</table>

# 检测启动状态 #

浏览器中输入，查看module列表是否存在repeater  
[http://127.0.0.1:1111/sandbox/default/module/http/sandbox-module-mgr/list][http_127.0.0.1_1111_sandbox_default_module_http_sandbox-module-mgr_list]  
启动成功则会议显示如下信息  
![在这里插入图片描述][20201231152843808.png]

# 录制回放 #

## 1、请求如下接口 ##

[http://127.0.0.1:8001/regress/slogan][http_127.0.0.1_8001_regress_slogan]  
返回如下信息

## 2、查看请求的traceId ##

在repeater.log日志中（log的路径:`C:\Users\userName\logs\sandbox\repeater`）找到对应的`traceId`  
![在这里插入图片描述][20201231153018103.png]

## 3、开始请求回放 ##

方式一：  
通过透传`traceId`（在header或者参数中带上`traceId`请求目标接口）

[http://127.0.0.1:8001/regress/slogan?Repeat-TraceId-X=192168056001157528042944310001ed][http_127.0.0.1_8001_regress_slogan_Repeat-TraceId-X_192168056001157528042944310001ed]

方式二:

通过`facadeApi`提供的接口进行回放

[http://127.0.0.1:8001/facade/api/repeat/unknown/192168056001157528042944310001ed][http_127.0.0.1_8001_facade_api_repeat_unknown_192168056001157528042944310001ed]

不管何种回放，最终都会进行请求到具体的目标程序，并且请求参数都会与第一次保持一致。

[https_github.com_alibaba_jvm-sandbox]: https://github.com/alibaba/jvm-sandbox
[http_sandbox-ecological.oss-cn-hangzhou.aliyuncs.com_sandbox-1.2.1-bin.tar]: http://sandbox-ecological.oss-cn-hangzhou.aliyuncs.com/sandbox-1.2.1-bin.tar
[20201231152336921.png]: /images/20221120/3b0bc131a766492da8854ed8c7aa0298.png
[http_sandbox-ecological.oss-cn-hangzhou.aliyuncs.com_repeater-stable-bin.tar]: http://sandbox-ecological.oss-cn-hangzhou.aliyuncs.com/repeater-stable-bin.tar
[https_github.com_alibaba_jvm-sandbox-repeater]: https://github.com/alibaba/jvm-sandbox-repeater
[20201231152421818.png]: /images/20221120/5d76c9ad3d4346dd9d37554b7d3f6f42.png
[http_127.0.0.1_1111_sandbox_default_module_http_sandbox-module-mgr_list]: http://127.0.0.1:1111/sandbox/default/module/http/sandbox-module-mgr/list
[20201231152843808.png]: https://img-blog.csdnimg.cn/20201231152843808.png
[http_127.0.0.1_8001_regress_slogan]: http://127.0.0.1:8001/regress/slogan
[20201231153018103.png]: https://img-blog.csdnimg.cn/20201231153018103.png
[http_127.0.0.1_8001_regress_slogan_Repeat-TraceId-X_192168056001157528042944310001ed]: http://127.0.0.1:8001/regress/slogan?Repeat-TraceId-X=192168056001157528042944310001ed
[http_127.0.0.1_8001_facade_api_repeat_unknown_192168056001157528042944310001ed]: http://127.0.0.1:8001/facade/api/repeat/unknown/192168056001157528042944310001ed