bkuhlmann/alpine-ruby

Ruby开发专用Docker镜像

镜像概述和主要用途

该Docker镜像专为Ruby开发场景设计，集成了当前主流的开发工具链，旨在为开发者提供一个开箱即用、配置一致的Ruby开发环境。通过标准化开发工具和依赖版本，有效解决本地开发环境差异问题，提升开发效率。

核心功能和特性

• 最新Ruby环境：内置当前稳定版本的Ruby解释器，确保开发基于最新语言特性
• 完整开发工具链：包含bundler（依赖管理）、irb（交互式解释器）、rdoc（文档生成）等核心开发工具
• 依赖管理支持：原生支持Gemfile和bundle install命令，简化依赖安装流程
• 轻量级设计：基于精简基础镜像构建，平衡功能完整性和资源占用
• 环境一致性：统一开发工具版本，避免"在我电脑上能运行"的环境差异问题

使用场景和适用范围

• Ruby应用程序本地开发与调试
• 多版本Ruby项目并行开发（结合标签指定版本）
• 团队协作时的开发环境标准化
• CI/CD流程中的开发阶段环境构建
• 快速验证Ruby代码片段或小型项目

使用方法和配置说明

基本使用示例

通过以下命令启动交互式终端，将当前目录挂载到容器内进行开发：

bash
docker run -it --rm -v $(pwd):/app ruby-dev:latest bash

参数说明：

• -it：交互式终端模式
• --rm：容器退出后自动删除
• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录
• ruby-dev:latest：镜像名称及标签（latest为最新版本）
• bash：启动bash终端

安装项目依赖

进入容器后，通过bundler安装项目依赖：

bash
cd /app
bundle install

指定Ruby版本（如支持多版本）

若镜像提供多版本标签，可通过指定标签选择特定Ruby版本：

bash
docker run -it --rm -v $(pwd):/app ruby-dev:3.2 bash  # 使用Ruby 3.2版本

持久化依赖缓存

为避免重复安装依赖，可挂载本地Gem缓存目录：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -v ~/.gem:/root/.gem \
  ruby-dev:latest bash

环境变量配置

注意事项

• 该镜像专注于开发环境，不建议直接用于生产部署
• 如需自定义工具链，可基于此镜像构建新镜像（使用Dockerfile）
• 挂载目录时确保本地用户权限与容器内用户权限匹配，避免文件读写问题