Công cụ và luồng làm việc cốt lõi trong phát hành phiên bản Homebrew

Homebrew cung cấp một hệ sinh thái công cụ đầy đủ để quản lý quy trình phát hành phần mềm hiệu quả trên macOS và Linux. Trong đó, hai thành phần chính là lệnh brew bump-formula-pr và hệ thống kiểm thử tự động BrewTestBot.

Quy trình phát hành cơ bản

1. Cập nhật phiên bản: Sử dụng lệnh bump-formula-pr để tự động nâng cấp số phiên bản và mã băm xác minh.
2. Kiểm tra tự động: Hệ thống BrewTestBot tiến hành xây dựng và kiểm thử trên nhiều nền tảng.
3. Duyệt thủ công: Người bảo trì xem xét các thay đổi trước khi chấp thuận tích hợp.
4. Phát hành tự động: Sau khi được duyệt, phiên bản mới sẽ được tích hợp và phân phối dưới dạng gói nhị phân.

Sử dụng lệnh brew bump-formula-pr để cập nhật phiên bản

Lệnh này giúp tự động hóa quá trình nâng cấp phiên bản phần mềm trong công thức Homebrew.

Cú pháp cơ bản

brew bump-formula-pr --version=1.2.3 tên-công-thức

Lệnh này thực hiện các bước sau:

• Thay đổi số phiên bản trong file công thức.
• Tải xuống mã nguồn phiên bản mới và tính toán SHA256 checksum.
• Tạo nhánh Git chứa các thay đổi.
• Gửi commit lên kho lưu trữ GitHub.
• Mở yêu cầu kéo (pull request) mới.

Tùy chọn nâng cao

• --no-audit: Bỏ qua bước kiểm tra cục bộ (không khuyến nghị).
• --force: Buộc cập nhật ngay cả khi không có sự thay đổi rõ ràng về phiên bản.
• --message: Thêm thông điệp tùy chỉnh cho commit.

Thông tin chi tiết về cú pháp có thể tìm thấy tại tài liệu hướng dẫn chính thức của Homebrew.

BrewTestBot – Trung tâm kiểm thử và phát hành tự động

BrewTestBot là hệ thống CI/CD tích hợp sẵn của Homebrew, đảm nhiệm việc kiểm tra độ ổn định và tương thích của phiên bản mới.

Luồng xử lý của BrewTestBot

1. Kích hoạt tự động: Khi có pull request mới, hệ thống bắt đầu chạy kiểm thử.
2. Kiểm tra đa nền tảng: Xây dựng và thử nghiệm trên Linux và các phiên bản macOS khác nhau.
3. Báo cáo kết quả: Hiển thị trạng thái thành công hoặc thất bại sau khi hoàn tất.

Xử lý lỗi phổ biến

Khi gặp lỗi, BrewTestBot hiển thị thông báo chi tiết giúp người dùng khắc phục:

• Lỗi biên dịch: Cần điều chỉnh tùy chọn build hoặc cập nhật phụ thuộc.
• Test case thất bại: Phiên bản mới có thể không tương thích với test hiện tại.
• Vấn đề phụ thuộc: Một số thư viện liên quan cần được nâng cấp đồng thời.

Hướng dẫn khắc phục chi tiết có thể tham khảo trong tài liệu BrewTestBot.md.

Thực hành tốt nhất trong phát hành phiên bản

Quản lý phiên bản theo chuẩn SemVer

Homebrew khuyến khích áp dụng quy tắc phiên bản ngữ nghĩa:

• Major: Thay đổi API không tương thích ngược.
• Minor: Tính năng mới nhưng vẫn giữ khả năng tương thích.
• Patch: Sửa lỗi mà không ảnh hưởng đến chức năng chung.

Kiểm tra phiên bản tự động

Hệ thống Autobump theo dõi phiên bản mới từ upstream và tạo PR nếu phù hợp. Cấu hình chi tiết nằm trong Autobump.md.

Danh sách kiểm tra trước khi phát hành

• Xác nhận các thay đổi lớn từ bản release note gốc.
• Kiểm tra khả năng build và chạy cục bộ.
• Rà soát danh sách phụ thuộc cần cập nhật.
• Đảm bảo test cases đã bao phủ đầy đủ chức năng chính.

Hướng dẫn cho người bảo trì: Quản lý tích hợp và phát hành

Điều kiện tích hợp tự động

Một pull request sẽ được tích hợp tự động nếu:

• Tất cả kiểm thử đều vượt qua.
• Có ít nhất một người bảo trì phê duyệt.
• Không tồn tại conflict và tuân thủ guideline đóng góp.

Quy trình phát hành thủ công

Trường hợp đặc biệt như thêm công thức mới hoặc thay đổi phức tạp, người bảo trì sử dụng lệnh:

brew pr-publish <số_PR>

Tài liệu hướng dẫn chi tiết dành riêng cho người bảo trì có tại Maintainer-Guide.md.