版本模型

回報問題 查看原始碼 。 夜間 7.2 7.1 7.0 6.5 6.4

如原始網誌的公告所述 post、Bazel 4.0 以上版本支援兩種測試群組：滾動式 以及長期支援 (LTS) 版本。本頁內容涵蓋 有關 Bazel 發布模型的資訊

發布版本管理

Bazel 使用 major.minor.patch Semantic 版本管理架構。

  • 主要版本包含無法回溯相容的功能 每個主要 Bazel 版本都是 LTS 版本。
  • 次要版本包含回溯相容的錯誤修正和功能 從主要分支版本向後移植。
  • 修補程式版本包含重大錯誤修正。

此外，發行前版本後面會加上連字號和 將日期後置字串加在下一個主要版本號碼

舉例來說，每種類型的新版本都會產生下列版本號碼：

  • 主要：6.0.0
  • 未成年人：6.1.0
  • 修補程式：6.1.2
  • 預先發布版：7.0.0-pre.20230502.1

支援階段

每個主要 Bazel 版本都有四個支援階段：

  • 滾動中：這個主要版本目前仍在預先發布階段，Bazel 團隊 從 HEAD 發布滾動式版本。
  • 有效：這個主要版本是目前使用中的 LTS 版本。Bazel 團隊將重要功能和錯誤修正向後移植到其子版本。
  • 維護：這個主要版本是維護中的舊版 LTS 版本 模式。Bazel 團隊承諾僅向後移植重大錯誤修正 安全問題及 OS 相容性問題。
  • 已淘汰：Bazel 團隊不再支援這項主要資料庫。 版本，所有使用者都應遷移至較新的 Bazel LTS 版本。

發布頻率

Bazel 會定期發布兩個測試群組的版本。

滾動式版本

  • 推出作業採用與 Google Blaze 版本協調並發布 每兩週從 HEAD 起它是下一個 Bazel LTS 的預先發布版 版本。
  • 滾動式版本可能會發布不相容的變更。不相容的標記為 建議用於重大破壞性變更，以及推出不相容的變更 應用程式應遵循回溯相容性 政策。

LTS 版本

  • 主要版本：新的 LTS 版本預計將從 HEAD 版本中切斷 每 12 個月。新的 LTS 發布後，就會立即進入運作中狀態 ，且先前的 LTS 版本會進入「維護」階段。
  • 次要版本：雖然有效 LTS 測試群組會推出新的小版本 每 2 個月發布一次
  • 修補程式版本：適用於運作中及 LTS 版本的最新修補程式版本 維護階段預計依重大錯誤釋出 找出程式碼中的安全漏洞和錯誤 並提供修正建議
  • Bazel LTS 版本會在進入 維護階段達 2 年。

如需預定發布的版本，請參閱版本資訊 問題 。

支援矩陣

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 月

您可以在此版本找到所有 Bazel 版本 頁面。

發布程序與政策規定

對滾動式的版本來說，這項程序相當簡單：大約每兩週一次， 新版本的建構方式，與 Google 內部使用的基準一致 Blaze 版本。由於發布時間縮短，我們不會將任何變更向後移植 。

針對 LTS 版本，程序和政策如下：

  1. 決定版本的基準修訂版本。
    • 針對新的主要 LTS 版本，基準修訂版本是主要 LTS 的
    • 如果是次要或修補程式版本，基準修訂版本是 上一個 LTS 版本的最新版本。
  2. 從基準的 release-<version> 名稱中建立版本分支版本 修訂版本。
  3. 透過 PR 將變更向後移植到發布分支版本。
    • 社群成員可藉由回覆 「@bazel-io flag」，在相關 GitHub 問題或 PR 上標示為可能 Bazel 團隊會將這些因素分類，並決定是否 反向移植修訂版本。
    • 只有主要分支版本的回溯相容修訂版本才能向後移植， 接受額外的小幅變更來解決合併衝突。
  4. 找出發布阻礙並修正發布分支版本的問題。
    • 系統已在版本分支版本中使用相同的測試套件進行測試 postsubmit 和 下游測試管道 您在 Bazel CI 上Bazel 團隊會監控版本的測試結果 並修正任何發現的迴歸問題
  5. 如果所有已知項目都已知，則從發布分支版本建立新的候選版本 發布攔截器已獲得解決
    • 候選版公布日期： bazel-discuss Bazel 團隊會監控候選人的社群錯誤報告。
    • 如果發現新的發布阻礙，請返回最後一個步驟， 解決所有問題後，建立新的候選版。
    • 在此之後，就無法在版本分支版本中新增功能 建立第一個候選版
  6. 如果不再發布，請將候選版推送為正式版 發現障礙物
    • 如果是修補程式版本，請至少在兩個工作天後推送該版本 最後一個候選版本已過舊
    • 如果是主要版本和次要版本，請在兩個工作天後推送發布版本 最後一版候選版已過，但時間不會超過一週 第一版候選版已結束。
    • 這個版本只會推送到隔天營業的那一天 當天。
    • 版本宣布日期： bazel-discuss Bazel 團隊會監控並解決新舊版本的社群錯誤報告 版本。

回報迴歸問題

如果使用者在新的 Bazel 版本中發現迴歸，請發布候選版本， 在 HEAD 執行的 Bazel，請在 GitHub。別擔心！您可以使用 Bazelisk 能模擬錯誤修訂版本，並在錯誤檔案中加入這項資訊 報表。

舉例來說，如果 Bazel 6.1.0 建構作業執行成功，但第二個建構作業失敗 6.2.0 版的候選版，您可以透過

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

您可以設定要執行的 BAZELISK_SHUTDOWN 或 BAZELISK_CLEAN 環境變數 以便重設建構狀態 重現問題。詳情請參閱 Bazelisk 的說明文件 Bise 功能。

請記得將 Bazelisk 升級至最新版本，以便使用 Bisect 而不是每個特徵的分數

規則相容性

如果您是規則作者，且想與不同的 Bazel 版本，請查看規則 相容性網頁。