Những điều kỳ quặc của copybara

Mục đích của tài liệu này là mô tả những điểm bất thường mà bạn có thể thấy khi đóng góp nội dung do công cụ quản lý việc sao chép nguồn qua lại từ kho lưu trữ nội bộ của Google. Công cụ này có tên là Copybara.

Nguồn đáng tin cậy nội bộ

Do nguồn đáng tin cậy cho mã trong kho lưu trữ này là kho lưu trữ nội bộ của Google, nên Copybara sẽ thực hiện các biến đổi đối với mã bất cứ khi nào mã được nhập và xuất. Điều này có nghĩa là đôi khi những thay đổi dường như bình thường có thể gây lỗi nội bộ theo những cách đáng ngạc nhiên.

Trạng thái hợp nhất PR và những điểm khác biệt không thống nhất

Vì nguồn đáng tin cậy là nội bộ, nên PR không được hợp nhất trực tiếp, chúng được nhập vào kho lưu trữ nội bộ của Google nơi trải qua quá trình thử nghiệm bổ sung, sau đó thay đổi nội bộ đó được gửi và được quy cho tác giả của PR. Do những phép biến đổi mà Copybara áp dụng, không có gì đảm bảo rằng điểm khác biệt sẽ giống hệt nhau (ví dụ: Copybara áp dụng định dạng khi nhập).

Vì lý do này, Copybara sẽ không đánh dấu PR là đã hợp nhất mà sẽ đóng PR đó và áp dụng riêng một cam kết liên kết rất chặt chẽ với PR đó.

Phần phụ thuộc trên TSL theo bản sao

Hiện tại, để ngăn chặn mọi thay đổi tạm thời bị lỗi, XLA không phụ thuộc vào TSL bằng cách tải bản sao xuống bằng cách sử dụng http_archive của Bazel, mà bằng cách sao chép TSL bằng cách sao chép TSL vào thư mục third_party của XLA.