adcombi/ruby

Ruby集成环境镜像文档

镜像概述

本镜像基于官方Ruby镜像构建，预安装了NodeJS、ImageMagick和gosu工具，旨在提供一个开箱即用的Ruby开发与运行环境，减少依赖配置时间，适用于需要同时处理Ruby后端、前端资源、图像操作及权限管理的应用场景。

核心功能与特性

• 基础环境：继承官方Ruby镜像的稳定性与可靠性，包含完整的Ruby运行时及开发工具
• 前端支持：预安装NodeJS，支持JavaScript开发、前端资源构建（如Webpack、Babel）及npm/yarn依赖管理
• 图像处理：集成ImageMagick，提供图片格式转换、裁剪、缩放、滤镜等丰富的图像处理能力
• 权限管理：包含gosu工具，可安全地降低容器内进程权限，遵循最小权限原则，提升容器运行安全性

使用场景与适用范围

• Ruby应用开发环境：快速搭建无需手动配置依赖的开发环境
• 全栈Ruby项目：如Rails应用中需NodeJS处理前端资源的场景
• 图像处理应用：涉及图片上传、格式转换、缩略图生成等功能的Ruby服务
• 安全容器部署：需要控制进程权限的生产环境部署

使用方法与配置说明

基本使用

直接运行镜像进入交互式Ruby环境：

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

项目开发环境配置

挂载本地项目目录并指定工作目录：

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

此命令将当前目录挂载到容器内/app目录，并将工作目录切换至/app，可直接在容器内执行bundle install、rails server等命令。

环境变量

继承自官方Ruby镜像的核心环境变量，主要包括：

• RUBY_VERSION：Ruby版本号
• BUNDLE_VERSION：Bundler版本号
• GEM_HOME：RubyGems安装路径（默认/usr/local/bundle）
• PATH：包含Ruby、NodeJS及工具的可执行路径

权限管理（gosu使用）

使用gosu以非root用户执行命令，增强安全性：

bash
# 以nobody用户身份运行Ruby脚本
docker run -it --rm [镜像名称] gosu nobody ruby script.rb

# 以指定UID/GID运行应用
docker run -it --rm [镜像名称] gosu 1000:1000 bundle exec rails server

Docker Compose配置示例

yaml
version: '3.8'
services:
  ruby-app:
    image: [镜像名称]
    volumes:
      - ./:/app
      - bundle_data:/usr/local/bundle
    working_dir: /app
    command: gosu appuser bundle exec rails server -b 0.0.0.0
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=development

volumes:
  bundle_data:  # 持久化Bundler依赖，加速后续启动

注意事项

• 镜像标签通常包含Ruby版本信息（如2.7、3.2），请根据项目需求选择对应版本
• ImageMagick支持大部分常见图片格式，如需特殊格式支持，可在容器内通过包管理器补充安装
• 使用gosu时需确保目标用户/UID在容器内存在，可通过Dockerfile或启动脚本预先创建