Bạn có thể gọi Bazel từ tập lệnh để thực hiện bản dựng, chạy kiểm thử hoặc truy vấn biểu đồ phần phụ thuộc. Bazel được thiết kế để cho phép tạo tập lệnh hiệu quả, nhưng phần này liệt kê một số thông tin chi tiết cần lưu ý để giúp tập lệnh của bạn mạnh mẽ hơn.
Chọn cơ sở đầu ra
Tuỳ chọn --output_base kiểm soát vị trí mà quy trình Bazel sẽ ghi kết quả của bản dựng, cũng như nhiều tệp làm việc được Bazel sử dụng nội bộ, một trong số đó là khoá bảo vệ chống lại việc nhiều quy trình Bazel đồng thời thay đổi cơ sở đầu ra.
Việc chọn đúng thư mục cơ sở đầu ra cho tập lệnh của bạn phụ thuộc vào một số yếu tố. Nếu bạn cần đặt kết quả của bản dựng ở một vị trí cụ thể, thì vị trí này sẽ quyết định cơ sở đầu ra mà bạn cần sử dụng. Nếu bạn đang thực hiện lệnh gọi "chỉ đọc" đến Bazel (chẳng hạn như bazel query), thì các yếu tố khoá sẽ quan trọng hơn. Cụ thể, nếu cần chạy đồng thời nhiều thực thể của tập lệnh, bạn cần lưu ý rằng mỗi quy trình máy chủ Blaze có thể xử lý tối đa một lệnh gọi tại một thời điểm.
Tuỳ thuộc vào tình huống, có thể mỗi thực thể của tập lệnh sẽ phải đợi đến lượt hoặc bạn có thể sử dụng --output_base để chạy nhiều máy chủ Blaze và sử dụng các máy chủ đó.
Nếu sử dụng giá trị cơ sở đầu ra mặc định, bạn sẽ phải cạnh tranh để giành cùng một khoá mà các lệnh Bazel tương tác của người dùng sử dụng. Nếu người dùng đưa ra các lệnh chạy trong thời gian dài, chẳng hạn như bản dựng, thì tập lệnh của bạn sẽ phải đợi các lệnh đó hoàn tất trước khi có thể tiếp tục.
Lưu ý về chế độ máy chủ
Theo mặc định, Bazel sử dụng một quy trình máy chủ chạy trong thời gian dài để
tối ưu hoá. Khi chạy Bazel trong một tập lệnh, đừng quên gọi shutdown khi bạn hoàn tất việc sử dụng máy chủ hoặc chỉ định --max_idle_secs=5 để các máy chủ nhàn rỗi tự động tắt ngay lập tức.
Tôi sẽ nhận được mã thoát nào?
Bazel cố gắng phân biệt các lỗi do mã nguồn đang được xem xét với các lỗi bên ngoài ngăn Bazel thực thi đúng cách. Việc thực thi Bazel có thể dẫn đến các mã thoát sau:
Mã thoát chung cho tất cả các lệnh:
0– Thành công2– Lỗi dòng lệnh, cờ hiệu hoặc tổ hợp lệnh không hợp lệ hoặc biến môi trường không hợp lệ. Bạn phải sửa đổi dòng lệnh.8– Bản dựng bị gián đoạn nhưng chúng tôi đã chấm dứt bằng cách tắt có trật tự.9– Khoá máy chủ được giữ và--noblock_for_lockđã được truyền.32– Lỗi môi trường bên ngoài không có trên máy này.33– Bazel hết bộ nhớ và gặp sự cố. Bạn cần sửa đổi dòng lệnh.34– Dành cho mục đích sử dụng nội bộ của Google.35– Dành cho mục đích sử dụng nội bộ của Google.36– Vấn đề về môi trường cục bộ, nghi ngờ là vĩnh viễn.37– Ngoại lệ chưa được xử lý / Lỗi Bazel nội bộ.38– Lỗi tạm thời khi công bố kết quả lên Dịch vụ sự kiện bản dựng.39– Các blob do Bazel yêu cầu bị loại bỏ khỏi Bộ nhớ đệm từ xa.41-44– Dành cho mục đích sử dụng nội bộ của Google.45– Lỗi liên tục khi công bố kết quả lên Dịch vụ sự kiện bản dựng.47– Dành cho mục đích sử dụng nội bộ của Google.49– Dành cho mục đích sử dụng nội bộ của Google.
Mã trả về cho các lệnh bazel build, bazel test:
1– Bản dựng không thành công.3– Bản dựng OK, nhưng một số kiểm thử không thành công hoặc hết thời gian chờ.4– Bản dựng thành công nhưng không tìm thấy kiểm thử nào mặc dù đã yêu cầu kiểm thử.
Đối với bazel run:
1– Bản dựng không thành công.- Nếu bản dựng thành công nhưng quy trình con được thực thi trả về mã thoát khác 0, thì đó cũng sẽ là mã thoát của lệnh.
Đối với bazel query:
3- Thành công một phần, nhưng truy vấn gặp phải 1 hoặc nhiều lỗi trong tập hợp tệp BUILD đầu vào và do đó, kết quả của thao tác không đáng tin cậy 100%. Điều này có thể là do tuỳ chọn--keep_goingtrên dòng lệnh.7– Lệnh không thành công.
Các phiên bản Bazel trong tương lai có thể thêm mã thoát bổ sung, thay thế mã thoát lỗi chung 1 bằng một giá trị khác khác 0 có ý nghĩa cụ thể.
Tuy nhiên, tất cả các giá trị thoát khác 0 sẽ luôn tạo thành một lỗi.
Đọc tệp .bazelrc
Theo mặc định, Bazel đọc tệp .bazelrc từ thư mục không gian làm việc cơ sở
hoặc thư mục gốc của người dùng. Việc có nên làm như vậy hay không là lựa chọn của tập lệnh; nếu tập lệnh cần hoàn toàn khép kín (chẳng hạn như khi thực hiện bản dựng phát hành), bạn nên tắt tính năng đọc tệp .bazelrc bằng cách sử dụng tuỳ chọn --bazelrc=/dev/null. Nếu bạn muốn thực hiện bản dựng bằng các chế độ cài đặt ưu tiên của người dùng, thì hành vi mặc định sẽ tốt hơn.
Nhật ký lệnh
Kết quả đầu ra của Bazel cũng có trong tệp nhật ký lệnh mà bạn có thể tìm thấy bằng lệnh sau:
bazel info command_logTệp nhật ký lệnh chứa các luồng stdout và stderr xen kẽ của lệnh Bazel gần đây nhất. Xin lưu ý rằng việc chạy bazel info sẽ ghi đè nội dung của tệp này, vì sau đó, tệp này sẽ trở thành lệnh Bazel gần đây nhất.
Tuy nhiên, vị trí của tệp nhật ký lệnh sẽ không thay đổi trừ phi bạn thay đổi chế độ cài đặt của các tuỳ chọn --output_base hoặc --output_user_root.
Phân tích cú pháp đầu ra
Bạn có thể phân tích cú pháp đầu ra của Bazel khá dễ dàng cho nhiều mục đích. Hai tuỳ chọn có thể
hữu ích cho tập lệnh của bạn là --noshow_progress (ẩn thông báo tiến trình)
và --show_result n (kiểm soát việc in thông báo "bản dựng mới nhất" hay không); bạn có thể phân tích cú pháp các thông báo này để
khám phá những mục tiêu đã được tạo thành công và vị trí của các tệp đầu ra
mà chúng tạo ra. Hãy nhớ chỉ định một giá trị rất lớn cho n nếu bạn dựa vào các thông báo này.
Khắc phục sự cố về hiệu suất bằng cách lập hồ sơ
Xem phần Lập hồ sơ hiệu suất.