Squash Docker镜像技术文档

1. 镜像概述和主要用途

Squash是一款开源测试管理工具，旨在管理需求/用户故事与测试用例，规划测试活动，跟踪测试执行过程。该工具支持手动和自动化测试，适用于各类开发生命周期（如敏捷Scrum、SAFe或V模型）及构建/运行阶段，并可与需求仓库、缺陷跟踪器、自动化测试框架及CI/CD管道集成。

Squash提供两个核心Docker镜像：

• squashtest/squash：Squash TM（测试管理）应用镜像，提供测试管理核心功能的Web界面与后端服务。
• squashtest/squash-orchestrator：Squash Orchestrator（测试编排器）镜像，专门用于调度和运行自动化测试任务。

2. 核心功能和特性

2.1 整体功能

• 测试资产管理：支持需求/用户故事与测试用例的创建、关联及版本控制。
• 测试活动规划：可设计测试 campaign、分配测试任务并跟踪进度。
• 测试执行跟踪：记录手动测试步骤与结果，集成自动化测试执行流程。
• 多工具集成：兼容主流需求管理工具、缺陷跟踪系统（如JIRA）、CI/CD平台（如Jenkins）及自动化测试框架（如Selenium），完整集成列表见官方文档。

2.2 各镜像特性

• squashtest/squash：

  • 提供Web界面的测试管理平台（Squash TM）。
  • 支持测试报告生成与数据可视化分析。
  • 管理用户权限与团队协作流程。

• squashtest/squash-orchestrator：

  • 自动化测试任务调度与执行。
  • 与Squash TM联动，接收测试任务并返回执行结果。
  • 支持多环境下的自动化测试脚本运行。

3. 使用场景和适用范围

3.1 典型使用场景

• 敏捷开发团队：在Scrum、SAFe等敏捷流程中管理迭代测试活动。
• 传统开发流程：支持V模型等阶段式开发的测试计划与执行跟踪。
• 自动化测试集成：需集中管理和运行自动化测试脚本的项目。
• CI/CD流水线嵌入：在持续集成/部署流程中自动触发和执行测试。

3.2 适用范围

• 软件测试团队（手动测试与自动化测试人员）。
• 需要标准化测试流程、提升测试可追溯性的组织。
• 跨团队协作的大型项目（如多模块产品测试管理）。

4. 使用方法和配置说明

4.1 前置要求

• Docker Engine 19.03+ 或 Docker Desktop。
• 网络环境：容器需可访问外部数据库（如使用squashtest/squash）及Squash TM（如使用squash-orchestrator）。
• 资源配置：根据测试规模调整CPU、内存（建议参考官方部署文档的硬件要求）。

4.2 镜像拉取

通过Docker命令获取镜像：

# 拉取Squash TM镜像
docker pull squashtest/squash:latest

# 拉取Squash Orchestrator镜像
docker pull squashtest/squash-orchestrator:latest

4.3 部署Squash TM（squashtest/squash）

详细部署步骤见Squash TM Docker安装文档。基本部署示例（需提前配置外部数据库）：

docker run -d \
  --name squash-tm \
  -p 8080:8080 \  # 映射Web端口
  -e DATABASE_URL=jdbc:postgresql://<db-host>:<db-port>/<db-name> \  # 数据库连接URL
  -e DB_USERNAME=<db-username> \  # 数据库用户名
  -e DB_PASSWORD=<db-password> \  # 数据库密码
  squashtest/squash:latest

注：Squash TM依赖外部数据库（如PostgreSQL、MySQL），需提前部署数据库并配置连接参数。

4.4 部署Squash Orchestrator（squashtest/squash-orchestrator）

详细部署步骤见Squash Orchestrator安装文档。基本部署示例：

docker run -d \
  --name squash-orchestrator \
  -p 8081:8080 \  # 映射服务端口
  -e SQUASH_TM_URL=http://<squash-tm-host>:8080 \  # Squash TM访问地址
  -e ORCHESTRATOR_TOKEN=<auth-token> \  # 与Squash TM通信的认证令牌
  squashtest/squash-orchestrator:latest

5. 相关文档和资源

• Squash TM官方文档：Web应用文档
• 测试自动化指南：Orchestrator集成文档
• 镜像部署详情：
  • Squash TM Docker部署：文档链接
  • Squash Orchestrator部署：文档链接