Như đã thông báo trong blog ban đầu bài đăng, Bazel Các phiên bản 4.0 trở lên hỗ trợ 2 kênh phát hành: cập nhật cho phiên bản mới và bản phát hành hỗ trợ dài hạn (LTS). Trang này trình bày thông tin mới nhất thông tin về mô hình phát hành của Bazel.
Tạo phiên bản phát hành
Bazel sử dụng lược đồ Định nghĩa phiên bản ngữ nghĩa major.minor.patch.
- Bản phát hành chính chứa các tính năng không tương thích ngược với bản phát hành trước. Mỗi phiên bản Bazel chính là một bản phát hành LTS.
- Bản phát hành nhỏ chứa các bản sửa lỗi và tính năng tương thích ngược được điều chỉnh cho phù hợp từ nhánh chính.
- Bản phát hành bản vá chứa các bản sửa lỗi quan trọng.
Ngoài ra, các phiên bản phát hành trước được biểu thị bằng cách thêm dấu gạch nối và hậu tố ngày vào số phiên bản chính tiếp theo.
Ví dụ: một bản phát hành mới của mỗi loại sẽ dẫn đến các số phiên bản sau:
- Chính: 6.0.0
- Nhỏ: 6.1.0
- Bản vá: 6.1.2
- Bản phát hành trước: 7.0.0-pre.20230502.1
Các giai đoạn hỗ trợ
Mỗi phiên bản Bazel chính, có 4 giai đoạn hỗ trợ:
- Rolling: Nhóm Bazel, phiên bản chính này vẫn đang ở giai đoạn phát hành trước phát hành các bản phát hành cuốn hút từ HEAD.
- Đang hoạt động: Phiên bản chính này là bản phát hành LTS (hỗ trợ dài hạn) hiện đang hoạt động. Quần đảo Bazel điều chỉnh cho phiên bản cũ các tính năng quan trọng và bản sửa lỗi vào các bản phát hành nhỏ.
- Bảo trì: Phiên bản chính này là một bản phát hành LTS cũ ở chế độ bảo trì. Nhóm Bazel chỉ hứa hẹn sẽ điều chỉnh các bản sửa lỗi nghiêm trọng cho các vấn đề về bảo mật và khả năng tương thích với hệ điều hành vào bản phát hành LTS này.
- Không dùng nữa: Nhóm Bazel không còn hỗ trợ phiên bản chính này nữa, tất cả người dùng nên chuyển sang các bản phát hành Bazel LTS mới hơn.
Nhịp độ phát hành
Bazel thường xuyên phát hành các bản phát hành cho hai kênh phát hành.
Bản phát hành chính thức
- Các bản phát hành được sắp xếp được phối hợp với bản phát hành Google Blaze và được phát hành từ HEAD khoảng hai tuần một lần. Đây là bản xem trước của LTS Bazel tiếp theo bản phát hành.
- Bản phát hành đang chạy có thể gửi những thay đổi không tương thích. Cờ không tương thích: được đề xuất cho những thay đổi lớn có thể gây lỗi, triển khai các thay đổi không tương thích cần tuân theo khả năng tương thích ngược .
Bản phát hành LTS
- Bản phát hành chính: Bản phát hành LTS mới dự kiến sẽ bị cắt bớt khỏi HEAD khoảng mỗi 12 tháng. Sau khi ra mắt bản phát hành LTS mới, bản phát hành đó sẽ ngay lập tức chuyển sang trạng thái Đang hoạt động và bản phát hành LTS trước đó sẽ chuyển sang giai đoạn Bảo trì.
- Bản phát hành nhỏ: Dự kiến sẽ phát hành phiên bản nhỏ mới trên kênh LTS đang hoạt động mỗi 2 tháng một lần.
- Bản phát hành bản vá: Các phiên bản bản vá mới cho bản phát hành LTS ở trạng thái Đang hoạt động và Chúng tôi dự kiến sẽ phát hành các giai đoạn bảo trì theo yêu cầu đối với những lỗi nghiêm trọng bản sửa lỗi.
- Bản phát hành LTS của Bazel sẽ chuyển sang giai đoạn Ngừng sử dụng sau khi ở giai đoạn Bảo trì trong 2 năm.
Đối với các bản phát hành theo kế hoạch, vui lòng kiểm tra các vấn đề về bản phát hành trên GitHub.
Ma trận hỗ trợ
| Bản phát hành LTS | Giai đoạn hỗ trợ | Phiên bản mới nhất | Ngừng hỗ trợ |
|---|---|---|---|
| Bazel 7 | Tuyển sinh không có kỳ hạn | Kiểm tra trang phát hành GitHub | Không áp dụng |
| Bazel 6 | Đang hoạt động | 6.4.0 | Tháng 12 năm 2025 |
| Bazel 5 | Đang bảo trì | 5.4.1 | Tháng 1 năm 2025 |
| Bazel 4 | Đang bảo trì | 4.2.4 | Tháng 1 năm 2024 |
Bạn có thể tìm thấy mọi bản phát hành của Bazel trên bản phát hành trên GitHub.
Quy trình phát hành và chính sách
Đối với phiên bản phát hành luân phiên, quy trình rất đơn giản: cứ khoảng hai tuần một lần, bản phát hành mới được tạo, phù hợp với cùng một đường cơ sở như Bản phát hành linh hoạt. Do lịch phát hành nhanh chóng, chúng tôi không điều chỉnh ngược bất kỳ thay đổi nào cho các bản phát hành lăn.
Đối với bản phát hành LTS, quy trình và chính sách dưới đây được tuân thủ:
- Xác định cam kết cơ sở cho bản phát hành.
- Đối với một bản phát hành LTS lớn mới, lệnh xác nhận cơ sở là phần đầu của nhánh.
- Đối với một bản phát hành nhỏ hoặc bản vá, cam kết cơ sở là TIÊU ĐỀ của phiên bản mới nhất hiện tại của cùng một bản phát hành LTS (hỗ trợ dài hạn).
- Tạo một nhánh phát hành mang tên
release-<version>từ đường cơ sở cam kết. - Điều chỉnh các thay đổi cho các phiên bản cũ thông qua yêu cầu phát hành (PR) cho nhánh phát hành.
- Cộng đồng có thể đề xuất một số cam kết để điều chỉnh cho phiên bản cũ bằng cách trả lời
"
@bazel-io flag" về các vấn đề hoặc PR có liên quan trên GitHub để đánh dấu là tiềm năng trình chặn phát hành, nhóm Bazel phân loại chúng và quyết định xem điều chỉnh cho phiên bản cũ các cam kết. - Chỉ những cam kết có khả năng tương thích ngược trên nhánh main mới có thể được điều chỉnh cho phiên bản cũ, Có thể chấp nhận các thay đổi nhỏ bổ sung để giải quyết xung đột hợp nhất.
- Cộng đồng có thể đề xuất một số cam kết để điều chỉnh cho phiên bản cũ bằng cách trả lời
"
- Xác định các yếu tố chặn bản phát hành và khắc phục các vấn đề phát hiện được trên nhánh phát hành.
- Nhánh phát hành được kiểm thử bằng cùng một bộ kiểm thử trong postsubmit và quy trình kiểm thử hạ nguồn trên Bazel CI. Nhóm Bazel theo dõi kết quả kiểm thử của nhánh phát hành và khắc phục mọi lỗi hồi quy phát hiện được.
- Tạo một bản phát hành đề xuất mới từ nhánh phát hành khi tất cả các trình chặn bản phát hành đã biết đều được giải quyết.
- Bản phát hành dùng thử được công bố trên bazel-discuss, nhóm Bazel theo dõi các báo cáo lỗi của cộng đồng cho bản phát hành dùng thử.
- Nếu phát hiện thấy trình chặn phát hành mới, hãy quay lại bước cuối cùng và tạo một bản phát hành dùng thử mới sau khi giải quyết xong tất cả vấn đề.
- Không cho phép thêm tính năng mới vào nhánh phát hành sau bản phát hành đầu tiên được tạo.
- Chuyển bản phát hành dùng thử dưới dạng bản phát hành chính thức nếu không có bản phát hành nào khác
có trình chặn
- Đối với các bản phát hành của bản vá, hãy ra mắt bản phát hành ít nhất 2 ngày làm việc sau bản phát hành dùng thử cuối cùng đã hết.
- Đối với bản phát hành chính và phụ, hãy đẩy bản phát hành 2 ngày làm việc sau khi bản phát hành đề xuất gần đây nhất được phát hành, nhưng không sớm hơn một tuần sau khi bản phát hành đề xuất đầu tiên được phát hành.
- Bản phát hành chỉ được đẩy vào ngày mà ngày tiếp theo là giờ làm việc ngày.
- Bản phát hành sẽ được công bố vào thảo luận về ứng dụng tự nhiên, nhóm Bazel sẽ giám sát và xử lý các báo cáo lỗi của cộng đồng về bản phát hành.
Báo cáo số lần hồi quy
Nếu người dùng phát hiện thấy sự hồi quy trong bản phát hành Bazel mới, bản phát hành đề xuất hoặc thậm chí là Bazel tại HEAD, vui lòng gửi lỗi trên GitHub. Bạn có thể sử dụng Bazelisk sẽ chia đôi thủ phạm và đưa thông tin này vào lỗi báo cáo.
Ví dụ: nếu bản dựng của bạn thành công với Bazel 6.1.0 nhưng không thành công với phiên bản thứ hai phát hành dùng thử của 6.2.0, bạn có thể chia đôi qua
bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar
Bạn có thể đặt biến môi trường BAZELISK_SHUTDOWN hoặc BAZELISK_CLEAN để chạy các lệnh bazel tương ứng nhằm đặt lại trạng thái bản dựng nếu cần để tái hiện vấn đề. Để biết thêm thông tin, hãy xem tài liệu về Bazelisk
tính năng chia đôi.
Hãy nhớ nâng cấp Bazelisk lên phiên bản mới nhất để sử dụng tính năng chia đôi của chúng tôi.
Khả năng tương thích với quy tắc
Nếu bạn là tác giả quy tắc và muốn duy trì khả năng tương thích với nhiều phiên bản Bazel, vui lòng xem trang Khả năng tương thích với quy tắc.