Chế độ nhà cung cấp

Chế độ nhà cung cấp là một tính năng của Bzlmod cho phép bạn tạo bản sao cục bộ của các phần phụ thuộc bên ngoài. Điều này rất hữu ích cho các bản dựng ngoại tuyến hoặc khi bạn muốn kiểm soát nguồn của một phần phụ thuộc bên ngoài.

Bật chế độ nhà cung cấp

Bạn có thể bật chế độ nhà cung cấp bằng cách chỉ định cờ --vendor_dir.

Chẳng hạn như bằng cách thêm thành phần này vào tệp .bazelrc:

# Enable vendor mode with vendor directory under <workspace>/vendor_src
common --vendor_dir=vendor_src

Thư mục nhà cung cấp có thể là một đường dẫn tương đối đến thư mục gốc của không gian làm việc hoặc một đường dẫn tuyệt đối.

Cung cấp một kho lưu trữ bên ngoài cụ thể

Bạn có thể sử dụng lệnh vendor với cờ --repo để chỉ định nhà cung cấp repo nào. Lệnh này chấp nhận cả tên kho lưu trữ chuẩn và tên kho lưu trữ hiển thị.

Ví dụ: chạy:

bazel vendor --vendor_dir=vendor_src --repo=@rules_cc

hoặc

bazel vendor --vendor_dir=vendor_src --repo=@@rules_cc~

cả hai đều sẽ nhận được rules_cc để cung cấp trong <workspace root>/vendor_src/rules_cc~.

Các phần phụ thuộc bên ngoài của nhà cung cấp cho các mục tiêu nhất định

Để cung cấp tất cả phần phụ thuộc bên ngoài cần thiết cho việc xây dựng các mẫu mục tiêu nhất định, bạn có thể chạy bazel vendor <target patterns>.

Ví dụ

bazel vendor --vendor_dir=vendor_src //src/main:hello-world //src/test/...

sẽ cung cấp tất cả kho lưu trữ cần thiết để tạo mục tiêu //src/main:hello-world và tất cả mục tiêu trong //src/test/... với cấu hình hiện tại.

Trong trường hợp này, lệnh này sẽ thực hiện lệnh bazel build --nobuild để phân tích các mẫu mục tiêu. Do đó, các cờ tạo có thể được áp dụng cho lệnh này và tác động đến kết quả.

Tạo mục tiêu khi không có mạng

Với các phần phụ thuộc bên ngoài có sẵn, bạn có thể tạo mục tiêu ngoại tuyến bằng cách

bazel build --vendor_dir=vendor_src //src/main:hello-world //src/test/...

Bản dựng phải hoạt động trong một môi trường bản dựng sạch mà không có quyền truy cập mạng và bộ nhớ đệm của kho lưu trữ.

Do đó, bạn nên kiểm tra nguồn được cung cấp và tạo các mục tiêu tương tự khi không có mạng trên một máy khác.

Nhà cung cấp tất cả phần phụ thuộc bên ngoài

Để cung cấp tất cả các kho lưu trữ trong biểu đồ phần phụ thuộc bên ngoài bắc cầu, bạn có thể chạy:

bazel vendor --vendor_dir=vendor_src

Xin lưu ý rằng việc cung cấp tất cả phần phụ thuộc có một số nhược điểm:

  • Việc tìm nạp tất cả các kho lưu trữ (bao gồm cả những kho lưu trữ được giới thiệu theo cách bắc cầu) có thể tốn thời gian.
  • Thư mục nhà cung cấp có thể trở nên rất lớn.
  • Một số kho lưu trữ có thể không tìm nạp được nếu không tương thích với nền tảng hoặc môi trường hiện tại.

Do đó, trước tiên hãy xem xét việc cung cấp dịch vụ cho các mục tiêu cụ thể.

Định cấu hình chế độ nhà cung cấp bằng Ask.bazel

Bạn có thể kiểm soát cách xử lý các kho lưu trữ nhất định bằng tệp Ask.bazel nằm trong thư mục nhà cung cấp.

Có 2 lệnh, cả 2 lệnh đều chấp nhận một danh sách tên kho lưu trữ chuẩn làm đối số:

  • ignore(): để bỏ qua hoàn toàn kho lưu trữ từ chế độ nhà cung cấp.
  • pin(): để ghim một kho lưu trữ vào nguồn được cung cấp hiện tại của nó như thể có một cờ --override_repository cho kho lưu trữ này. Bazel sẽ KHÔNG cập nhật nguồn do nhà cung cấp cung cấp cho kho lưu trữ này trong khi chạy lệnh của nhà cung cấp, trừ phi kho lưu trữ đó được bỏ ghim. Người dùng có thể sửa đổi và duy trì nguồn được cung cấp cho kho lưu trữ này theo cách thủ công.

Ví dụ

ignore("@@rules_cc~")
pin("@@bazel_skylib~")

Có cấu hình này

  • Cả hai kho lưu trữ này sẽ bị loại trừ khỏi các lệnh tiếp theo của nhà cung cấp.
  • Repo bazel_skylib sẽ bị ghi đè thành nguồn nằm trong thư mục nhà cung cấp.
  • Người dùng có thể sửa đổi nguồn do bazel_skylib cung cấp một cách an toàn.
  • Để tạo lại bazel_skylib, trước tiên, người dùng phải tắt câu lệnh pin.

Tìm hiểu cách hoạt động của chế độ nhà cung cấp

Bazel tìm nạp các phần phụ thuộc bên ngoài của một dự án trong $(bazel info output_base)/external. Việc cung cấp các phần phụ thuộc bên ngoài có nghĩa là di chuyển các tệp và thư mục liên quan sang một thư mục nhà cung cấp nhất định và sử dụng nguồn do nhà cung cấp cung cấp cho các bản dựng sau này.

Nội dung được cung cấp bao gồm:

  • Thư mục kho lưu trữ
  • Tệp đánh dấu kho lưu trữ

Trong quá trình tạo bản dựng, nếu tệp điểm đánh dấu được cung cấp đã được cập nhật hoặc kho lưu trữ được ghim trong tệp Ask.bazel, thì Bazel sẽ sử dụng nguồn được cung cấp bằng cách tạo một đường liên kết tượng trưng đến tệp đó trong $(bazel info output_base)/external thay vì thực sự chạy quy tắc kho lưu trữ. Nếu không, một cảnh báo sẽ được in và Bazel sẽ dự phòng để tìm nạp phiên bản mới nhất của kho lưu trữ.