قم بتثبيت تطبيق GitHub الخاص بـ Zinn® حتى نتمكن من النشر دون رمز مميز طويل الأجل

ما الذي يوفره لك ربطه

يتيح لك تثبيت تطبيق Zinn® GitHub نشر الموقع من مستودعاتك — ومزامنة لوحة المشروع باستمرار مع GitHub — دون تسليمنا رمزًا شخصيًا. فنحن نحتفظ فقط بـ رقم التثبيت الخاص بالتطبيق، وهو رقم عديم الفائدة بمفرده، ونقوم بإصدار رمز يستمر لمدة ساعة في كل مرة نحتاج فيها إلى واحد. وهو الخيار الأفضل للمؤسسات، لأنه لا يتبع لأي شخص بعينه ولا يتوقف عن العمل عند مغادرة أحد الأشخاص.

قبل أن تبدأ

حساب على GitHub، أو حقوق المالك في المؤسسة التي ترغب في تثبيت التطبيق بها. تتطلب المؤسسات التي تمنع تطبيقات الطرف الثالث موافقة المالك للسماح بذلك؛ وإذا لم يكن ذلك ممكنًا، فاستخدم رمزًا دقيق الصلاحيات (fine-grained token) بدلاً من ذلك (Connect your GitHub account).

1. أنشئ المفتاح في GitHub

لا يوجد مفتاح لإنشائه. ثبّت تطبيق Zinn® GitHub على حسابك الشخصي أو مؤسستك، واختر إما جميع المستودعات أو فقط تلك التي تريد منا نشرها.

ثم ابحث عن رقم التثبيت:

• الحساب الشخصي — Settings ← Applications ← Installed GitHub Apps، ثم Configure بجوار تطبيق Zinn®.
• المؤسسة — Your organizations ← Settings ← GitHub Apps، ثم Configure بجوار تطبيق Zinn®.

الرقم الموجود في نهاية شريط العناوين في تلك الصفحة — على سبيل المثال github.com/settings/installations/12345678 — هو رقم التثبيت.

2. اربطه هنا

يتم اختيار التطبيق في المكان الذي يُستخدم فيه بدلاً من شاشة Integrations:

• في اتصال مستودع الموقع، اختر GitHub (app install).
• في رابط GitHub الخاص بلوحة المشروع، اختر The Zinn® GitHub app.

الصق رقم التثبيت (Installation number) وتابع. نقوم بالتحقق من التثبيت قبل حفظ أي شيء؛ فالرقم الذي يتعذر علينا الوصول إليه لا يتم تخزينه أبدًا.

ما يحدث بعد ذلك

• تظهر المستودعات التي منحت التطبيق الوصول إليها ليتمكن الموقع من النشر منها، ويؤدي كل إرسال (push) إلى نشره.
• يظهر كل إجراء نتخذه في سجل التدقيق الخاص بالتثبيت على GitHub تحت اسم التطبيق، وليس اسمك.
• لمنحنا المزيد من المستودعات، قم بتغيير صلاحية وصول التطبيق إلى المستودعات من صفحة Configure نفسها — ولا يلزم إعادة ربط أي شيء.

إذا لم يتم الاتصال

أحد المستودعات مفقود. يشمل التثبيت فقط المستودعات التي اخترتها. افتح Configure وأضفه.

تم رفض الرقم. تحقق من أنه رقم التثبيت المأخوذ من شريط العناوين، وليس معرف (ID) التطبيق نفسه، وأن التطبيق لا يزال مثبتًا — فالتطبيق الذي تم إلغاء تثبيته لا يملك أي تثبيت.

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

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

إلغاء الاتصال

افتح Integrations، وابحث عن الحساب واضغط على Disconnect. يؤدي ذلك إلى حذف المفتاح المخزن فورًا. سيتوقف أي شيء كان يستخدمه عند إجرائه التالي، وستوضح الشاشات التي كانت تعتمد عليه ذلك بدلاً من أن تفشل دون إشعار.

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