b4handjr/selenium-firefox

selenium-firefox Docker镜像文档

镜像概述和主要用途

selenium-firefox是一个集成了Selenium和Firefox浏览器的Docker镜像，旨在提供便捷的Web自动化测试环境。该镜像基于Selenium Firefox的夜间构建版本，主要用于支持通过tox工具运行pytest自动化测试脚本，帮助开发和测试团队快速搭建一致的测试环境。

核心功能和特性

• 集成Selenium WebDriver：内置Selenium WebDriver，支持Firefox浏览器的自动化控制，实现Web页面交互测试
• Firefox浏览器环境：包含完整的Firefox浏览器，确保测试在标准化浏览器环境中执行，避免环境差异导致的测试不一致
• 夜间构建版本：基于Firefox的夜间构建版本，可获取最新的浏览器功能和问题修复，适合需要验证最新浏览器兼容性的场景
• tox与pytest兼容：支持与tox（测试环境管理工具）和pytest（Python测试框架）集成，便于测试环境隔离和测试用例执行

使用场景和适用范围

• Web自动化测试：适用于开发和测试团队进行Web应用的自动化功能测试、兼容性测试
• CI/CD流程集成：可嵌入持续集成/持续部署（CI/CD）流水线，实现代码提交后的自动化测试验证
• 测试环境标准化：解决不同开发/测试环境中浏览器版本、依赖库差异导致的"本地测试通过，线上失败"问题
• pytest测试项目：特别适合使用pytest编写测试用例，并通过tox管理多环境测试的Python项目

使用方法和配置说明

基本使用（docker run）

启动容器并运行pytest测试脚本：

bash
docker run -it --rm \
  -v $(pwd):/tests \  # 挂载本地测试目录到容器内
  -w /tests \          # 设置工作目录为测试目录
  selenium-firefox \   # 镜像名称
  tox -e py39          # 运行tox环境（示例：py39环境）执行pytest测试

结合docker-compose使用

创建docker-compose.yml文件：

yaml
version: '3'
services:
  test:
    image: selenium-firefox
    volumes:
      - ./:/tests
    working_dir: /tests
    command: tox -e py310  # 根据项目tox配置指定环境

启动测试：

bash
docker-compose run test

配置说明

• 挂载测试目录：通过-v参数将本地测试代码目录挂载到容器内（如示例中的/tests），确保测试脚本可被容器访问
• tox环境配置：需在项目根目录下准备tox.ini文件，定义测试环境（如Python版本、依赖库等）和pytest执行命令
• 自定义测试命令：可通过修改docker run或docker-compose中的command参数，指定具体的测试命令（如pytest tests/ --cov=myapp）

注意事项

• 确保本地项目已安装tox并配置tox.ini文件，或在容器内安装必要依赖
• 若测试需要访问本地网络服务，可使用--network=host参数让容器共享主机网络（仅适用于开发环境）
• 夜间构建版本可能包含未稳定功能，生产环境建议使用稳定版本镜像