guildeducation/rails

Docker CircleCI Guild 镜像文档

镜像概述

本仓库包含用于CI（持续集成）环境的Docker镜像，基于官方基础镜像修改，添加了Guild CI流程所需的额外工具，适用于Ruby、Node及Rails项目的持续集成场景。

镜像类型

Ruby

基于https://hub.docker.com/_/ruby/%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%9D%E5%A4%96%E5%9C%A8%60/usr/local/bin%60%E8%B7%AF%E5%BE%84%E4%B8%8B%E5%AE%89%E8%A3%85%E4%BA%86https://github.com/codeclimate/test-reporter%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8ECI%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E4%BB%A3%E7%A0%81%E8%B4%A8%E9%87%8F%E6%8A%A5%E5%91%8A%E7%94%9F%E6%88%90%E3%80%82

Node

基于https://hub.docker.com/_/node/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%90%8C%E6%A0%B7%E5%9C%A8%60/usr/local/bin%60%E8%B7%AF%E5%BE%84%E4%B8%8B%E5%AE%89%E8%A3%85%E4%BA%86https://github.com/codeclimate/test-reporter%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%BB%A1%E8%B6%B3Node%E9%A1%B9%E7%9B%AE%E7%9A%84CI%E4%BB%A3%E7%A0%81%E8%B4%A8%E9%87%8F%E5%88%86%E6%9E%90%E9%9C%80%E6%B1%82%E3%80%82

Rails

基于上述Ruby镜像构建，额外集成Node环境，Node版本通过镜像标签的后半部分标识（例如：2.4.2-9.4.0表示Ruby 2.4.2 + Node 9.4.0）。

特性：

• 集成Yarn包管理器（与官方Node镜像一致）
• 暴露环境变量NODE_VERSION和YARN_VERSION，分别表示当前Node和Yarn版本
• 预装Google Chrome稳定版和chromedriver，支持Capybara/Selenium/System测试场景

使用场景

• Ruby项目的CI流程，需代码质量报告生成
• Node项目的CI流程，需代码质量报告生成
• Rails项目的CI流程，需前端依赖管理（Yarn）及浏览器自动化测试（Chrome+chromedriver）

使用方法

拉取镜像

根据项目类型选择对应镜像：

bash
# Ruby镜像
docker pull guild/ci-ruby:${RUBY_VERSION}

# Node镜像
docker pull guild/ci-node:${NODE_VERSION}

# Rails镜像（格式：ruby版本-node版本）
docker pull guild/ci-rails:${RUBY_VERSION}-${NODE_VERSION}

CI配置示例（以Rails项目为例）

在.circleci/config.yml中使用：

yaml
jobs:
  test:
    docker:
      - image: guild/ci-rails:2.7.8-18.17.1
    steps:
      - checkout
      - run: bundle install
      - run: yarn install
      - run: bundle exec rails test
      - run: bundle exec rails system:test
      - run: codeclimate-test-reporter

添加新版本

1. 编辑versions.json文件，添加所需语言的新版本（Ruby/Node），Node需同时指定对应Yarn版本映射
2. 运行update.sh脚本，自动生成新的Dockerfile
3. 将生成的Dockerfile提交至代码仓库
4. 在Docker Hub对应仓库（ruby/node/rails）的设置中，更新自动构建配置，指定新Dockerfile路径及标签