Seperti yang diumumkan dalam 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.
Matriks dukungan
| Rilis LTS | Tahap dukungan | Versi terbaru | Akhir dukungan |
|---|---|---|---|
| Bazel 8 | Berkelanjutan | Periksa halaman rilis berkelanjutan | T/A |
| Bazel 7 | Aktif | 7.2.0 | Des 2026 |
| Bazel 6 | Pemeliharaan | 6.5.0 | Des 2025 |
| Bazel 5 | Pemeliharaan | 5.4.1 | Januari 2025 |
| Bazel 4 | Tidak digunakan lagi | 4.2.4 | Januari 2024 |
Semua rilis LTS Bazel dapat ditemukan di halaman rilis di GitHub.
Pembuatan versi rilis
Bazel menggunakan skema Pembuatan Versi Semantik major.minor.patch.
- Rilis utama berisi fitur yang tidak kompatibel dengan rilis sebelumnya. Setiap versi utama Bazel adalah 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 setiap jenis akan menghasilkan nomor versi berikut:
- Besar: 6.0.0
- Kecil: 6.1.0
- Patch: 6.1.2
- Pra-rilis: 7.0.0-pre.20230502.1
Tahapan dukungan
Untuk setiap versi utama Bazel, ada empat tahap dukungan:
- Diluncurkan: Versi utama ini masih dalam pra-rilis, tim Bazel memublikasikan rilis berkelanjutan dari HEAD.
- Aktif: Versi utama ini adalah rilis LTS aktif saat ini. Tim Bazel mem-backport fitur penting dan perbaikan bug ke 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 menyediakan dukungan untuk versi utama ini. Semua pengguna harus bermigrasi ke rilis Bazel LTS yang lebih baru.
Ritme rilis
Bazel secara rutin memublikasikan rilis untuk dua jalur rilis.
Rilis berkelanjutan
- Rilis berkelanjutan dikoordinasikan dengan rilis Google Blaze dan dirilis dari HEAD sekitar setiap dua minggu. Ini adalah pratinjau dari rilis Bazel LTS berikutnya.
- Rilis berkelanjutan dapat mengirimkan perubahan yang tidak kompatibel. Flag 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 diperkirakan akan dipotong dari HEAD sekitar setiap 12 bulan. Setelah keluar, rilis LTS baru akan segera memasuki tahap Aktif, dan rilis LTS sebelumnya akan memasuki tahap Pemeliharaan.
- Rilis minor: Versi minor baru di jalur Active LTS diharapkan dirilis setiap 2 bulan sekali.
- Rilis patch: Versi patch baru untuk rilis LTS dalam tahap Aktif dan Pemeliharaan diharapkan akan dirilis secara on demand untuk perbaikan bug penting.
- Rilis LTS Bazel memasuki tahap Tidak digunakan lagi setelah berada pada tahap Pemeliharaan selama 2 tahun.
Untuk rilis terencana, lihat masalah rilis kami di GitHub.
Prosedur & kebijakan rilis
Untuk rilis berkelanjutan, prosesnya mudah: sekitar setiap dua minggu, rilis baru akan dibuat, yang 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 di bawah diikuti:
- Tentukan commit dasar 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 saat ini dari rilis LTS yang sama.
- Buat cabang rilis dengan nama
release-<version>dari commit dasar pengukuran. - Melakukan backport perubahan melalui PR ke cabang rilis.
- Komunitas dapat menyarankan commit tertentu untuk di-backport dengan membalas
"
@bazel-io flag" pada masalah GitHub atau PR yang relevan untuk menandainya sebagai potensi pemblokir rilis. Tim Bazel akan menentukan prioritasnya dan memutuskan apakah akan melakukan backport commit. - Hanya commit yang kompatibel dengan versi lama di cabang utama yang dapat di-backport. Perubahan kecil tambahan untuk menyelesaikan konflik penggabungan dapat diterima.
- Komunitas dapat menyarankan commit tertentu untuk di-backport dengan membalas
"
Perubahan backport menggunakan Masalah Permintaan Pilihan Cherry untuk pengelola Bazel.
Pengelola Bazel dapat meminta untuk memilih commit tertentu ke cabang rilis. Proses ini dimulai dengan membuat permintaan pengambilan penting di GitHub. Berikut cara melakukannya.
- Buka permintaan pengambilan keputusan
- Isi detail permintaan
- Judul: Berikan judul yang ringkas dan deskriptif untuk permintaan.
- ID Commit: Masukkan ID commit yang ingin Anda pilih. Jika ada beberapa commit, pisahkan dengan koma.
- Kategori: Tentukan kategori permintaan.
- Peninjau: Untuk beberapa pengulas, pisahkan ID GitHub mereka dengan koma.
- Tetapkan pencapaian
- Temukan bagian "Pencapaian" dan klik setelan.
- Pilih pemblokir rilis X.Y.Z yang sesuai. Tindakan ini akan memicu bot pilihan ceri untuk memproses permintaan Anda untuk cabang "release-X.Y.Z".
- Kirimkan Masalah
- Setelah semua detail diisi dan miestone ditetapkan, kirimkan masalah.
Bot pilihan utama akan memproses permintaan dan memberi tahu jika commit memenuhi syarat untuk pemilihan tradisional. Jika commit dapat dipilih, yang berarti tidak ada konflik penggabungan saat memilih commit, maka bot akan membuat permintaan pull baru. Jika permintaan pull disetujui oleh anggota tim Bazel, commit akan dipilih secara berurutan dan digabungkan ke cabang rilis. Untuk contoh visual permintaan pengambilan keputusan yang telah selesai, lihat contoh ini.
Mengidentifikasi pemblokir rilis dan memperbaiki masalah yang ditemukan di cabang rilis.
- Cabang rilis diuji dengan rangkaian pengujian yang sama di postsubmit dan pipeline pengujian downstream pada Bazel CI. Tim Bazel memantau hasil pengujian cabang rilis dan memperbaiki regresi yang ditemukan.
Buat 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 tersebut.
- 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; pilihan utama hanya terbatas pada perbaikan penting. Jika pilihan terbaik diperlukan, pemohon harus menjawab pertanyaan berikut: Mengapa perubahan ini penting, dan manfaat apa yang diberikannya? Bagaimana kemungkinan perubahan ini menyebabkan regresi?
Mengirim kandidat rilis sebagai rilis resmi jika tidak ditemukan pemblokir rilis lebih lanjut
- Untuk rilis patch, kirim rilis setidaknya dua hari kerja setelah kandidat rilis terakhir keluar.
- Untuk rilis besar dan kecil, 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 yang hari berikutnya adalah hari kerja.
- Rilis ini 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-bagi commit pelakunya dan menyertakan informasi ini dalam laporan bug.
Misalnya, jika build Anda berhasil dengan Bazel 6.1.0, tetapi gagal dengan kandidat rilis kedua 6.2.0, Anda dapat membaginya menjadi 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 bisect Bazelisk.
Ingatlah untuk mengupgrade Bazelisk ke versi terbaru agar dapat menggunakan fitur bisect.
Kompatibilitas aturan
Jika Anda adalah pembuat aturan dan ingin mempertahankan kompatibilitas dengan berbagai versi Bazel, lihat halaman Kompatibilitas Aturan.