Chế độ nhà cung cấp là một tính năng 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 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.
Ví dụ: bằng cách thêm tệp 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.
Nhà cung cấp một kho lưu trữ bên ngoài cụ thể
Bạn có thể dùng lệnh vendor với cờ --repo để chỉ định kho lưu trữ cần cung cấp, lệnh này chấp nhận cả tên kho lưu trữ chuẩn và tên kho lưu trữ rõ ràng.
Ví dụ: chạy:
bazel vendor --vendor_dir=vendor_src --repo=@rules_cc
hoặc
bazel vendor --vendor_dir=vendor_src --repo=@@rules_cc+
sẽ nhận được rules_cc để được cung cấp theo hợp đồng dưới <workspace root>/vendor_src/rules_cc+.
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ả các phần phụ thuộc bên ngoài cần thiết để tạo 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ả các kho lưu trữ cần thiết để tạo mục tiêu //src/main:hello-world và tất cả các mục tiêu trong //src/test/... bằng cấu hình hiện tại.
Về cơ bản, lệnh này thực hiện lệnh bazel build --nobuild để phân tích các mẫu mục tiêu. Do đó, bạn có thể áp dụng các cờ bản dựng cho lệnh này và ảnh hưởng đến kết quả.
Xây dựng mục tiêu khi không có mạng
Khi các phần phụ thuộc bên ngoài được cung cấp, 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 kho lưu trữ.
Do đó, bạn có thể kiểm tra nguồn được cung cấp và tạo cùng các mục tiêu ngoại tuyến trên một máy khác.
Cung cấp tất cả cá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ả cá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ữ, kể cả những kho lưu trữ được giới thiệu một cách gián tiếp, có thể tốn nhiều 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 cân nhắc việc bán hàng cho các mục tiêu cụ thể.
Định cấu hình chế độ nhà cung cấp bằng VENDOR.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 VENDOR.bazel nằm trong thư mục nhà cung cấp.
Có 2 chỉ thị, cả hai đều chấp nhận danh sách tên kho lưu trữ chuẩn làm đối số:
ignore(): để hoàn toàn bỏ qua một kho lưu trữ khỏi 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 như thể có cờ--override_repositorycho kho lưu trữ này. Bazel sẽ KHÔNG cập nhật nguồn được cung cấp cho kho lưu trữ này khi chạy lệnh nhà cung cấp, trừ phi nguồn đó chưa được 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+")
Với 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 của nhà cung cấp sau này.
- Repo
bazel_skylibsẽ được ghi đè thành nguồn nằm trong thư mục nhà cung cấp. - Người dùng có thể sửa đổi một cách an toàn nguồn được cung cấp của
bazel_skylib. - Để cung cấp lại
bazel_skylib, trước tiên, người dùng phải tắt câu lệnh ghim.
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. Vendoring external dependencies (Nhà 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 có liên quan ra thư mục nhà cung cấp đã cho 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 điểm đánh dấu kho lưu trữ
Trong quá trình tạo, nếu tệp đánh dấu được cung cấp là mới nhất hoặc kho lưu trữ được ghim trong tệp VENDOR.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 nguồn đó 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ẽ quay lại tìm nạp phiên bản mới nhất của kho lưu trữ.
Tệp đăng ký nhà cung cấp
Bazel phải thực hiện quy trình phân giải mô-đun Bazel để tìm nạp các phần phụ thuộc bên ngoài. Quy trình này có thể yêu cầu truy cập vào các tệp đăng ký thông qua Internet. Để đạt được bản dựng ngoại tuyến, Bazel sẽ cung cấp tất cả các tệp đăng ký được tìm nạp từ mạng trong thư mục <vendor_dir>/_registries.
Đường liên kết tượng trưng của nhà cung cấp
Các kho lưu trữ bên ngoài có thể chứa các đường liên kết tượng trưng trỏ đến các tệp hoặc thư mục khác. Để đảm bảo các đường liên kết tượng trưng hoạt động chính xác, Bazel sử dụng chiến lược sau để viết lại các đường liên kết tượng trưng trong nguồn được cung cấp:
- Tạo một đường liên kết tượng trưng
<vendor_dir>/bazel-externaltrỏ đến$(bazel info output_base)/external. Mọi lệnh Bazel đều tự động làm mới tệp này. - Đối với nguồn được cung cấp, hãy viết lại tất cả các đường liên kết tượng trưng ban đầu trỏ đến một đường dẫn trong
$(bazel info output_base)/externalthành một đường dẫn tương đối trong<vendor_dir>/bazel-external.
Ví dụ: nếu symlink ban đầu là
<vendor_dir>/repo_foo+/link => $(bazel info output_base)/external/repo_bar+/file
Đường liên kết đó sẽ được viết lại thành
<vendor_dir>/repo_foo+/link => ../../bazel-external/repo_bar+/file
trong đó
<vendor_dir>/bazel-external => $(bazel info output_base)/external # This might be new if output base is changed
Vì <vendor_dir>/bazel-external được Bazel tạo tự động, nên bạn nên thêm <vendor_dir>/bazel-external vào .gitignore hoặc tương đương để tránh kiểm tra <vendor_dir>/bazel-external.
Với chiến lược này, các symlink trong nguồn được cung cấp sẽ hoạt động chính xác ngay cả sau khi nguồn được cung cấp được di chuyển đến một vị trí khác hoặc cơ sở đầu ra bazel bị thay đổi.