Tìm hành vi không nghiêm ngặt trong quy tắc WORKSPACE

Báo cáo vấn đề Xem nguồn Nightly/3}

Trong ví dụ sau, máy chủ lưu trữ là máy mà Bazel chạy.

Khi sử dụng tính năng thực thi từ xa, các bước xây dựng và/hoặc kiểm thử thực tế sẽ không diễn ra trên máy chủ lưu trữ mà thay vào đó sẽ được gửi đến hệ thống thực thi từ xa. Tuy nhiên, các bước liên quan đến việc giải quyết quy tắc không gian làm việc đang diễn ra trên máy chủ. Nếu các quy tắc không gian làm việc của bạn truy cập vào thông tin về máy chủ để sử dụng trong quá trình thực thi, thì bản dựng của bạn có thể bị lỗi do không tương thích giữa các môi trường.

Trong quá trình điều chỉnh các quy tắc Bazel để thực thi từ xa, bạn cần tìm và khắc phục các quy tắc không gian làm việc đó. Trang này mô tả cách tìm các quy tắc không gian làm việc có thể có vấn đề bằng cách sử dụng nhật ký không gian làm việc.

Tìm quy tắc không khép kín

Các quy tắc không gian làm việc cho phép nhà phát triển thêm các phần phụ thuộc vào không gian làm việc bên ngoài. Tuy nhiên, các quy tắc này đủ phong phú để cho phép quy trình xử lý tuỳ ý diễn ra trong quy trình. Tất cả các lệnh liên quan đều diễn ra cục bộ và có thể là nguồn tiềm ẩn tính không liền mạch. Thông thường, hành vi không liền mạch được giới thiệu thông qua repository_ctx, cho phép tương tác với máy chủ.

Kể từ Bazel 0.18, bạn có thể nhận nhật ký về một số thao tác có thể không kín bằng cách thêm cờ --experimental_workspace_rules_log_file=[PATH] vào lệnh Bazel. Ở đây [PATH] là tên tệp mà trong đó nhật ký sẽ được tạo.

Những điều cần lưu ý:

  • nhật ký sẽ ghi lại các sự kiện khi chúng được thực thi. Nếu một số bước được lưu vào bộ nhớ đệm, các bước đó sẽ không xuất hiện trong nhật ký, vì vậy, để nhận được kết quả đầy đủ, bạn đừng quên chạy trước bazel clean --expunge.

  • Đôi khi, các hàm có thể được thực thi lại. Trong trường hợp đó, các sự kiện liên quan sẽ xuất hiện trong nhật ký nhiều lần.

  • Các quy tắc của Workspace hiện chỉ ghi lại các sự kiện Starlark.

Cách tìm nội dung được thực thi trong quá trình khởi chạy không gian làm việc:

  1. Chạy bazel clean --expunge. Lệnh này sẽ xoá sạch bộ nhớ đệm cục bộ và mọi kho lưu trữ được lưu vào bộ nhớ đệm, đảm bảo rằng tất cả hoạt động khởi chạy sẽ được chạy lại.

  2. Thêm --experimental_workspace_rules_log_file=/tmp/workspacelog vào lệnh Bazel rồi chạy bản dựng.

    Thao tác này sẽ tạo ra một tệp proto nhị phân liệt kê các thông báo thuộc loại WorkspaceEvent

  3. Tải mã nguồn Bazel xuống rồi chuyển đến thư mục Bazel bằng cách sử dụng lệnh bên dưới. Bạn cần có mã nguồn để có thể phân tích cú pháp nhật ký không gian làm việc bằng trình phân tích cú pháp nhật ký không gian làm việc.

    git clone https://github.com/bazelbuild/bazel.git
cd bazel

  4. Trong kho lưu trữ mã nguồn Bazel, hãy chuyển đổi toàn bộ nhật ký không gian làm việc thành văn bản.

    bazel build src/tools/workspacelog:parser
bazel-bin/src/tools/workspacelog/parser --log_path=/tmp/workspacelog > /tmp/workspacelog.txt

  5. Kết quả có thể khá chi tiết và bao gồm đầu ra từ các quy tắc Bazel tích hợp.

    Để loại trừ các quy tắc cụ thể khỏi kết quả, hãy sử dụng tuỳ chọn --exclude_rule. Ví dụ:

    bazel build src/tools/workspacelog:parser
bazel-bin/src/tools/workspacelog/parser --log_path=/tmp/workspacelog \
    --exclude_rule "//external:local_config_cc" \
    --exclude_rule "//external:dep" > /tmp/workspacelog.txt

  6. Mở /tmp/workspacelog.txt và kiểm tra các hoạt động không an toàn.

Nhật ký bao gồm các thông báo WorkspaceEvent mô tả một số thao tác có thể không gián đoạn được thực hiện trên repository_ctx.

Sau đây là các thao tác được đánh dấu là có khả năng không chấm dứt:

  • execute: thực thi một lệnh tuỳ ý trên môi trường máy chủ lưu trữ. Kiểm tra xem những vấn đề này có thể tạo ra bất kỳ phần phụ thuộc nào trên môi trường máy chủ lưu trữ hay không.

  • download, download_and_extract: để đảm bảo các bản dựng khép kín, hãy nhớ chỉ định sha256

  • file, template: về bản chất đây không phải là không khép kín mà có thể là một cơ chế để đưa các phần phụ thuộc trên môi trường máy chủ vào kho lưu trữ. Hãy đảm bảo rằng bạn hiểu rõ nguồn đầu vào và việc này không phụ thuộc vào môi trường máy chủ lưu trữ.

  • os: về bản chất đây không phải là không khép kín, mà là một cách dễ dàng để nhận các phần phụ thuộc trên môi trường lưu trữ. Thường thì bản dựng khép kín sẽ không gọi thuộc tính này. Khi đánh giá xem cách sử dụng của bạn có mang tính khép kín hay không, xin lưu ý rằng thao tác này đang chạy trên máy chủ lưu trữ chứ không phải trên worker. Nhìn chung, việc nhận thông tin cụ thể về môi trường từ máy chủ lưu trữ không phải là ý tưởng hay cho các bản dựng từ xa.

  • symlink: đây thường là an toàn, nhưng hãy tìm dấu hiệu cảnh báo. Mọi đường liên kết tượng trưng đến bên ngoài kho lưu trữ hoặc đến một đường dẫn tuyệt đối đều sẽ gây ra sự cố cho worker từ xa. Nếu đường liên kết tượng trưng được tạo dựa trên các thuộc tính của máy chủ lưu trữ, thì đường liên kết đó cũng có thể gây ra vấn đề.

  • which: việc kiểm tra các chương trình được cài đặt trên máy chủ thường gặp vấn đề vì các worker có thể có nhiều cấu hình.