git-fetch - عبر الإنترنت في السحابة

برنامج:

اسم

git-fetch - تنزيل الكائنات والمراجع من مستودع آخر

موجز

طائرة نفاثة جلب [ ] [ [ ...]]
طائرة نفاثة جلب [ ]
طائرة نفاثة جلب --عديد [ ] [( | ) ...]
طائرة نفاثة جلب --الجميع [ ]

الوصف

إحضار الفروع و / أو العلامات (إجمالاً ، "المراجع") من واحد أو أكثر من المستودعات الأخرى ،
جنبا إلى جنب مع الأشياء اللازمة لإكمال تاريخهم. فروع التعقب عن بعد هي
محدث (انظر وصف أدناه للتعرف على طرق التحكم في هذا السلوك).

بشكل افتراضي ، يتم أيضًا جلب أي علامة تشير إلى التواريخ التي يتم جلبها ؛ ال
التأثير هو جلب العلامات التي تشير إلى الفروع التي تهتم بها. هذا الافتراضي
يمكن تغيير السلوك باستخدام الخيارين --tags أو - no-tags أو عن طريق التكوين
بعيد. .tagOpt. باستخدام refspec التي تجلب العلامات بشكل صريح ، يمكنك جلب العلامات
التي لا تشير إلى الفروع التي تهتم بها أيضًا.

طائرة نفاثة جلب يمكن الجلب من مستودع واحد مسمى أو عنوان URL ، أو من عدة ملفات
المستودعات دفعة واحدة إذا يتم إعطاء وهناك أجهزة تحكم عن بعد. الدخول في
ملف الضبط. (يرى بوابة التكوين(1)).

عندما لا يتم تحديد جهاز تحكم عن بعد ، سيتم استخدام جهاز التحكم عن بعد الأصلي افتراضيًا ، ما لم يكن هناك ملف
تكوين فرع المنبع للفرع الحالي.

أسماء المراجع التي تم جلبها مع أسماء الكائنات التي يشيرون إليها هي
مكتوبة إلى .git / FETCH_HEAD. يمكن استخدام هذه المعلومات بواسطة البرامج النصية أو أوامر git الأخرى ،
مثل بوابة سحب(1).

OPTIONS

--الكل
إحضار كافة أجهزة التحكم عن بعد.

-a ، - إرفاق
قم بإلحاق أسماء المراجع وأسماء الكائنات للمراجع التي تم جلبها بالمحتويات الحالية لـ
.git / FETCH_HEAD. بدون هذا الخيار ، ستتم الكتابة فوق البيانات القديمة في .git / FETCH_HEAD.

- العمق =
حد الجلب إلى العدد المحدد من عمليات التنفيذ من طرف كل فرع بعيد
تاريخ. إذا كان الجلب إلى ملف ضحل تم إنشاؤه بواسطة git clone مع --depth =
الخيار (انظر استنساخ بوابة(1)) ، تعميق أو تقصير التاريخ إلى العدد المحدد من
يرتكب. لا يتم جلب العلامات الخاصة بعمليات الارتباطات المعمقة.

- غير ضحلة
إذا كان مستودع المصدر مكتملًا ، فقم بتحويل مستودع ضحل إلى مستودع كامل ،
إزالة جميع القيود التي تفرضها المستودعات الضحلة.

إذا كان مستودع المصدر ضحلًا ، فقم بإحضار أكبر قدر ممكن بحيث يكون التيار
المستودع له نفس تاريخ مستودع المصدر.

- تحديث ضحلة
بشكل افتراضي عند الجلب من مستودع ضحل ، يرفض git fetch ذلك
تتطلب تحديث .git / الضحلة. يقوم هذا الخيار بتحديث .git / الضحلة وقبول مثل هذه المراجع.

--ركض جاف
اعرض ما سيتم فعله دون إجراء أي تغييرات.

-f ، - القوة
متى طائرة نفاثة جلب يستخدم مع : refspec ، فإنه يرفض تحديث
الفرع المحلي ما لم يكن الفرع البعيد يجلب هو سليل
ل . يتجاوز هذا الخيار هذا الاختيار.

