Tối ưu hoá bộ nhớ

Trang này mô tả cách giới hạn và giảm bộ nhớ mà Bazel sử dụng.

Chạy Bazel với RAM hạn chế

Trong một số trường hợp, bạn có thể muốn Bazel sử dụng bộ nhớ tối thiểu. Bạn có thể đặt vùng nhớ khối xếp tối đa thông qua cờ khởi động --host_jvm_args, chẳng hạn như --host_jvm_args=-Xmx2g.

Đánh đổi tốc độ xây dựng gia tăng để lấy bộ nhớ

Nếu bản dựng quá lớn, Bazel có thể đưa ra OutOfMemoryError (OOM) khi không có đủ bộ nhớ. Bạn có thể khiến Bazel sử dụng ít bộ nhớ hơn (với chi phí là bản dựng gia tăng chậm hơn) bằng cách truyền các cờ lệnh sau: --discard_analysis_cache, --nokeep_state_after_build, và --notrack_incremental_state.

Các cờ này sẽ giảm thiểu bộ nhớ mà Bazel sử dụng trong bản dựng, với chi phí là khiến các bản dựng trong tương lai chậm hơn so với bản dựng gia tăng tiêu chuẩn.

Bạn cũng có thể truyền riêng từng cờ trong số này:

• --discard_analysis_cache sẽ giảm bộ nhớ được sử dụng trong quá trình thực thi (không phải phân tích). Bản dựng gia tăng sẽ không phải thực hiện lại quá trình tải gói, nhưng sẽ phải thực hiện lại quá trình phân tích và thực thi (mặc dù bộ nhớ đệm hành động trên đĩa có thể ngăn chặn hầu hết quá trình thực thi lại).
• --notrack_incremental_state sẽ không lưu trữ bất kỳ cạnh nào trong biểu đồ phần phụ thuộc nội bộ của Bazel, do đó, không thể sử dụng cho bản dựng gia tăng. Bản dựng tiếp theo sẽ loại bỏ dữ liệu đó, nhưng dữ liệu đó sẽ được giữ lại cho đến thời điểm đó để gỡ lỗi nội bộ, trừ phi bạn chỉ định --nokeep_state_after_build.
• --nokeep_state_after_build sẽ loại bỏ tất cả dữ liệu sau bản dựng, để bản dựng gia tăng phải xây dựng từ đầu (ngoại trừ bộ nhớ đệm hành động trên đĩa). Riêng cờ này không ảnh hưởng đến dấu hiệu mức cao của bản dựng hiện tại.

Đánh đổi tính linh hoạt của bản dựng để lấy bộ nhớ bằng Skyfocus (Thử nghiệm)

Nếu muốn Bazel sử dụng ít bộ nhớ hơn và giữ lại tốc độ xây dựng gia tăng, bạn có thể cho Bazel biết tập hợp tệp đang hoạt động mà bạn sẽ sửa đổi. Bazel sẽ chỉ giữ lại trạng thái cần thiết để xây dựng lại các thay đổi đối với các tệp đó một cách chính xác. Tính năng này được gọi là Skyfocus.

Để sử dụng Skyfocus, hãy truyền cờ --experimental_enable_skyfocus:

bazel build //pkg:target --experimental_enable_skyfocus

Theo mặc định, tập hợp đang hoạt động sẽ là tập hợp tệp bên cạnh mục tiêu đang được xây dựng. Trong ví dụ này, tất cả các tệp trong //pkg sẽ được giữ trong tập hợp đang hoạt động và các thay đổi đối với các tệp bên ngoài tập hợp đang hoạt động sẽ không được phép cho đến khi bạn phát hành bazel clean hoặc khởi động lại máy chủ Bazel.

Nếu bạn muốn chỉ định một tập hợp tệp hoặc thư mục chính xác, hãy sử dụng cờ --experimental_working_set, như sau:

bazel build //pkg:target --experimental_enable_skyfocus
--experimental_working_set=path/to/another/dir,path/to/tests/dir

Bạn cũng có thể truyền --experimental_skyfocus_dump_post_gc_stats để hiển thị số lượng giảm bộ nhớ:

Khi kết hợp tất cả, bạn sẽ thấy như sau:

$ bazel test //pkg:target //tests/... --experimental_enable_skyfocus --experimental_working_set dir1,dir2,dir3/subdir --experimental_skyfocus_dump_post_gc_stats
INFO: --experimental_enable_skyfocus is enabled. Blaze will reclaim memory not needed to build the working set. Run 'blaze dump --skyframe=working_set' to show the working set, after this command.
WARNING: Changes outside of the working set will cause a build error.
INFO: Analyzed 149 targets (4533 packages loaded, 169438 targets configured).
INFO: Found 25 targets and 124 test targets...
INFO: Updated working set successfully.
INFO: Focusing on 334 roots, 3 leafs... (use --experimental_skyfocus_dump_keys to show them)
INFO: Heap: 1237MB -> 676MB (-45.31%)
INFO: Elapsed time: 192.670s ...
INFO: Build completed successfully, 62303 total actions

Trong ví dụ này, việc sử dụng Skyfocus cho phép Bazel giảm 561 MB (45%) bộ nhớ và các bản dựng gia tăng để xử lý các thay đổi đối với các tệp trong dir1, dir2 và dir3/subdir sẽ giữ lại tốc độ nhanh, với sự đánh đổi là Bazel không thể xây dựng lại các tệp đã thay đổi bên ngoài các thư mục này.

Phân tích bộ nhớ

Bazel đi kèm với một trình phân tích bộ nhớ tích hợp có thể giúp bạn kiểm tra mức sử dụng bộ nhớ của quy tắc. Đọc thêm về quy trình này trên phần Phân tích bộ nhớ của tài liệu về cách cải thiện hiệu suất của các quy tắc tuỳ chỉnh.