strategicblue/clj-deps-selenium

Selenium + Clojure deps UI验收测试镜像

镜像概述

该Docker镜像专为通过Clojure deps工具链使用Selenium进行UI验收测试而设计，集成了Selenium WebDriver和Clojure依赖管理环境，提供便捷的UI自动化测试执行能力，适用于开发和CI/CD场景中的测试流程自动化。

核心功能与特性

• 内置Selenium WebDriver，支持主流浏览器的UI元素交互与测试
• 集成Clojure deps工具，简化测试代码的依赖声明与管理
• 轻量级基础镜像，减少部署体积，加速测试环境启动
• 兼容标准Clojure测试框架，支持自定义测试用例与报告输出
• 可配置浏览器类型及测试参数，适应多样化测试场景

使用场景

• CI/CD流水线中的UI验收测试自动化环节
• 开发环境中快速验证UI功能变更的正确性
• 跨浏览器兼容性测试的统一执行环境
• 批量UI测试用例的自动化执行与结果收集

使用方法

基本使用流程

1. 准备包含Clojure测试代码的项目，确保deps.edn中声明Selenium依赖
2. 通过docker run命令挂载项目目录并执行测试命令

示例命令

bash
docker run -v /本地测试项目路径:/app \
  -w /app \
  [镜像名称] \
  clojure -M:test  # 执行项目中定义的测试任务

环境变量配置

支持以下环境变量自定义测试行为：

• BROWSER：指定测试浏览器类型，可选值：chrome、firefox（默认：chrome）
• SELENIUM_HUB_URL：远程Selenium Grid服务地址（默认：使用本地驱动）
• TEST_TIMEOUT：测试用例超时时间（秒，默认：300）
• REPORT_PATH：测试报告输出路径（默认：./target/test-reports）

带环境变量的运行示例

bash
docker run -v /本地测试项目路径:/app \
  -w /app \
  -e BROWSER=firefox \
  -e REPORT_PATH=/app/reports \
  [镜像名称] \
  clojure -M:test

CI/CD集成示例（GitHub Actions）

yaml
jobs:
  ui-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run UI tests
        uses: docker/run-action@v3
        with:
          image: [镜像名称]
          volumes:
            - ${{ github.workspace }}:/app
          workdir: /app
          env: |
            BROWSER=chrome
            REPORT_PATH=/app/test-reports
          command: clojure -M:test
      - name: Upload test report
        uses: actions/upload-artifact@v3
        with:
          name: test-report
          path: test-reports/

注意事项

• 测试项目需确保deps.edn正确声明Selenium及相关依赖（如org.seleniumhq.selenium/selenium-java）
• 本地浏览器驱动模式下，需确保镜像包含对应浏览器二进制文件；远程模式需提前部署Selenium Grid
• 测试报告路径建议通过环境变量配置并挂载本地目录，以便持久化保存测试结果
• 大规模测试场景建议配合Selenium Grid实现分布式执行，提升测试效率