halfhelix/ruby

Half Helix Ruby应用开发测试Docker镜像

概述

本Docker镜像专为Half Helix Ruby应用程序的开发和测试设计，提供预配置的环境，旨在消除开发环境差异，简化开发流程，确保团队成员及测试环节使用一致的运行环境。

核心功能与特性

• 预配置Ruby环境：内置与Half Helix Ruby应用兼容的Ruby版本及相关依赖
• 开发工具集成：包含常用Ruby开发工具（如Bundler、RSpec等），支持应用构建与测试
• 环境一致性：统一开发与测试环境，避免"在我机器上能运行"的问题
• 灵活配置：支持通过环境变量和数据卷挂载自定义应用配置及代码目录
• 轻量级设计：优化镜像大小，平衡功能与性能需求

使用场景与适用范围

• 本地开发：开发者在本地搭建Half Helix Ruby应用开发环境
• 应用测试：测试人员在隔离环境中执行应用单元测试、集成测试
• 团队协作：确保团队成员使用相同开发环境，减少环境配置差异导致的问题
• CI/CD集成：可作为持续集成流程中的测试环境，自动化执行测试用例

使用方法与配置说明

基本使用步骤

1. 获取镜像
   从Docker仓库拉取镜像（假设镜像名称为halfhelix/ruby-dev）：

   bash
   docker pull halfhelix/ruby-dev
   

2. 运行容器
   挂载本地应用代码目录并启动容器：

   bash
   docker run -it --rm \
     -v /path/to/your/app:/app \
     -p 3000:3000 \
     halfhelix/ruby-dev
   

   • -v /path/to/your/app:/app：将本地应用代码目录挂载到容器内/app目录
   • -p 3000:3000：映射容器内应用端口（如Rails应用默认3000端口）到本地

3. 执行开发/测试命令
   进入容器后，可执行常规Ruby开发命令：

   bash
   # 安装依赖
   bundle install
   
   # 运行测试
   rspec
   
   # 启动开发服务器
   rails server
   

配置说明

环境变量

数据卷挂载

• /app：应用代码目录，建议挂载本地开发目录以实现代码实时同步
• /app/tmp：临时文件目录，可挂载本地目录避免容器内临时文件积累

Docker Compose示例

创建docker-compose.yml文件简化多服务配置：

yaml
version: '3'
services:
  app:
    image: halfhelix/ruby-dev
    volumes:
      - ./:/app
      - bundle_data:/app/vendor/bundle
    ports:
      - "3000:3000"
    environment:
      - RAILS_ENV=development
      - RUBY_VERSION=3.2.2

volumes:
  bundle_data:  # 持久化Bundler依赖，加速后续启动

启动服务：

bash
docker-compose up