MeterSphereV2.3版本Mac本地启动详细教程（含常见错误）（二）

已于 2023-03-14 11:48:20 修改
阅读量3.9k 收藏 5
点赞数 2
分类专栏： 测试 文章标签： 测试工具 metersphere spring cloud spring boot
于 2022-11-18 22:42:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hao65103940/article/details/127930921
版权

一、准备工作

  1. 因为代码是java语言写的，所以提前准备好java的环境
  2. JDK11 ：https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html
  3. maven（3.6.2以上都行）：https://archive.apache.org/dist/maven/maven-3/
  4. git安装
  5. mac安装nodejs和npm：https://www.cnblogs.com/aspirant/p/15875878.html
  6. docker安装 （推荐v20.10）：https://www.docker.com/products/docker-desktop/
  7. mysql安装：https://cdn.mysql.com//Downloads/MySQL-8.0/mysql-8.0.30-macos12-x86_64.dmg
  8. redis安装：https://blog.csdn.net/yinjl123456/article/details/118977360
  9. minio安装：https://blog.csdn.net/sinat_29356635/article/details/127068778
  • 以上环境根据自己电脑系统安装即可。
  • 环境已准备好，请忽略。

二、下载代码

代码地址：https://github.com/metersphere/metersphere/tree/v2.3
需要拉取服务为：

  1. metersphere
  2. ms-jmeter-core
  3. jmeter-plugins-webdriver

三、Mac版本启动

3.1 启动前准备

参考官网把mysql，redis，还有metersphere.properties 分别准备好。（注意：windows系统注意metersphere.properties 的位置。类似：D:\opt\metersphere\conf\metersphere.properties）
https://metersphere.io/docs/v2.x/dev_manual/

V2.3. 版本做了微服务改造，目录结构区别还是蛮大的。

.
├── Jenkinsfile                                     # 构建JAR包使用的 jenkinsfile
├── LICENSE
├── OWNERS
├── README.md                                       # 项目中文介绍
├── README-EN.md                                    # 项目英文介绍
├── SECURITY.md                                     # 安全说明
├── CODE_OF_CONDUCT.md                        
├── CONTRIBUTING.md 
├── build.md                                        # 构建过程
├──framework                                          
│   ├── eureka                                       # 服务注册中心
│   ├── gateway                                      # API 网关
│   ├── sdk-parent                                   # SDK
│   ├── .gitignore                                    
│   └── pom                                          # 主框架的 pom 文件           
├──test-track                                        # 测试跟踪模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 测试跟踪模块使用的 pom 文件   
├── api-test                                         # 接口测试模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 接口测试模块使用的 pom 文件
├── performance-test                                 # 性能测试模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 性能测试模块使用的 pom 文件
├── report-stat                                      # 报表统计模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 报表统计模块使用的 pom 文件  
├── project-management                               # 项目管理模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 项目管理模块使用的 pom 文件 
├── system-setting                                   # 系统设置模块
│   ├── backend                                      # 后端代码目录
│   ├── frontend                                     # 前端代码目录
│   ├── Dockerfile                                   # 构建容器镜像使用的 dockerfile
│   └── pom                                          # 系统设置模块使用的 pom 文件
├── .gitignore
├── .gitmodules
└── pom.xml                                         # 整体 maven 项目使用的 pom 文件

以上工作都完成之后，我们就开始本地启动了。

3.2 打包依赖

注意：三个项目的maven仓库必须配置一致。如果在打包过程中包依赖找不到问题，就去看下自己的仓库地址是否一致。

因为启动metersphere 需要 一些依赖，所有我们在启动之前先把 ms-jmeter-core 和 jmeter-plugins-webdriver 给 打包一下:

mvn clean install

3.3 启动metersphere服务

以上依赖都打包好之后，开始执行以下命令，如果打包依赖有问题，请参考下面的问题解决。

在项目根目录下面执行以下命令

    1. 依赖打包
# parent pom 安装到本地仓库, sdk 也进行安装
./mvnw install -N
./mvnw clean install -pl framework,framework/sdk-parent,framework/sdk-parent/domain,framework/sdk-parent/sdk

#  如果是企业版本 需要加上  framework/sdk-parent/xpack-interface
    1. 整体打包
./mvnw clean package

image.png
以上是成功的图片

启动顺序

  1. 先启动eureka
  2. 再启动system-setting （创建数据库的），到这一步 如果可以启动成功，就可以访问页面了。

image.png

  1. 如果要进行多模块联调的话需要启动 gateway 和其他服务
  • 可以通过eureka查看服务信息,注册成功，就可以多模块联调了。

