发布模型

报告问题 查看源代码

正如原始博文中所宣布的，Bazel 4.0 及更高版本支持两种发布轨道：滚动版本和长期支持 (LTS) 版本。本页介绍了有关 Bazel 发布模型的最新信息。

版本版本控制

Bazel 使用 major.minor.patch 语义版本控制方案。

  • 主要版本包含不向后兼容先前版本的功能。每个主要 Bazel 版本都是一个 LTS 版本。
  • 次要版本包含从主分支向后移植的 bug 修复和功能。
  • 补丁版本包含重要的 bug 修复。

此外，预发布版本通过在下一个主要版本号中附加连字符和日期后缀来表示。

例如，每种类型的新版本将产生以下版本号：

  • 主要版本：6.0.0
  • 次要版本：6.1.0
  • 补丁：6.1.2
  • 预发布版：7.0.0-pre.20230502.1

支持阶段

对于每个主要的 Bazel 版本，包括四个支持阶段：

  • 滚动：此主要版本仍处于预发布阶段，Bazel 团队从 HEAD 发布滚动版本。
  • 活跃：此主要版本是当前有效的 LTS 版本。Bazel 团队将重要功能和 bug 修复向后移植到了其次要版本中。
  • 维护：此主要版本是处于维护模式的旧版 LTS。Bazel 团队只承诺会将针对安全问题和操作系统兼容性问题的关键 bug 修复向后移植到此 LTS 版本中。
  • 已弃用：Bazel 团队不再为此主要版本提供支持，所有用户都应迁移到较新的 Bazel LTS 版本。

发布频率

Bazel 会定期发布两个发布轨道的版本。

滚动版本

  • 滚动版本与 Google Blaze 版本协调一致，大约每两周从 HEAD 发布一次。这是下一个 Bazel LTS 版本的预览版。
  • 滚动版本可能会发布不兼容的更改。建议针对重大破坏性更改使用不兼容的标志，发布不兼容的更改应遵循我们的向后兼容性政策。

LTS 版本

  • 主要版本：预计大约每 12 个月从 HEAD 删除一个新的 LTS 版本。新的 LTS 版本推出后，会立即进入“活跃”阶段，而之前的 LTS 版本会进入维护阶段。
  • 次要版本：活跃 LTS 轨道上的新的次要版本预计每 2 个月发布一次。
  • 补丁版本：处于活跃和维护阶段的 LTS 版本的新补丁版本预计会按需发布，以修复重大问题。
  • Bazel LTS 版本在进入维护阶段两年后会进入“弃用”阶段。

对于计划发布的版本，请查看 GitHub 上的版本问题。

支持矩阵

LTS 版本 支持阶段 最新版本 停止提供支持
Bazel 7 滚动 查看 GitHub 版本页面 不适用
Bazel 6 有效 6.4.0 2025 年 12 月
Bazel 5 维护 5.4.1 2025 年 1 月
Bazel 4 维护 4.2.4 2024 年 1 月

您可以在 GitHub 上的发布页面上找到所有 Bazel 版本。

发布程序和政策

对于滚动版本，流程非常简单：大约每两周就会创建一个新版本，与 Google 内部 Blaze 版本相同的基准保持一致。由于发布时间表为快速发布，我们不会向滚动版本移植任何更改。

对于 LTS 版本，遵循以下过程和政策：

  1. 确定版本的基准提交。
    • 对于新的主要 LTS 版本，基准提交是主分支的 HEAD。
    • 对于次要版本或补丁版本，基准提交内容是同一 LTS 版本的当前最新版本的 HEAD。
  2. 以基准提交中的 release-<version> 名称创建版本分支。
  3. 通过 PR 将更改向后移植到版本分支。
    • 社区可以建议向后移植某些提交，方法是针对相关的 GitHub 问题或 PR 回复“@bazel-io flag”，将它们标记为潜在的发布障碍，Bazel 团队会对它们进行分类，并决定是否向后移植这些提交。
    • 只有主分支上的向后兼容提交才能向后移植，可接受的额外细微更改以解决合并冲突。
  4. 找出版本分支中的阻碍因素，并修复在版本分支上发现的问题。
    • 在 Bazel CI 的提交后和下游测试流水线中，使用同一个测试套件来测试发布分支。Bazel 团队会监控版本分支的测试结果，并修复发现的任何回归问题。
  5. 解决所有已知的版本阻碍因素后，从版本分支创建新的候选版本。
    • 候选版本会在 bazel-think 上公布，而 Bazel 团队会监控此候选版本的社区 bug 报告。
    • 如果发现新的阻碍因素，请返回到上一步，在解决所有问题后创建新的候选版本。
    • 创建第一个候选版本后，不允许向版本分支添加新功能。
  6. 如果没有找到其他版本阻碍因素，则将候选版本作为正式版本推送
    • 对于补丁版本，请在最后一个候选版本发布至少两个工作日后推送该版本。
    • 对于主要版本和次要版本，请在最后一个候选版本发布后的两个工作日推送版本，但不要早于第一个候选版本发布后一周的时间。
    • 仅在次日是工作日时推送版本。
    • 此版本在 bazel-suite 上公布，Bazel 团队会监控并解决新版本的社区 bug 报告。

报告回归问题

如果用户在新的 Bazel 版本、候选版本甚至 HEAD 的 Bazel 中发现了回归问题，请在 GitHub 上提交 bug。您可以使用 Bazelisk 对问题提交进行二元分割，并将此信息包含在 bug 报告中。

例如，如果您的构建使用 Bazel 6.1.0 成功，但在第二个候选版本 6.2.0 上构建失败，您可以通过

bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar

您可以设置 BAZELISK_SHUTDOWN 或 BAZELISK_CLEAN 环境变量，以运行相应的 bazel 命令，以便在需要重现问题时重置 build 状态。如需了解详情，请参阅有关 Bazelisk bisect 功能的文档。

请务必将 Bazelisk 升级到最新版本，以使用 bisect 功能。

规则兼容性

如果您是规则编写者并希望保持与不同 Bazel 版本的兼容性，请查看规则兼容性页面。