qTest Sessions OnPremise Docker镜像文档

1. 镜像概述和主要用途

qTest Sessions OnPremise Docker镜像是qTest Sessions应用的本地部署版本，基于Docker容器化技术构建。qTest Sessions是qTest Suite的核心组件之一，专注于测试会话管理，支持测试用例的执行规划、实时跟踪、结果记录及协作分析，帮助测试团队高效管理测试执行过程。该镜像适用于企业内部环境部署，满足数据本地化、自主可控的IT管理需求。

2. 核心功能和特性

2.1 测试会话管理

• 支持创建、编辑、删除测试会话，定义测试范围和执行计划
• 关联测试用例与需求，实现测试过程可追溯性

2.2 测试执行跟踪

• 实时记录测试用例执行状态（通过/失败/阻塞/跳过）
• 支持添加测试步骤结果、缺陷截图及备注信息

2.3 协作与沟通

• 测试会话内评论与讨论功能
• 支持测试结果实时同步至团队成员

2.4 集成能力

• 与qTest Manager、qTest Planner等qTest Suite组件无缝集成
• 支持与JIRA等缺陷管理工具对接，一键创建缺陷

2.5 权限与安全

• 基于角色的访问控制（RBAC）
• 测试数据加密存储，符合企业安全规范

2.6 报告与分析

• 生成测试会话执行摘要报告
• 支持自定义报表导出（CSV/Excel格式）

3. 使用场景和适用范围

3.1 适用组织

• 企业内部测试团队（需本地化部署测试工具的场景）
• 对数据隐私和合规性有严格要求的行业（金融、医疗、政府等）
• 已部署qTest Suite其他组件的用户

3.2 典型场景

• 中大型软件项目的测试执行管理
• 多团队协作的测试过程跟踪
• 需与内部现有IT系统（如LDAP、SSO）集成的场景
• 持续测试流程中的会话规划与结果分析

4. 使用方法和配置说明

4.1 前提条件

• Docker Engine 20.10+ 及 Docker Compose 2.0+
• 至少4核CPU、8GB内存、50GB可用磁盘空间
• 网络通畅，开放以下端口（可自定义）：
  • 应用端口：8080（HTTP）/ 8443（HTTPS，可选）
  • 数据库端口（若使用外部数据库）：5432（PostgreSQL）或3306（MySQL）
• 外部数据库（推荐PostgreSQL 12+ 或 MySQL 8.0+）

4.2 获取镜像

镜像需从qTest官方私有仓库或授权渠道获取，命令示例：

docker pull [私有仓库地址]/qtest-sessions-onpremise:latest

4.3 快速启动（docker run）

docker run -d \
  --name qtest-sessions \
  -p 8080:8080 \
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_NAME=qtest_sessions \
  -e DB_USER=qtest_user \
  -e DB_PASSWORD=secure_password \
  -e QTEST_MANAGER_URL=[***] \
  -v /data/qtest/sessions:/opt/qtest/sessions/data \
  [私有仓库地址]/qtest-sessions-onpremise:latest

4.4 Docker Compose配置示例

创建docker-compose.yml文件：

version: '3.8'

services:
  qtest-sessions:
    image: [私有仓库地址]/qtest-sessions-onpremise:latest
    container_name: qtest-sessions
    restart: always
    ports:
      - "8080:8080"
    environment:
      # 数据库配置
      DB_TYPE: postgres  # 支持postgres/mysql
      DB_HOST: postgres
      DB_PORT: 5432
      DB_NAME: qtest_sessions
      DB_USER: qtest_user
      DB_PASSWORD: ${DB_PASSWORD}
      # 应用配置
      SERVER_PORT: 8080
      LOG_LEVEL: INFO
      QTEST_MANAGER_URL: [***]
      QTEST_LICENSE_KEY: ${LICENSE_KEY}
      # 认证配置
      AUTH_TYPE: internal  # 可选：internal/ldap/sso
      LDAP_URL: ldap://ldap-server:389  # 仅当AUTH_TYPE=ldap时需配置
    volumes:
      - sessions-data:/opt/qtest/sessions/data
      - sessions-logs:/opt/qtest/sessions/logs
    depends_on:
      - postgres

  postgres:
    image: postgres:13-alpine
    container_name: qtest-sessions-db
    restart: always
    environment:
      POSTGRES_DB: qtest_sessions
      POSTGRES_USER: qtest_user
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  sessions-data:
  sessions-logs:
  postgres-data:

4.5 环境变量配置说明

4.6 持久化存储

需挂载以下目录以确保数据持久化：

• /opt/qtest/sessions/data：应用数据（测试会话记录、附件等）
• /opt/qtest/sessions/logs：应用日志
• 数据库数据目录（若使用容器化数据库，如示例中postgres-data卷）

4.7 启动与停止

启动服务

# 使用docker run
docker start qtest-sessions

# 使用docker-compose
docker-compose up -d

停止服务

# 使用docker run
docker stop qtest-sessions

# 使用docker-compose
docker-compose down

查看日志

docker logs -f qtest-sessions  # 实时查看应用日志

4.8 验证部署

1. 访问应用地址：http://<主机IP>:<SERVER_PORT>
2. 检查登录页面是否正常加载
3. 使用默认管理员账户（admin/admin123）登录（首次登录需修改密码）
4. 验证功能：创建测试会话、关联测试用例、执行测试并记录结果

5. 注意事项

• 生产环境需配置HTTPS（通过反向代理如Nginx实现）
• 定期备份数据库及持久化目录数据
• 镜像更新前需停止当前容器，并备份数据
• 环境变量中敏感信息（如DB_PASSWORD）建议通过Docker Secrets或环境变量文件管理，避免明文暴露