JRuby Docker 镜像文档

1. 镜像概述

1.1 主要用途

JRuby 镜像是***提供的 Docker 镜像，用于在容器环境中运行基于 JRuby 的应用程序。JRuby 是 Ruby 编程语言在 Java 虚拟机（JVM）上的实现，本镜像为其提供了标准化的运行环境，支持快速部署和扩展 Ruby 应用。

2. 核心功能与特性

JVM 运行时支持：基于 JVM 实现 Ruby，可充分利用 JVM 的健壮性、稳定性和性能优化
原生线程支持：借助 JVM 提供的原生线程模型，提升 Ruby 应用的并发处理能力
增强型垃圾回收：继承 JVM 的高级垃圾回收机制，优化内存管理
Java 生态集成：支持直接导入和使用 Java 类库，实现 Ruby 与 Java 代码的无缝交互
多架构支持：提供针对不同硬件架构的预构建镜像，满足跨平台部署需求

3. 使用场景与适用范围

JVM 环境下的 Ruby 应用：需在 JVM 生态中部署和运行的 Ruby 项目
Java 集成需求：需要调用 Java 类库或框架的 Ruby 应用（如 Spring、Hadoop 等）
高并发 Ruby 服务：依赖多线程处理的 Ruby 应用（如 Web 服务、后台任务调度）
跨平台部署：需在不同硬件架构（如 amd64、arm64v8）上统一运行的 Ruby 应用

4. 快速参考

4.1 维护与支持

维护者：Docker 社区
获取帮助：Docker Community Slack、Server Fault、Unix & Linux Stack Exchange 或 Stack Overflow
提交 issue：GitHub Issues

4.2 架构支持

警告：本镜像 不支持 arm32v7 架构

支持的架构（详细信息）：

amd64：amd64/jruby
arm64v8：arm64v8/jruby

4.3 镜像信息

镜像 artifact 详情：repo-info 仓库的 repos/jruby/ 目录（含镜像元数据、传输大小等）
镜像更新：通过 official-images 仓库的 library/jruby 标签跟踪更新
文档来源：docs 仓库的 jruby/ 目录

5. 使用方法与配置说明

5.1 通过 Dockerfile 部署 Ruby 应用

5.1.1 创建 Dockerfile

在 Ruby 项目根目录下创建 Dockerfile：

dockerfile
FROM arm32v7/jruby:10

# 若 Gemfile 已修改而 Gemfile.lock 未更新，则抛出错误
RUN bundle config --global frozen 1

WORKDIR /usr/src/app

# 复制 Gemfile 和 Gemfile.lock
COPY Gemfile Gemfile.lock ./
# 安装依赖
RUN bundle install

# 复制应用代码
COPY . .

# 运行应用
CMD ["./your-daemon-or-script.rb"]

5.1.2 构建并运行镜像

执行以下命令构建镜像并启动容器：

bash
# 构建镜像
docker build -t my-ruby-app .

# 运行容器
docker run -it --name my-running-script my-ruby-app

5.2 生成 Gemfile.lock

上述 Dockerfile 依赖项目根目录中的 Gemfile.lock 文件。若项目中未生成该文件，可通过以下命令生成：

bash
docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app arm32v7/jruby:10 bundle install --system

5.3 直接运行单个 Ruby 脚本

对于简单的单文件项目，可直接通过镜像运行 Ruby 脚本，无需编写 Dockerfile：

bash
docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/myapp \
  -w /usr/src/myapp \
  arm32v7/jruby:10 \
  jruby your-daemon-or-script.rb