enggaccounts/pytest-base-ci

pytest-selenium-chrome 镜像文档

镜像概述

本镜像基于 selenium/standalone-chrome 构建，在其基础上预装了 pytest 测试框架及相关依赖，旨在为Web自动化测试项目提供即开即用的运行环境。通过整合Chrome浏览器环境与pytest测试框架，简化自动化测试环境的搭建流程，支持快速执行Web UI自动化测试脚本。

核心功能和特性

• 基础环境：基于 selenium/standalone-chrome，内置Chrome浏览器及Selenium WebDriver，支持浏览器自动化操作
• 测试框架：预装pytest及常用插件（如 pytest-selenium），满足自动化测试脚本编写与执行需求
• 即开即用：无需手动配置浏览器驱动与测试框架，拉取镜像后可直接运行测试脚本
• 兼容性：支持标准pytest命令及配置，兼容主流pytest插件生态

使用场景和适用范围

• Web UI自动化测试：适用于使用pytest+Selenium进行Web界面自动化测试的场景
• 测试脚本验证：本地快速验证pytest测试脚本在Chrome环境下的执行效果
• CI/CD集成：可作为持续集成/持续部署流程中的测试环节，自动化执行Web测试用例
• 教学与演示：用于Web自动化测试教学，提供统一的环境配置

使用方法和配置说明

拉取镜像

bash
docker pull [镜像名称]  # 替换为实际镜像名称

基本运行方式

运行容器并执行测试脚本（假设本地测试脚本目录为 ./tests）：

bash
docker run -v $(pwd)/tests:/tests [镜像名称] pytest /tests

挂载测试目录

将本地测试脚本目录挂载到容器内，便于执行自定义测试用例：

bash
docker run -v /本地测试脚本路径:/容器内测试路径 [镜像名称] pytest /容器内测试路径

自定义pytest配置

如需使用自定义pytest配置文件（如 pytest.ini 或 pyproject.toml），可将配置文件一同挂载到容器内：

bash
docker run -v $(pwd)/tests:/tests -v $(pwd)/pytest.ini:/pytest.ini [镜像名称] pytest /tests -c /pytest.ini

环境变量配置

支持通过环境变量调整Chrome运行参数（继承自 selenium/standalone-chrome）：

• SE_OPTS：设置Selenium服务选项，如 --enable-logging
• CHROME_OPTS：设置Chrome浏览器启动参数，如 --headless=new（无头模式）

示例（无头模式运行测试）：

bash
docker run -e CHROME_OPTS="--headless=new" -v $(pwd)/tests:/tests [镜像名称] pytest /tests

docker-compose配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  pytest-selenium:
    image: [镜像名称]
    volumes:
      - ./tests:/tests
      - ./pytest.ini:/pytest.ini
    environment:
      - CHROME_OPTS=--headless=new
    command: pytest /tests -c /pytest.ini

启动服务：

bash
docker-compose up

注意事项

• 确保本地测试脚本依赖与镜像预装依赖兼容，如需额外依赖，可通过 requirements.txt 挂载并安装：

  bash
  docker run -v $(pwd)/tests:/tests -v $(pwd)/requirements.txt:/requirements.txt [镜像名称] bash -c "pip install -r /requirements.txt && pytest /tests"
  

• 容器运行时需保证网络通畅，如需访问本地服务，可使用 --network=host 或配置端口映射