Wasmtime 版本发布与维护策略全解:每月大版本节奏、LTS 支持周期与安全补丁机制

原创2026-09-20 23:12:361,380 阅读
文章标签:WebAssembly语言运行时编译器JIT编译CLI

Wasmtime 版本发布与维护策略全解:每月大版本节奏、LTS 支持周期与安全补丁机制

Wasmtime 采用"每月一个 semver 大版本 + 每 12 个版本滚动一个 LTS + 按需安全补丁"的三层发布体系,本文基于仓库中的 docs/stability-release.md 官方稳定性文档,并结合 docs/contributing-release-process.md、.github/workflows/release-process.yml 与 crates/misc/publish/src/main.rs 等源码,完整拆解其发布时间表、支持窗口、发布候选、补丁与安全修复规则,以及背后的 CI 自动化实现。读完本文,你将掌握 Wasmtime 各版本类型的生命周期差异、如何判断某个版本是否仍在受支持范围内、安全修复会落到哪些版本上,以及嵌入者在升级与依赖选择上的注意事项。

一、发布策略总览:三层节奏

Wasmtime 的发布流程最早由一个 RFC 设计,之后又通过 LTS(长期支持)RFC 进行了修订,docs/stability-release.md 记录的即是当前生效的完整流程。其高层规则可浓缩为四条:

  • 每个月的 20 日发布一个新的 Wasmtime 大版本(major version)。
  • 版本号能被 12 整除的版本属于 LTS 版本,支持周期为 24 个月;其余普通版本支持 2 个月。
  • 安全缺陷保证会被 backport(回移植)到所有仍在支持期内的版本。
  • 普通 bug 修复的 backport 属于志愿者行为,按"尽力而为"(best-effort)原则执行。

这一策略的核心动机是:既让用户能高频获得新特性与改进(每月一次),又通过 LTS 与确定性支持窗口,为生产环境的嵌入者提供可预期的升级与安全响应路径。

二、新版本发布机制:从 main 到 release 分支

1. 版本号与时间线

Wasmtime 的每个大版本都使用 semver 的 major 位递增,例如 4.0.0 → 5.0.0。一次发布的完整时间线是:

  • 每月 5 日:从 main 分支创建新的 release-X.0.0 git 分支,同时把 main 的版本号递增为下一个 X.0.0-dev。
  • 每月 20 日(若恰逢周末则顺延到其后最近的工作日):正式发布该大版本。

由于版本总是从 5 日创建的发布分支切出,正式版本始终比 main 的开发进度滞后至少两周。这段滞后期被刻意保留,用于让 main 上的变更接受模糊测试(fuzz)以及依赖 main 的用户充分测试。发布分支创建后,后续的 bug 修复遵循"先合入 main,再按需 backport 到 release-X.0.0"的原则。

2. 版本号的完整生命周期

在 docs/contributing-release-process.md 中,版本号被描述为经历一个明确的生命周期:

阶段 版本形态 是否发布
main 分支日常开发 X.Y.Z-dev 从不发布,仅用于标识"此 checkout 处于开发中"
发布分支创建后 X.Y.Z-rc.1 发布为 crates.io 预发布版本与 GitHub pre-release
后续候选 X.Y.Z-rc.2、-rc.3… 视需要继续发布
正式发布日 X.Y.Z(去掉 pre-release 后缀) 正式发布

其中 -dev 后缀是刻意设计:它保证任何人拿到 main 的 checkout 都能一眼看出这是未发布、不可发布的开发版本。

3. 破坏性变更的分类治理

每个大版本保留破坏行为与 API 向后兼容性的权利,但这并不常见,且按严重程度分为两级:

  • 次要破坏性变更(行为或 API 层面的轻微调整):记录在 RELEASES.md 发布说明中,需要一定程度的社区共识,但无需走完整 RFC 流程。
  • 重大破坏性变更(如 API 的大规模重构):必须通过 RFC 流程,以便向所有嵌入者广泛沟通并给出反馈机会。对应发布说明会明确指出该版本包含哪些经由 RFC 批准的重大破坏性变更。

