مراوغة النسخ الاحتياطي

الغرض من هذا المستند هو وصف الأشياء الغريبة التي قد تراها أثناء المشاركة بسبب الأداة التي تدير نسخ المصدر ذهابًا وإيابًا من مستودع Google الداخلي. تُسمى هذه الأداة Copybara.

مصدر داخلي للحقيقة

ولأنّ مصدر الرمز البرمجي في هذا المستودع هو مستودع Google الداخلي، يُجري Copybara أي عمليات تحويل على الرمز البرمجي عند استيراد الرمز وتصديرها. هذا يعني أن التغييرات التي تبدو طبيعية في بعض الأحيان يمكن أن تحدث داخليًا بطرق مدهشة.

حالات دمج PR وحالات عدم الاتساق

وبما أنّ مصدر الحقيقة هو داخلي، لا يتم دمج تقارير العلاقات العامة مباشرةً، بل يتم استيرادها إلى مستودع Google الداخلي حيث يخضع لاختبار إضافي، ثم يتم إرسال هذا التغيير الداخلي، ويُنسب إلى مؤلف العلاقات العامة. وبسبب عمليات التحويل التي تطبّقها Copybara، ما من ضمان بأنّ الفرق سيكون متطابقًا (على سبيل المثال، يطبِّق Copybara التنسيق عند الاستيراد).

لهذا السبب، لن يصنّف موقع Copybara المحتوى على أنه مدمج، بل سيغلقه ويطبّق بشكل منفصل إتمامًا يجب ربطه بشكل وثيق بـ PR.

التبعية على TSL حسب النسخة

وفقًا لما هو مُطبّق حاليًا، لمنع أي عمليات تنفيذ غير مكتملة مؤقتًا، يعتمد XLA على TSL، ليس من خلال تنزيل نسخة من خلال http_archive في Bazel، ولكن عن طريق إرسال نسخة TSL إلى دليل third_party لـ XLA.