Ruby Docker镜像文档

镜像概述和主要用途

Ruby Docker镜像是由Docker官方维护的标准化容器镜像，基于Debian或Alpine等基础系统构建，集成了Ruby编程语言运行环境及相关工具链。该镜像旨在为Ruby应用开发、测试和部署提供一致、隔离的运行环境，支持多种Ruby版本和架构，适用于从简单脚本到复杂Web应用（如Ruby on Rails）的容器化需求。

核心功能和特性

多版本与变体支持

• 版本覆盖：支持Ruby 2.7+及所有稳定版本（如3.0、3.1、3.2、3.3等），满足不同应用的版本兼容性需求。
• 基础镜像变体：
  • ruby:<version>：基于Debian Bullseye，包含完整系统依赖，适合生产环境。
  • ruby:<version>-slim：基于Debian Bullseye Slim，精简系统组件，减少镜像体积（比完整版小约40%）。
  • ruby:<version>-alpine：基于Alpine Linux，极致精简（体积通常<100MB），适合资源受限场景，但需注意musl libc与glibc的兼容性差异。
  • ruby:<version>-bullseye/-bookworm：指定Debian具体发行版，确保依赖稳定性。

工具链集成

• 预安装Ruby解释器、gem包管理器及bundler依赖管理工具。
• 支持gem install直接安装RubyGems，bundle install解析Gemfile依赖。

跨平台兼容性

• 支持多架构（amd64、arm64、ppc64le等），可运行于x86服务器、ARM开发板（如树莓派）及云平台。

安全与维护

• 定期同步基础系统安全更新，降低漏洞风险。
• 遵循Docker最佳实践，非root用户运行（部分变体），减少权限暴露。

使用场景和适用范围

典型使用场景

• Ruby应用开发：本地开发环境快速搭建，避免系统Ruby版本冲突。
• Web应用部署：Ruby on Rails、Sinatra等Web框架应用的容器化部署。
• 脚本运行：独立Ruby脚本（如数据处理、自动化任务）的隔离执行。
• CI/CD流程：作为持续集成/部署流水线中的构建或测试环境（如运行RSpec测试）。

适用范围

• 开发者本地开发环境（搭配Docker Compose实现多服务联动）。
• 生产环境容器化部署（Kubernetes、Docker Swarm、云容器服务等）。
• 轻量级服务（如API服务、定时任务）的资源优化部署（优先选择-slim或-alpine变体）。

使用方法和配置说明

获取镜像

通过Docker Hub拉取镜像，格式为：

docker pull ruby:<tag>

标签（tag）说明：
标签格式为<ruby-version>-<variant>，例如：

• 3.3：Ruby 3.3，基于Debian Bullseye完整版。
• 3.2-slim：Ruby 3.2，基于Debian Slim。
• 3.1-alpine3.19：Ruby 3.1，基于Alpine 3.19。
• 3.3.0-bullseye：Ruby 3.3.0，指定Debian Bullseye发行版。

完整标签列表可参考Docker Hub Ruby镜像页。

基本使用示例

1. 交互式Ruby shell

启动Ruby交互式解释器（irb）：

docker run -it --rm ruby:3.3 irb

• -it：交互式终端。
• --rm：退出后自动删除容器。

2. 运行本地Ruby脚本

执行当前目录下的script.rb：

# 假设本地存在 script.rb（如：puts "Hello, Docker!"）
docker run --rm -v "$PWD":/app -w /app ruby:3.3 ruby script.rb

• -v "$PWD":/app：将当前目录挂载到容器内/app目录。
• -w /app：设置工作目录为/app。

Ruby on Rails应用部署示例

1. 创建Dockerfile

在Rails应用根目录创建Dockerfile：

# 基于slim变体减少体积
FROM ruby:3.3-slim

# 安装系统依赖（Rails需Node.js、Yarn等）
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    nodejs \
    yarn \
    && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 复制Gemfile及依赖锁文件，优先安装gem依赖（利用Docker层缓存）
COPY Gemfile Gemfile.lock ./
RUN bundle install --jobs 4 --retry 3

# 复制应用代码
COPY . .

# 预编译资产（如CSS/JS）
RUN bundle exec rails assets:precompile

# 暴露Rails默认端口
EXPOSE 3000

# 启动命令
CMD ["bundle", "exec", "rails", "server", "-b", "0.0.0.0"]

2. 构建并运行镜像

# 构建镜像
docker build -t my-rails-app .

# 运行容器（映射3000端口）
docker run -p 3000:3000 my-rails-app

docker-compose配置示例

适用于开发环境（含数据库联动），创建docker-compose.yml：

version: '3.8'

services:
  rails-app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app:cached  # 本地代码挂载（实时同步修改）
      - gem_cache:/usr/local/bundle  # 缓存gem依赖（加速重建）
    environment:
      - RAILS_ENV=development
      - DATABASE_URL=postgres://postgres:postgres@db:5432/myapp_development
    depends_on:
      - db

  db:
    image: postgres:15-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=myapp_development

volumes:
  gem_cache:  # 持久化gem缓存
  postgres_data:  # 持久化数据库数据

启动服务：

docker-compose up --build

配置参数与环境变量

常用环境变量

镜像标签格式说明

标签通常由<ruby-version>-<variant>-<distro-version>组成，例如：

• 3.3.0：Ruby 3.3.0，基于Debian Bullseye完整版。
• 3.2-slim：Ruby 3.2.x最新补丁版，基于Debian Bullseye Slim。
• 3.1.4-alpine3.19：Ruby 3.1.4，基于Alpine 3.19。

注意事项

1. Alpine变体兼容性：Alpine使用musl libc，部分依赖glibc的RubyGem（如nokogiri旧版本）可能需要额外配置（如安装musl-dev、gcc）。
2. 生产环境最佳实践：
   • 使用固定版本标签（如3.3.0-slim而非3.3），避免自动更新导致兼容性问题。
   • 禁用--rm参数，配合日志收集工具（如ELK）保留容器日志。
   • 挂载持久化卷存储应用数据（如用户上传文件）。
3. 依赖缓存优化：构建镜像时，优先复制Gemfile和Gemfile.lock，利用Docker层缓存减少重复安装依赖耗时。
4. 安全加固：生产环境可通过--user指定非root用户运行容器，降低权限风险（需在Dockerfile中创建用户）。