image.png

完整配置文件：

metersphere.properties
# eureka 配置
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/


# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/metersphere2.3?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=Calong@2015


# kafka 配置，node-controller 以及 data-streaming 服务需要使用 kafka 进行测试结果的收集和处理
kafka.partitions=1
kafka.replicas=1
kafka.topic=JMETER_METRICS
kafka.test.topic=JMETER_TESTS
kafka.bootstrap-servers=127.0.0.1:9092
kafka.log.topic=JMETER_LOGS
kafka.report.topic=JMETER_REPORT

# node-controller 所使用的 jmeter 镜像版本
jmeter.image=registry.cn-qingdao.aliyuncs.com/metersphere/jmeter-master:5.5-ms1-jdk11

# TCP Mock 端口范围
tcp.mock.port=10000-10010

# Redis 配置
spring.redis.host=localhost
spring.session.store-type=redis
spring.redis.port=6379
spring.redis.password=Password123@redis


# 启动模式，lcoal 表示以本地开发模式启动
run.mode=local

# minio 配置
minio.endpoint=http://localhost:9000
minio.accessKey=minioadmin
minio.secretKey=minioadmin

## CAS
#cas.client.name=MS_SERVER
## CAS SERVER URL
#cas.server.url=http://xxx/cas
## METERSPHERE SERVER URL
#as.client.url=http://IP:8081
mysql
[mysqld]
datadir=/var/lib/mysql

default-storage-engine=INNODB
character_set_server=utf8mb4
#lower_case_table_names=1  --> mysql8 初始化的时候带上
performance_schema=off
table_open_cache=128
transaction_isolation=READ-COMMITTED
max_connections=1000
max_connect_errors=6000
max_allowed_packet=64M
innodb_file_per_table=1
innodb_buffer_pool_size=512M
innodb_flush_method=O_DIRECT
innodb_lock_wait_timeout=1800

server-id=1
log-bin=mysql-bin
expire_logs_days = 2
binlog_format=mixed

character-set-client-handshake = FALSE
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
init_connect='SET default_collation_for_utf8mb4=utf8mb4_general_ci'

sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

skip-name-resolve

[mysql]
default-character-set=utf8mb4

[mysql.server]
default-character-set=utf8mb4

3.4 总结

  1. 准备好自己的环境
  2. 拉取metersphere代码，项目根目录下执行 ./mvnw install -N
  3. 拉取ms-jmeter-core和jmeter-plugins-webdriver 并且执行 mvn clean install
  4. metersphere 根目录下执行：
./mvnw clean install -pl framework,framework/sdk-parent,framework/sdk-parent/domain,framework/sdk-parent/sdk
  1. metersphere 根目录下执行：./mvnw clean package 打包跟网络和电脑自身的资源配置有关系（大约30min~2h）

以上就是源码启动MeterSphereV2.3微服务架构版本的方法，如有问题，欢迎指正。

四、常见遇到的问题

4.1 启动gateway 报错：“redis.ReactiveRedisSessionRepository” that cloud not be found.

  • 问题：是因为metersphere.properties 少了配置

image.png

  • 解决：

image.png
在metersphere.properties 添加以上配置即可。

4.2 启动服务模块报错：Error creating bean with name ‘minIOFileRepository’

  • 问题：

image.png

image.png

  • 解决：

是因为metersphere.properties 没有配置minio

image.png
添加以上配置：
参考：https://blog.csdn.net/sinat_29356635/article/details/127068778
http://docs.minio.org.cn/docs/master/minio-docker-quickstart-guide
https://blog.csdn.net/weixin_43888891/article/details/122021704

4.3 打包ms-jmeter-core报错 “Could not find artifact io.metersphere:meterspere:pom:2.3 ”

  • 问题

image.png

  • 解决：

以上问题是因为，没有找到对应的依赖，在mvn clean install ms-jmeter-core 项目之前 ，需要在metersphere项目主目录下面，执行 ./mvnw install -N
即：
image.png

然后再去ms-jmeter-core 项目下面执行 mvn clean install

4.4 打包ms-jmeter-core 报错Could not find “jmeter-plugins-webdriver:jar:3.4.4”

  • 问题

image.png

  • 解决

是因为没有“jmeter-plugin-webdriver”依赖包，
直接去Github仓库：https://github.com/metersphere/jmeter-plugins-webdriver下载，注意分支要跟metersphere版本一致。
直接执行mvn clean install

4.5 打包ms-jmeter-core报错"org.apache.commons.lang"不存在

  • 问题

image.png

  • 解决

在项目ms-jmeter-core的pom.xml文件里面添加