-ك ، - حفظ
احتفظ بالحزمة التي تم تنزيلها.

--مضاعف
السماح بالعديد و الحجج التي يتعين تحديدها. لا قد يكون
محدد.

-p ، --prune
بعد الجلب ، قم بإزالة أي مراجع للتتبع عن بعد لم تعد موجودة في
بعيد. لا تخضع العلامات للتقليم إذا تم جلبها فقط بسبب
المتابعة التلقائية للعلامة الافتراضية أو بسبب خيار العلامات. ومع ذلك ، إذا تم جلب العلامات بسبب استحقاقها
إلى refspec صريح (سواء في سطر الأوامر أو في التكوين البعيد ، لـ
على سبيل المثال ، إذا تم استنساخ جهاز التحكم عن بُعد باستخدام الخيار -mirror) ، فسيكون أيضًا موضوعًا
للتقليم.

-n ، - بدون علامات
بشكل افتراضي ، العلامات التي تشير إلى الكائنات التي تم تنزيلها من المستودع البعيد
يتم جلبها وتخزينها محليًا. يقوم هذا الخيار بتعطيل متابعة العلامة التلقائية هذه. ال
قد يتم تحديد السلوك الافتراضي لجهاز التحكم عن بعد مع جهاز التحكم عن بعد. .tag اختيار الإعداد.
يرى بوابة التكوين(1).

--refmap =
عند جلب المراجع المدرجة في سطر الأوامر ، استخدم refspec المحدد (يمكن توفيره
أكثر من مرة) لتعيين المراجع إلى فروع التتبع عن بُعد ، بدلاً من قيم
عن بعد. *. إحضار متغيرات التكوين للمستودع البعيد. انظر قسم
"فروع التعقب عن بعد المكونة" للحصول على التفاصيل.

-t ، - العلامات
قم بإحضار جميع العلامات من جهاز التحكم عن بعد (على سبيل المثال ، إحضار العلامات عن بعد refs / tags / * إلى العلامات المحلية
بنفس الاسم) ، بالإضافة إلى أي شيء آخر قد يتم جلبه بخلاف ذلك. استخدام
هذا الخيار وحده لا يُخضع العلامات للتقليم ، حتى لو تم استخدام --prune (على الرغم من
قد يتم تقليم العلامات على أي حال إذا كانت أيضًا وجهة مرجع صريح ؛ يرى
--تقليم).

--recurse-submodules [= نعم | عند الطلب | لا]
يتحكم هذا الخيار في ما إذا كانت وتحت أي شروط يتم تنفيذ عمليات جديدة للوحدات الفرعية المأهولة
يجب جلبه أيضًا. يمكن استخدامه كخيار منطقي للتعطيل تمامًا
العودية عند الضبط على لا أو تتكرر دون قيد أو شرط في جميع الوحدات الفرعية المأهولة
عند الضبط على نعم فعلا، وهو الإعداد الافتراضي عند استخدام هذا الخيار بدون أي قيمة. يستخدم
بناء على الطلب لتتكرر فقط في وحدة فرعية مأهولة عندما يسترد المشروع العملاق ملف
الالتزام الذي يقوم بتحديث مرجع الوحدة الفرعية إلى التزام غير موجود بالفعل في
استنساخ وحدة فرعية محلية.

--لا تتكرر الوحدات الفرعية
قم بتعطيل الجلب المتكرر للوحدات الفرعية (هذا له نفس تأثير استخدام امتداد
- وحدات فرعية متكررة = لا اختيار).

--submodule-prefix =
يعلق إلى المسارات المطبوعة في رسائل إعلامية مثل "إحضار الوحدة الفرعية
foo ". يُستخدم هذا الخيار داخليًا عند التكرار على الوحدات الفرعية.

