onsdigital/spp-python-selenium

Selenium+Behave/pytest自动化测试镜像

镜像概述

本镜像为Web应用自动化测试提供一站式解决方案，集成Selenium WebDriver、Behave（行为驱动开发框架）和pytest（测试框架），预配置浏览器驱动环境，无需手动安装依赖，可快速部署并执行自动化测试任务。

核心功能与特性

• 多框架支持：同时集成Behave（BDD测试）和pytest（单元/集成测试），满足不同测试场景需求
• Selenium集成：内置Selenium WebDriver，支持Web元素定位、页面交互等自动化操作
• 浏览器驱动预配置：包含ChromeDriver、GeckoDriver等主流浏览器驱动，匹配对应浏览器版本
• 环境隔离：容器化部署确保测试环境一致性，避免本地环境依赖冲突
• 轻量高效：基于精简基础镜像构建，启动快速，资源占用低

使用场景

• Web应用自动化测试：适用于各类Web系统的UI功能验证、流程自动化测试
• 行为驱动开发（BDD）：通过Behave实现自然语言描述的测试用例（.feature文件），促进跨团队协作
• 单元/集成测试：使用pytest编写测试脚本，执行Web应用的单元测试或集成测试
• CI/CD流程集成：作为自动化测试环节嵌入CI/CD管道，实现代码提交后的自动测试验证

使用方法与配置说明

基本使用流程

1. 准备测试脚本：将Behave测试用例（features目录及steps定义）或pytest测试文件存放于本地目录
2. 启动容器：通过docker run命令挂载测试目录，配置环境变量，执行测试命令

示例命令

1. 使用Behave执行BDD测试（默认浏览器：Chrome）

bash
docker run -v /本地测试脚本路径:/tests \
  docker.xuanyuan.run/your-image-name:latest \
  behave /tests/features

2. 使用pytest执行测试（指定Firefox浏览器）

bash
docker run -v /本地测试脚本路径:/tests \
  -e BROWSER=firefox \
  docker.xuanyuan.run/your-image-name:latest \
  pytest /tests/test_scripts/

3. 集成Selenium Grid（远程执行测试）

bash
docker run -v /本地测试脚本路径:/tests \
  -e BROWSER=chrome \
  -e SELENIUM_REMOTE=http://grid-host:4444/wd/hub \
  docker.xuanyuan.run/your-image-name:latest \
  pytest /tests --browser=remote

环境变量配置

测试脚本挂载

通过-v参数将本地测试目录挂载至容器内TEST_PATH（默认/tests），确保容器可访问测试用例。例如：

bash
# 本地测试脚本位于./my_tests，挂载到容器/test目录
-v $(pwd)/my_tests:/tests

浏览器与驱动支持

镜像预安装以下浏览器及对应驱动，无需额外配置：

• Chrome：Chrome浏览器 + ChromeDriver（版本匹配）
• Firefox：Firefox浏览器 + GeckoDriver（版本匹配）
• Edge：Microsoft Edge浏览器 + EdgeDriver（版本匹配）

测试报告生成

• Behave：通过BEHAVE_FORMAT指定报告格式，如生成HTML报告：

  bash
  docker run -v $(pwd)/reports:/reports \
    -e BEHAVE_FORMAT=html \
    docker.xuanyuan.run/your-image-name:latest \
    behave /tests/features -f html -o /reports/behave_report.html
  

• pytest：通过PYTEST_ARGS指定报告参数，如生成HTML报告：

  bash
  docker run -v $(pwd)/reports:/reports \
    -e PYTEST_ARGS="--html=/reports/pytest_report.html" \
    your-image-name:latest \
    pytest /tests