clickmechanic/ruby_node

CircleCI 构建镜像（含Ruby、Node JS及Web浏览器）### 镜像概述

本镜像为CircleCI专用构建环境，集成Ruby、Node JS开发环境及Web浏览器，旨在简化CI/CD流程中的环境配置，支持多语言项目的自动化构建、测试与部署。通过预安装核心开发工具，减少构建环境准备时间，提升CI/CD效率。

核心功能与特性

• 多语言环境集成：内置Ruby运行时环境，支持Ruby项目构建；集成Node JS环境，满足JavaScript/TypeScript项目开发需求。
• Web浏览器支持：包含主流Web浏览器（如Chrome、Firefox等），可直接运行前端自动化测试（如Selenium、Cypress等）。
• CI/CD优化：针对CircleCI流程优化，兼容常见CI命令，支持构建缓存、依赖管理等CI特性。
• 开箱即用：预配置基础开发工具链，无需手动安装依赖，直接用于项目构建流程。

使用场景

• Web应用构建：适用于基于Ruby on Rails、Node JS（如React、Vue）等技术栈的Web项目构建。
• 前端自动化测试：支持需要浏览器环境的前端测试场景，如UI测试、端到端测试（E2E）。
• 混合技术栈项目：满足同时使用Ruby和Node JS的项目（如Ruby后端+Node前端）在CI流程中的统一环境需求。
• CircleCI流水线集成：作为CircleCI config.yml 中的执行环境，简化CI配置。

使用方法#### 1. 拉取镜像

bash
docker pull docker.xuanyuan.run/circleci/build-image:latest

2. 基本运行命令

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地项目目录到容器内/app
  -w /app \         # 设置工作目录为/app
  circleci/build-image:latest \
  sh -c "ruby -v && node -v && google-chrome --version"  # 验证环境版本

3. 环境变量配置

可通过环境变量指定具体版本（如未指定，使用默认版本）：

• RUBY_VERSION：指定Ruby版本（如3.2.2）
• NODE_VERSION：指定Node JS版本（如18.18.0）
• BROWSER_CHANNEL：指定浏览器渠道（如stable、beta）

示例（指定版本）：

bash
docker run -it --rm \
  -e RUBY_VERSION=3.2.2 \
  -e NODE_VERSION=18.18.0 \
  docker.xuanyuan.run/circleci/build-image:latest \
  sh -c "ruby -v && node -v"

4. Docker Compose配置示例

yaml
version: '3'
services:
  build-service:
    image: docker.xuanyuan.run/circleci/build-image:latest
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - RUBY_VERSION=3.2.2
      - NODE_VERSION=18.18.0
    command: sh -c "bundle install && npm install && npm run test"  # 执行构建与测试命令

5. CircleCI 配置集成

在项目.circleci/config.yml中使用该镜像：

yaml
version: 2.1
jobs:
  build-and-test:
    docker:
      - image: circleci/build-image:latest
    steps:
      - checkout
      - run: bundle install  # Ruby依赖安装
      - run: npm install     # Node依赖安装
      - run: npm run build   # 构建项目
      - run: npm run test    # 执行测试
workflows:
  main:
    jobs:
      - build-and-test

注意事项

• 镜像标签：建议使用具体版本标签（如v1.0.0）而非latest，确保构建环境一致性。
• 资源需求：运行浏览器测试时需保证容器有足够内存（建议至少2GB），避免测试崩溃。
• 权限配置：容器内默认使用非root用户，挂载目录时需确保权限正确（可通过-u $(id -u):$(id -g)指定用户ID）。