اربط حساب Bitbucket الخاص بك حتى يتم نشر مواقعك من مستودع

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

يتيح ربط Bitbucket للموقع إمكانية النشر انطلاقاً من أحد مستودعات Bitbucket Cloud الخاصة بكم: ادفعوا التغييرات إلى الفرع وسيتم تحديث الموقع.

قبل أن تبدأوا

حساب Bitbucket Cloud يتمتع بصلاحية الوصول إلى المستودعات التي ترغبون في نشرها.

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

يوفر Bitbucket نوعين من بيانات الاعتماد، وكلاهما يعمل بنجاح:

• رمز وصول (access token) لمستودع أو مشروع أو مساحة عمل، يتم إنشاؤه من الإعدادات الخاصة بذلك المستودع أو المشروع أو مساحة العمل تحت قسم Access tokens. وهو مرتبط بذلك المستودع أو المشروع أو مساحة العمل بدلاً من ارتباطه بشخص معين. امنحوه صلاحية القراءة للمستودعات.
• رمز API في حساب Atlassian الخاص بكم. حددوا ملفكم الشخصي، ثم Account settings ← Security ← Create and manage API tokens ← Create API token with scopes. قوموا بتسميته، وحددوا تاريخ انتهاء الصلاحية، واختاروا Bitbucket كتطبيق، ثم حددوا صلاحية القراءة للمستودعات. يعرض Bitbucket الرمز مرة واحدة فقط؛ فقوموا بنسخه حينها.

2. الربط هنا

افتحوا Integrations في لوحة التحكم الخاصة بكم واختاروا Connect an account. حددوا Code hosting كمجموعة وBitbucket كحساب، ثم املأوا API token — وإذا كنتم قد أنشأتم رمزاً على حساب Atlassian الخاص بكم بدلاً من رمز الوصول، فاكتبوا Account username أيضاً، ثم اضغطوا على Connect account.

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

يحدد اسم المستخدم كيفية إرسالنا للرمز، لذا لا تدخلوه إلا في حالة استخدام رمز حساب. سيتم رفض رمز الوصول الذي يتم إدخاله مع اسم مستخدم، أو رمز الحساب الذي يتم إدخاله بدونه.

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

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

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

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

كان يعمل ثم توقف. يمكن لكلا النوعين من الرموز أن تنتهي صلاحيتهما. أنشئوا رمزاً جديداً وقوموا بربطه.

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

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

قطع الاتصال

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

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