alienfast/ci-ruby

镜像概述

本镜像为Ruby和Node.js项目设计，是一个轻量级CI（持续集成）服务器解决方案，旨在简化开发团队的自动化构建、测试与部署流程。集成Ruby与Node.js运行环境，可快速搭建具备自动化流程的CI服务，无需手动配置底层环境。

核心功能与特性

• 多环境支持：内置Ruby与Node.js运行环境，可通过配置指定具体版本（如Ruby 2.7/3.2，Node.js 14/16/18）。
• 自动化流程：支持从代码拉取（Git集成）、依赖安装（bundle install/npm install）、测试执行（rspec/jest等）到结果报告生成的全流程自动化。
• 灵活配置：支持自定义CI任务（通过配置文件定义构建步骤）、并行任务处理（提升多模块项目测试效率）。
• 轻量部署：基于精简基础镜像，启动快速，资源占用低，适合中小型项目或开发环境快速搭建。

使用场景与适用范围

• 开发团队：Ruby或Node.js技术栈团队的日常持续集成流程（如提交代码后自动触发测试）。
• 项目规模：小型到中型Ruby/Node.js项目（单仓库多模块或多仓库关联项目）的自动化构建与测试。
• 环境需求：需要快速部署CI服务，且不愿依赖第三方托管服务（如Jenkins、GitHub Actions）的场景。

使用方法与配置说明

基础使用（docker run）

bash
docker run -d \
  --name ruby-node-ci \
  -p 8080:8080 \  # CI服务Web界面端口
  -e RUBY_VERSION=3.2.2 \  # 指定Ruby版本
  -e NODE_VERSION=18.17.1 \  # 指定Node.js版本
  -v /path/to/project:/app \  # 挂载项目代码目录
  -v /path/to/ci-config:/etc/ci \  # 挂载CI配置文件（如.gitlab-ci.yml风格配置）
  [镜像名称]

核心环境变量

docker-compose配置示例

yaml
version: '3'
services:
  ci-server:
    image: [镜像名称]
    ports:
      - "8080:8080"
    environment:
      - RUBY_VERSION=3.2.2
      - NODE_VERSION=18.17.1
      - GIT_REPO_URL=https://github.com/your-project.git
      - PARALLEL_JOBS=2
    volumes:
      - ./project:/app  # 本地项目目录
      - ./ci-config:/etc/ci  # CI配置目录
      - ci-cache:/var/cache/ci  # 缓存依赖（加速后续构建）
volumes:
  ci-cache:

配置文件说明

CI任务配置文件（默认路径/etc/ci/config.yml）需定义构建步骤，示例：

yaml
stages:
  - install
  - test

install:
  script:
    - bundle install  # Ruby依赖安装
    - npm install     # Node.js依赖安装

test:
  script:
    - rspec spec/     # Ruby测试
    - npm test        # Node.js测试
  parallel: true      # 启用并行执行

访问与监控

启动后，通过 http://localhost:8080 访问CI服务Web界面，可查看任务状态、构建日志及测试报告。日志文件默认存储于容器内/var/log/ci目录，可通过挂载持久化保存。