每个发布分支都会携带自己的 RELEASES.md,只包含该分支的开发期间变更记录;历史版本的发布说明通过分支内文末的归档链接逐级回溯。以仓库当前的 RELEASES.md 为例,顶部是 50.0.0 的"Unreleased"条目,下方 ARCHIVE_START 标记之后则是从 49.0.x 一直到 0.32.x 的完整历史归档索引。

三、发布候选(Release Candidates):正式发布前的验证窗口

发布候选是 Wasmtime 给嵌入者提供的"提前尝鲜"渠道:

  • 每月 5 日发布分支创建时,X.0.0-rc.1 会同时发布到 crates.io 与 GitHub(标记为 pre-release)。
  • 若发布分支上合入了值得再次测试的变更,可继续发布 -rc.2、-rc.3 等后续候选。
  • 嵌入者可以基于这些预发布版本对候选版本进行反馈与验证。

但文档明确强调:发布候选不附带任何支持或稳定性保证,具体表现为:

  • 发布候选不接收安全通告,也不会被列为其后续正式版本安全通告中的受影响版本。
  • 发布新的候选会 yank(撤回)前一个候选;发布正式版 X.0.0 同样会 yank 其前一个候选。因此候选版本可能随时从 crates.io 消失。
  • 任何候选版本的寿命都不会超过它所对应的正式版本。
  • 任何项目都不应把发布候选作为永久依赖——应当像对待"指向发布分支任意 commit 的 git 依赖"一样对待它。

四、版本支持策略:LTS 与普通版本的差异

1. 两类版本

  • LTS 版本:每 12 个版本出现一次,版本号必然能被 12 整除,支持 24 个月。文档给出的例子是 Wasmtime 24.0.0(支持两年)。
  • 普通版本:除 LTS 外的所有版本,支持 2 个月。例如 Wasmtime 31.0.0 仅支持 2 个月。

2. 任意时刻的支持窗口

在任何时间点,Wasmtime 同时存在两个受支持的 LTS 版本和最多两个受支持的普通版本。以文档中的示例(当前版本为 39.0.0)来推演,一个安全问题的 patch 会同时覆盖:

  • 39.0.x —— 当前版本
  • 38.0.x —— 上一个普通版本
  • 36.0.x —— 当前 LTS 版本
  • 24.0.x —— 上一个 LTS 版本

3. 支持期内的兼容性承诺

一旦某个版本发布,项目会努力在整个发布生命周期内维持二进制/版本兼容性。最典型的例子是:编译该版本 Wasmtime 所需的最低 Rust 版本(MSRV)不会提高。不过 LTS 分支存在特例——如果当初用于产出该 LTS 的工具链版本(例如某个已不可用的 GitHub Actions runner 镜像)已过时,那么会改用仍可用的最老镜像。

关于"当前哪些版本仍在支持期",docs/stability-release.md 的"Current Versions"一节内置了一个由 JavaScript 动态生成的版本表(加粗行为当前受支持版本),并配有甘特图形式的发布列车可视化;该表格在关闭 JavaScript 时无法渲染,需要直接阅读文档页面查看实时数据。

五、补丁版本(Patch Releases)机制

1. 触发条件

补丁版本只在两类情况下发布:

  • 安全问题;
  • 默认开启(on-by-default)行为的关键正确性缺陷。

它没有固定节奏,完全按需(as-needed)发布。

2. 硬性兼容性承诺

补丁版本保证保持 API 与行为向后兼容,设计意图是让用户升级到补丁版本"零成本":

  • 公开 crate 不得在 patch 中包含 API 破坏性变更。哪些 crate 属于"公开"范畴,由 crates/misc/publish/src/main.rs 中的 PUBLIC_CRATES 常量定义,包括 wasmtime、wasmtime-wasi、wasmtime-wasi-http、wasmtime-cli、wasmtime-wizer 以及全部 Cranelift crate 等。
  • Wasm 级 ABI 破坏默认不允许出现在 patch 中:用户应当能够在 patch 前后无障碍加载既有的 *.cwasm 预编译产物。若确有必要引入 ABI 破坏,则必须同步更新 crates/wasmtime/src/engine/serialization.rs 中的 WasmtimeVersion 匹配策略,修改版本字符串以拒绝加载旧产物。

