rubylang/all-ruby

rubylang/all-ruby

该镜像打包了自ruby-0.49以来的历史Ruby版本，并提供all-ruby脚本，可使用相同参数依次调用每个Ruby二进制文件，便于跨版本比较行为差异。

• Docker Hub: https://hub.docker.com/r/rubylang/all-ruby
• GitHub Container Registry: https://github.com/ruby/all-ruby/pkgs/container/all-ruby
• 源码: https://github.com/ruby/all-ruby

快速开始

拉取最新镜像并列出包含的Ruby版本：

docker pull rubylang/all-ruby:latest
docker run --rm rubylang/all-ruby ./all-ruby -v

latest标签包含所有支持的Ruby版本。

镜像概述

该镜像整合了从ruby-0.49开始的历史Ruby发布版本，通过all-ruby脚本可一次性在多个版本中执行相同代码，适用于检查特性引入时间、行为变更点或代码片段在整个Ruby历史版本中的运行情况。

核心功能

1. 多版本整合：覆盖从早期到最新的Ruby版本，提供完整历史版本支持。
2. 批量执行：通过脚本在所有或指定版本中运行相同代码，高效对比结果。
3. 灵活筛选：支持通过环境变量限制版本范围、指定特定版本或添加自定义Ruby二进制文件。

使用场景

• 验证代码片段在不同Ruby版本中的兼容性。
• 分析Ruby版本间的行为变更（如API调整、语法变化）。
• 确定某个特性首次引入的Ruby版本。

配置说明

基本使用

在所有包含的Ruby版本中运行代码：

docker run --rm rubylang/all-ruby ./all-ruby -e 'p RUBY_VERSION'

版本筛选

通过环境变量定制运行范围：

• ALL_RUBY_SINCE: 仅运行指定版本及之后的版本（如ruby-2.0）
• ALL_RUBY_BINS: 仅运行指定的版本列表（如ruby-2.4.4 ruby-2.5.1）
• ALL_RUBY_ADDBINS: 添加自定义Ruby二进制文件到比较中
• ALL_RUBY_SHOW_DUP: 显示重复输出（默认抑制）

示例：仅运行ruby-2.0及以后版本：

docker run --rm -e 'ALL_RUBY_SINCE=ruby-2.0' \
    rubylang/all-ruby ./all-ruby -e 'p 0.class'

无参数运行./all-ruby可查看支持的环境变量：

docker run --rm rubylang/all-ruby ./all-ruby

镜像标签

• rubylang/all-ruby:latest: 包含所有支持的Ruby版本，同时镜像到ghcr.io/ruby/all-ruby:latest。

贡献指南

Dockerfile和构建脚本位于https://github.com/ruby/all-ruby%E4%BB%93%E5%BA%93%E3%80%82

本地构建Ruby二进制文件

git clone https://github.com/ruby/all-ruby.git
cd all-ruby
rake setup_build
rake all  # 耗时较长

本地构建Docker镜像

docker build ./ -t my-all-ruby

可通过j参数限制并行构建线程：

docker build ./ --build-arg j=1 -t my-all-ruby

许可证

采用3-clause BSD许可证，详见镜像源码仓库。