知识库

Loading

0 评论 / 0 点赞 / 179 阅读  新人入手  安装部署 最后更新: 2022-06-13 作者: 飞致云 总字数: 3324

1 环境要求

得益于 Docker 跨平台应用,MeterSphere 理论上可以部署在任何可以运行 Docker 的宿主机。
我们并非是只支持 Linux 操作系统,我们是支持可以部署 Docker 的任意 x86_64 的宿主机(Windows / Linux / macOS)。
本文将以 Windows 10 为例介绍如何在 Windows 10 上安装 MeterSphere。

注意:

云虚拟机可能不支持,需要嵌套虚拟化
物理机可以,Hyper-V 支持嵌套虚拟化

部署服务器要求:

操作系统: 可运行 Docker 的 Windows 操作系统
CPU/内存: 4核8G
磁盘空间: 200G

2 安装部署

2.1 安装 WSL

参考在 Windows 10 上安装 WSL | Microsoft Docs此问题,进行 Windows 宿主机的配置。

使用管理员身份运行:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启操作系统
下载适用于 x64 计算机的 WSL2 Linux 内核更新包

2.2 设置 WSL2 为默认

以管理员身份执行:

wsl --set-default-version 2

2.3 安装 Ubuntu

在 Windows 10 的应用商店里搜索"Ubuntu"并安装:
image-1655089532170

2.4 检测 Ubuntu WSL 版本

以管理员身份执行:

wsl.exe -l -v

image-1655089590283

示例中安装的 Ubuntu Name 为 “Ubuntu”, 如像上图出现 Ubuntu 版本为 1, 则继续执行命令:

wsl.exe --set-version Ubuntu 2

出现下图结果即为成功:
image-1655089665842

2.5 安装 Docker

下载Docker Desktop for Windows,如果使用的是 macOS,Install Docker Desktop on Mac | Docker Documentation

2.6 Docker 设置

Docker Desktop 安装完成后,进入 Settings 界面,选择 Resources 菜单下的 WSL INTEGRATION,按下图设置后,点击右下角的 Apply & Restart 即可。

image-1655089824890

2.7 下载安装包

请自行下载 MeterSphere 最新版本的离线安装包:

安装包下载链接: https://community.fit2cloud.com/#/products/metersphere/downloads

2.8 启动 Ubuntu

在应用商店里,选择 Ubuntu,点击"启动"按钮启动 Ubuntu,并执行命令切换到 root 用户:

sudo su -

image-1655089957867

2.9 检查 Docker 环境

在 Ubuntu 命令行中执行命令:

docker version

如能像下图一样正常显示 docker 版本信息,则能正常执行 MeterSphere 后续的安装操作,如出现异常,请根据提示信息解决异常问题。
image-1655090017089

2.10 解压安装包

在 Ubuntu 中,以 root 用户执行如下命令:

# 假设安装包存放路径为 c:\metersphere-offline-installer-v1.20.4-lts.tar.gz
cd /mnt/c
# 解压安装包
tar zxvf metersphere-offline-installer-v1.20.4-lts.tar.gz

2.11 配置安装参数(可选)

安装配置文件说明, 如果无特殊需求可以不进行修改采用默认参数安装

MeterSphere 支持以配置文件的形式来设置安装参数,如安装目录、服务运行端口、数据库配置参数等,安装前修改安装包中的 install.conf 文件可完成配置。
具体参数说明见:安装配置文件说明

2.12 执行安装脚本

# 进入安装包目录
cd metersphere-offline-installer-v1.20.4-lts
# 运行安装脚本
/bin/bash install.sh

注意:

/opt/metersphere/
├── bin                                         #-- 安装过程中需要加载到容器中的脚本
├── compose_files                               #-- 根据不同的安装模式,保存需要使用到的 compose 文件信息
├── conf                                        #-- MeterSphere 各组件及数据库等中间件的配置文件
├── data                                        #-- MeterSphere 各组件及数据库等中间件的数据持久化目录
├── docker-compose-base.yml                     #-- MeterSphere 基础 Docker Compose 文件,定义了网络等基础信息 
├── docker-compose-kafka.yml                    #-- MeterSphere 自带的 Kafka 所需的 Docker Compose 文件
├── docker-compose-mysql.yml                    #-- MeterSphere 自带的 MySQL 所需的 Docker Compose 文件
├── docker-compose-node-controller.yml          #-- MeterSphere Node-Controller 组件所需的 Docker Compose文件
├── docker-compose-server.yml                   #-- MeterSphere Server 及 Data-Streaming 所需的 Docker Compose文件
├── docker-compose-redis.yml                    #-- MeterSphere Redis 组件所需的 Docker Compose文件
├── docker-compose-prometheus.yml               #-- MeterSphere Prometheus 组件所需的Docker Compose 文件
├── install.conf -> /opt/metersphere/.env       #-- MeterSphere 的配置文件 /opt/metersphere/.env 的软链接
├── logs                                        #-- MeterSphere 各组件的日志文件持久化目录
└── version                                     #-- 安装包对应的 MeterSphere 版本信息

安装成功后,通过浏览器访问如下页面登录 MeterSphere

地址: http://目标服务器IP地址:服务运行端口
用户名: admin
密码: metersphere

image-1655090355908

3 常见问题及解决方式

3.1 创建容器失败,找不到文件或目录

image-1655090529962

解决方法:

将metersphere目录下的docker-compose-*.yml里的volumes都按照下面要求进行修改。(windows下的docker不要用单独的volumes定义,将下面路径写到上面,下面volumes部分可删)
image-1655090560387
image-1655090571124

3.2 执行安装脚本时,出现Container is unhealthy

image-1655090599003
解决方法:
1.执行命令 docker logs “23c9a9217da8”,如下图查看发现是没有权限
image-1655090623535
2.将挂载目录为由原来的/bitnami改为/data,重新执行/bin/bash install.sh
image-1655090647533

3.3 执行安装脚本,安装启动都没有报错,msctl status出现health:starting,之后docker ps -a发现promethus容器是Restarting状态

image-1655090678088
解决方法:
1.查看日志(docker logs containsId),如下图发现是promethus目录下的文件没有权限
image-1655090700026
2.手动给promethus目录赋权,之后重新执行安装脚本的命令。

chmod +777 /opt/metersphere/conf/promethus
chmod +777 /opt/metersphere/data/promethus

3.4 执行msctl status,发现ms-server状态是health:staring状态,访问前端也访问不了

image-1655090784385
解决方法:
1.查看/opt/metersphere/logs/info.log日志,如下图发现是redis连接有问题
image-1655090806131
2.修改/opt/metersphere/.env文件,将redis/kafka的ip换成本机ip,执行msctl reload后再执行msctl status,发现容器都正常启动。输入 http://IP:8081 可以正常访问网站。
image-1655090826186
image-1655090839465

文章目录
其他资源