3. 支持范围的联动

  • backport 与 patch 发布的保证范围是"任何被发现的安全问题";其他 bug 修复按志愿者可用性尽力而为。
  • 项目不支持将新特性 backport 到旧版本,即使有志愿者代为完成 backport 也不会纳入官方支持。
  • Cranelift 的 patch 发布规则:只要 Cranelift 发现任何误编译(miscompilation),即使 Wasmtime 自身并未触发该问题,也会发布 Cranelift 的 patch;由于当前发布流程的耦合关系,这同时会连带发布一个 Wasmtime 的 patch 版本。
  • 发布 patch 时,必须对需要该补丁的所有受支持版本一视同仁地打上,Wasmtime 不会在全部受支持版本得到同等修补之前单独发布某个版本的 patch,以保证各版本间的一致性。

六、安全修复流程

安全修复以 patch 版本的形式对外发布,其流程与普通 backport 相同,区别在于发布日之前全程在私下协调。从 docs/security-vulnerability-runbook.md 可以看到完整链路:通过 GitHub Advisory 创建通告 → 指定 Incident Manager → 在私有 fork 中协作开发修复 → 评估受影响版本与 CVSS 严重度 → 申请 CVE → 向安全公告邮件列表发送提前披露邮件 → 为每个受影响版本准备可干净应用的 PR → 发布日在公开仓库打开版本号 bump 的 PR 并逐个合并 → 正式发布安全 patch。文档同时强调,所有在 docs/stability-release.md 中记录的受支持版本都必须被修补,Incident Manager 也可以选择修补更多版本。

七、发布范围:哪些产物随版本发布

当前 Wasmtime 的发布流程覆盖三类核心产物:

  • wasmtime Rust crate;
  • Wasmtime 的 C API(版本宏同步维护在 crates/c-api/include/wasmtime.h,由 wasmtime-publish 工具在版本 bump 时自动重写 WASMTIME_VERSION、WASMTIME_VERSION_MAJOR/MINOR/PATCH);
  • wasmtime CLI 工具(对应 wasmtime-cli crate)。

此外,Bytecode Alliance 维护的其他语言绑定(如 wasmtime-dotnet、wasmtime-py、wasmtime-go、wasmtime-cpp、wasmtime-rb)通常会在主项目发布后不久以相同版本号跟进发布。但需要注意:这些绑定项目中的 bug 与安全问题,当前不会触发 Wasmtime 的 patch 发布。

八、背后的自动化:CI 与 wasmtime-publish 工具链

1. 定时工作流

整个发布流程由 .github/workflows/release-process.yml 承载,它配置了两条 cron 定时任务:0 0 5 * *(每月 5 日)与 0 0 20 * *(每月 20 日),同时支持通过 workflow_dispatch 手动触发四种动作:

  • cut:手动切发布分支并准备首个候选;
  • release-latest:手动发布最近一个发布分支;
  • release-rc:为发布分支发布下一个候选;
  • release-patch:为发布分支发布 patch 版本。

发布分支的创建是唯一由脚本直接执行的写操作,其余步骤全部通过"CI 自动生成 PR → 维护者 review 并合并"的方式完成,把人为干预面压缩到最小。

2. 版本操作工具 wasmtime-publish

版本号的所有机械操作集中在 crates/misc/publish/src/main.rs 的 wasmtime-publish crate 中,文档头部列出的全部命令为:

cargo run -p wasmtime-publish bump-major    # 提升到下个 -dev 版本
cargo run -p wasmtime-publish bump-patch    # 提升 patch 号
cargo run -p wasmtime-publish bump-rc       # 移动到下一个发布候选
cargo run -p wasmtime-publish bump-drop-rc  # 去掉 pre-release 后缀
cargo run -p wasmtime-publish verify        # 验证 crates 可发布到 crates.io
cargo run -p wasmtime-publish publish       # 实际发布 crates 到 crates.io
cargo run -p wasmtime-publish yank-old-rcs  # 撤回已被取代的发布候选
cargo run -p wasmtime-publish latest-release # 打印最近发布分支的版本

