تمرين تعاون Azure Repos مع طلبات السحب

مكتمل

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

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

يجب أن تتبع أي تغييرات يتم دفعها إلى فروع الخادم هذه السياسات قبل قبول التغييرات.

النُهج هي طريقة رائعة لفرض جودة التعليمات البرمجية لفريقك ومعايير إدارة التغيير. في هذه الوصفة، ستتعلم كيفية تكوين نهج الفروع في فرعك الرئيسي.

الاستِعداد

تشتمل نُهج الفروع الجاهزة على العديد من السياسات، مثل إنشاء التحقق من الصحة وفرض إستراتيجية الدمج. سنركز فقط على سياسات الفرع اللازمة لإعداد سير عمل مراجعة التعليمات البَرمجية في هذه الوصفة.

كيفية القيام بذلك

  1. افتح عرض الفروع لمستودع myWebApp Git في مدخل الفريق غير المحدودة. حَدد الفرع الرئيسي، ومن القائمة المنسدلة، اختر نهج الفرع:

    فتح الإصدارات الفرعية.

  2. في طريقة عرض النهج، يقدم نهج خارج الصندوق. عيّن الحد الأدنى لعدد المراجعين إلى 1:

    يلزم حدًا أدنى من المراجعين.

    يسمح خيار السماح لمقدمي الطلبات بالموافقة على التغييرات الخاصة بهم للمرسل بالموافقة الذاتية على تغييراته.

    في حين أن هذا قد يكون مقبولا للفرق الناضجة، بشكل عام، فإنه يجب تجنبه.

  3. استخدم نهج المراجعة مع نَهج تحليل التعليقات. يسمح لك فرض أن يتم حل تعليقات مراجعة التعليمات البرمجية قبل قُبول التغييرات. يمكن للمطلب أخذ الملاحظات من التعليق وإنشاء عُنصر عمل جديد وحل التغييرات. يضمن على الأقل عدم فقدان تعليقات مراجعة التعليمات البرمجية مع قبول التعليمات البرمَجية في الفرع الرئيسي:

     تحقق من دقة التعليقات.

  4. يحث أحد المتطلبات على تغيير التعليمة البرمجية في مشروع الفريق. إذا كان عنصر العمل الذي قام بتشغيل العمل غير مرتبط بالتغيير، فسيصبح من الصعب فهم سبب إجراؤه بمرور الوقت. إنه مفيد بشكل خاص عند مراجعة محفوظات التغييرات. تكوين نهج التحقق من عناصر العمل المرتبطة لمنع التغييرات التي لا تَحتوي على عنصر عمل مرتبط بها:

     تحقق من عناصر العمل المرتبطة.

  5. حدد الخيار لتضمين مراجعين عند رفع طلب السحب تلقائياً. يمكنك تعيين المراجعين الذين تمت إضافتهم استنادا إلى منطقة التعليمات البَرمجية التي يتم تغييرها:

     أضف مراجعين تلقائيين.

طريقة العمل

مع سياسات الفرع المعمول بها، أصبح الفرع الرئيسي الآن محميًا بالكامل.

الطريقة الوحيدة لدفع التغييرات إلى الفرع الرئيسي هي أولاً إجراء التغييرات في فرع آخر ثم رفع طلب السَحب لتشغيل سير عمل قبول التغيير.

اختر إنشاء فرع جديد من إحدى مجموعات قصص المستخدم الموجودة في مركز عناصر العمل.

من خلال إنشاء فرع جديد من عنصر عمل، يتم ربط عنصر العمل هذا تلقائيًا بالفرع.

يمكنك اختياريًا تضمين أكثر من عنصر عمل واحد مع فرع كجزء من إنشاء سير العمل:

أنشئ إصدار فرعي.

بادئة في الاسم عند إنشاء الفرع لعمل مجلد للدخول إليه.

في المثال السابق، سيذهب الفرع في المجلد. إنها طريقة رائعة لتنظيم الفروع في بيئات مزدحمة.

