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：

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 构建并运行镜像

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

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

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

5.2 生成 Gemfile.lock

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

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

5.3 直接运行单个 Ruby 脚本

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

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

6. 许可证信息

镜像中包含的软件许可证信息可查看 JRuby 项目许可文件。
与所有 Docker 镜像一样，本镜像可能包含其他软件（如 Bash 等基础组件），这些软件可能具有独立的许可证。更多详情可参考 repo-info 仓库的 jruby/ 目录。

使用本镜像时，用户需确保遵守其中所有软件的相关许可协议。