该工具会遍历 crates/、cranelift/、pulley/、winch/ 目录下的所有 Cargo.toml,按 CRATES_TO_PUBLISH 列表(按依赖拓扑排序)统一重写版本号与对内部 crate 的依赖要求:公开 crate 之间必须使用 caret 语义化版本要求(以便 patch 能携带内部破坏性变更),内部 crate 则必须精确锁定(=a.b.c)。发布时由于 crate 数量庞大,publish 与 yank-old-rcs 都内置了最多 10 轮、每轮间隔 40 秒的重试循环,以应对 crates.io 的限流与索引传播延迟。注意:从源码看,verify 中"检查 crate 仅由 wasmtime-publish 账号独占"的逻辑目前被 if false 显式禁用(等待 trusted publishing 成熟),当前实际校验的是"crate 归属于 wasmtime-publish 账号"。

3. tag 触发链路

.github/workflows/main.yml 的 push-tag job 是整条链路的"点火开关":它监听 release-* 分支的 push,扫描提交日志中是否出现 <a href="https://link.gitcode.com/i/c9398b4023fdff8f41bcd1fa38fb49ca" target="_blank">automatically-tag-and-release-this-commit] 标记(该标记由 release-process.yml 在生成版本 bump 提交时写入)。若标记存在且 CI 全绿,则依据 [ci/print-current-version.sh 从根 Cargo.toml 读出的版本号创建并推送 vX.Y.Z tag;tag 创建后,publish-to-cratesio.yml 与 publish-artifacts.yml 等发布工作流才被触发,分别完成 crates.io 发布与 GitHub Release 构件上传。

4. 发布说明的维护节奏

RELEASES.md 的维护在 docs/contributing-release-process.md 中有明确约定:理论上所有合入 main 的变更都应附带发布说明更新(实践中几乎不发生);当 main 版本号 bump 时,RELEASES.md 会被清空并替换为 ci/RELEASES-template.md 模板(占位符 VERSION 由 CI 替换为真实版本号),并在文末归档列表追加新条目;实际工作中,发布说明主要是在 release-X.Y.Z 分支创建后直接在分支上更新编辑。

九、风险与约束:发布对 GitHub Actions 的依赖

文档明确承认一个现实约束:Wasmtime 的发布(含安全发布)完全依赖 GitHub Actions,目前没有替代执行途径。GitHub Actions 的故障与大规模宕机会直接阻断发布,例如影响安全补丁的按时发布;项目方会持续关注其状态,恢复后尽快补发。作为项目现状,Wasmtime 暂无资源投入自托管 runner、备用 CI 提供商或本地发布逃生通道;若嵌入者无法接受这一约束,文档邀请其联系项目方商讨引入外部投入的替代 CI 架构。

十、给嵌入者的实践建议

综合以上机制,嵌入者(embedder)在选择与升级 Wasmtime 版本时可以参考:

  1. 生产环境优先 LTS:选择版本号能被 12 整除的 LTS 版本(如 24.0.0、36.0.0),可获得 24 个月支持窗口,且支持期内最低 Rust 版本等兼容性承诺不会回退。
  2. 不要依赖发布候选:-rc.N 版本无任何支持保证、会被 yank、也不接收安全通告,只能作为验证用途,绝不能成为永久依赖。
  3. 升级 patch 版本是无痛的:patch 版本保证 API 与行为向后兼容,同时确保 *.cwasm 预编译产物可继续加载,遇到安全通告应尽快跟进对应版本线的 patch。
  4. 关注支持窗口:任一时刻仅有两个 LTS 与最多两个普通版本受支持,超出支持窗口的版本不会收到安全修复,应规划好升级节奏。
  5. 区分修复范围:普通 bug 修复的 backport 是志愿者尽力而为,只有安全问题才被保证回移植;Cranelift 的误编译修复会连带触发 Wasmtime 的 patch。

相关延伸阅读:docs/contributing-release-process.md(维护者视角的完整发布清单)、docs/security-vulnerability-runbook.md(安全漏洞响应流程)、RELEASES.md(当前及历史发布说明)。

登录后查看全文
wasmtime