Model Rilis

Laporkan masalah Lihat sumber

Seperti yang diumumkan di postingan blog asli, Bazel 4.0 dan versi yang lebih tinggi memberikan dukungan untuk dua jalur rilis: rilis berkelanjutan dan rilis dukungan jangka panjang (LTS). Halaman ini membahas informasi terbaru tentang model rilis Bazel.

Pembuatan versi rilis

Bazel menggunakan skema Pembuatan Versi Semantik major.minor.patch.

• Rilis utama berisi fitur yang tidak kompatibel dengan rilis sebelumnya. Setiap versi Bazel utama merupakan rilis LTS.
• Rilis minor berisi perbaikan bug yang kompatibel dengan versi lama dan fitur yang di-backport dari cabang utama.
• Rilis patch berisi perbaikan bug penting.

Selain itu, versi pra-rilis ditunjukkan dengan menambahkan tanda hubung dan akhiran tanggal ke nomor versi utama berikutnya.

Misalnya, rilis baru dari setiap jenis akan menghasilkan nomor versi berikut:

• Utama: 6.0.0
• Kecil: 6.1.0
• Patch: 6.1.2
• Pra-rilis: 7.0.0-pre.20230502.1

Tahapan dukungan

Untuk setiap versi Bazel utama, ada empat tahap dukungan:

• Rolling: Versi utama ini masih dalam versi pra-rilis, tim Bazel memublikasikan rilis berkelanjutan dari HEAD.
• Aktif: Versi utama ini adalah rilis LTS yang aktif saat ini. Tim Bazel mem-backport fitur penting dan perbaikan bug ke dalam rilis minornya.
• Pemeliharaan: Versi utama ini adalah rilis LTS lama dalam mode pemeliharaan. Tim Bazel hanya berjanji untuk melakukan backport perbaikan bug penting untuk masalah keamanan dan masalah kompatibilitas OS ke dalam rilis LTS ini.
• Tidak digunakan lagi: Tim Bazel tidak lagi memberikan dukungan untuk versi utama ini, semua pengguna harus bermigrasi ke rilis Bazel LTS yang lebih baru.

Ritme rilis

Bazel memublikasikan rilis secara rutin untuk dua jalur rilis.

Rilis berkelanjutan

• Rilis berkelanjutan dikoordinasikan dengan rilis Google Blaze dan dirilis dari HEAD setiap dua minggu. Ini adalah pratinjau rilis Bazel LTS berikutnya.
• Rilis berkelanjutan dapat mengirimkan perubahan yang tidak kompatibel. Tanda yang tidak kompatibel direkomendasikan untuk perubahan besar yang dapat menyebabkan gangguan. Peluncuran perubahan yang tidak kompatibel harus mengikuti kebijakan kompatibilitas mundur kami.

Rilis LTS

• Rilis utama: Rilis LTS baru diharapkan untuk dipangkas dari HEAD sekitar setiap 12 bulan. Setelah rilis LTS baru keluar, rilis akan langsung memasuki tahap Aktif, dan rilis LTS sebelumnya akan memasuki tahap Pemeliharaan.
• Rilis minor: Verion minor baru pada jalur LTS Aktif diharapkan dirilis setiap 2 bulan sekali.
• Rilis patch: Versi patch baru untuk rilis LTS dalam tahap Aktif dan Pemeliharaan diperkirakan akan dirilis sesuai permintaan untuk perbaikan bug penting.
• Rilis Bazel LTS memasuki tahap Tidak digunakan lagi setelah berada dalam tahap Pemeliharaan selama 2 tahun.

Untuk rilis terencana, lihat masalah rilis kami di GitHub.

Matriks dukungan

Rilis LTS	Tahap dukungan	Versi terbaru	Akhir dukungan
Bazel 7	Berkelanjutan	Periksa halaman rilis GitHub	T/A
Bazel 6	Aktif	6.4.0	Des 2025
Roti Bazel 5	Pemeliharaan	5.4.1	Januari 2025
Bazel 4	Pemeliharaan	4.2.4	Januari 2024

Semua rilis Bazel dapat ditemukan di halaman rilis di GitHub.

Catatan: Versi Bazel yang lebih lama dari Bazel 4 tidak lagi didukung. Pengguna Bazel sebaiknya mengupgrade ke rilis LTS terbaru atau menggunakan rilis berkelanjutan jika Anda ingin mengikuti perubahan terbaru di HEAD.

