campuscode/ruby-gitlab-ci

ruby-gitlab-ci 镜像文档

镜像概述和主要用途

ruby-gitlab-ci 是一个专为Gitlab CI环境设计的Docker镜像，集成了Ruby、PhantomJS、Node.js、Qt5及Xvfb等开发工具和依赖组件，旨在为CI/CD流水线提供一致且全面的运行环境，简化项目在Gitlab CI中的配置与部署流程。

核心功能和特性

• 多语言运行时：集成Ruby和Node.js，支持Ruby应用开发、测试及JavaScript相关任务执行
• 无头浏览器支持：内置PhantomJS，提供无需图形界面的浏览器环境，适用于前端自动化测试
• GUI与虚拟显示能力：包含Qt5库提供GUI相关依赖，Xvfb支持虚拟显示，可运行需要图形环境的应用和测试
• CI环境适配：针对Gitlab CI环境优化，可直接作为CI/CD流水线中的执行环境，减少工具链配置复杂度

使用场景和适用范围

• Ruby应用（如Ruby on Rails项目）的自动化测试、构建与部署流程
• 前端项目（基于JavaScript/TypeScript）的自动化测试（如使用PhantomJS的端到端测试）
• 需要虚拟显示环境的UI自动化测试或图形应用测试
• 依赖Qt5库的应用开发与测试任务

使用方法和配置说明

基础使用

通过以下命令拉取并运行镜像（假设镜像标签为最新版）：

bash
docker run --rm -it ruby-gitlab-ci

在Gitlab CI中集成

在项目的.gitlab-ci.yml文件中指定该镜像作为作业执行环境：

yaml
stages:
  - test

ruby_test:
  stage: test
  image: ruby-gitlab-ci
  script:
    - ruby --version  # 验证Ruby环境
    - bundle install  # 安装Ruby依赖
    - bundle exec rspec  # 运行RSpec测试

frontend_test:
  stage: test
  image: ruby-gitlab-ci
  script:
    - node --version  # 验证Node.js环境
    - npm install  # 安装JavaScript依赖
    - phantomjs --version  # 验证PhantomJS环境
    - xvfb-run npm test  # 使用Xvfb运行需要虚拟显示的测试

挂载项目目录

如需在容器中访问本地项目文件，可通过-v参数挂载主机目录：

bash
# 将当前目录挂载到容器的/app目录并运行测试
docker run --rm -v $(pwd):/app -w /app ruby-gitlab-ci bundle exec rspec

环境变量配置

镜像默认使用内置工具的默认配置，可通过环境变量自定义部分参数（具体支持的变量需参考镜像版本说明），例如指定Ruby版本（若镜像支持多版本标签）：

bash
docker run --rm -e RUBY_VERSION=3.2.2 -it ruby-gitlab-ci