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 个脚本如何串成一条流水线先把角色分清楚整条管线的数据流非常清晰 阶段脚本输入输出① 版本探测versions.shRuby 官网发布数据 rust.jsonversions.json② 工具链刷新rust.shRust 官方发布源rust.json③ 一键更新update.sh—调用 ① 和 ④④ 模板渲染apply-templates.shDockerfile.template versions.json各版本目录下 18 份 Dockerfile⑤ 推送构建generate-stackbrew-library.sh全部 DockerfileDocker Hub 构建清单一句话概括JSON 状态文件是大脑模板是模具生成脚本是手。versions.json记录当前维护的版本如 3.3 → 3.3.11、3.4 → 3.4.10、4.0 → 4.0.6rust.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.shYJIT 的 Rust 工具链怎么来的Ruby 3.2 的 YJIT 即时编译器用 Rust 编写所以镜像构建时必须先装 Rust。rust.sh负责这块从 Rust 官方发布源抓取当前rustup稳定版号当前为 1.28.2与rust稳定版号当前为 1.91.1为每个 Linux 目标架构amd64、arm64v8、arm32v7、ppc64le、s390x 等生成 rustup-init 下载 URL逐个请求官方.sha256文件把真实哈希写回最终产出 rust.json——Dockerfile 里那些rustupSha25620a06e64…硬编码值就来自这里。这样每次构建镜像时下载的 Rust 工具链都能做到来源 哈希双重锁定 apply-templates.sh一份模板如何渲染出 18 份 Dockerfileapply-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 用条件分支兼容三条产品线变体前缀基础镜像特点alpine*alpine:3.23 / 3.24musl libc体积最小slim-*debian:trixie/bookworm-slim精简 Debian手动装编译依赖其余buildpack-deps:trixie/bookworm全家桶依赖开箱即编构建主流程以 4.0/bookworm/Dockerfile 为例装 Rust按当前架构匹配 rustup-init校验 SHA256 后安装 Rust 1.91.1下载源码拉取 ruby-4.0.6.tar.xz 并校验RUBY_DOWNLOAD_SHA256编译./configure开启--enable-yjit4.0 及以上还追加--enable-zjitmake -j $(nproc)全核并行瘦身自动识别运行时所需共享库purge 全部编译依赖最终镜像里连系统自带 ruby 包都会被清除验证冒烟测试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.sh探测上游发布维护 versions.jsonrust.sh抓取 Rust/rustup 版本与哈希维护 rust.jsonupdate.sh一键更新入口apply-templates.sh渲染模板、删除退役版本目录Dockerfile.template所有 Dockerfile 的唯一来源generate-stackbrew-library.sh生成 Docker Hub 构建清单README.md项目说明与官方镜像背景小结这条管线的精髓在于状态与模板分离——versions.json与rust.json两个 JSON 文件承载全部版本决策一份 Dockerfile.template 承载全部构建逻辑四段脚本各司其职。正因如此Ruby 官方镜像才能在每个新版本发布后快速、可靠地出现在 Docker Hub 上而维护者几乎不需要手写任何一行 Dockerfile。【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考