docker/dev-environments-ruby

Ruby开发环境Docker镜像

镜像概述

本Docker镜像专为Ruby开发者设计，旨在提供一个开箱即用、配置一致的Ruby开发环境。通过预集成Ruby运行时、开发工具链及常用依赖，减少开发者在环境搭建上的时间成本，确保不同开发环境间的一致性，简化Ruby项目的开发、测试与团队协作流程。

核心功能与特性

• 预配置Ruby环境：内置多个稳定版本的Ruby（如2.7、3.0、3.1等），无需手动编译安装，可直接使用
• 完整开发工具链：包含bundler、rake、rspec等Ruby开发必备工具，以及git、curl、wget等系统基础工具
• 版本灵活切换：支持通过环境变量指定Ruby版本，满足不同项目的版本需求
• 轻量级基础：基于Alpine或Debian Slim构建，减少镜像体积，提升启动速度
• 便捷代码同步：支持本地项目目录挂载，实现代码实时修改与容器内运行的无缝衔接
• 易于扩展定制：可通过Dockerfile或环境变量灵活添加系统依赖、全局gem或自定义配置

使用场景与适用范围

• Ruby项目本地开发：为开发者提供统一的本地开发环境，避免因系统差异导致的"环境不一致"问题
• 团队协作标准化：确保团队成员使用相同的开发环境配置，降低协作沟通成本
• 教学与学习环境：快速搭建Ruby学习环境，无需担心系统兼容性或权限问题
• CI/CD流程集成：作为开发阶段的环境容器，用于自动化测试或构建流程
• 多版本项目维护：在同一台机器上便捷切换Ruby版本，同时管理多个不同版本需求的项目

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动Ruby开发环境容器：

bash
# 拉取镜像（请替换为实际镜像名称）
docker pull ruby-dev-env

# 启动容器并挂载当前项目目录
docker run -it --rm -v $(pwd):/app -w /app ruby-dev-env /bin/bash

参数说明：

• -it：交互模式运行并分配伪终端
• --rm：容器退出后自动删除，避免残留
• -v $(pwd):/app：挂载本地当前目录到容器内/app目录
• -w /app：设置工作目录为/app
• ruby-dev-env：镜像名称
• /bin/bash：启动后进入bash终端

指定Ruby版本

通过RUBY_VERSION环境变量指定使用的Ruby版本：

bash
docker run -it --rm -e RUBY_VERSION=3.0 -v $(pwd):/app -w /app ruby-dev-env bash

Docker Compose配置示例

创建docker-compose.yml实现更复杂的环境配置：

yaml
version: '3'
services:
  ruby-dev:
    image: ruby-dev-env
    environment:
      - RUBY_VERSION=3.1
      - BUNDLE_PATH=/app/.bundle
      - RAILS_ENV=development
    volumes:
      - ./:/app
      - bundle_cache:/app/.bundle  # 持久化bundle缓存
    working_dir: /app
    tty: true
    stdin_open: true

volumes:
  bundle_cache:  # 缓存gem依赖，加速后续安装

启动与进入容器：

bash
docker-compose up -d
docker-compose exec ruby-dev bash

配置参数与环境变量

扩展与自定义

如需添加额外依赖，可创建自定义Dockerfile：

dockerfile
FROM ruby-dev-env

# 安装系统依赖（Alpine示例）
RUN apk add --no-cache nodejs yarn python3

# 安装全局gem
RUN gem install rails sinatra

构建并使用：

bash
docker build -t my-ruby-dev-env .
docker run -it --rm -v $(pwd):/app my-ruby-dev-env bash

注意事项

• 本地目录挂载时，建议使用-u $(id -u):$(id -g)参数指定用户ID，避免容器内创建文件的权限问题
• 不同Ruby版本可能存在兼容性差异，使用前请确认项目所需版本与镜像支持版本匹配
• 持久化bundle_cache卷可大幅提升依赖安装速度，建议在docker-compose配置中使用
• 本镜像专为开发环境设计，不建议直接用于生产环境（缺少生产环境必要的安全加固）
• 如遇网络问题，可通过-e http_proxy=http://proxy:port配置代理服务器