ربط الكود الخاص بك

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

يتم إدارة الاتصالات في إعدادات → اتصالات → التحكم في المصدر (/settings/connections/source-control).

المزودون المدعومون#

GitHub: تثبيت التطبيق أو الرمز#

بالنسبة لـ GitHub، فإن تثبيت تطبيق Coroid GitHub هو الخيار الأفضل. يمنح التطبيق صلاحيات الوصول حسب كل مستودع وليس لكل مستخدم، ويستمر في العمل حتى بعد مغادرة الشخص الذي قام بإعداده، ويسمح لـ Coroid باستقبال أحداث webhook دون الحاجة إلى الاستعلام المتكرر.

اختر استخدام رمز وصول شخصي عندما يتطلب تثبيت التطبيق موافقة مسؤول لا تملكها.

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

الاتصال باستخدام رمز وصول شخصي#

قم بإنشاء الرمز في مزودك، ثم الصقه في إعدادات → اتصالات → التحكم في المصدر.

يجب على الرمز المميز قراءة محتويات المستودع وإنشاء فروع وطلبات سحب. في GitHub، هذا هو repo النطاق المطلوب في GitLab. api.

تتم تشفير الرموز قبل تخزينها، ولا تقوم API بإرجاعها أو عرضها مرة أخرى في واجهة المستخدم بعد حفظها. كما أنها مستبعدة من حزم تصدير الإعدادات؛ حيث تحتوي الحزمة المصدرة على عنصر نائب، ويجب إعادة إدخال السر عند استيرادها في مكان آخر.

ربط مستودع بمشروع#

الاتصال يجعل المستودعات متاحة؛ أما المشروع فهو ما يعمل فيه Coroid بالفعل. يمكنك إنشاؤه من مشاريع ← جديد، واختر المستودع المرتبط، وسيقوم Coroid بإجراء تحليل أولي للكود لاستكشاف اللغات وأوامر البناء واختبارها.

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

جرب استخدام Coroid دون الكتابة في مستودعك#

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

لا يحتاج مستودع GitHub العام إلى أي اتصال: فقط اختر الربط باستخدام URL، ثم الصق عنوان المستودع وتحقق من صلاحية الوصول. بدون اتصال بـ GitHub، يتم تحديد خيار Local only تلقائيًا، لأن Coroid يمكنه قراءة مستودع عام لكن لا يوجد ما يمكنه دفعه إليه.

الفرع الذي يعمل منه Coroid#

يبدأ Coroid من فرعك الافتراضي ويفتح طلبات سحب مقابله. يمكنك تغيير الفرع الأساسي لكل مشروع ضمن إعدادات المستودع إذا كنت تدمج في فرع غير main.

التحقق من الاتصال#

يعمل الاتصال عندما يظهر المستودع في قائمة إنشاء المشروع وينتهي التحليل الأولي للمشروع. إذا كان المستودع المتوقع غير موجود، فأكثر الأسباب شيوعًا هي:

• تم تثبيت تطبيق GitHub لكن لم يتم منحه صلاحيات الوصول إلى ذلك المستودع تحديدًا
• نطاق الرمز ضيق للغاية لدرجة أنه لا يستطيع سرد المستودعات الخاصة
• ينتمي المستودع إلى مؤسسة مختلفة عن تلك التي قمت بربطها

التالي#

كيف يتحول المهمة إلى pull request — ما الذي يحدث بعد وصفك لبعض الأعمال.