Orijinal blog yayınında açıklandığı gibi, Bazel 4.0 ve sonraki sürümler iki sürüm kanalı için destek sağlar: sürekli sürümler ve uzun süreli destek (LTS) sürümleri. Bu sayfada, Bazel'in sürüm modeliyle ilgili en güncel bilgiler yer almaktadır.
Destek matrisi
| LTS sürümü | Destek aşaması | Son sürüm | Destek sonu |
|---|---|---|---|
| Bazel 8 | Daimi | Sürekli sürüm yayınlama sayfasını kontrol etme | Yok |
| Bazel 7 | Etkin | 7.4.1 | Aralık 2026 |
| Bazel 6 | Bakım | 6.5.0 | Aralık 2025 |
| Bazel 5 | Bakım | 5.4.1 | Ocak 2025 |
| Bazel 4 | Kullanımdan kaldırıldı | 4.2.4 | Ocak 2024 |
Tüm Bazel LTS sürümlerini GitHub'daki sürüm sayfasında bulabilirsiniz.
Sürüm oluşturma
Bazel, major.minor.patch Anlamsal Sürüm Oluşturma şemasını kullanır.
- Büyük sürümler, önceki sürümle geriye dönük uyumlu olmayan özellikler içerir. Her büyük Bazel sürümü LTS sürümüdür.
- Ara sürümler, geriye dönük uyumlu hata düzeltmeleri ve ana daldan geri bağlanan özellikleri içerir.
- Yama sürümü, kritik hata düzeltmeleri içerir.
Ayrıca, yayın öncesi sürümler, bir sonraki ana sürüm numarasına kısa çizgi ve tarih son eki eklenerek gösterilir.
Örneğin, her türün yeni bir sürümü aşağıdaki sürüm numaralarına neden olur:
- Büyük: 6.0.0
- Küçük: 6.1.0
- Yama: 6.1.2
- Lansman öncesi: 7.0.0-pre.20230502.1
Destek aşamaları
Her büyük Bazel sürümü için dört destek aşaması vardır:
- Devamlı: Bu ana sürüm hâlâ ön sürüm aşamasındadır. Bazel ekibi, HEAD'den sürekli sürümler yayınlar.
- Etkin: Bu ana sürüm, mevcut etkin LTS sürümüdür. Bazel ekibi, önemli özellikleri ve hata düzeltmelerini küçük sürümlerine geri taşır.
- Bakım: Bu ana sürüm, bakım modunda olan eski bir LTS sürümüdür. Bazel ekibi yalnızca güvenlik sorunları ve işletim sistemi uyumluluğu sorunlarına yönelik kritik hata düzeltmelerini bu LTS sürümüne geriye dönük olarak taşıyacağını taahhüt etmektedir.
- Desteği sonlandırıldı: Bazel ekibi artık bu büyük sürüm için destek sağlamıyor. Tüm kullanıcıların yeni Bazel LTS sürümlerine geçmesi gerekiyor.
Sürüm yayınlama sıklığı
Bazel, iki sürüm kanalı için düzenli olarak sürüm yayınlar.
Devamlı sürümler
- Devamlı sürümler, Google Blaze sürümüyle koordine edilir ve yaklaşık iki haftada bir HEAD'den yayınlanır. Bu, bir sonraki Bazel LTS sürümünün önizlemesidir.
- Devamlı sürümler, uyumsuz değişiklikler içerebilir. Önemli ve önemli değişiklikler için uyumsuz işaretler önerilir. Uyumsuz değişikliklerin kullanıma sunulması geri uyumluluk politikamıza uygun olmalıdır.
LTS sürümleri
- Büyük sürüm: Yeni bir LTS sürümünün, HEAD'den yaklaşık 12 ayda bir çıkarılması bekleniyor. Yeni bir LTS sürümü kullanıma sunulduğunda hemen Etkin aşamaya girer ve önceki LTS sürümü Bakım aşamasına girer.
- Küçük sürüm: Etkin LTS kanalında yeni küçük sürümlerin 2 ayda bir yayınlanması beklenir.
- Yama sürümü: Etkin ve Bakım aşamalarındaki LTS sürümleri için kritik hata düzeltmeleriyle ilgili yeni yama sürümlerinin isteğe bağlı olarak yayınlanması beklenir.
- Bazel LTS sürümü, 2 yıl boyunca Bakım aşamasında kaldıktan sonra Desteği sonlandırılan aşamaya girer.
Planlanan sürümler için lütfen GitHub'daki sürüm sorunlarını inceleyin.
Yayınlama prosedürü ve politikaları
Devamlı sürümler için süreç basittir: Yaklaşık iki haftada bir, Google'ın dahili Blaze sürümüyle aynı temele uygun yeni bir sürüm oluşturulur. Hızlı sürüm planı nedeniyle, değişiklikleri kademeli sürümlere geriye dönük olarak aktarmayız.
LTS sürümlerinde aşağıdaki prosedür ve politikalar uygulanır:
- Sürüm için bir referans değer gönderimi belirleyin.
- Yeni bir ana LTS sürümü için ana dalın HEAD'i temel taahhüttür.
- Küçük veya yama sürümlerinde ana hat taahhüt, aynı LTS sürümünün mevcut en son sürümünün HEAD'idir.
- Temel hatalı taahhütten
release-<version>adlı bir sürüm dalı oluşturun. - Değişiklikleri, yayın dalına PR'ler aracılığıyla geri taşıyın.
- Topluluk, ilgili GitHub sorunlarına veya PR'lere "
@bazel-io flag" yanıtı vererek belirli taahhütlerin geri bağlanmasını önerebilir. Bu öneriler, potansiyel sürüm engelleyici olarak işaretlenir. Bazel ekibi, bu önerileri önceliklendirir ve taahhütlerin geri bağlanıp bağlanmayacağına karar verir. - Yalnızca ana daldaki geriye dönük uyumlu taahhütler geriye aktarılabilir. Birleştirme çakışmalarını çözmek için yapılan küçük ek değişiklikler kabul edilir.
- Topluluk, ilgili GitHub sorunlarına veya PR'lere "
Bazel bakım ekibi için Cherry-Pick Request Issue'ı kullanarak değişiklikleri geriye dönük olarak taşıyın.
Bazel bakımcıları, belirli taahhütleri bir sürüm dalına ekleme isteğinde bulunabilir. Bu işlem, GitHub'da bir seç-al isteği oluşturularak başlatılır. Bunu nasıl yapacağınız aşağıda açıklanmıştır.
- Seçili öğeleri alma isteğini açın.
- İstek ayrıntılarını doldurun
- Başlık: İstek için kısa ve açıklayıcı bir başlık girin.
- Commit kimlikleri: Seçmek istediğiniz commit'lerin kimliklerini girin. Birden fazla taahhüt varsa bunları virgülle ayırın.
- Kategori: İsteğin kategorisini belirtin.
- Yorumcular: Birden fazla yorumcu varsa GitHub kimliklerini virgülle ayırın.
- Ara hedefi ayarlama
- "Önemli aşama" bölümünü bulup ayarı tıklayın.
- Uygun X.Y.Z sürüm engelleyicilerini seçin. Bu işlem, "release-X.Y.Z" şubesi için isteğinizi işlemesi amacıyla cherry-pick bot'unu tetikler.
- Sorunu gönderme
- Tüm ayrıntılar doldurulduktan ve yer işareti ayarlandıktan sonra sorunu gönderin.
Seçmeli alma botu isteği işler ve taahhütlerin seçmeli alma işlemine uygun olup olmadığını bildirir. Taahhütler seç-al yapılabiliyorsa (yani taahhüt seçerken birleştirme çakışması yoksa) bot yeni bir çekme isteği oluşturur. Alma isteği Bazel ekibinin bir üyesi tarafından onaylandığında, taahhütler özenle seçilir ve sürüm dalıyla birleştirilir. Tamamlanmış bir seç-al isteğiyle ilgili görsel bir örnek için bu örneğe bakın.
Sürüm yayınlamayı engelleyen sorunları tespit edin ve sürüm dalında bulunan sorunları düzeltin.
- Sürüm dalı, Bazel CI'de postsubmit ve aşağı akış test ardışık düzeninde aynı test paketiyle test edilir. Bazel ekibi, sürüm dalının test sonuçlarını izler ve bulunan tüm gerileme sorunlarını düzeltir.
Bilinen tüm sürüm engelleyicileri çözüldüğünde sürüm dalından yeni bir sürüm adayı oluşturun.
- Sürüm adayı bazel-discuss'ta duyurulur. Bazel ekibi, aday için topluluktaki hata raporlarını izler.
- Yeni sürüm yayınlamayı engelleyen öğeler tespit edilirse son adıma geri dönün ve tüm sorunları çözdükten sonra yeni bir sürüm adayı oluşturun.
- İlk sürüm adayı oluşturulduktan sonra sürüm dalına yeni özelliklerin eklenmesine izin verilmez. Seçim yaparken yalnızca kritik düzeltmeler dikkate alınır. Belirli bir veri kümesini seçmek gerekiyorsa istek sahibi aşağıdaki soruları yanıtlamalıdır: Bu değişiklik neden kritik ve ne gibi avantajlar sağlıyor? Bu değişikliğin gerileme oluşturma olasılığı nedir?
Başka yayın engelleyicisi bulunmazsa sürüm adayını resmi sürüm olarak yayınlama
- Yama sürümleri için, son sürüm adayı yayınlandıktan en az iki iş günü sonra sürümü yayınlayın.
- Büyük ve küçük sürümler için sürümü, son sürüm adayı yayınlandıktan iki iş günü sonra yayınlayın ancak ilk sürüm adayı yayınlandıktan bir haftadan önce yayınlamayın.
- Sürüm yalnızca bir sonraki günün iş günü olduğu bir günde yayınlanır.
- Sürüm bazel-discuss'te duyurulur. Bazel ekibi, yeni sürümle ilgili topluluktaki hata raporlarını izler ve ele alır.
Geriye gidişleri bildirme
Kullanıcılar yeni bir Bazel sürümünde, sürüm adayında veya hatta HEAD'deki Bazel'de gerileme bulursa lütfen GitHub'da hata kaydı oluşturun. Sorunlu commit'i ikiye bölmek ve bu bilgileri hata raporuna eklemek için Bazelisk'i kullanabilirsiniz.
Örneğin, derlemeniz Bazel 6.1.0 ile başarılı olur ancak 6.2.0'ın ikinci sürüm adayı ile başarısız olursa
bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar
Sorunu yeniden oluşturmak için gerekirse BAZELISK_SHUTDOWN veya BAZELISK_CLEAN ortam değişkenini, ilgili bazel komutlarını çalıştıracak şekilde ayarlayarak derleme durumunu sıfırlayabilirsiniz. Daha fazla bilgi için Bazelisk bisect özelliği ile ilgili dokümanlara göz atın.
Bölme özelliğini kullanmak için Bazelisk'i en son sürüme yükseltmeyi unutmayın.
Kural uyumluluğu
Kural yazarıysanız ve farklı Bazel sürümleriyle uyumluluğu korumak istiyorsanız lütfen Kural Uyumluluğu sayfasına göz atın.