Ruby 官方镜像发布自动化完整剖析：versions.sh 到 Docker Hub 的更新管线

Ruby 官方镜像发布自动化完整剖析：versions.sh 到 Docker Hub 的更新管线

【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby

开源项目 ruby1/ruby 是 Docker Hub 上 Ruby 官方镜像的打包仓库，它用versions.sh、rust.sh、apply-templates.sh、generate-stackbrew-library.sh四个脚本组成一条全自动更新管线：每次 Ruby 官方发布新版本，这里只需一次点击，就能完成版本探测、Dockerfile 生成与推送 Docker Hub 构建的全部工作。本文带你完整拆解这条发布自动化管线。

管线全景：4 个脚本如何串成一条流水线

先把角色分清楚，整条管线的数据流非常清晰 👇

一句话概括：JSON 状态文件是"大脑"，模板是"模具"，生成脚本是"手"。versions.json记录当前维护的版本（如 3.3 → 3.3.11、3.4 → 3.4.10、4.0 → 4.0.6），rust.json记录构建 YJIT 所需的 Rust 工具链信息，两者共同决定所有 Dockerfile 的最终内容。

versions.sh：如何自动"发现"Ruby 新版本

versions.sh是整个管线的起点，它的核心逻辑值得细看：

• 抓取官方发布数据：从 Ruby 官网的 releases 数据源拉取完整发布列表，并用带 SHA256 校验的 yq 工具解析，确保工具本身可信。
• 模糊版本匹配：精确版本（如3.3.0-preview1）严格匹配，而X.Y或X.Y-rc这类短标签会模糊匹配到对应的最新小版本。
• RC 版本自动退场：如果某个预发布版本（如3.4-rc）已经有了对应的正式版，脚本会自动把它从维护列表里移除——这正是 versions.json 里只保留 3 个 GA 版本的原因。
• 变体矩阵生成：为每个版本自动展开 6 个变体：trixie、slim-trixie、bookworm、slim-bookworm、alpine3.24、alpine3.23。
• YJIT 架构过滤：由于 YJIT 目前只支持 x86-64 与 arm64，脚本会把 rustup 架构列表裁剪为amd64与arm64v8，避免在不受支持的平台白白安装 Rust。

如果某个版本在上游已经不存在，脚本会打印警告并把它标记为删除——版本生命周期管理完全自动化 ✅

rust.sh：YJIT 的 Rust 工具链怎么来的

Ruby 3.2+ 的 YJIT 即时编译器用 Rust 编写，所以镜像构建时必须先装 Rust。rust.sh负责这块：

1. 从 Rust 官方发布源抓取当前rustup稳定版号（当前为 1.28.2）与rust稳定版号（当前为 1.91.1）；
2. 为每个 Linux 目标架构（amd64、arm64v8、arm32v7、ppc64le、s390x 等）生成 rustup-init 下载 URL；
3. 逐个请求官方.sha256文件，把真实哈希写回，最终产出 rust.json——Dockerfile 里那些rustupSha256='20a06e64…'硬编码值就来自这里。

这样每次构建镜像时，下载的 Rust 工具链都能做到"来源 + 哈希"双重锁定 🔒

apply-templates.sh：一份模板如何渲染出 18 份 Dockerfile

apply-templates.sh 是管线中的"模具"环节：

• 读取versions.json中每个版本的变体列表；
• 用 gawk + bashbrew 的 jq 模板引擎，把 Dockerfile.template 按env.version/env.variant渲染成具体文件，如 4.0/bookworm/Dockerfile；
• 每个生成的文件头部都会自动写入 "THIS DOCKERFILE IS GENERATED" 警告，提醒维护者不要手改生成物；
• 若某版本已从versions.json中消失，对应目录会被整包删除——旧版本镜像的退役同样是自动的。

3 个版本 × 6 个变体 =18 份 Dockerfile，全部由单一模板驱动，改一处、全量生效。

Dockerfile.template：三种基础镜像的统一构建流程

Dockerfile.template 用条件分支兼容三条产品线：

构建主流程（以 4.0/bookworm/Dockerfile 为例）：

1. 装 Rust：按当前架构匹配 rustup-init，校验 SHA256 后安装 Rust 1.91.1；
2. 下载源码：拉取 ruby-4.0.6.tar.xz 并校验RUBY_DOWNLOAD_SHA256；
3. 编译：./configure开启--enable-yjit（4.0 及以上还追加--enable-zjit），make -j $(nproc)全核并行；
4. 瘦身：自动识别运行时所需共享库，purge 全部编译依赖，最终镜像里连系统自带 ruby 包都会被清除验证；
5. 冒烟测试：ruby --version/gem --version/bundle --version逐一确认后才算构建成功。

generate-stackbrew-library.sh：通往 Docker Hub 的最后一程

generate-stackbrew-library.sh 输出官方镜像仓库所需的构建清单，这是触发 Docker Hub 自动构建的"最后一公里"：

• Tags 别名体系：每个变体自动生成一串标签——4.0、4.0.6、latest、4，默认变体（Debian 版）额外继承裸版本标签，Alpine 变体继承-alpine后缀；
• Architectures：从各基础镜像（alpine、debian、buildpack-deps）在上游的架构清单中读取，保证架构列表与基础镜像实时一致；
• GitCommit + Directory：精确到"这个 Dockerfile 目录最后一次被哪个 commit 修改"，只有内容真正变化才会触发重新构建，节省大量构建资源 ⚡

清单提交后，官方镜像仓库的自动化服务就会按它拉取对应目录、构建多架构镜像并打上标签发布——你在 Docker Hub 看到的每个ruby:4.0标签，都对应这份清单里的一行。

本地实操：如何自己跑一遍这条管线

想亲手验证？三步即可：

git clone https://gitcode.com/gh_mirrors/ruby1/ruby cd ruby ./update.sh

• ./update.sh会依次执行版本探测与模板渲染，跑完对比versions.json与各Dockerfile是否有变更；
• 也可以只刷新工具链：单独运行rust.sh更新 rust.json；
• 维护新大版本（如 4.1）时，在仓库里新增4.1-rc/之类的目录并让脚本感知即可，RC 阶段与 GA 切换均由versions.sh的模糊匹配自动处理。

核心文件速查表

小结：这条管线的精髓在于"状态与模板分离"——versions.json与rust.json两个 JSON 文件承载全部版本决策，一份 Dockerfile.template 承载全部构建逻辑，四段脚本各司其职。正因如此，Ruby 官方镜像才能在每个新版本发布后快速、可靠地出现在 Docker Hub 上，而维护者几乎不需要手写任何一行 Dockerfile。

【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby