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