qasymphony/insights

qTest Insights 2 Docker镜像文档

1. 镜像概述和主要用途

1.1 概述

qTest Insights 2 Docker镜像是qTest Insights 2的官方公共容器化分发版本，旨在简化qTest Insights 2的部署与运行流程。该镜像基于1.21.31版本构建，集成了安全增强及漏洞修复，确保测试数据分析环境的稳定性与安全性。

1.2 主要用途

提供qTest Insights 2的容器化部署方案，支持快速搭建测试数据分析平台，帮助团队从测试过程中收集、分析数据并生成可视化报告，优化测试策略与产品质量监控。

2. 核心功能和特性

2.1 安全增强

本版本针对以下依赖库的已知漏洞进行修复，提升运行环境安全性：

2.2 核心功能

• 测试数据分析：自动化收集测试用例执行结果、缺陷分布、覆盖率等关键指标，支持多维度分析。
• 可视化报告：生成图表化报告（如趋势图、饼图、热力图），直观展示测试进度与质量风险。
• 容器化部署：基于Docker技术，简化环境配置，支持跨平台一致运行，降低部署复杂度。

3. 使用场景和适用范围

3.1 使用场景

• 测试团队需快速部署qTest Insights 2进行测试数据可视化与报告生成。
• QA部门定期分析测试质量趋势，向管理层输出产品质量评估报告。
• 开发与测试协同场景中，通过数据分析定位高频缺陷模块，指导开发优化。

3.2 适用范围

• 采用qTest系列工具进行测试管理的企业或团队。
• 需对测试数据进行集中化分析的中大型测试环境。
• 支持Docker容器化部署的Linux/Windows/macOS系统（需Docker Engine 20.10+）。

4. 使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine（推荐20.10+）及Docker Compose（可选）。
• 具备qTest Insights 2授权许可（如需商业功能）。
• 网络可访问Docker Hub或官方镜像仓库。

4.2 获取镜像

从官方仓库拉取镜像（假设镜像标签为qtest/insights:2.1.21.31）：

bash
docker pull qtest/insights:2.1.21.31

4.3 启动容器

4.3.1 基本命令（单容器）

bash
docker run -d \
  --name qtest-insights \
  -p 8080:8080 \  # 映射应用端口（容器内默认8080）
  -v /local/data:/app/data \  # 挂载数据持久化目录（本地路径需替换）
  -v /local/logs:/app/logs \  # 挂载日志目录
  -e QTEST_LICENSE_KEY="your-license-key" \  # 授权密钥（必填）
  -e DB_CONNECTION_STRING="jdbc:postgresql://db-host:5432/insights" \  # 数据库连接串
  -e DB_USERNAME="db-user" \  # 数据库用户名
  -e DB_PASSWORD="db-pass" \  # 数据库密码
  qtest/insights:2.1.21.31

4.3.2 Docker Compose配置（推荐生产环境）

创建docker-compose.yml：

yaml
version: '3.8'
services:
  insights:
    image: qtest/insights:2.1.21.31
    container_name: qtest-insights
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs
    environment:
      - QTEST_LICENSE_KEY="your-license-key"
      - DB_CONNECTION_STRING="jdbc:postgresql://db:5432/insights"
      - DB_USERNAME="postgres"
      - DB_PASSWORD="postgres-pass"
      - LOG_LEVEL="INFO"  # 日志级别：DEBUG/INFO/WARN/ERROR
    depends_on:
      - db  # 依赖PostgreSQL数据库（需单独配置）

  db:
    image: postgres:14
    container_name: insights-db
    restart: always
    ports:
      - "5432:5432"
    volumes:
      - ./db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB="insights"
      - POSTGRES_USER="postgres"
      - POSTGRES_PASSWORD="postgres-pass"

启动服务：

bash
docker-compose up -d

4.4 环境变量配置

4.5 验证部署

容器启动后，访问http://localhost:8080（或映射的宿主机IP:端口），通过qTest Insights 2控制台验证服务可用性。若启动失败，可查看日志排查：

bash
docker logs qtest-insights

4.6 注意事项

• 数据目录/app/data需持久化挂载，避免容器重启后数据丢失。
• 生产环境建议配置HTTPS（通过Nginx反向代理实现）。
• 定期更新镜像至最新版本，以获取安全补丁与功能优化。