Trang này mô tả cách điều tra các trường hợp thiếu bộ nhớ đệm trong bối cảnh thực thi cục bộ.
Trang này giả định rằng bạn có một bản dựng và/hoặc kiểm thử đã tạo thành công trên máy và được thiết lập để sử dụng tính năng lưu vào bộ nhớ đệm từ xa, đồng thời bạn muốn đảm bảo rằng bộ nhớ đệm từ xa đang được sử dụng hiệu quả.
Để biết các mẹo về cách kiểm tra tỷ lệ truy cập bộ nhớ đệm và cách so sánh các nhật ký thực thi giữa hai lệnh gọi Bazel, hãy xem phần Gỡ lỗi lượt truy cập bộ nhớ đệm từ xa để thực thi từ xa. Mọi nội dung trình bày trong hướng dẫn đó cũng áp dụng cho việc lưu vào bộ nhớ đệm từ xa bằng thực thi. Tuy nhiên, việc thực thi cục bộ cũng đặt ra một số thách thức khác.
Kiểm tra tỷ lệ lượt truy cập vào bộ nhớ đệm
Các kết quả thành công trong bộ nhớ đệm từ xa sẽ hiện trên dòng trạng thái, tương tự như Tỷ lệ lượt truy cập trong bộ nhớ đệm có điều khiển từ xa Thực thi.
Trong kết quả tiêu chuẩn của lần chạy Bazel, bạn sẽ thấy nội dung như sau:
INFO: 7 processes: 3 remote cache hit, 4 linux-sandbox.
Điều này có nghĩa là trong số 7 hành động đã thử, 3 hành động có một lượt truy cập bộ nhớ đệm từ xa và 4 hành động không có lượt truy cập bộ nhớ đệm và được thực thi cục bộ bằng chiến lược linux-sandbox
. Số lượt truy cập vào bộ nhớ đệm cục bộ không được đưa vào bản tóm tắt này. Nếu bạn nhận được 0 quy trình (hoặc một con số thấp hơn dự kiến), hãy chạy bazel clean
, theo sau là lệnh tạo/kiểm thử.
Khắc phục sự cố về số lần truy cập vào bộ nhớ đệm
Nếu bạn không nhận được tỷ lệ lượt truy cập vào bộ nhớ đệm mà mình mong muốn, hãy làm như sau:
Đảm bảo giao tiếp thành công với điểm cuối từ xa
Để đảm bảo bản dựng của bạn kết nối thành công với bộ nhớ đệm từ xa, hãy làm theo các bước trong phần này.
Kiểm tra kết quả của bạn để xem có cảnh báo
Với tính năng thực thi từ xa, nếu không thể giao tiếp với điểm cuối từ xa thì bản dựng của bạn sẽ không thành công. Mặt khác, một bản dựng cục bộ có thể lưu vào bộ nhớ đệm sẽ không bị lỗi nếu không thể lưu vào bộ nhớ đệm. Kiểm tra kết quả của lệnh gọi Bazel để tìm các cảnh báo, chẳng hạn như dưới dạng:
WARNING: Error reading from the remote cache:
hoặc
WARNING: Error writing to the remote cache:
Theo sau các cảnh báo như vậy sẽ là thông báo lỗi nêu chi tiết về kết nối sự cố sẽ giúp bạn gỡ lỗi: ví dụ: nhập sai tên điểm cuối hoặc thông tin đăng nhập được đặt không chính xác. Tìm và khắc phục mọi lỗi như vậy. Nếu thông báo lỗi bạn thấy không cung cấp đủ thông tin, hãy thử thêm
--verbose_failures
.Làm theo các bước trong bài viết Khắc phục sự cố về lượt truy cập vào bộ nhớ đệm cho điều khiển từ xa thực thi thành đảm bảo rằng các lệnh gọi Bazel ghi vào bộ nhớ đệm có thể nhận được lượt truy cập vào bộ nhớ đệm trên cùng một máy và trên nhiều máy.
Đảm bảo các lệnh gọi Bazel đọc bộ nhớ đệm có thể nhận được lượt truy cập bộ nhớ đệm.
a. Vì các lệnh gọi Bazel đọc bộ nhớ đệm sẽ có một tập hợp dòng lệnh khác hãy chú ý thêm để đảm bảo chúng được thiết lập đúng cách để giao tiếp với bộ nhớ đệm từ xa. Đảm bảo bạn đã đặt cờ
--remote_cache
và không có cảnh báo trong kết quả.b. Đảm bảo các lệnh gọi Bazel đọc bộ nhớ đệm tạo ra các mục tiêu giống với các lệnh gọi Bazel ghi bộ nhớ đệm.
c. Làm theo các bước tương tự để đảm bảo lưu vào bộ nhớ đệm trên các máy, để đảm bảo lưu vào bộ nhớ đệm từ lệnh gọi Bazel ghi vào bộ nhớ đệm đến lệnh gọi Bazel đọc bộ nhớ đệm.