mitimesdev/docker-elixir-chromedriver

docker-elixir-chromedriver 镜像文档

镜像概述

docker-elixir-chromedriver是一个集成Elixir、Node.js和Chromedriver的Docker镜像，旨在提供开箱即用的自动化测试环境。该镜像整合了多种测试所需组件，避免手动配置多个工具的繁琐过程，可直接用于运行各类自动化测试任务。

核心功能与特性

• 多环境集成：同时包含Elixir运行环境、Node.js及Chromedriver，满足多语言测试需求
• 开箱即用：预配置必要依赖，无需额外安装即可启动测试
• 浏览器自动化：内置Chromedriver，支持基于Chrome浏览器的自动化测试场景
• 依赖管理：集成npm包管理工具，便于安装前端测试依赖
• 灵活兼容：适配主流测试框架，支持Elixir Mix测试命令及自定义测试脚本

使用场景与适用范围

• Elixir应用的单元测试、集成测试执行
• 需要浏览器环境的端到端（E2E）自动化测试
• CI/CD流水线中的自动化测试环节集成
• 跨平台测试环境一致性保障
• 本地开发环境中的测试验证

使用方法与配置说明

基本使用（docker run）

运行Elixir测试：

bash
docker run --rm -v $(pwd):/app -w /app docker-elixir-chromedriver mix test

运行包含前端依赖的测试：

bash
docker run --rm -v $(pwd):/app -w /app docker-elixir-chromedriver \
  sh -c "npm install && mix test test/e2e"

Docker Compose配置示例

yaml
version: '3.8'
services:
  test:
    image: docker-elixir-chromedriver
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - MIX_ENV=test
      - NODE_ENV=test
    command: mix test

环境变量配置

卷挂载说明

• 建议将项目根目录挂载至容器内/app目录，确保测试代码可被访问
• 可挂载/app/deps和/app/node_modules目录以缓存依赖，加速测试启动

注意事项

• 运行浏览器测试时，建议使用--headless模式以减少资源占用
• 如需自定义Chromedriver版本，可通过构建自定义Dockerfile扩展基础镜像
• 在CI环境中使用时，确保容器拥有足够的系统资源（特别是内存）以支持浏览器运行