اربِط حسابك على GitLab لتُنشر مواقعك من مستودع

ما يوفره لك ربط الحساب

يتيح لك ربط GitLab نشر الموقع من أحد مستودعات GitLab الخاصة بك، كما يتيح لنا النشر على GitLab Pages على حسابك عند اختياره كمستضيف للموقع.

قبل أن تبدأ

حساب GitLab يمتلك حق الوصول إلى المشاريع التي ترغب في نشرها.

1. إنشاء المفتاح في GitLab

في GitLab، حدد صورتك الرمزية في أعلى اليمين، ثم Edit profile ← Access ← Personal access tokens، وقم بإنشاء رمز مميز جديد (قد يُطلق GitLab على هذا الخيار اسم Legacy token في قائمة Generate token). قم بتسميته، وحدد تاريخ انتهاء الصلاحية، وضع علامة اختيار على هذه النطاقات:

• api
• write_repository

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

2. ربطه هنا

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

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

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

• يمكن نشر الموقع مباشرة من مستودع على هذا الحساب: اختره من اتصال مستودع الموقع، وحدد المستودع والفرع، وستؤدي كل عملية دفع (push) إلى النشر.
• يمكن لكل فرع آخر الحصول على معاينة خاصة به، حتى تتمكن من التحقق من التغيير قبل وصوله إلى الموقع المباشر.
• تستخدم منصات الاستضافة الثابتة المعتمدة على Git مثل Render وAzure Static Web Apps هذا الاتصال كمصدر للرمز البرمجي للموقع.

في حال عدم الاتصال

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

نطاق مفقود. لا يمكن تغيير نطاقات الرمز المميز بعد إنشائه؛ أنشئ رمزًا جديدًا مع وضع علامة اختيار على كلا النطاقين.

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

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

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

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

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