ما يفعله الاتصال من أجلكم
يتيح ربط Bitbucket للموقع النشر من أحد مستودعات Bitbucket Cloud الخاصة بكم: قوموا بالدفع إلى الفرع وسيتم تحديث الموقع.
قبل أن تبدأوا
حساب Bitbucket Cloud مع إمكانية الوصول إلى المستودعات التي ترغبون في نشرها.
1. إنشاء المفتاح في Bitbucket
يوفر Bitbucket نوعين من بيانات الاعتماد، وكلاهما يعمل:
- رمز وصول لمستودع أو مشروع أو مساحة عمل، يتم إنشاؤه من إعدادات ذلك المستودع أو المشروع أو مساحة العمل نفسها ضمن رمز الوصول (Access tokens). إنه مرتبط بهذا المستودع أو المشروع أو مساحة العمل بدلاً من شخص معين. امنحه حق الوصول للقراءة إلى المستودعات.
- رمز واجهة برمجة التطبيقات (API) على حساب Atlassian الخاص بكم. حددوا ملفكم الشخصي، ثم إعدادات الحساب (Account settings) ← الأمان (Security) ← إنشاء رموز API وإدارتها (Create and manage API tokens) ← إنشاء رمز API بنطاقات (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). يؤدي هذا إلى حذف المفتاح المخزن في الحال. يتوقف أي شيء كان يستخدمه عند إجرائه التالي، وتوضح الشاشات التي تعتمد عليه ذلك بدلاً من الفشل بصمت.
لا يؤدي قطع الاتصال إلى التراجع عما تم القيام به بالفعل — فالجلات أو عمليات النشر أو الإعدادات التي قمنا بتغييرها على حسابك تبقى كما هي. إذا كنت تعتقد أن المفتاح نفسه قد تسرب، فقم بإلغائه أيضاً لدى المورد؛ قطع الاتصال يزيل نسختنا، وليس نسختهم.