residently/ruby

Ruby 2.4.0 集成测试专用镜像

镜像概述和主要用途

本镜像基于官方Ruby 2.4.0基础镜像构建，通过集成node.js、xvfb（虚拟显示服务器）和qtwebkit（WebKit渲染引擎），提供了完整的无头（无图形界面）集成测试运行环境。旨在解决Ruby应用在无图形界面环境中执行依赖Web界面渲染的集成测试时的环境依赖问题。

核心功能和特性

• 基础环境：内置Ruby 2.4.0运行时，满足Ruby应用的基础执行需求
• 前端支持：集成node.js，支持前端资源构建和JavaScript运行时依赖
• 无头显示：包含xvfb虚拟显示服务器，模拟图形显示环境，支持需要GUI的应用运行
• Web渲染：集成qtwebkit WebKit引擎，支持网页内容解析和渲染，满足基于Web界面的测试场景
• 兼容性：保持与官方Ruby 2.4.0镜像的基础兼容性，可无缝迁移现有Ruby 2.4.0项目的测试环境

使用场景和适用范围

• CI/CD流水线：在Jenkins、GitLab CI等持续集成/部署系统中，作为测试阶段的运行环境
• 服务器环境：在无图形界面的Linux服务器中执行依赖Web界面渲染的Ruby集成测试
• 自动化测试：支持Selenium、Capybara等Ruby测试框架的无头模式运行
• 遗留系统：适用于仍依赖Ruby 2.4.0版本且需要Web界面测试的旧项目

详细使用方法和配置说明

基本使用方式

通过docker run命令启动容器，挂载测试代码目录并执行测试命令：

bash
docker run -v /path/to/your/test/code:/app -w /app ruby-2.4-test-image bundle exec rake test

自定义xvfb配置

如需调整xvfb虚拟显示参数（如分辨率、颜色深度），可通过环境变量XVFB_ARGS指定：

bash
docker run -e XVFB_ARGS="-screen 0 1280x720x24" -v /path/to/test/code:/app ruby-2.4-test-image bundle exec rspec

集成node.js依赖

容器内置node.js，可直接在测试流程中执行npm命令：

bash
docker run -v /path/to/test/code:/app -w /app ruby-2.4-test-image sh -c "npm install && bundle install && bundle exec cucumber"

部署示例

Docker Run 示例

bash
# 启动容器并运行测试命令
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  ruby-2.4-test-image \
  sh -c "bundle install && xvfb-run bundle exec rspec spec/integration"

典型测试流程说明

1. 挂载本地测试代码目录到容器内工作目录
2. 安装Ruby依赖（bundle install）
3. 如需前端依赖，执行npm install
4. 使用xvfb-run命令包装测试命令，启动虚拟显示环境
5. 执行测试命令（如bundle exec rspec、bundle exec cucumber）