vericred/ruby-ci

镜像概述

本Docker镜像集成了多种开发和构建工具，旨在为持续集成（CI）流程提供统一、稳定的运行环境。镜像预装了特定版本的Ruby、Node.js、psql（PostgreSQL客户端）和phantomjs，满足多种技术栈项目的构建和测试需求。

核心功能与特性

预装组件及版本

• Ruby 2.4.3：用于运行Ruby语言编写的应用程序、测试脚本及构建任务
• Node 8.9.4：支持前端项目构建（如JavaScript transpile、npm包管理）和Node.js应用测试
• psql 9.4.15：PostgreSQL客户端工具，可用于数据库相关的集成测试（如初始化测试数据库、执行SQL脚本）
• phantomjs 2.1.1：无界面WebKit浏览器，支持前端自动化测试（如页面渲染、JavaScript执行验证）

优势

• 减少CI环境配置复杂度，避免因工具版本差异导致的构建失败
• 统一开发与CI环境，提升构建一致性
• 预装常用工具链，开箱即可用于多语言混合项目（如Ruby后端+Node前端）的构建流程

使用场景

• Ruby项目CI构建：适用于基于Ruby 2.4.3的项目，执行代码 lint、单元测试、集成测试等任务
• 前端+后端混合项目：支持通过Node.js处理前端资源（如Webpack打包），同时通过Ruby执行后端逻辑测试
• 数据库集成测试：通过psql客户端连接外部PostgreSQL数据库，执行数据初始化或测试用例数据准备
• 前端自动化测试：使用phantomjs运行基于Selenium或CasperJS的前端UI自动化测试

使用方法

基本运行命令

通过以下命令启动容器，直接进入交互式终端以执行CI任务：

bash
docker run -it --rm [镜像名称] /bin/bash

若需挂载本地项目目录并运行构建脚本（如ci-build.sh）：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] sh ci-build.sh

典型CI配置示例（以GitLab CI为例）

在.gitlab-ci.yml中使用本镜像作为构建环境：

yaml
stages:
  - test

ruby-test:
  stage: test
  image: [镜像名称]
  script:
    - ruby -v  # 验证Ruby版本
    - bundle install  # 安装Ruby依赖
    - bundle exec rake test  # 执行Ruby测试

node-build:
  stage: test
  image: [镜像名称]
  script:
    - node -v  # 验证Node版本
    - npm install  # 安装Node依赖
    - npm run build  # 执行前端构建

db-test:
  stage: test
  image: [镜像名称]
  script:
    - psql --version  # 验证psql版本
    - psql -h [db-host] -U [user] -d [db-name] -c "SELECT 1"  # 测试数据库连接

frontend-test:
  stage: test
  image: [镜像名称]
  script:
    - phantomjs --version  # 验证phantomjs版本
    - phantomjs test/frontend/automation.js  # 执行phantomjs自动化测试

注意事项

• 镜像中未预装额外构建工具（如Maven、Gradle等），若需其他工具需在CI脚本中手动安装
• 本镜像基于特定版本组件构建，若项目需更高版本依赖，建议评估兼容性或使用其他镜像
• 运行涉及数据库的任务时，需确保外部数据库服务可访问（如通过CI环境变量配置连接信息）