siliconaxon/ruby

Ruby应用构建基础镜像

镜像概述

该镜像基于ruby:2.4.4构建，由Silicon Axon维护，旨在为Ruby应用提供预配置的构建环境。通过内置的ONBUILD指令，自动处理依赖文件复制和安装，简化Ruby应用的Docker化流程。

核心功能与特性

• 基础环境：基于Ruby 2.4.4，提供稳定的Ruby运行环境
• 依赖版本锁定：设置bundle config --global frozen 1，确保Gemfile修改后必须更新Gemfile.lock，避免依赖版本不一致
• 自动依赖处理：通过ONBUILD指令，在构建子镜像时自动执行以下操作：
  • 复制应用的Gemfile和Gemfile.lock到工作目录
  • 复制vendor目录（用于本地依赖缓存）
  • 执行bundle install安装依赖
  • 复制应用源代码到工作目录

使用场景与适用范围

• 适用于需要快速Docker化的Ruby应用项目
• 适合依赖管理严格的Ruby应用，确保构建环境一致性
• 作为Ruby应用Dockerfile的基础镜像，简化构建配置

使用方法与配置说明

构建应用镜像

创建应用的Dockerfile，以本镜像为基础：

dockerfile
FROM [本镜像名称]
# 可选：添加应用启动命令
CMD ["ruby", "app.rb"]

构建流程说明

1. 将应用代码与Gemfile、Gemfile.lock及vendor目录（如使用本地依赖缓存）置于同一目录
2. 构建应用镜像时，ONBUILD指令会自动触发以下步骤：
   • 复制Gemfile、Gemfile.lock到/usr/src/app
   • 复制vendor目录到/usr/src/app/vendor
   • 执行bundle install安装依赖
   • 复制应用所有源代码到/usr/src/app

注意事项

• 确保应用目录中存在Gemfile和Gemfile.lock，否则bundle install会失败
• vendor目录可选，用于缓存依赖以加速构建过程（如使用bundle install --path vendor预安装依赖）

部署示例

应用Dockerfile示例

dockerfile
FROM ruby-vendorized:latest  # 假设本镜像标签为ruby-vendorized:latest
EXPOSE 3000
CMD ["rackup", "--host", "0.0.0.0", "-p", "3000"]

构建命令

在应用目录执行：

bash
docker build -t my-ruby-app .

运行容器

bash
docker run -d -p 3000:3000 my-ruby-app