signalwire/ruby-base-image

Ruby应用基础镜像（包含NodeJS）

镜像概述

本镜像为Ruby应用提供基础运行环境，集成NodeJS工具链，旨在简化需要同时依赖Ruby后端与NodeJS相关功能（如前端资源构建、npm包管理）的应用部署流程。通过预配置Ruby和NodeJS环境，减少应用容器化过程中的环境配置工作，提升开发与部署效率。

核心功能与特性

• 双环境集成：同时包含Ruby运行时和NodeJS环境，满足后端开发与前端构建需求
• 基础依赖预装：包含常用系统库、构建工具（如gcc、make）及RubyGems、npm/yarn包管理器
• 轻量级设计：基于官方基础镜像优化，最小化镜像体积，减少资源占用
• 版本兼容性：支持主流Ruby版本与NodeJS版本组合（具体版本可通过镜像标签指定）
• 即开即用：无需额外配置即可运行基础Ruby应用及NodeJS命令

使用场景

• Ruby on Rails/Sinatra等Ruby框架应用，需NodeJS处理前端资源（如Webpack打包、Sass编译）
• 包含前端构建流程的Ruby项目（如使用npm scripts执行代码检查、测试或打包）
• 需要在同一容器内运行Ruby后端服务和NodeJS辅助进程（如定时任务、消息队列消费者）

使用方法与配置说明

基本使用

作为基础镜像构建应用（Dockerfile示例）

dockerfile
# 基于本镜像构建自定义应用镜像
FROM docker.xuanyuan.run/[镜像名称]:[标签]  # 标签可指定Ruby/NodeJS版本，如ruby3.2-node18

# 设置工作目录
WORKDIR /app

# 复制应用依赖文件并安装
COPY Gemfile Gemfile.lock ./
RUN bundle install --without development test

COPY package.json package-lock.json ./
RUN npm ci --only=production

# 复制应用代码
COPY . .

# 启动命令
CMD ["bundle", "exec", "ruby", "app.rb"]

交互式运行（开发调试）

bash
# 启动容器并进入交互式shell
docker run -it --rm [镜像名称] /bin/bash

# 在容器内验证环境
ruby -v  # 查看Ruby版本
node -v  # 查看NodeJS版本
npm -v   # 查看npm版本

环境变量配置

注意事项

• 版本选择：通过镜像标签指定所需Ruby和NodeJS版本（如ruby3.1-node16），避免因版本不匹配导致兼容性问题
• 生产环境优化：构建应用镜像时建议使用--without development test（RubyGems）和--only=production（npm）减少依赖体积
• 持久化存储：如需保存Gem或npm依赖，可将BUNDLE_PATH或node_modules挂载为卷，加速依赖安装

版本支持

具体支持的Ruby和NodeJS版本组合请参考镜像标签列表，建议选择与应用需求匹配的版本标签以确保兼容性。