mozilla/treeherder

Mozilla Treeherder Docker镜像文档

1. 镜像概述

Mozilla Treeherder是一款开源的CI/CD结果可视化与分析工具，主要用于帮助开发团队实时监控、分析自动化测试结果，提升软件质量与开发效率。该工具最初为Mozilla Firefox等大型项目设计，现广泛适用于各类需持续集成/持续部署的开发场景，支持多CI系统数据整合与深度结果分析。

2. 核心功能与特性

2.1 多源数据集成能力

• 兼容主流CI系统（Jenkins、Taskcluster、GitHub Actions等）数据导入
• 提供标准化数据转换接口，支持自定义CI输出格式适配

2.2 实时可视化监控

• 实时展示测试任务状态（通过/失败/进行中）与执行进度
• 树状层级视图呈现任务依赖关系，颜色编码标识状态异常
• 支持多分支、多平台测试结果并行展示

2.3 深度测试结果分析

• 历史趋势追踪：测试通过率、执行时间等关键指标时序分析
• 失败模式聚类：自动识别重复失败场景，归类相似问题
• 性能基准对比：支持不同版本/分支测试性能数据横向比较

2.4 开放集成与扩展

• 完整REST API支持第三方系统集成（通知工具、问题跟踪系统等）
• 可自定义数据处理器与视图插件，满足特定业务需求

3. 典型使用场景

3.1 开发团队日常测试监控

• 实时跟踪代码提交后的自动化测试结果，快速定位提交引入的回归问题
• 监控夜间构建与大规模测试任务执行状态，及时发现阻塞问题

3.2 CI/CD流程优化

• 分析测试任务耗时分布，识别CI流程瓶颈任务
• 基于历史数据优化测试用例优先级，提升CI执行效率

3.3 大型项目质量管控

• 管理多团队、多模块并行开发的测试结果，统一质量视图
• 提供版本发布质量报告，支持基于数据的发布决策

4. Docker部署与使用方法

4.1 环境要求

• Docker Engine 20.10+
• Docker Compose 2.0+（推荐）
• 至少2GB RAM，10GB可用磁盘空间
• 网络可访问CI系统API端点（如需实时同步）

4.2 快速启动（单容器模式）

bash
docker run -d \
  --name treeherder \
  -p 8000:8000 \
  -e DB_HOST=your-mysql-host \
  -e DB_USER=treeherder \
  -e DB_PASSWORD=secure-password \
  -e DB_NAME=treeherder \
  -e SECRET_KEY=your-random-secret-key \
  mozilla/treeherder:latest

4.3 完整部署（Docker Compose）

创建docker-compose.yml配置文件：

yaml
version: '3.8'

services:
  treeherder:
    image: mozilla/treeherder:latest
    container_name: treeherder-app
    ports:
      - "8000:8000"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_USER=treeherder
      - DB_PASSWORD=treeherder-pass
      - DB_NAME=treeherder
      - SECRET_KEY=${SECRET_KEY}
      - DEBUG=False
      - LOG_LEVEL=INFO
      - ALLOWED_HOSTS=localhost,192.168.1.100
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: treeherder-db
    environment:
      - MYSQL_ROOT_PASSWORD=root-pass
      - MYSQL_DATABASE=treeherder
      - MYSQL_USER=treeherder
      - MYSQL_PASSWORD=treeherder-pass
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:

启动服务：

bash
# 生成安全密钥（示例）
export SECRET_KEY=$(openssl rand -hex 32)
# 启动服务
docker-compose up -d

4.4 核心环境变量配置

4.5 访问与初始配置

服务启动后，通过http://<主机IP>:8000访问Web界面。首次使用需完成：

1. 注册管理员账户（系统自动引导）
2. 配置CI数据源（导航至Settings > Data Sources）
3. 录入CI系统连接信息（API端点、认证令牌等）
4. 启用数据同步（自动/手动触发）

5. 数据导入与使用

5.1 数据导入方式

• API推送：CI系统通过Treeherder API主动推送测试结果
• 定时同步：配置周期性拉取CI系统结果数据
• 文件导入：上传JSON/CSV格式测试报告（支持批量导入）

5.2 核心数据格式要求

测试结果数据需包含字段：任务ID、状态（pass/fail/error/running）、开始/结束时间、测试用例名称、执行时长等。详细规范见Treeherder数据 schema。

5.3 结果分析与应用

• 实时监控：通过仪表盘查看当前测试任务状态，快速定位失败项
• 历史查询：按任务名称、状态、时间范围筛选历史结果
• 趋势分析：通过内置图表查看测试通过率、耗时变化趋势
• 问题跟踪：关联缺陷管理系统（如Bugzilla/JIRA），自动创建问题工单

6. 官方资源

• 项目源码：https://github.com/mozilla/treeherder
• 详细文档：Treeherder Docs
• API参考：Treeherder API