<dependency>
  <groupId>commons-lang</groupId>
  <artifactId>commons-lang</artifactId>
  <version>2.5</version>
</dependency>

4.6 启动gateway报错：”UnkonwHostException“

  • 问题

image.png

  • 解决

是因为配置文件地址不对。修改metersphere.properties 文件
image.png

4.7 启动system-setting 报错"which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by" mysql5.7

  • 问题：

image.png

  • 解决：
  1. 先查出来所有的sql_mode
select @@global.sql_mode;
  1. 然后把only_full_group_by去掉，再更新一下。
set @@global.sql_mode = "STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
灬囖
关注
专栏目录
Metersphere安装部署
wanghuiqin229的博客
02-09 1万+
准备环境：lunux服务器：8g,64位且可以访问互联网 一、在线安装 curl -sSL https://github.com/metersphere/metersphere/releases/latest/download/quick_start.sh | bash Metersphere被打包成一个镜像，他的安装脚本install.sh实际是利用docker进行安装，若服务器已经安装docker，则会根据脚本去拉取对应镜像，并实现安装部署。 若在线安装不成功，则需要我们下载离线安装包进行安装。 二、
【MeterSphere安装问题记录】dependency failed to start: container system-setting is unhealthy
Evaron的博客
06-15 3204
最近发现了一个开源的自动化测试平台metersphere，刚好现在的公司没有自动化平台，也不想再搞纯代码项目了，遂开始跟着。
已解决——Could not find artifact xxx 亲测有效！！！
最新发布
星辰探码的博客
08-06 1622
Could not find artifact xxx” 是 Maven 构建过程中常见的问题之一，但通过正确的方法和步骤，我们可以快速解决此问题。希望本文的介绍和亲测有效的解决方案能帮助开发者高效地解决类似问题，提升项目开发的顺利度。如果有其他问题或疑问，欢迎留言讨论。通过确认依赖库的正确性、检查仓库配置、清理本地仓库、检查网络连接和添加替代仓库等方法，开发者可以快速定位并解决“Could not find artifact xxx”问题。
metersphere 安装和本地启动步骤
Doubleeleph的博客
07-12 679
切换到安装目录 .\bin\windows\kafka-server-start.bat .\config\server.properties。按照这个链接内的步骤，缺什么再去搜索安装即可。安装过程中出现报错，可以搜索，可以找到对应的解决方式。输入 redis-server.exe redis.windows.conf。找到这个文件夹删除之后，再次输入上面那一长串启动即可。客户端链接 zkCli【这步骤可以不做】这个地方会出现启动失败的情况。启动服务 zkServer。
【centos7 MeterSphere设置服务自启动】
weixin_47370541的博客
10-07 832
metersphere
mac上metersphere本地开发环境搭建
cuishuangyuan的博客
04-28 5126
Metersphere文档地址：https://metersphere.io/docs/dev_manual/ 代码地址： #下载指定版本metersphere源码，最新版本可能要根据实际情况稍有改动 git clone https://github.com/metersphere/metersphere.git git reset --hard df1d5d7608b3e8cc9c45e63b648a2b8a84e03d42 （v1.19.3版本） 主系统：包含项目前端和后端 后端框架:...
MeterSphere使用指南
weixin_36888733的博客
07-14 298
一、简介MeterSphere是一站式开源持续测试平台，涵盖测试跟踪、接口测试、性能测试、团队协作等功能，兼容JMeter 等开源标准，有效助力开发和测试团队充分利用云弹性进行高度可扩展的自动化测试，加速高质量软件的交付。https://github.com/metersphere产品优势开源：基于开源、兼容开源；按月发...
MeterSphere部署与启动
AOLIGEI_2019的博客
06-21 4497
#https://www.cnblogs.com/tangda/p/10824273.html #博客园推荐学习博客 一、CentOS配置python3环境： 参考链接：https://www.cnblogs.com/knighterrant/p/10719887.html https://www.cnblogs.com/qiangyuzhou/p/10783519.html pip3 install --upgrade pip #升级pip3 进入pipenv环境
MeterSphere之设置服务开机自启动
qq_33417373的博客
08-13 6463
在MeterSphere日常使用过程中，服务器重启或者出现故障是可预见性的且实际存在的，如做服务器的冷迁移或者资源变更或者关机等情况，所以系统跟随服务器自启动必然也会成为某些用户的需求。 现就针对此需求，说明一下如何对metersphere 进行设置开机自启动(metersphere安装或者升级过程中并未添加docker自启动及MS服务启动） 一、设置docker服务自启动 #设置开机启动docker服务: systemctl enable docker 二、创建me
源码启动MeterSphereV2.6版本注意事项（三）
御良私塾
01-28 2350
当然从V2.3到V2.6中间经过3个月的迭代，变化很多，不仅功能有新增，并且页面交互也有了很大的改造，可见Metersphere的产品团队和用户一直在不断的成长，希望越来越好。当然，中间新增功能很多，各位可以部署详细去看下。以上截图图一为V2.6之前版本，图二为V2.6版本。通过对比，从视觉上，V2.6版本内容更加丰富了；样式更加规范了，给人的第一感觉就不很乱；从实用性上来讲，做了部分的统计功能，比如工作台->我的代办的统计；测试跟踪->用例数量统计、测试计划统计、定时任务统计等；
MeterSphere本地化部署实践
luozhuwang的专栏
01-19 1751
开发者需要先创建好对应文件夹，并将工程目录中 backend/src/main/resources/jmeter/bin 目录下的配置文件拷贝到 /opt/jmeter/bin 目录。请参考文档中的建库语句创建 MeterSphere 使用的数据库，metersphere-server 服务启动时会自动在配置的库中创建所需的表结构及初始化数据。metersphere-server 服务依赖的 JMeter 核心类库需要加载 JMeter 配置文件，默认加载 /opt/jmeter 下的配置文件。
开源持续测试平台Linux MeterSphere本地部署与远程访问
2301_77053417的博客
12-25 4323
MeterSphere 是一站式开源持续测试平台, 涵盖测试跟踪、接口测试、UI 测试和性能测试等功能，全面兼容 JMeter、Selenium 等主流开源标准，有效助力开发和测试团队充分利用云弹性进行高度可扩展的自动化测试，加速高质量的软件交付，推动中国测试行业整体效率的提升。下面介绍在Linux 中部署MeterSphere 并且结合cpolar 内网穿透实现远程也可以访问MeterSphere 界面!
Metersphere 源码启动并做性能测试（一）
御良私塾
09-16 4122
最近了解到在github上比较🔥的一个一站式开源测试平台https://github.com/metersphere/metersphere，一看还是JAVA写的，并且还是开源的，看了下官网文档，覆盖测试管理、接口测试、UI 测试和性能测试等众多功能，所以就想本地跑起来试试。
配置metersphere开机自启
qq_43189784的博客
08-16 477
快速配置metersphere开机自启动，解决服务器电源恢复后管理人员没在现场不能自动启动的问题
metersphere 测试平台安装记录
keny-大成的博客
10-06 1513
1.metersphere安装记录 curl -sSL https://github.com/metersphere/metersphere/releases/latest/download/quick_start.sh | sh --2020-10-06 22:09:30-- https://github.com/metersphere/metersphere/releases/latest/download/metersphere-release-v1.3.0.tar.gz 正在解析主机 gi..
MeterSphere实战（一）
weixin_43431593的博客
12-11 1972
MeterSphere是一位朋友讲到的测试平台，说这东西是开源的，因为我是做测试的，很乐意了解一些新鲜事物。在我看来，测试就是要专注一些领域，然后要啥都会一点点，接着融会贯通起来，这样就可以万变不离其中，啥都能测试了。自动化测试是测试领域的重要技术，与性能测试、安全测试并称为测试三剑客，还是挺有意思的一门学科。
打造远程测试利器：在Linux上部署MeterSphere并实现公网访问
qq_44103359的博客
04-14 654
本文详细介绍了如何在Linux环境下部署MeterSphere，并实现公网访问，以便进行远程测试工作。通过本文的介绍，读者可以了解到MeterSphere的部署流程、配置方法以及远程测试工作的步骤。掌握这些方法对于开发团队进行高效远程测试至关重要。随着MeterSphere的不断发展和完善，远程测试。
metersphere服务器断电重启后无法使用解决办法
qq_45808279的博客
11-15 1069
服务器异常关机后MySQL无法启动
使用MeterSphere2.10版本遇到的问题
Caoqingqing521的博客
05-30 175
1.测试计划执行时报node处理任务异常：/opt/metersphere/data/body/9c478027-e759-4464-b2e0-fa163d8b6803_4567b47e-a01e-41b2-8d01-ebb48f44949a.jmx (No such file or directory)场景：由于是Jmeter中写完的接口，直接导入MeterSphere的，所以单独执行是可以的，如果批量执行或者在测试计划中执行就会报错。解决：先把信息头管理关掉，然后再打开就可以了。
Docker容器常见故障
王笋的专栏
11-23 6168
以下是整理的容器类问题故障，分为9个类。
评论 7
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值