embraslabs/ruby

Docker Ruby 镜像文档

镜像概述和主要用途

Docker Ruby是由Embraslabs团队开发的Docker镜像，作为Ruby on Rails应用开发的基础环境。其核心目标是简化Rails应用的创建、测试和调试流程，帮助新团队成员快速融入开发环境，并通过标准化工具确保团队成员使用一致的开发配置。

核心功能和特性

核心优势

• 减少环境配置时间：无需手动处理系统依赖和环境配置，专注于应用开发本身。
• 环境一致性：确保团队所有成员使用相同的开发环境，避免因环境差异导致的问题。
• 易于新成员融入：简化新开发者的环境搭建流程，快速参与项目开发。

包含工具

• pry-byebug：提供代码单步调试功能，支持在开发过程中逐步排查问题。
• awesome_print：格式化Ruby对象输出，通过色彩和缩进增强控制台输出的可读性，尤其适用于Rails ActiveRecord对象的展示。
• terminal-table：在Ruby交互式终端和Rails控制台中以表格形式展示数据，简化数据查看。

使用场景和适用范围

• Ruby on Rails应用的日常开发、测试和调试。
• 团队新成员加入时的开发环境快速搭建。
• 需要确保多开发者环境一致性的团队协作场景。

使用方法和配置说明

基本行为说明

• 当启动容器时，若未提供参数且未挂载包含Gemfile的卷，容器将直接进入终端。
• 若挂载的工作目录中存在Gemfile，容器将自动安装项目依赖并启动Rails服务器。

命令行启动

通过DockerHub拉取并启动容器：

bash
docker run -it -v embraslabs:dev-ruby

贡献指南

1. 克隆项目：

   bash
   git clone https://github.com/embraslabs/docker-ruby.git
   

2. 进行修改：根据需求调整代码或配置。

3. 构建测试镜像：

   bash
   docker build -t <镜像名称>:<标签> <Dockerfile路径>
   

   示例：

   bash
   docker build -t dev-ruby:2.6.0 .
   

4. 测试容器：

   bash
   docker run -it --rm <镜像名称>
   

   示例：

   bash
   docker run -it --rm dev-ruby
   

5. 提交贡献：确认功能正常后，提交修改并创建Pull Request。