testrail/apache

TestRail 预安装 Apache 镜像文档

镜像概述

本Docker镜像基于Apache Web服务器构建，预安装了TestRail测试管理软件，旨在为测试团队提供快速部署的测试管理环境。通过集成Apache服务与TestRail应用，镜像消除了手动安装配置的复杂性，实现开箱即用的测试管理系统部署，适用于各类测试流程管理需求。

核心功能和特性

• 预安装TestRail：镜像内置TestRail测试管理软件，无需手动下载安装
• 集成Apache环境：包含完整的Apache Web服务器配置，满足TestRail运行需求
• 简化部署流程：省去环境依赖配置、软件安装等步骤，一键启动测试管理系统
• 环境一致性：通过Docker容器化确保不同环境下的部署一致性，避免"环境差异"问题
• 可移植性：支持在任何支持Docker的环境中运行，包括本地服务器、云平台等
• 基础配置优化：默认配置已针对TestRail运行进行基础优化，提升初始使用体验

使用场景和适用范围

适用场景

• 测试团队快速搭建测试管理平台，开展测试计划、用例管理与结果跟踪
• 开发或测试环境中临时部署TestRail，支持短期项目或验证需求
• 教学或演示环境中展示TestRail功能与测试管理流程
• 需要频繁部署或迁移测试管理系统的场景

适用范围

• 使用TestRail进行测试管理的团队或个人
• 追求快速部署、简化配置的测试环境需求
• 具备基础Docker使用经验的技术团队
• 需要跨环境保持一致测试管理配置的场景

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐20.10.0+版本）
• 可用的数据库服务（TestRail支持MySQL 5.7+/8.0+或PostgreSQL 10+，需提前准备）
• 至少1GB内存和10GB磁盘空间

镜像拉取

bash
docker pull [镜像仓库地址]/apache-testrail:latest

注：请替换[镜像仓库地址]为实际的镜像仓库路径

基本运行命令

bash
docker run -d \
  --name testrail-server \
  -p 80:80 \
  -e DB_HOST=your-db-host \
  -e DB_NAME=testrail_db \
  -e DB_USER=testrail_user \
  -e DB_PASSWORD=your-db-password \
  -v /path/to/testrail-data:/var/www/testrail \
  [镜像仓库地址]/apache-testrail:latest

参数说明

访问TestRail

容器启动后，通过浏览器访问以下地址进入TestRail：

http://[主机IP或域名]:[映射端口]

首次访问将引导完成TestRail初始化配置，默认管理员账号为：

• 用户名：admin@admin.com
• 密码：admin

首次登录后请立即修改管理员密码

数据持久化

为避免容器重启或删除导致数据丢失，建议通过-v参数挂载以下目录：

• /var/www/testrail：TestRail应用数据目录（包含配置、上传文件等）
• /var/log/apache2：Apache日志目录（可选，用于问题排查）

自定义配置

如需修改Apache或TestRail配置，可通过以下方式：

1. 挂载自定义配置文件到容器内对应路径（如Apache配置：-v /local/apache.conf:/etc/apache2/sites-available/000-default.conf）
2. 进入容器内部修改配置（需重启服务生效）：

bash
docker exec -it testrail-server /bin/bash
# 修改配置后重启Apache
service apache2 restart

停止与重启

bash
# 停止容器
docker stop testrail-server

# 重启容器
docker restart testrail-server

# 删除容器（需先停止）
docker rm testrail-server