简介

MeterSphere 是一站式开源持续测试平台, 涵盖测试跟踪、接口测试、UI 测试和性能测试等功能，全面兼容 JMeter、Selenium 等主流开源标准，有效助力开发和测试团队充分利用云弹性进行高度可扩展的自动化测试，加速高质量的软件交付，推动中国测试行业整体效率的提升。

官方地址：MeterSphere – 开源持续测试平台 – 官网

开源项目：GitHub – metersphere/metersphere

v2.3离线安装包：开源社区 – FIT2CLOUD 飞致云

MeterSphere 的功能

• 测试跟踪: 对接主流项目管理平台，测试过程全链路跟踪管理；列表脑图模式自由切换，用例编写更简单、测试报告更清晰；
• 接口测试: 比 JMeter 易用，比 Postman 强大； API 管理、Mock 服务、场景编排、多协议支持，你想要的全都有；
• UI 测试: 基于 Selenium 浏览器自动化，高度可复用的测试脚本； 无需复杂的代码编写，人人都可开展的低代码自动化测试；
• 性能测试: 兼容 JMeter 的同时补足其分布式、监控与报告以及管理短板; 轻松帮助团队实现高并发、分布式的性能压测，完成压测任务的统一调度与管理。

配置要求

lunux服务器：4 核 8 G 磁盘20G

macOS系统：4 核 8 G 磁盘20G

安装部署

其核心是基于docker 容器化安装和部署，需要对docker有一定了解。

常用命令

启动：msctl start
停止：msctl stop
查看状态： msctl status
重启：msctl restart
重载：msctl reload
查看版本：msctl version
卸载：msctl uninstall

默认安装目录都在 /opt/metersphere

一、在线安装

Metersphere整体被打包成一个镜像，他的安装脚本install.sh实际是利用docker进行安装，若服务器已经安装docker，则会根据脚本去拉取对应镜像，并实现安装部署。

curl -sSL https://github.com/metersphere/metersphere/releases/latest/download/quick_start.sh | bash

过程出现配置不兼容问题比较不好处理，推荐lunux服务器 尝试在线一键安装。

二、离线安装

这里以macOS 系统为例进行离线安装部署。linux 相对更为简单，可作为参考。

1.安装docker 以及docker-compose

1.1确认是否已安装Homebrew

fangyuan$ brew -v

打印输出

Homebrew 3.4.7

Homebrew/homebrew-core (git revision af15a30b144; last commit 2022-04-21)

Homebrew/homebrew-cask (git revision aac68e88a1; last commit 2022-04-20)

1.2说明已经安装，然后进行docker安装

brew install --cask --appdir=/Applications docker

1.1.1如果未安装Homebrew ，一下为Homebrew在线安装方式

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装完成会出现如下图标软件

2.Docker 设置

需要添加 /opt/metersphere 路径

3.下载安装包

开源社区 – FIT2CLOUD 飞致云

4.解压并安装

#创建文件夹
mkdir /opt/metersphere
#授权
chmod 777 /opt/metersphere
#将解压包copy至metersphere
cp yuorload/metersphere-offline-installer-v2.3.0.tar.gz  /opt/metersphere
#解压文件
tar -zxvf /opt/metersphere/metersphere-offline-installer-v2.3.0.tar.gz
#进入解压后的文件并安装
cd /opt/metersphere/metersphere-offline-installer-v2.3.0
sh install.sh 

正常安装完成会出现如下展示

所有镜像全部启动成功！

5.访问使用

地址：http://localhost:8081/#/login 初始化账密：admin/metersphere

正常情况下到这里是算大功告成了，但往往你能看到这里说明是有问题的，而它往往就不能是一次错误没有的顺利安装完成。

6.过程常见错误

6.1提示没有 docker-compose-* 文件

原因：

这是因为它默认安装路径为 /opt/metersphere/，回去这个路径下找相关的配置文件

解决方案：

1.将安装包路径下 metersphere 文件夹下的全部文件复制到 /opt/metersphere/ 文件下

#注意这里需要加-rf 因为该文件路径下存在文件夹需要一并copy到/opt/metersphere/ 
cp -rf /opt/metersphere/metersphere-offline-installer-v2.3.0/metersphere /opt/metersphere/

2.复制成功，进入到/opt/metersphere/metersphere-offline-installer-v2.3.0 文件下

3.重新执行install.sh

6.2创建容器失败，找不到文件或目录

原因：

查看相应docker-compose*.yml 其独立挂载的volumes在mac OS系统中不被识别

解决方案：

1.不适用独立挂载，将独立挂载的文件路径配置到相应容器服务的挂载配置下

举例如下：

6.3 找不到指定路径异常

Creating test-track … error

ERROR: for test-track Cannot start service test-track: error while mounting volume '/var/lib/docker/volumes/metersphere_ms-conf/_data': failed to mount local volume: mount /opt/metersphere/conf:/var/lib/docker/volumes/metersphere_ms-conf/_data, flags: 0x1000: no such file or directory

原因：

报错说明很明显，说找不到/var/lib/docker/volumes/metersphere_ms-conf/_data路径，这明显是不存在的，那为什么会出现呢，还是打开配置文件 docker-compose-test-track.yml ,这里注意下是/opt/metersphere，所有配置文件当前都指的是这个默认的路径下。发现存在这样的文件挂在：

很明显ms-*的路径是找不到的，其是它就是想把容器中对应的/opt/metersphere/conf 文件挂在到本地一个指定路径下，那么我们本地其实也有这个路径，因此我们将配置改为：

volumes:- /opt/metersphere/conf:/opt/metersphere/conf- /opt/metersphere/logs:/opt/metersphere/logs- /opt/metersphere/data:/opt/metersphere/data

当然你也可以简单暴力的挂载成这样：- /opt/metersphere/:/opt/metersphere/

msctl reload 之后看到该容器已经启动成功，其他容器类似操作即可。

6.4 发现 ms-server服务还是没有起来

原因：

提示连接redis 失败，而redis 本身启动正常，应该是全局配置文件问题。

解决方案：

查看配置文件需要指定ms_*_host= 到对应的服务地址上去支持name代替IP

msctl reload 重新加载