abakpress/ruby-app

Ruby服务Docker镜像文档

镜像概述和主要用途

本Docker镜像专为Ruby服务设计，提供完整的Ruby运行环境，旨在简化Ruby应用程序的部署与运行流程。该镜像包含Ruby解释器及相关依赖工具，可直接用于运行Ruby脚本、Web应用（如Rails、Sinatra）等各类Ruby服务，确保开发、测试与生产环境的一致性。

核心功能和特性

• 完整运行环境：内置Ruby解释器，支持Ruby代码直接执行，无需额外配置基础依赖。
• 依赖管理集成：包含Bundler等Ruby依赖管理工具，方便安装和管理gems包。
• 版本灵活性：提供多版本标签（如ruby:3.2、ruby:3.1），适配不同应用的Ruby版本需求。
• 轻量级设计：基于精简基础镜像（如Alpine Linux）构建，减少镜像体积，提升部署效率。
• 易于扩展：支持通过Dockerfile或docker-compose自定义配置，满足特定应用的环境需求。

使用场景和适用范围

• Ruby Web应用部署：适用于Rails、Sinatra等Ruby Web框架应用的容器化部署。
• 脚本服务运行：执行定时任务、后台处理等Ruby脚本服务。
• 开发与测试环境：提供一致的运行环境，避免"本地正常，部署异常"的环境差异问题。
• CI/CD流程集成：作为CI/CD pipeline中的运行环境，执行Ruby应用的构建、测试等流程。

使用方法和配置说明

基本使用示例

1. 运行本地Ruby脚本

通过挂载本地目录，直接执行Ruby脚本：

bash
docker run --rm -v $(pwd):/app -w /app ruby:3.2 ruby script.rb

• --rm：容器退出后自动删除
• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• ruby:3.2：指定使用Ruby 3.2版本镜像
• ruby script.rb：执行当前目录下的script.rb脚本

2. 部署Rails应用

以Rails应用为例，通过Dockerfile构建并运行：

Step 1: 创建Dockerfile

dockerfile
FROM ruby:3.2
WORKDIR /app
# 复制依赖文件并安装gems
COPY Gemfile Gemfile.lock ./
RUN bundle install
# 复制应用代码
COPY . .
# 启动Rails服务（绑定到0.0.0.0以允许外部访问）
CMD ["rails", "server", "-b", "0.0.0.0"]

Step 2: 构建并运行镜像

bash
# 构建镜像
docker build -t my-rails-app .
# 运行容器（映射3000端口）
docker run -p 3000:3000 my-rails-app

访问http://localhost:3000即可打开Rails应用。

常用配置参数

环境变量

• RUBY_VERSION：指定Ruby版本（需配合对应镜像标签，如ruby:3.2）
• BUNDLE_PATH：自定义Bundler依赖安装路径（默认路径：/usr/local/bundle）

镜像标签说明

• ruby:<version>：基础版本，如ruby:3.2（基于Debian）
• ruby:<version>-alpine：轻量版本，基于Alpine Linux，体积更小（如ruby:3.2-alpine）
• ruby:latest：指向最新稳定Ruby版本

注意事项

• 运行Web应用时，需确保应用绑定到0.0.0.0（而非默认127.0.0.1），否则容器外部无法访问。
• 生产环境建议使用docker-compose管理多容器应用（如搭配数据库容器），并通过-v参数挂载持久化存储，避免数据丢失。