crunchstyle/ruby-chromedriver

ruby-chromedriver

镜像概述

本镜像基于官方Ruby 2.x镜像构建，集成Chrome浏览器、ChromeDriver及NodeJS，支持Capybara/Cucumber测试框架。使用X虚拟帧缓冲区（Xvfb）进行键码转换，可替代Qt和PhantomJS，适用于持续集成/持续交付（CI/CD）流水线。

核心功能

1. 集成Ruby 2.x环境、稳定版Chrome浏览器及对应驱动
2. 支持Xvfb虚拟显示，满足无界面测试需求
3. 可通过环境变量配置测试屏幕尺寸（2.8版本及以上）
4. 兼容GitLab等主流CI/CD平台

使用场景

• Ruby on Rails项目的Cucumber自动化测试
• CI/CD流水线中的无界面浏览器测试
• 替代PhantomJS实现更稳定的前端测试

配置说明

GitLab CI配置示例

适用于Ruby on Rails项目的Cucumber测试：

yaml
cucumber:
  stage: test
  image: 'nbulai/ruby-chromedriver:latest'
  variables:
    RAILS_ENV: test
  script:
    - chromedriver -v # 检查驱动版本
    - ... # 项目依赖安装等步骤
    - bin/cucumber
  artifacts:
    paths:
      - coverage/
  only:
    - master

Docker运行示例（指定屏幕尺寸）

bash
docker run -e SCREEN="1280x1024x16" -t -i --rm nbulai/ruby-chromedriver:latest bash

本地测试环境配置

1. 安装Chrome及驱动：

bash
# 添加Google公钥
wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
# 添加Chrome稳定版仓库
echo "deb http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list
sudo apt-get update 
# 安装Chrome和驱动
sudo apt-get install google-chrome-stable chromium-chromedriver
sudo ln -s /usr/lib/chromium-browser/chromedriver /usr/bin/chromedriver
# 验证安装
chromedriver -v

2. 添加Gem依赖： 在项目Gemfile的test组中添加：

ruby
group :test do
  # ...其他依赖
  gem 'selenium-webdriver'
end

3. 配置Capybara驱动： 编辑features/support/env.rb：

ruby
Capybara.register_driver(:headless_chrome) do |app|
  capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
    # 若出现启动异常，可添加no-sandbox参数
    chromeOptions: { args: %w[headless disable-gpu no-sandbox] } 
  )
  Capybara::Selenium::Driver.new(app, browser: :chrome, desired_capabilities: capabilities)
end

Capybara.javascript_driver = :headless_chrome

许可证

本仓库内容基于MIT许可证发布。
版权所有 (c) 2017-2018 Nikita Bulai (***)。