وثائق

GitHub

قم بربط GitHub بالتطبيق أو رمز وصول شخصي، وتعرف على الصلاحيات الممنوحة لكل منهما.

يتصل GitHub إما عبر Coroid تطبيق GitHub أو رمز وصول شخصي. قم بتهيئته في إعدادات → اتصالات → التحكم في المصدر.

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

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

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

تطبيق GitHubرمز وصول شخصي
نطاق الوصولحسب المستودعكل ما يمكن للمستخدم رؤيته
يستمر عمله بعد مغادرة الشخص الذي قام بإعدادهنعملا
أحداث الـ Webhookنعماستعلام مستمر
الانتسابالتطبيقمالك الرمز

تثبيت التطبيق

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

إذا لم يظهر مستودع معين عند إنشاء مشروع، فمن المؤكد أن التطبيق لم يُمنح صلاحيات لهذا المستودع تحديدًا؛ وهذه هي الحالة الأكثر شيوعًا بفارق كبير.

استخدام الرمز

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

تتم تشفير الرموز أثناء التخزين، ولا تقوم API بإعادتها أبدًا، كما لا يتم تضمينها في صادرات الإعدادات.

مشاكل GitHub

تدعم نفس الاتصال استيراد المشاكل كمهام عمل. اطلع على استيراد المهام.

ما الذي يقوم به Coroid في مستودعك؟

  • يقرأ الكود لفهمه وتعديله
  • ينشئ فرعًا لكل مهمة
  • يُرسل هذا الفرع ويفتح طلب سحب في pull request مقابل فرعك الأساسي

لا يقوم أبدًا بالتزام التغييرات بفرعك الافتراضي ولا بدمجها. تظل قواعد حماية الفروع والفحوصات المطلوبة وقواعد المراجعة كما هي دون تغيير.