اربط حسابك على GitHub برمز مميز لتتمكن مواقعك من النشر انطلاقاً من مستودع

ما يقدمه لك الربط

يتيح ربط GitHub باستخدام رمز مميز (token) إمكانية نشر الموقع من أحد مستودعاتك: قم بالدفع (push) إلى الفرع وسيتحدث الموقع. كما يتيح لنا النشر على GitHub Pages في حسابك عند اختيار ذلك كمضيف للموقع.

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

قبل أن تبدأ

حساب GitHub يمتلك صلاحية الوصول إلى المستودعات التي تريد نشرها. وإذا كانت تابعة لمؤسسة، فقد يتعين على المالك الموافقة على الرموز المميزة دقيقة الصلاحيات (fine-grained tokens) الخاصة بها.

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

في GitHub، انقر على صورتك الشخصية، ثم Settings ← Developer settings ← Personal access tokens ← Fine-grained tokens ← Generate new token. قم بتسميته وحدد تاريخ انتهاء الصلاحية. ضمن Repository access، اختر Only select repositories وحدد المستودعات التي تنشرها — وهو أضيق نطاق وصول يفي بالغرض.

ضمن Repository permissions، امنح صلاحية Read and write لكل من:

• Contents
• Pages
• Administration

اضغط على Generate token وانسخه — يعرضه GitHub لمرة واحدة فقط.

2. اربطه هنا

افتح Integrations في لوحة التحكم الخاصة بك واختر Connect an account. اختر Code hosting كمجموعة وGitHub كحساب، واملأ API token، واضغط على Connect account.

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

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

• يمكن للموقع النشر مباشرة من مستودع في هذا الحساب: اختره من

اتصال مستودع الموقع، وحدد المستودع والفرع، وستؤدي كل عملية دفع إلى النشر.

• يمكن لكل فرع آخر الحصول على معاينة خاصة به، حتى تتمكن من مراجعة التغيير قبل وصوله إلى

الموقع المباشر.

• تستخدم مضيفات المواقع الثابتة المبنية على Git مثل Render وAzure Static Web Apps هذا الاتصال

كمصدر للتعليمات البرمجية للموقع.

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

لا يظهر المستودع. لا يتضمن نطاق وصول الرمز المميز للمستودع هذا المستودع. قم بتعديل الرمز المميز في GitHub وأضف المستودع.

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

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

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

قطع الاتصال

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

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