وثائق

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

اربط مستودع GitHub أو GitLab حتى يتمكن Coroid من القراءة منه وفتح طلبات سحب مقابلها.

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

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

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

المزودطريقة الاتصالالتوفر
GitHubتثبيت تطبيق GitHub، أو رمز وصول شخصيمتاح للاستخدام بشكل عام
GitLabرمز وصول شخصيمعاينة خاصة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

التالي

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