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