Orbit
ربط مستودع Bitbucket
Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…
يتصل Bitbucket بـ Orbit عبر OAuth: تقوم بتفويض Kapsule مرة واحدة، وتدرج Orbit المستودعات التي يمكن لحسابك على Bitbucket الوصول إليها، وتسجل webhook لكل مستودع بحيث يؤدي كل push إلى بدء build. يغطي هذا الدليل الاتصال وتحديد المستودع وإنشاء المشروع والتحقق عند عدم ظهور مستودع.
قبل أن تبدأ
ترى Orbit فقط ما يراه حسابك على Bitbucket. بالنسبة لمستودع workspace تحتاج على الأقل إلى حق الكتابة، وحصول كافٍ لإنشاء webhook للمستودع. إذا كان workspace الخاص بك يقيد مستخدمي OAuth الجهات الخارجية، يجب على المسؤول السماح بـ Kapsule Orbit قبل نجاح الاتصال.
الخطوة 1: توصيل Bitbucket
- في KPanel، انقر على Orbit في الشريط الجانبي الأيسر.
- انقر على New project.
- اترك الوضع محددًا على Import Git Repo.
- في الخطوة 1، انقر على Connect Bitbucket.
سيتم إرسالك إلى Bitbucket لتفويض مستهلك Kapsule Orbit OAuth. امنح الأذونات المطلوبة وسيعيدك Bitbucket إلى KPanel مع تحميل مستودعاتك. ثم تعرض الخطوة 1 Just connected.
إذا فشل التفويض، ستعرض KPanel الخطأ الذي أعاده Bitbucket. اقرأه بدلاً من إعادة المحاولة بشكل عشوائي: حظر سياسة workspace والتفويض الملغى يبدوان متشابهين لكن يحتاجان إلى إصلاحات مختلفة.
الخطوة 2: تحديد مستودع
تظهر مستودعاتك التي يمكنك الوصول إليها كقائمة. انقر على Select بجانب المستودع الذي تريد نشره. المستودعات الخاصة تحمل شارة Private؛ تنشر Orbit المستودعات العامة والخاصة على حد سواء.
إذا كان المستودع مفقودًا
- تأكد من مستوى وصولك إلى المستودع. حق الوصول للقراءة غير كافٍ؛ تحتاج إلى حق write لتتمكن Orbit من تسجيل webhook الذي تحتاجه.
- تحقق من أن المستودع في workspace تنتمي إليه فعلاً، وليس واحدًا لديك رابط له فقط.
- انقر على Reconnect Bitbucket في الخطوة 1 لإعادة تشغيل OAuth flow وتحديث الرمز وقائمة المستودع.
إذا أظهرت اللوحة No repos accessible، نجح الاستدعاء لكنه لم يعد بشيء. أعد الاتصال وتأكد من أنك وافقت على نطاقات المستودع.
الخطوة 3: إعداد مشروعك
| الحقل | ما يفعله |
|---|---|
| Project Name | اسم العرض في KPanel، على سبيل المثال my-app |
| Deploy URL | النطاق الفرعي تحت kaps.run، لذلك يصبح my-app إلى my-app.kaps.run |
انقر على Create project. تستنسخ Orbit المستودع وتصف build الأول وتأخذك إلى نظرة عامة على المشروع مع سجل البث.
يتم تعيين Deploy URL slug مرة واحدة عند الإنشاء ولا يمكن تعديله لاحقًا. للخدمة تحت عنوان مختلف، أرفق مجال مخصص. انظر Adding a Custom Domain to Your Project.
النشر التلقائي
تسجل Orbit webhook على مستودع Bitbucket الخاص بك عند إنشاء المشروع. بعد ذلك:
- يؤدي الدفع إلى فرع الإنتاج الخاص بك إلى وضع نشر إنتاج في قائمة الانتظار.
- يؤدي الدفع إلى أي فرع آخر إلى بناء معزول في
branch-<branch-name>.kaps.run، إذا كان Branch previews مفعلاً في Settings تحت Runtime. انظر Branch Preview Deployments in Orbit. - يؤدي حذف فرع إلى إيقافة معاينته مؤقتًا، ويتم استعادة التخزين خلال يوم واحد تقريبًا.
لا تقوم أبدًا بإنشاء webhook أو صيانته بنفسك.
إعداد CI required checks في Orbit يحد من النشر على أسماء وظائف GitHub Actions أو خط أنابيب GitLab. لا يحد من Bitbucket Pipelines. إذا كنت بحاجة إلى Bitbucket Pipelines لتحديد متى يحدث النشر، فأوقف النشر المُطلق بـ push لهذا الفرع واجعل خط الأنابيب الخاص بك يستدعي deploy hook عند النجاح بدلاً من ذلك. انظر Triggering Deployments Via Deploy Hooks.
إعادة توصيل أو قطع Bitbucket
- انقر على Orbit، ثم New project.
- في الخطوة 1، انقر على Reconnect لإعادة تشغيل OAuth flow، أو Disconnect لإزالة الرابط.
إعادة الاتصال هي الخطوة الأولى الصحيحة عندما ينقطع عرض المستودع، لأن رموز OAuth تنتهي وإعادة الاتصال تنشئ رمزًا جديدًا.
قطع الاتصال يحتفظ بمشاريعك وسجل نشرها، والنشر المباشر يستمر في خدمة حركة المرور. يتوقف النشر المُطلق بـ push. توقف deploy hooks أيضًا، لأن hook يقرأ رأس الفرع عبر اتصال المزود لتقرير ما سيتم بناؤه.
قراءة ذات صلة
- Deploying Your Project لدورة النشر الكاملة، أقفال النشر والموافقات
- Configuring Your Build Command and Output Directory إذا فشل البناء الأول أو نشر المجلد الخطأ
- Connecting a GitHub Repo و Connecting a GitLab Repo للمزودين الآخرين