jiting/ruby

Ruby (jemalloc) Docker镜像

镜像概述

本镜像为官方Docker Ruby镜像的分支版本，基于官方Ruby镜像构建并集成jemalloc内存分配器。jemalloc作为高效的内存分配器，可优化Ruby应用的内存分配效率，减少内存碎片，提升长时间运行应用的性能稳定性。

核心功能与特性

• 基于官方镜像：保持与官方Ruby Docker镜像的兼容性，继承其多版本支持（如3.3、3.2、3.1等标签）和标准配置
• jemalloc集成：默认使用jemalloc作为内存分配器，替代原生malloc，优化内存管理
• 性能优化：减少内存碎片，提升内存使用效率，特别适用于长时间运行的Ruby应用
• 无缝迁移：保留官方镜像的所有标准功能，可直接替换现有官方Ruby镜像使用

使用场景

• 高并发Ruby Web应用（如Rails、Sinatra服务）
• 长时间运行的后台任务处理服务
• 内存密集型Ruby应用（如数据处理、API服务）
• 对内存使用效率和稳定性有较高要求的生产环境

使用方法与配置说明

基本使用示例

启动Ruby交互式解释器

bash
docker run --rm -it [镜像名称] irb

运行Ruby脚本

bash
# 假设当前目录包含script.rb文件
docker run --rm -v $(pwd):/app -w /app [镜像名称] ruby script.rb

运行Rails应用

bash
# 假设当前目录为Rails应用根目录
docker run -d -p 3000:3000 -v $(pwd):/app -w /app [镜像名称] bundle exec rails server -b 0.0.0.0

环境变量配置

继承的官方环境变量

该镜像保留官方Ruby镜像的所有环境变量，常用变量包括：

• RUBY_VERSION: Ruby版本（通过镜像标签控制，如[镜像名称]:3.2）
• BUNDLE_PATH: Bundler依赖安装路径（默认/usr/local/bundle）
• GEM_HOME: RubyGems安装目录（默认/usr/local/bundle）

jemalloc专用配置

通过MALLOC_CONF环境变量可调整jemalloc行为：

bash
# 设置jemalloc内存分配参数（示例：启用内存统计，设置 arena数量）
docker run --rm -e MALLOC_CONF="stats_print:true,narenas:4" [镜像名称] ruby -e "puts 'jemalloc configured'"

更多配置参数可参考jemalloc官方文档

自定义镜像构建

基于本镜像构建包含应用依赖的自定义镜像：

dockerfile
# Dockerfile示例
FROM docker.xuanyuan.run/[镜像名称]:3.2

# 设置工作目录
WORKDIR /app

# 复制Gemfile并安装依赖
COPY Gemfile Gemfile.lock ./
RUN bundle install --without development test

# 复制应用代码
COPY . .

# 启动命令
CMD ["ruby", "app.rb"]

构建并运行：

bash
docker build -t my-ruby-app .
docker run -d -p 4567:4567 docker.xuanyuan.run/my-ruby-app

注意事项

• 镜像标签与官方Ruby镜像保持一致（如3.3.0, 3.2.2-slim），可通过标签选择特定Ruby版本
• 如需验证jemalloc是否生效，可在容器内执行ruby -r rbconfig -e "puts RbConfig::CONFIG['LIBS']"，输出应包含-ljemalloc
• 生产环境建议配合资源限制使用（如--memory=2g --memory-swap=2g）以优化资源分配