weinfuse/ruby

Ruby Docker镜像文档

概述

Ruby Docker镜像是由Ruby官方维护的容器化解决方案，包含完整的Ruby运行时环境。该镜像支持多个Ruby版本（如2.7、3.0、3.1、3.2等）及多种操作系统变体（standard、slim、alpine），可快速搭建一致的Ruby应用运行环境，简化开发、测试和部署流程。

核心功能与特性

多版本支持

• 涵盖Ruby主流版本：2.7、3.0、3.1、3.2、3.3等，通过标签区分（如ruby:3.2、ruby:3.3.0）
• 支持补丁版本指定（如ruby:3.2.2），确保环境一致性

多样化变体

• standard：基于Debian系统，包含完整依赖（如build-essential、libssl-dev），适合开发环境
• slim：精简版Debian基础，移除非必要工具，体积较standard小30%-50%，适合生产环境
• alpine：基于Alpine Linux，体积最小（约为standard的1/3），适合资源受限场景（需注意Alpine依赖兼容性）

官方维护与安全

• 由Ruby核心团队定期更新，同步Ruby安全补丁
• 镜像构建过程透明，遵循Docker最佳实践，降低安全风险

预配置环境

• 内置RubyGems和Bundler包管理工具
• 包含基础编译工具，支持原生扩展安装（如nokogiri、pg等gem）

使用场景

开发环境快速搭建

• 无需本地安装Ruby，通过容器化环境实现"一键启动"开发环境
• 多版本并行开发（如同时维护Ruby 3.0和3.2项目）

CI/CD流程集成

• 在自动化测试、构建流程中作为执行环境，确保环境一致性
• 支持GitHub Actions、GitLab CI等主流CI/CD平台

生产环境部署

• 结合slim或alpine变体降低容器体积，减少资源占用
• 配合Docker Compose或Kubernetes实现规模化部署

使用方法与配置说明

基本使用

拉取镜像

bash
# 拉取最新稳定版（默认标签为latest，指向最新稳定版）
docker pull ruby:latest

# 拉取指定版本（如3.2的slim变体）
docker pull ruby:3.2-slim

验证Ruby环境

bash
# 查看Ruby版本
docker run --rm ruby:3.2 ruby -v

# 查看gem版本
docker run --rm ruby:3.2 gem -v

# 查看Bundler版本
docker run --rm ruby:3.2 bundle -v

运行Ruby应用

执行单行命令

bash
# 执行Ruby代码
docker run --rm ruby:3.2 ruby -e "puts 'Hello, Ruby Docker!'"

运行本地项目

bash
# 挂载当前目录到容器/app目录，执行项目中的脚本
docker run --rm -v "$PWD":/app -w /app ruby:3.2 ruby app.rb

# 使用Bundler安装依赖并运行
docker run --rm -v "$PWD":/app -w /app ruby:3.2 sh -c "bundle install && bundle exec rails server"

环境变量配置

变体选择建议

• 开发环境：优先使用standard变体，完整依赖支持原生扩展编译
• 生产环境：推荐3.2-slim或3.2-alpine（需测试项目依赖兼容性）
• 极小镜像需求：选择alpine变体，配合bundle install --without development test减少依赖体积

部署示例

1. 基本Ruby脚本运行

bash
# 创建测试脚本
echo "puts 'Ruby version: ' + RUBY_VERSION" > test.rb

# 通过容器运行
docker run --rm -v "$PWD":/app -w /app ruby:3.2 ruby test.rb
# 输出：Ruby version: 3.2.2（版本号可能因镜像更新变化）

2. Rails应用部署（docker-compose示例）

yaml
# docker-compose.yml
version: '3'
services:
  web:
    image: ruby:3.2-slim
    volumes:
      - .:/app
      - bundle_data:/usr/local/bundle
    working_dir: /app
    command: sh -c "bundle install && rails server -b 0.0.0.0"
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=production
      - DATABASE_URL=postgres://user:password@db:5432/app_db
  db:
    image: postgres:15
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=app_db

volumes:
  bundle_data:

启动命令：docker-compose up -d

注意事项

• 生产环境建议使用固定版本标签（如ruby:3.2.2-slim），避免因镜像更新导致版本变更
• Alpine变体可能需要额外安装系统依赖（通过apk add），例如libc6-compat解决glibc兼容性问题
• 敏感配置（如数据库密码）建议通过环境变量或Docker Secrets注入，避免硬编码在镜像中