镜像概述

主要用途

该Docker镜像旨在提供便捷的突变测试报告远程访问能力，消除本地查看报告的环境限制，支持用户通过网络从任何设备、任何地点访问突变测试结果，简化测试报告的共享与协作流程。

核心功能与特性

• 跨平台访问：支持通过浏览器在电脑、手机、平板等各类设备上查看报告，无需考虑设备类型与操作系统
• 无本地依赖：无需在本地安装报告查看工具或依赖特定运行环境，直接通过Docker容器提供服务
• 灵活集成：可与本地文件系统或远程存储的突变测试报告文件无缝集成，支持常见报告格式
• 轻量部署：容器化设计确保快速启动与资源高效利用，适合开发环境与生产环境部署

使用场景与适用范围

• 团队协作场景：开发团队成员可远程访问同一突变测试报告，便于代码质量评审与问题定位
• 远程办公需求：团队成员在不同物理地点时，无需传输报告文件即可实时查看最新测试结果
• CI/CD流程集成：可作为CI/CD流水线的补充组件，在测试阶段完成后自动部署报告查看服务
• 个人项目管理：个人开发者可快速搭建报告查看服务，集中管理多个项目的突变测试结果

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动容器，映射本地报告目录并暴露访问端口：

docker run -d \
  -p 8080:80 \
  -v /本地报告目录路径:/app/reports \
  --name mutation-report-viewer \
  [镜像名称]

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口（主机端口可自定义）
• -v /本地报告目录路径:/app/reports：挂载本地突变测试报告所在目录到容器内/app/reports路径
• --name mutation-report-viewer：指定容器名称，便于后续管理

环境变量配置

通过环境变量自定义容器运行参数，支持的配置项如下：

带认证的部署示例：

docker run -d \
  -p 8080:8080 \
  -v /data/mutation-reports:/app/reports \
  -e PORT=8080 \
  -e BASIC_AUTH_ENABLED=true \
  -e BASIC_AUTH_USER=devteam \
  -e BASIC_AUTH_PASSWORD=Secure@2024 \
  --name mutation-report-viewer \
  [镜像名称]

Docker Compose配置

对于需要持久化部署或多容器协同的场景，可使用docker-compose.yml配置：

version: '3.8'
services:
  mutation-report-viewer:
    image: [镜像名称]
    container_name: mutation-report-viewer
    ports:
      - "8080:80"  # 主机端口:容器端口（需与PORT环境变量一致）
    volumes:
      - ./local-reports:/app/reports  # 本地报告目录相对路径
    environment:
      - PORT=80
      - BASIC_AUTH_ENABLED=true
      - BASIC_AUTH_USER=admin
      - BASIC_AUTH_PASSWORD=Report@2024
    restart: unless-stopped  # 容器退出时自动重启（非手动停止情况）

启动命令：docker-compose up -d

访问报告

容器启动后，通过浏览器访问以下地址即可查看报告：
http://<主机IP>:<映射端口>

示例：若主机IP为192.168.1.100，映射端口为8080，则访问地址为 [***]。启用基础认证时，需输入配置的用户名和密码进行验证。