daveksloan/rails-chrome-headless

Rails应用测试构建镜像（基于CircleCI和Chrome无头浏览器）

镜像概述

该Docker镜像专为CircleCI环境设计，提供Rails应用测试构建能力，集成Google Chrome无头浏览器，支持需要浏览器环境的自动化测试场景，确保在CI/CD流程中高效、一致地执行Rails应用测试。

核心功能与特性

• CircleCI兼容：针对CircleCI环境优化，可直接集成到CI/CD流水线中
• Chrome无头浏览器：预安装Google Chrome无头浏览器，支持前端交互测试、JavaScript执行等浏览器相关测试场景
• Rails测试支持：提供Rails应用测试所需的基础运行环境，简化测试配置流程
• 构建一致性：标准化测试环境，避免因本地环境差异导致的测试结果不一致问题

使用场景与适用范围

• Rails应用自动化测试：适用于需要浏览器环境的Rails功能测试、集成测试（如Capybara测试）
• CircleCI流水线集成：作为测试阶段的构建环境，用于执行Rails应用的自动化测试任务
• 持续集成场景：在代码提交或PR触发时，自动运行浏览器相关测试，确保代码质量

使用方法与配置说明

CircleCI配置示例

在.circleci/config.yml中配置使用该镜像：

yaml
version: 2.1
jobs:
  test:
    docker:
      - image: [镜像名称]  # 替换为实际镜像名称
    steps:
      - checkout  # 拉取代码
      - run: bundle install  # 安装依赖
      - run: bundle exec rake db:create db:migrate  # 准备测试数据库
      - run: bundle exec rspec  # 执行Rails测试（根据实际测试框架调整）
workflows:
  test_workflow:
    jobs:
      - test

本地测试命令

如需本地验证镜像功能，可使用以下命令：

bash
# 拉取镜像（假设镜像已发布到Docker Hub）
docker pull docker.xuanyuan.run/[镜像名称]

# 运行测试命令
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  bundle exec rake test

测试环境配置

• 浏览器参数：如需自定义Chrome无头浏览器参数，可在测试命令中添加，例如：

  bash
  bundle exec rspec --default-path spec/features CHROME_OPTS="--no-sandbox --disable-dev-shm-usage"
  

• 依赖管理：确保项目的Gemfile中包含浏览器测试相关依赖（如capybara、selenium-webdriver等）

注意事项

• 确保CircleCI runner具有足够的资源（推荐至少2GB内存）以支持Chrome无头浏览器运行
• 如遇到权限问题，可在测试命令前添加--no-sandbox参数（如上述示例）
• 定期更新镜像以获取Chrome浏览器安全更新和功能改进