--recurse-submodules-default = [نعم | عند الطلب]
يُستخدم هذا الخيار داخليًا لتوفير قيمة افتراضية غير سلبية مؤقتًا لـ
الخيار --recurse-subodules. جميع الطرق الأخرى لتكوين الوحدة الفرعية للجلب
العودية (مثل الإعدادات بتنسيق وحدات gitmodules(5) و بوابة التكوين(1)) تجاوز هذا الخيار ،
كما هو الحال مع تحديد - [لا] - الوحدات الفرعية المتكررة مباشرة.

-u، -تحديث-رئيس-موافق
افتراضيا طائرة نفاثة جلب يرفض تحديث الرأس الذي يتوافق مع التيار
فرع. هذه العلامة تعطل الشيك. هذا محض للاستخدام الداخلي لـ طائرة نفاثة سحب
للتواصل مع طائرة نفاثة جلبوما لم تكن تقوم بتنفيذ البورسلين بنفسك
ليس من المفترض أن تستخدمه.

- حزمة التحميل
عند تقديمه ، يتم التعامل مع المستودع الذي سيتم الجلب منه طائرة نفاثة أحضر حزمة,
- exec = إلى الأمر لتحديد مسار غير افتراضي لملف
تشغيل الأمر على الطرف الآخر.

-Q ، - هادئ
تمرير - هادئ إلى git-fetch-pack وإسكات أي أوامر git أخرى مستخدمة داخليًا.
لم يتم الإبلاغ عن التقدم إلى تدفق الخطأ القياسي.

-v ، - الإسراف
كن مطولا.

--تقدم
يتم الإبلاغ عن حالة التقدم في تدفق الخطأ القياسي افتراضيًا عندما يكون كذلك
متصل بمحطة ، ما لم يتم تحديد q-. هذا العلم يفرض حالة التقدم حتى
إذا لم يتم توجيه تدفق الخطأ القياسي إلى محطة طرفية.


المستودع "البعيد" الذي يعد مصدر عملية الجلب أو السحب. هذا
يمكن أن تكون المعلمة إما عنوان URL (راجع قسم GIT URLS أدناه) أو اسم جهاز تحكم عن بعد
(انظر القسم عن بعد أدناه).


اسم يشير إلى قائمة المستودعات كقيمة أجهزة التحكم عن بعد. في ال
ملف الضبط. (يرى بوابة التكوين(1)).


يحدِّد المراجع المطلوب جلبها والمراجع المحلية المراد تحديثها. عندما لا س
تظهر في سطر الأوامر ، تتم قراءة المراجع المطلوب إحضارها من جهاز التحكم عن بُعد. .أحضر
المتغيرات بدلاً من ذلك (انظر الفروع المكونة للتتبع عن بُعد أدناه).

شكل ملف المعلمة اختيارية plus + ، متبوعة بالمرجع المصدر
، متبوعة بنقطتين: ، متبوعة بالوجهة المرجع . يمكن أن يكون القولون
حذفت عندما فارغ.

بطاقة شعار تعني نفس المراجع / العلامات / : المراجع / العلامات / ؛ يطلب الجلب
كل شيء حتى العلامة المحددة.

المرجع البعيد المطابق يتم جلبه ، وإذا ليست سلسلة فارغة ، فإن
المرجع المحلي الذي يطابق ذلك يتم إرساله سريعًا باستخدام . إذا كانت علامة الجمع الاختيارية هي
مستخدمًا ، يتم تحديث المرجع المحلي حتى لو لم ينتج عنه تحديث سريع التقديم.

ملاحظات
عندما يكون من المعروف أن الفرع البعيد الذي تريد جلبه سيتم إعادة لفه وإعادة تأسيسه
بانتظام ، من المتوقع ألا يكون طرفه الجديد منحدراً من سابقه
نصيحة (كما تم تخزينها في فرع التتبع عن بُعد في آخر مرة جلبت فيها). أنت
قد ترغب في استخدام علامة + للإشارة إلى أنه ستكون هناك حاجة إلى تحديثات غير سريعة التقديم
لمثل هذه الفروع. لا توجد طريقة لتحديد أو إعلان أن الفرع سيكون
يتم توفيرها في المستودع بهذا السلوك ؛ يجب على المستخدم الذي يقوم بالسحب ببساطة
تعرف أن هذا هو نمط الاستخدام المتوقع للفرع.

