إعدادات المستودع والفروع

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

يمكن العثور عليها ضمن إعدادات المشروع.

متزامن أو محلي فقط#

يحدد وضع المستودع ما إذا كان بإمكان Coroid الكتابة إلى GitHub أو GitLab.

• متزامن (الوضع الافتراضي): يقوم Coroid بدفع فرع كل مهمة وفتح طلب سحب مقابل فرعك الأساسي.
• محلي فقط: يقوم Coroid بالنسخ والسحب من المستودع ولكن دون الكتابة إليه. لا عمليات دفع، ولا فروع على البُعد، ولا طلبات سحب، ولا تعليقات، ولا مراجعات، ولا عمليات تحقق، ولا روابط ويب، ولا عمليات دمج، ولا تشغيل خطوط أنابيب. تتم جميع الفروع والالتزامات والمراجعات وعمليات التحقق والمعاينات داخل Coroid.

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

الوضع المحلي فقط هو الطريقة الآمنة لتجربة Coroid على مستودع حقيقي. تُنفذ المهام والخطط حتى مرحلة المراجعة. حيث يوجد pull request، تظهر المراجعة محفوظ في Coroid وإجراء واحد، بدء المزامنة. يتطلب الموافقة مشروعًا متزامنًا، لأن الموافقة تؤدي إلى الدمج في فرعك الأساسي؛ داخل الخطة، تظل المهام مجتمعة على فرع الخطة في Coroid. نسخة Coroid من فرعك الأساسي تظل مطابقة للنسخة البعيدة، لذا لا يصل شيء إليها لم تقم بفتح pull request له.

للاطلاع على العمل على جهازك، افتح استنساخ وتصدير في إعدادات المستودع، وإنشاء رمز وصول، ثم جلب فروع Coroid من مستودعه الخاص:

git remote add coroid https://coroid@git.coroid.ai/git/<project-id>.git
git fetch coroid

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

لا يعتمد أي شيء في وضع المحلي فقط على نطاق رمز الوصول الخاص بك: يرفض Coroid أي كتابة إلى المستودع نفسه، بغض النظر عن ما يمكن للاتصال القيام به. ينتقل الوضع مع إعدادات فروع المشروع في قابلية نقل الإعدادات.

الفرع الأساسي#

Coroid ينشئ فروعًا من فرعك الأساسي ويفتح طلبات سحب مقابلة له. ويكون هذا الفرع هو الفرع الافتراضي للمستودع بشكل افتراضي.

قم بتغييره إذا كنت ترغب في الدمج في مكان آخر — مثل فرع develop أو قطار إصدارات، أو فرع تكامل طويل الأمد. يُعد هذا الخطأ أكثر أخطاء الإعداد شيوعًا، وينتج عنه طلبات سحب تستهدف فرعًا لا يقوم أحد بمراجعته.

عند تغيير الفرع المستهدف#

يسجل أي خطة الالتزام الخاص بالفرع الأساسي الذي بدأت منه. وإذا تغير الفرع الأساسي قبل دمج pull request الخاص بالخطة، فإن Coroid يوقف عملية الدمج؛ راجع عند تحرك الفرع الأساسي. يحدد هذا الإعداد ما سيحدث بعد ذلك:

• إيقاف التنفيذ للمراجعة (افتراضي) — يقوم شخص ما بفحص الالتزامات الجديدة وإما قبولها أو طلب من Coroid دمجها وإعادة التحقق منها.
• دمج وإعادة التحقق — يقوم Coroid بدمج التغييرات في فرع المسار الخاص بالخطة ويشغّل عمليات المطور واختبار الجودة والمراجعة مرة أخرى دون انتظار تدخل أحد. ويستهلك ذلك ساعات عمل الوكلاء. وإذا فشل الدمج أو إعادة التحقق، تعود القرارية إلى شخص.

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

فروع العمل#

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

لا يتم إرسال أي شيء مباشرةً إلى فرعك الأساسي. هذه ليست إعدادات؛ بل هي خاصية أساسية في طريقة عمل Coroid.

حماية الفروع#

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

إذا كانت قواعد الحماية تتطلب التزامًا موقعًا أو فحص حالة محدد لا يستطيع Coroid إنتاجه، فسيتم فتح pull request وسيظل غير قابل للدمج — وهذا يعكس عمل قواعدك، وليس خللًا في Coroid.

تنظيف#

يمكن تنظيف الفروع الخاصة بالعمل المنجز بعد دمج pull request أو إغلاقه. إذا كنت تعتمد على أسماء الفروع للتدقيق أو أدوات الإصدار، فتحقق من ذلك قبل تفعيل هذه الميزة.

تغيير الاتصال#

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

إعدادات خط أنابيب الإصدارات#

تحدد الفرع الأساسي المكان الذي يفتح فيه Coroid طلبات السحب. يتم النشر عبر مشروع منفصل. إصدار إعدادات التكوين: بيئة، سياسة الجاهزية الخاصة بها، وبشكل اختياري مرجع لخط أنابيب GitHub Actions أو GitLab، بالإضافة إلى وظيفة النشر. يجب أن يشير هذا المرجع إلى الالتزام المحدد للإصدار قبل أن يطلب Coroid تنفيذ العملية. قم بتهيئة بيانات اعتماد رد الاتصال ضمن نطاق البيئة حتى يتمكن خط الأنابيب من الإبلاغ عن نتيجته؛ فاتصال المستودع وحده لا يثبت ما تم نشره. يمكن لخطوط الأنابيب الخارجية الإبلاغ عن الأحداث دون الحاجة إلى تفعيل عمليات الإرسال من قبل Coroid.

ذات صلة#

• ربط كودك
• إنشاء مشروع وتهيئته
• إعدادات البناء والاختبار
• دعم اللغات وبيئة الوكلاء
• إصدارات