安装AngusTester-开启持续测试之旅

安装 AngusTester

1. 安装和运行AngusTester应用之前，需要先安装并运行AngusGM基础应用。
2. 以下是针对Enterprise安装过程说明，如果需要安装其他版本，将版本类型标志Enterprise替换成Community或Datacenter即可。

一、前置要求

• 系统要求

  • 操作系统：支持 Linux / MacOS / Windows Server。
  • 计算资源：最小配置要求 2核CPU、4GB内存，推荐配置 4核CPU、8GB内存。
  • 磁盘空间：最小 10GB 可用空间，推荐配置 100GB。

• 运行环境

  • 手动配置安装：需要配置 OpenJDK 17+，默认会自己安装。
  • Docker 和 Compose 部署：需要安装 Docker，推荐版本 V20.10+。

• 中间件

  • 数据库：需要 MySQL 5.7+。
  • Redis 缓存：需要 Redis 7.0+。

• 应用版本

  • 社区版本（Community）：永久免费版本。
  • 企业版本（Enterprise）：收费版本，需要获取许可。支持更多高级功能，支持更多用户。
  • 数据中心版本（Datacenter）：收费版本，需要获取许可。支持更多高级功能，支持多租户和更多用户。

二、手动配置安装

1. 下载并解压

# 下载安装包
curl -LO https://nexus.xcan.cloud/repository/release/package/AngusTester-Enterprise-1.0.0.zip

# 解压安装包至目标目录
mkdir -p /opt/AngusTester
unzip -qo AngusTester-Enterprise-1.0.0.zip -d /opt/AngusTester

# 进入到安装目录
cd /opt/AngusTester

2. 配置应用

# 复制配置模版文件
cp conf/.priv-template.env conf/.priv.env

# 编辑配置文件
vi conf/.priv.env

修改下面选项为你的配置：

# 初次安装或重新安装时需要设置成`AngusTester`，安装后会自动清除
INSTALL_APPS=AngusTester
# 指定安装数据库类型、必须参数
DATABASE_TYPE=MYSQL

# 应用程序IP(v4)或主机名。未配置时，自动获取运行环境的IPv4地址
# 注意：在docker环境中，必须指定为宿主机IP地址
TESTER_HOST=
# 应用程序端口，默认值为`8901`
TESTER_PORT=8901
# 配置Web站点访问地址，格式为：`http(s)://域名或IP+端口`，不指定会时会自动设置成：`http://GM_HOST:GM_PORT`
GM_WEBSITE=

# 管理员名称、可选参数
GM_ADMIN_FULL_NAME=
# 管理员邮箱地址、可选参数
GM_ADMIN_EMAIL=
# 管理员用户名，不指定时会自动设置成`admin`
GM_ADMIN_USERNAME=admin
# 管理员密码，不指定时会自动设置成`admin@123`
GM_ADMIN_PASSWORD=admin@123

# 数据库IP或主机名、必须参数
GM_DB_HOST=127.0.0.1
# 数据库端口、必须参数
GM_DB_PORT=3306
# 数据库名称、必须参数
GM_DB_NAME=angus
# 数据库用户名，该用户必须授权所有Angus数据库权限、必须参数
GM_DB_USER=Angus
# 数据库密码、必须参数
GM_DB_PASSWORD=Angus123

# Redis实例部署类型、必须参数
REDIS_DEPLOYMENT=SINGLE
# Redis实例IP或主机名、必须参数
REDIS_HOST=127.0.0.1
# Redis实例端口、必须参数
REDIS_PORT=6379
# Redis实例密码、必须参数
REDIS_PASSWORD=Angus123

# 配置angustester访问域名，可选参数
TESTER_WEBSITE=
# ------------------------

::: warning 注意

1. 以上配置除了INSTALL_APPS和TESTER_WEBSITE，其他配置选项应该和配置AngusGM应用选项保持一致。
2. 更多其他配置选项和说明请查看下面配置参考->应用配置。
   :::

3. 启动应用

# 运行启动命令
./startup-tester.sh

# 查看启动日志
tail -f -n1000 logs/tester.log

::: warning 注意

1. 该脚本是以后台进程启用应用，自动安装和启动大约需要2分钟，具体执行信息请查看 logs 日志文件内容。
2. 如果需要Nginx代理AngusTester应用，或通过Nginx虚拟服务器方式给应用配置域名，请查看下面配置参考->Nginx代理配置。
   :::

三、Docker方式安装

1. 准备安装目录与权限配置

# 创建主安装目录（必需步骤，用于后续挂载）
mkdir -p /opt/AngusTester 

# 进入安装目录进行操作
cd /opt/AngusTester

# 创建应用所需的子目录结构（配置文件、数据、日志等）
mkdir -p {
   
   data,logs,plugins,tmp}

# 设置目录权限（确保容器用户有读写权限）
# 注意：生产环境建议使用更精细的权限控制（如 chown 1000:1000）
chmod -R 777 /opt/AngusTester

2. 获取镜像与初始化配置

# 从 Docker Hub 拉取官方企业版镜像
docker pull xcancloud/angustester-enterprise:1.0.0

# 临时运行容器，将默认配置文件导出到宿主机目录
# 此步骤仅需执行一次，用于初始化配置模板
docker create --name temp_container xcancloud/angustester-enterprise:1.0.0
docker cp temp_container:/opt/AngusTester/default-conf conf
docker rm -f temp_container

# 基于模板创