GIT عناوين URL

بشكل عام ، تحتوي عناوين URL على معلومات حول بروتوكول النقل وعنوان ملف
الخادم البعيد ، والمسار إلى المستودع. اعتمادًا على بروتوكول النقل ، البعض
من هذه المعلومات قد تكون غائبة.

يدعم Git بروتوكولات ssh و git و http و https (بالإضافة إلى ذلك ، يمكن استخدام ftp و ftps
للجلب و rsync يمكن استخدامها للجلب والدفع ، ولكن هذه غير فعالة و
إهمال؛ لا تستخدمها).

لا يقوم النقل الأصلي (على سبيل المثال git: // URL) بالمصادقة ويجب استخدامه مع
الحذر على الشبكات غير الآمنة.

يمكن استخدام الصيغ التالية معهم:

· ssh: // [user @] host.xz [: port] /path/to/repo.git/

· git: //host.xz [: port] /path/to/repo.git/

· http [s]: //host.xz [: port] /path/to/repo.git/

· ftp [s]: //host.xz [: port] /path/to/repo.git/

· rsync: //host.xz/path/to/repo.git/

يمكن أيضًا استخدام صيغة بديلة تشبه scp مع بروتوكول ssh:

· [user @] host.xz: path / to / repo.git /

يتم التعرف على بناء الجملة هذا فقط في حالة عدم وجود شرطات مائلة قبل علامة النقطتين الأولى. هذا يساعد
تمييز مسار محلي يحتوي على نقطتين. على سبيل المثال المسار المحلي foo: bar يمكن أن يكون
يتم تحديده كمسار مطلق أو ./foo:bar لتجنب إساءة تفسيره على أنه عنوان url ssh.

يدعم بروتوكولات ssh و git أيضًا توسيع اسم المستخدم:

· ssh: // [user @] host.xz [: port] / ~ [مستخدم] /path/to/repo.git/

· git: //host.xz [: port] / ~ [مستخدم] /path/to/repo.git/

· [مستخدم @] host.xz: / ~ [مستخدم] /path/to/repo.git/

بالنسبة للمستودعات المحلية ، المدعومة أيضًا بواسطة Git محليًا ، قد تكون الصيغ التالية
مستعمل:

· /المسار/إلى/repo.git/

· ملف: ///path/to/repo.git/

هاتان الصيغتان متكافئتان في الغالب ، إلا عند الاستنساخ ، عندما يشير الأول إلى ذلك
- خيار محلي. يرى استنساخ بوابة(1) لمزيد من التفاصيل.

عندما لا يعرف Git كيفية التعامل مع بروتوكول نقل معين ، فإنه يحاول استخدام الامتداد
التحكم عن بعد- المساعد البعيد ، إن وجد. لطلب مساعد بعيد صراحة ،
يمكن استخدام الصيغة التالية:

· ::

أين قد يكون مسارًا أو خادمًا ومسارًا أو سلسلة عشوائية تشبه عنوان URL
يتعرف عليه المساعد البعيد المحدد الذي يتم استدعاؤه. يرى مساعدين gitremote(1) من أجل
تفاصيل.

إذا كان هناك عدد كبير من المستودعات البعيدة ذات الأسماء المتشابهة وتريد استخدام ملف
تنسيق مختلف لهم (مثل أن عناوين URL التي تستخدمها ستتم إعادة كتابتها في عناوين URL التي
work) ، يمكنك إنشاء قسم تكوين من النموذج:

[عنوان url " "]
بدلا من =

على سبيل المثال ، مع هذا:

[url "git: //git.host.xz/"]
بدلاً من ذلك = host.xz: / path / to /
بدلا من = العمل:

عنوان URL مثل "work: repo.git" أو مثل "host.xz: /path/to/repo.git" ستتم إعادة كتابته في أي
السياق الذي يأخذ عنوان URL ليكون "git: //git.host.xz/repo.git".

إذا كنت ترغب في إعادة كتابة عناوين URL للدفع فقط ، فيمكنك إنشاء قسم تكوين لملف
شكل:

[عنوان url " "]
pushInsteadOf =

على سبيل المثال ، مع هذا:

[url "ssh: //example.org/"]
pushInsteadOf = git: //example.org/

ستتم إعادة كتابة عنوان URL مثل "git: //example.org/path/to/repo.git" إلى
"ssh: //example.org/path/to/repo.git" لعمليات الدفع ، ولكن ستظل عمليات السحب تستخدم الأصل
URL.

أجهزة التحكم عن بعد

يمكن استخدام اسم أي مما يلي بدلاً من عنوان URL كـ دعوى:

جهاز تحكم عن بعد في ملف تكوين Git: $ GIT_DIR / config ،

ملف في الدليل $ GIT_DIR / ريموتات ، أو

ملف في الدليل $ GIT_DIR / الفروع.

كل هذه تسمح لك أيضًا بحذف refspec من سطر الأوامر لأن كل منها
تحتوي على refspec التي سيستخدمها git افتراضيًا.

عين عن بعد in ترتيب ملف
يمكنك اختيار تقديم اسم جهاز التحكم عن بُعد الذي قمت بتكوينه مسبقًا باستخدامه
بوابة التحكم عن بعد(1) بوابة التكوين(1) أو حتى عن طريق تعديل يدوي لملف $ GIT_DIR / config. عنوان URL
سيتم استخدام جهاز التحكم عن بُعد هذا للوصول إلى المستودع. سيكون refspec لجهاز التحكم عن بعد هذا
يتم استخدامه بشكل افتراضي عندما لا تقدم مرجعًا في سطر الأوامر. الإدخال في
سيظهر ملف التكوين بالشكل التالي:

[بعيد " "]
url =
pushurl =
دفع =
إحضار =

ال يستخدم للدفع فقط. إنه اختياري ويتم تعيينه افتراضيًا .

عين ملف in GIT_DIR دولار / عن بعد
يمكنك اختيار تقديم اسم الملف في $ GIT_DIR / remote. عنوان URL في هذا الملف
سيتم استخدامها للوصول إلى المستودع. سيتم استخدام المرجع في هذا الملف كافتراضي
عندما لا تقدم مرجعًا في سطر الأوامر. يجب أن يحتوي هذا الملف على ما يلي
شكل:

URL: أحد تنسيقات URL أعلاه
يدفع:
يحذب:

الدفع: يتم استخدام الخطوط بواسطة طائرة نفاثة دفع والسحب: يتم استخدام الخطوط بواسطة طائرة نفاثة سحب و طائرة نفاثة جلب.
الدفع المتعدد: والسحب: يمكن تحديد الخطوط لتعيينات الفروع الإضافية.

عين ملف in GIT_DIR دولار / الفروع
يمكنك اختيار تقديم اسم الملف في $ GIT_DIR / الفروع. عنوان URL في هذا الملف
سيتم استخدامها للوصول إلى المستودع. يجب أن يكون هذا الملف بالتنسيق التالي:

#

مطلوب؛ # هو اختياري.

اعتمادًا على العملية ، سيستخدم git أحد برامج refspecs التالية ، إذا لم تقم بذلك
توفير واحد في سطر الأوامر. اسم هذا الملف في $ GIT_DIR / الفروع
و الافتراضات لإتقان.

استخدامات git fetch:

المراجع / رؤساء / : المراجع / الرؤوس /

يستخدم git push:

الرأس: المراجع / الرؤوس /

مهيأ التتبع عن بعد الفروع

غالبًا ما تتفاعل مع نفس المستودع البعيد عن طريق الجلب بشكل منتظم ومتكرر
منه. لتتبع التقدم المحرز في مثل هذا المستودع البعيد ، git fetch
يسمح لك بتكوين جهاز التحكم عن بعد. . متغيرات تكوين الجلب.

عادة قد يبدو هذا المتغير كما يلي:

["أصل" بعيد]
fetch = + refs / heads / *: refs / remote / origin / *

يتم استخدام هذا التكوين بطريقتين:

عندما يتم تشغيل git fetch بدون تحديد الفروع و / أو العلامات المطلوب جلبها على
سطر الأوامر ، على سبيل المثال git fetch origin أو git fetch ، remote. قيم الجلب
تستخدم كمراجع مرجعية - فهي تحدد المراجع التي يجب جلبها والمراجع المحلية
تحديث. المثال أعلاه سوف يجلب جميع الفروع الموجودة في الأصل (أي أي
المرجع الذي يطابق الجانب الأيسر من القيمة ، المراجع / الرؤوس / *) وقم بتحديث
فروع التعقب عن بعد المقابلة في المراجع / أجهزة التحكم عن بعد / الأصل / * التسلسل الهرمي.

· عند تشغيل git fetch بفروع و / أو علامات واضحة لجلبها في سطر الأوامر ،
على سبيل المثال git fetch origin master ، و ق المعطاة في سطر الأوامر تحديد ماذا
يتم جلبها (على سبيل المثال ، سيد في المثال ، وهو اختصار لـ Master :،
وهو ما يعني بدوره "جلب رئيسي فرع لكني لا أقول ما صراحة
فرع التعقب عن بعد للتحديث معه من سطر الأوامر ") ، والمثال
الأمر سوف يجلب فقط ال رئيسي فرع. جهاز التحكم عن بعد. قيم الجلب
تحديد فرع التتبع عن بعد ، إن وجد ، الذي يتم تحديثه. عند استخدامها بهذه الطريقة ، فإن ملف
بعيد. ليس لقيم الجلب أي تأثير في اتخاذ القرار ماذا يتم جلبه
(على سبيل المثال ، لا يتم استخدام القيم كمراجع عندما يسرد سطر الأوامر refspecs) ؛ هم
تستخدم فقط لاتخاذ القرار أين يتم تخزين المراجع التي يتم جلبها من خلال العمل كملف
رسم الخرائط.

الاستخدام الأخير لجهاز التحكم عن بعد. يمكن تجاوز قيم الجلب بإعطاء
--refmap = المعلمات في سطر الأوامر.

أمثلة

· تحديث فروع التتبع عن بعد:

أصل إحضار $ git

ينسخ الأمر أعلاه جميع الفروع من المراجع / الرؤوس / مساحة الأسماء والمخازن البعيدة
لهم إلى المراجع / أجهزة التحكم عن بعد / الأصل / مساحة الاسم ، ما لم يكن الفرع. .أحضر
يستخدم الخيار لتحديد مرجع غير افتراضي.

· استخدام المراجع بشكل صريح:

أصل جلب الجلب $ + pu: pu صيانة: tmp

يقوم هذا بتحديث (أو إنشاء ، حسب الضرورة) الفروع pu و tmp في المستودع المحلي بواسطة
الجلب من الفروع (على التوالي) pu والمحافظة عليه من المستودع البعيد.

سيتم تحديث فرع pu حتى لو لم يتم تقديمه بسرعة ، لأنه كذلك
مسبوقة بعلامة الجمع ؛ لن يكون tmp.

· إلقاء نظرة خاطفة على فرع بعيد ، دون تكوين جهاز التحكم عن بُعد في مستودعك المحلي:

git fetch git $: //git.kernel.org/pub/scm/git/git.git صيانة
سجل بوابة FETCH_HEAD دولار

يقوم الأمر الأول بجلب فرع الصيانة من المستودع في
git: //git.kernel.org/pub/scm/git/git.git ويستخدم الأمر الثاني FETCH_HEAD ل
فحص الفرع مع بوابة الدخول(1). ستتم إزالة الكائنات التي تم جلبها في النهاية بواسطة
التدبير المنزلي المدمج في git (انظر بوابة gc(1)).

استخدم git-fetch عبر الإنترنت باستخدام خدمات onworks.net