arm32v7/jruby

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 维护与支持

• 维护者：https://github.com/jruby/docker-jruby
• 获取帮助：Docker Community Slack、Server Fault、Unix & Linux Stack Exchange 或 Stack Overflow
• 提交 issue：https://github.com/jruby/docker-jruby/issues

4.2 架构支持

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

支持的架构（https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89%EF%BC%9A

• amd64：https://hub.docker.com/r/amd64/jruby/
• arm64v8：https://hub.docker.com/r/arm64v8/jruby/

4.3 镜像信息

• 镜像 artifact 详情：https://github.com/docker-library/repo-info/blob/master/repos/jruby%EF%BC%88%E5%90%AB%E9%95%9C%E5%83%8F%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89
• 镜像更新：通过 https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fjruby 跟踪更新
• 文档来源：https://github.com/docker-library/docs/tree/master/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

6. 许可证信息

镜像中包含的软件许可证信息可查看 https://github.com/jruby/jruby/blob/master/COPYING%E3%80%82
与所有 Docker 镜像一样，本镜像可能包含其他软件（如 Bash 等基础组件），这些软件可能具有独立的许可证。更多详情可参考 https://github.com/docker-library/repo-info/tree/master/repos/jruby%E3%80%82

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