نشر معاينة الفروع في Orbit

Branch previews build every non-production, non-staging branch you push to its own isolated URL, so you can click through a change in a real environment before it merges. This guide covers turning…

تفعيل معاينات الفروع

افتح مشروعك في Orbit.
افتح علامة التبويب Settings.
ابحث عن قسم Runtime وشغّل Branch previews.

بعد التفعيل، كل push إلى فرع ليس فرع الإنتاج أو الـ staging يؤدي إلى بناء نشر على بيئة معاينة خاصة به.

مفتاح معاينات الفروع في إعدادات مشروع Orbit

معاينات الفروع هي مفتاح لكل مشروع، وليست إضافة مدفوعة. إنها متاحة على كل خطط Orbit، بما فيها خطة Launch المجانية. ما يختلف حسب الخطة هو عدد البيئات التي يمكن لمشروع واحد أن يملكها في نفس الوقت: Launch يسمح بـ 2 (الإنتاج بالإضافة إلى معاينة واحدة)، و Liftoff بـ 4، و Apex بـ 11. عندما يصل مشروع إلى حد البيئات الخاص به، لن تحصل الفروع الإضافية على معاينة خاصة بها إلى أن تحذف واحدة.

عناوين معاينة الفروع

تحصل معاينة على اسم مضيف مشتق من اسم الفرع: يتم تحويل الاسم إلى أحرف صغيرة، كل حرف ليس حرفًا أو رقمًا أو شرطة يصبح شرطة، وسلاسل الشرطات تنضغط، والنتيجة تُقطع إلى 48 حرفًا وتُسبق بـ branch-.

الفرع	اسم مضيف المعاينة
`redesign`	`branch-redesign.kaps.run`
`feat/new-checkout`	`branch-feat-new-checkout.kaps.run`
`JB/Fix_Cart`	`branch-jb-fix-cart.kaps.run`

عناوين المعاينة قابلة للوصول علنًا من أي شخص لديه الرابط. لا تُفهرس أو تُعلن عنها، لكنها أيضًا غير محمية بالوصول. لا تستخدم معاينة لمراجعة أي شيء يجب ألا يغادر فريقك، ولا توجه معاينة إلى بيانات الإنتاج. إذا كنت تحتاج إلى بيئة ما قبل الإنتاج محمية، استخدم بيئة staging بدلاً من ذلك: staging تدعم كلمة مرور وقائمة IP تحت Settings، في أقسام Staging: access protection و Staging: IP allowlist.

حيث تظهر المعاينات

علامة التبويب Overview للمشروع تحتوي على قسم Preview deployments يسرد كل معاينة نشطة. كل صف يعرض:

اسم الفرع، وشارة PR #number تربط إلى طلب السحب عندما يكون للفرع واحد مفتوحًا
الحالة الحالية (QUEUED أو BUILDING أو مباشرًا)
كم من الوقت مضى منذ نشره
رابط لفتح عنوان معاينة الفرع
View logs لفتح صفحة تفاصيل النشر
زر حذف

كل معاينة هي بيئة معزولة تمامًا مع عنوان خاص بها، وبناء خاص بها، ومتغيرات بيئة خاصة بها. لا يمكن لأي شيء تفعله أن يؤثر على الإنتاج.

علامة التبويب Branches للمشروع تعطي نفس المعلومات منظمة لكل فرع، وهو أسهل للمسح الضوئي عندما يكون لديك عدة فروع مفتوحة في نفس الوقت.

متغيرات البيئة في المعاينات

هذا هو الجزء الذي يستحق الاهتمام. متغير مشروط بـ All environments (project-wide) يُحقن في معاينة البناء، وعنوان معاينة عام.

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

الميكانيكا الكاملة، بما في ذلك كيفية إضافة متغير يقتصر على الإنتاج وكيفية عمل وراثة staging، موجودة في Setting Environment Variables Per Environment.

سجلات البناء للمعاينة

انقر على View logs بجوار أي معاينة لفتح صفحة تفاصيل النشر الخاصة بها. تحصل المعاينات على نفس المعاملة مثل نشرات الإنتاج: سجل بناء بث كامل، مراحل البناء، الالتزام والمؤلف، حجم القطع، إصابة الذاكرة أو بناء بارد، الإطار المكتشف ومدير الحزم، وزر التشخيص AI عندما يفشل البناء.

حذف معاينة

انقر على زر الحذف في صف المعاينة وأكّد.

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

التنظيف التلقائي

لا تضطر إلى تنظيف آثارك.

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

يمكنك أيضًا جعل المعاينات تنتهي صلاحيتها حسب الجدول الزمني. في Settings، ابحث عن Preview expiry واختر Never أو 7 أو 14 أو 30 أو 60 يوم. المعاينات الأقدم من ذلك توقفت تلقائيًا وتنظف في غضون 24 ساعة.

في مستودع مشغول، اضبط Preview expiry على 14 أو 30 يوم. كل معاينة نشطة تُحتسب مقابل حد البيئة في مشروعك، والمنتهية الصلاحية هي السبب المعتاد لفشل فرع جديد بهدوء في الحصول على معاينة.

الموافقة والمعاينات

إذا كان Require approval for production مفعلاً تحت Deploy protection، ينطبق على الإنتاج فقط. معاينات البناء لا تُعقد للموافقة.

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

استكشاف الأخطاء والإصلاح

تم الضغط على فرع لكن لم تظهر معاينة. تحقق، بالترتيب: هل Branch previews مفعل في Settings، ثم Runtime؟ هل الفرع فعلاً فرع الـ staging الخاص بك (staging ينشر إلى staging، وليس إلى معاينة)؟ هل الفرع مطابق لأحد Branch ignore patterns الخاصة بك، على سبيل المثال dependabot/*؟ هل المشروع بالفعل في حد البيئة الخاص به لخطتك؟

تم بناء المعاينة لكنها تعرض 404. البناء نجح لكن دليل الإخراج قد يكون خاطئًا لهذا الفرع. تحقق من Output directory في Settings، وتذكر أن فرع يمكن أن يغير إخراج البناء دون تغيير الإعداد. انظر Configuring Your Build Command and Output Directory.

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

معاينة طلب السحب المغلق لا تزال قابلة للوصول. التوقف يحدث في حدث webhook. إذا انقطع اتصال المزود عندما أغلقت طلب السحب، الحدث لم يصل أبدًا. احذف المعاينة يدويًا من علامة التبويب Overview.

قراءة ذات صلة

Deploying Your Project
Setting Environment Variables Per Environment
Orbit Plan Limits لمخصص البيئة على كل خطة