Prosedur & kebijakan rilis

Untuk rilis berkelanjutan, prosesnya cukup mudah: setiap dua minggu, rilis baru akan dibuat, selaras dengan dasar pengukuran yang sama dengan rilis Blaze internal Google. Karena jadwal rilis yang cepat, kami tidak melakukan backport perubahan apa pun pada rilis berkelanjutan.

Untuk rilis LTS, prosedur dan kebijakan berikut diikuti:

1. Tentukan commit dasar pengukuran untuk rilis.
   • Untuk rilis LTS utama yang baru, commit dasar pengukuran adalah HEAD cabang utama.
   • Untuk rilis minor atau patch, commit dasar pengukuran adalah HEAD versi terbaru dari rilis LTS yang sama saat ini.
2. Buat cabang rilis dengan nama release-<version> dari commit baseline.
3. Melakukan backport perubahan melalui PR ke cabang rilis.
   • Komunitas dapat menyarankan commit tertentu untuk di-backport dengan membalas "@bazel-io flag" pada masalah GitHub yang relevan atau PR untuk menandainya sebagai pemblokir rilis yang berpotensi. Tim Bazel akan melakukan triase dan memutuskan apakah akan melakukan back-port commit.
   • Hanya commit yang kompatibel dengan versi lama di cabang utama yang dapat di-backport, perubahan kecil tambahan untuk mengatasi konflik penggabungan dapat diterima.
4. Identifikasi pemblokir rilis dan perbaiki masalah yang ditemukan di cabang rilis.
   • Cabang rilis diuji dengan rangkaian pengujian yang sama di postsubmit dan pipeline pengujian downstream di Bazel CI. Tim Bazel memantau hasil pengujian cabang rilis dan memperbaiki regresi yang ditemukan.
5. Membuat kandidat rilis baru dari cabang rilis saat semua pemblokir rilis yang diketahui telah diselesaikan.
   • Kandidat rilis diumumkan di bazel-discuss, tim Bazel memantau laporan bug komunitas untuk kandidat.
   • Jika pemblokir rilis baru teridentifikasi, kembali ke langkah terakhir dan buat kandidat rilis baru setelah menyelesaikan semua masalah.
   • Fitur baru tidak diizinkan untuk ditambahkan ke cabang rilis setelah kandidat rilis pertama dibuat.
6. Mendorong kandidat rilis sebagai rilis resmi jika tidak ada pemblokir rilis lebih lanjut yang ditemukan
   • Untuk rilis patch, kirim rilis setidaknya dua hari kerja setelah kandidat rilis terakhir keluar.
   • Untuk rilis besar dan minor, kirim rilis dua hari kerja setelah kandidat rilis terakhir keluar, tetapi tidak lebih awal dari satu minggu setelah kandidat rilis pertama keluar.
   • Rilis hanya dikirim pada hari saat hari berikutnya adalah hari kerja.
   • Rilis diumumkan di bazel-discuss, tim Bazel memantau dan menangani laporan bug komunitas untuk rilis baru.

Melaporkan regresi

Jika pengguna menemukan regresi dalam rilis Bazel baru, kandidat rilis, atau bahkan Bazel di HEAD, laporkan bug di GitHub. Anda dapat menggunakan Bazelisk untuk membagi dua commit pelaku dan menyertakan informasi ini dalam laporan bug.

Misalnya, jika build Anda berhasil menggunakan Bazel 6.1.0, tetapi gagal dengan kandidat rilis kedua 6.2.0, Anda dapat membagi dua melalui

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

Anda dapat menetapkan variabel lingkungan BAZELISK_SHUTDOWN atau BAZELISK_CLEAN untuk menjalankan perintah bazel yang sesuai guna mereset status build jika diperlukan untuk mereproduksi masalah. Untuk detail selengkapnya, lihat dokumentasi tentang fitur dua Bazelisk.

Jangan lupa mengupgrade Bazelisk ke versi terbaru untuk menggunakan fitur bisect.

Kompatibilitas aturan

Jika Anda adalah pembuat aturan dan ingin mempertahankan kompatibilitas dengan versi Bazel yang berbeda, lihat halaman Kompatibilitas Aturan.