リリースのバージョニング

Bazel 4.0 以降では、長期サポート(LTS)リリースとローリング リリースの 2 つのリリース トラックがサポートされています。このページでは、Bazel のバージョニング、リリースの種類、Bazel ユーザーとコントリビューターにとっての各リリースのメリットについて説明します。

Bazel でのバージョニングについて

Bazel は、major.minor.patch セマンティック バージョニング スキームを使用します。

  • メジャー リリースには、以前のリリースと下位互換性のない機能が含まれています。
  • マイナー リリースには、新しい下位互換性のある機能が含まれています。
  • パッチリリースには、マイナーな変更とバグ修正が含まれています。

バージョン 3.5.1 を例にとると、各タイプの新しいリリースは、次のバージョン番号になります。

  • メジャー: 4.0
  • マイナー: 3.6
  • パッチ: 3.5.2

Bazel のリリース サイクル

Bazel はローリング リリースを継続的に公開します。すべてのメジャー バージョンは LTS リリースです。リリース サイクルに沿って、1 つの LTS リリースから次のリリースへ更新するか、各マイナー バージョン リリースで更新するかを選択できます。

このイメージは、ローリング リリースと LTS リリースの両方と、それぞれに想定されるサポートを示しています。

ロードマップ

図 1. ローリング リリースと LTS リリース。

リリース ブランチ

各メジャー バージョンは、リリース時に個別の開発ブランチになります。Bazel リリースに最初に更新しなくても、そのブランチの重大なバグに対する修正を受け取ることができます。メジャー バージョン ブランチの追加機能はマイナー リリースになり、ブランチの最も高いバージョンがサポート対象バージョンになります。

Bazel リリースは、連携して機能する推奨ルール バージョンのリストと組み合わされ、各ブランチ内では厳格な下位互換性があります。

LTS リリース

LTS リリースは、リリース後 3 年間サポートされるメジャー バージョン(4.0 など)です。メジャー バージョンは約 9 か月ごとにリリースされます。

リリース ブランチでの開発が進行中である場合、マイナー バージョンが作成されます。

プロジェクトをメジャー リリースに固定し、ご都合のよいときに新しいバージョンに更新できます。これにより、今後の変更をプレビューし、事前に調整できます。

ローリング リリース

ローリング リリースは、Bazel のメインブランチから定期的に切り取られます。このリリース サイクルでは、Google の内部 Blaze リリースと同期して、Bazel の次のメジャー バージョンのプレビュー リリースを継続的に提供します。

新しいローリング リリースには、以前のリリースと互換性のない互換性を破る変更が含まれる場合があります。

ローリング リリースは、Bazel CI 上の Bazel テストスイートと Google の内部テストスイートでテストされます。互換性のないフラグを使用すると、新しい機能への移行の負担を軽減できますが、デフォルトの動作はローリング リリースで変更される可能性があります。(ローリング リリースを使用して次の LTS バージョンをプレビューすることもできます。たとえば、5.0.0-pre.20210604.6 は 2021 年 6 月 4 日のカット候補に基づいており、5.0 LTS リリースに向けたマイルストーンを表します)。

最新のローリング リリースは GitHub からダウンロードできます。または、特定のバージョン名または最新のローリング リリースを使用する「ローリング」識別子を使用するように Bazelisk v1.9.0 以降を設定することもできます。詳細については、Bazelisk のドキュメントをご覧ください。

バージョンの更新

  • Bazel バージョンの更新の詳細については、Bazel の更新をご覧ください。
  • 新しい Bazel リリースへのアップデートに貢献する方法については、Bazel への貢献をご覧ください。