مع تحديد الفرع الذي تم إنشاؤه حديثًا في مدخل ويب، قم بتحرير ملف HomeController.cs لتضمين القصاصة البرمجية التالية وتنفيذ التغييرات في الفرع.

في الصورة أدناه، سترى أنه يمكنك تنفيذ التغييرات مباشرةً بعد تحرير الملف بالنقر فوق الزر "تنفيذ".

يدعم عنصر التحكم في مسار الملف في مدخل الفريق البحث.

ابدأ في كتابة مسار الملف لرؤية جميع الملفات في مستودع Git الخاص بك ضمن هذا الدليل، بدءًا من هذه الأحرف التي تظهر في القائمة المنسدلة لنتائج البحث في مسار الملف.

 تغيير التعليمة البرمجية والتثبيت.

يحتوي محرر التعليمات البرمجية في مدخل الويب على العديد من الميزات الجديدة في Azure DevOps Server، مثل دعم مطابقة الأقواس وتبديل المسافة البيضاء.

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

لدفع هذه التغييرات من الفرع الجديد إلى الفرع الرئيسي، قم بإنشاء طلب سحب من عرض طلب السحب.

حدد الفرع الجديد باعتباره المصدر والفرع الرئيسي باعتباره الفرع المستهدف.

يدعم نموذج طلب السحب الجديد تخفيض السعر، لذا يمكنك إضافة الوصف باستخدام صيغة markdown.

تدعم نافذة الوصف أيضاً الإشارات @ و# لربط عناصر العمل:

 إنشاء طلب سحب.

تم إنشاء طلب السحب؛ تلخص صفحة النظرة العامة التغييرات وحالة النُهج.

تعرض لك علامة التبويب "الملفات" قائمة بالتغييرات والفرق بين الإصدارين السابق والحالي.

ستظهر أي تحديثات يتم دفعها إلى ملفات التعليمات البرمجية في علامة التبويب "التحديثات"، وستظهر قائمة بجميع الالتزامات ضمن علامة التبويب "الالتزامات":

 سحب طلب سحب.

افتح علامة التبويب الملفات: يدعم هذا العرض تعليقات التعليمات البرمجية على مستوى الخط ومستوى الملف وبشكل عام.

تدعم التعليقات كلاً من @ للإشارات و# لربط عناصر العمل، ويدعم النص صيغة markdown:

استمرت تعليقات التعليمات البرمجية في سير عمل طلب السحب؛ تدعم تعليقات التعليمة البرمجية التكرارات المتعددة للمراجعات وتعمل بشكل جيد مع الردود المتداخلة.

يسمح نهج المراجع بسير عمل مراجعة التعليمات البرمجية كجزء من قبول التغيير.

إنها طريقة مُمتازة للفريق للتعاون في أي تغييرات في التعليمات البرمجية يتم دفعها إلى الفرع الرئيسي.

عندما يوافق العدد المطلوب من المراجعين على طلب السَحب، يمكن إكماله.

يمكنك أيضًا وضع علامة على طلب السَحب للإكمال التلقائي بعد المراجعة. يقوم بإكمال طلبات السحب تلقائيًا بمجرد تجميع جميع النُهج بنجاح.

يوجد المزيد

هل سبق لك أن كنت في حالة تم فيها حذف أحد الفروع عن طريق الخطأ؟ لا يمكن أن يكون من السَهل معرفة ما حدث.

يدعم Azure DevOps Server الآن البحث عن الفروع المحذوفة. يساعدك على فهم من حذفه ومتى. تتيح لك الواجهة أيضًا إعادة إنشاء الفرع.

تظهر الفروع المحذوفة فقط إذا بحثت عنها بأسمائها الدقيقة لحجب الضوضاء من نتائج البحث.

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

سترى أيضًا خيارًا للبحث عن تطابق تام في قائمة الفروع المحذوفة.

إذا تم العثور على تطابق، فسترى من قام بحذفها ومتى. يُمكنك أيضا استعادة الفرع. ستؤدي استعادة الفرع إلى إعادة إنشائه عند الالتزام الذي تم تحديده أخيرًا.

ومع ذلك، لن يستعيد النُهج والأذونات.