Orbit
خط أنابيب نشر Orbit
The Pipeline tab is a single page that answers "what happens when we push". It shows every way a deploy can be triggered, every gate that can stop one, the state of each environment, and which build…
يعتبر تبويب Pipeline صفحة واحدة تجيب على سؤال "ما الذي يحدث عندما نقوم بالدفع". تعرض كل طريقة يمكن تشغيل النشر بها، وكل بوابة يمكن أن توقفه، وحالة كل بيئة، وميزات البناء المفعلة، وكل ذلك يتم قراءته من إعدادات مشروعك الحقيقية.
حيث يقع خط الأنابيب
افتح Orbit، انقر فوق المشروع، واختر Pipeline ضمن مجموعة Deployments في شريط تبويب المشروع. تحمل الصفحة عنوان Deployment pipeline.
وهي لوحة تحكم للقراءة فقط. لا يتم تكوين أي شيء هنا؛ كل قسم يرتبط بالمكان الذي يوجد فيه الإعداد فعليًا. هذه قيمتها: شاشة واحدة لفهم المشروع، بدلاً من قراءة ثماني بطاقات إعدادات.
التنبيهات في الأعلى
يظهر لافتتان عندما تنطبقان:
- Deploy lock active (قفل النشر نشط)، مع رابط Manage (إدارة). يتم تخطي النشر المشغل بالدفع.
- N deployments awaiting approval (عدد من النشرات في انتظار الموافقة)، مع رابط Review (مراجعة). يحتاج شخص ما إلى الموافقة أو رفض النشرات.
إذا كان أي منهما معروضًا وتتساءل عن سبب عدم نشر الدفع، فقد وجدت إجابتك دون الحاجة للقراءة أكثر.
إحصائيات البناء
تعرض لوحة مدمجة، على البنيات الأخيرة: معدل النجاح، ومتوسط وقت البناء، وعدد البنيات الناجحة. إنها فحص صحة وليست تحليلاً. للصورة الكاملة، انظر Orbit Project Analytics و Orbit Build Insights.
مصادر التشغيل
يسرد هذا القسم كل طريقة للدخول إلى نشر لهذا المشروع:
| المصدر | ما تعرضه |
|---|---|
| Git push | المستودع المتصل، أو No repo connected (لا يوجد مستودع متصل) |
| Branch previews | ما إذا تم إنشاء معاينات تلقائيًا على أي فرع |
| Git tag | نمط الوسم، إن كان مكونًا |
| Manual deploy | متاح دائمًا |
اقرأ هذا كلما فوجئت بنشر. إذا ظهر بناء ولم يقم أحد بالدفع، فإن أحد هذه هو التفسير: وسم أو خطاف نشر أو شخص يضغط على زر.
البوابات والأمان
أكبر قسم هو قائمة البوابات، حيث تعرض كل منها حالتها الحالية مع رابط Configure (تكوين) لبطاقة الإعدادات ذات الصلة.
| البوابة | ما تفعله |
|---|---|
| Approval gate | يتطلب نشر الإنتاج موافقة صريحة |
| Staging prerequisite | يُنتظر في الإنتاج حتى يكتمل الاختبار على نفس الالتزام |
| CI checks | الفحوصات المطلوبة التي يجب أن تمر، أو No checks required (لا توجد فحوصات مطلوبة) |
| Freeze window | عطلات نهاية الأسبوع محجوبة، ساعات مخصصة، أو لا توجد جدولة تجميد |
| Deploy lock | نشط، أو لا يوجد قفل |
| Health check | المسار الذي يتم فحصه بعد النشر، أو Disabled (معطل) |
| Auto-rollback | يعود عند فشل فحص الصحة |
| Skew protection | نافذة الاحتفاظ للأصول القديمة |
| Auto retry | عدد المرات التي يتم فيها إعادة محاولة أخطاء البنية الأساسية |
تنطبق معظم هذه البوابات فقط على النشرات المشغلة بالدفع. النشرات اليدوية من اللوحة وخطافات النشر تمر مباشرة. يتصرف الاستثناء بشكل مختلف، وتفاصيل كل بوابة مغطاة في Deploying Your Project. اقرأ ذلك قبل أن تعتمد على بوابة كعنصر تحكم.
قراءة البوابات كقائمة تحقق
بالنسبة لمشروع مهم، فإن الأساس المعقول هو:
- Health check: قم بتعيينه، موجهًا إلى مسار يمارس التطبيق بدلاً من قشرة مخزنة مؤقتًا.
- Auto-rollback: تشغيل. بدون فحص صحة، ليس لديه شيء للتصرف بشأنه، لذلك يعمل الاثنان معًا.
- Auto retry: واحد أو اثنين. يعيد قائمة البنيات التي فشلت على أخطاء البنية الأساسية مثل انقطاع الشبكة، ولا يعيد محاولة أخطاء الكود، لذا لا يكلفك شيئًا سوى الوقت الموفر.
- Approval gate: تشغيل لأي شيء حيث يكون النشر السيء مكلفًا، إيقاف حيث يبطئك أكثر مما يحميك.
إذا كانت الصفحة تعرض Health check Disabled (معطل) و Auto-rollback مشغل، فإن هذا المزيج لا يفعل شيئًا. إنه أحد أسهل الأخطاء في التكوين التي يمكن أن تستمر لعدة أشهر دون ملاحظة، وهذه الصفحة هي حيث تكتشفها.
تدفق البيئة
يرسم قسم Environment flow (تدفق البيئة) كل بيئة كبطاقة مع حالتها الحالية: LIVE (مباشر)، BUILDING (قيد البناء) أو PAUSED (موقوف)، والفرع الذي تتابعه، ورقم إعادة المحاولة إذا كان النشر الحالي عبارة عن إعادة محاولة.
تعرض الشارات على كل بطاقة ما يتم تفعيله لتلك البيئة:
- Smoke tests: طلبات GET يتم تشغيلها على المسارات المختارة بعد كل نشر ناجح.
- Auto-promote: ترقية الاختبار إلى الإنتاج بعد عدد من الساعات الصحية.
- Canary: نسبة مئوية من حركة المرور على نشر كناري.
- Inherits prod vars: حيث يدمج الاختبار متغيرات بيئة الإنتاج بأولوية أقل.
- Scheduled rebuild: حيث يعاد بناء الإنتاج على فترات.
ترتبط كل بطاقة بنشرات تلك البيئة. إذا قالت بيئة No deployments yet (لا توجد نشرات حتى الآن)، فهي موجودة في التكوين لكن لم يتم شحن أي شيء إليها.
الميزات النشطة
يلخص القسم الأخير إعدادات مستوى البناء:
| الميزة | القيم |
|---|---|
| Server mode | SSR مفعل أو ثابت فقط |
| Auto-create on push | ما إذا كانت دفعات الفرع تنشئ بيئات |
| Health checks | قيد التشغيل أو إيقاف |
| Build retry | حد أقصى، أو إيقاف |
| Deploy groups | مجمع مع مشاريع أخرى، أو مستقل |
| Build timeout | الحد الزمني لكل بناء |
| Preview expiry | أيام قبل توقيف المعاينات، أو أبدًا |
Server mode هو ما يقع فيه الناس. يحتاج الإطار الذي يعرض على الخادم إلى تشغيله؛ التصدير الثابت لا يحتاج إليه. إذا كان مشروعك يبني بشكل جيد ثم يعرض صفحة فارغة أو 404 على كل مسار ما عدا الصفحة الرئيسية، فتحقق من هذا أولاً. انظر Frameworks Orbit Supports.
Preview expiry هو عنصر الصيانة. إذا تم تعيينه لأبدًا، فإن بيئات المعاينة تتراكم بلا حدود.
استخدام صفحة خط الأنابيب
عند إدراج شخص ما. أرسله هنا أولاً. إنها إحاطة أسرع وأكثر دقة من أي وثيقة، لأنها يتم إنشاؤها من التكوين المباشر.
عندما لم يحدث نشر. اعمل من الأعلى إلى الأسفل: اللافتات، ثم مصادر التشغيل، ثم البوابات. سيشرح أحدها السبب.
قبل إصدار محفوف بالمخاطر. تحقق من قراءة قسم البوابات بالطريقة التي تعتقدها. هذا هو الفرق بين الاعتقاد بأن لديك auto-rollback وفعلاً امتلاكه.
أثناء حادثة. يخبرك تدفق البيئة بما هو مباشر حيث، وما إذا كان هناك أي شيء في منتصف البناء.
استكشاف الأخطاء
تعرض الصفحة No repo connected (لا يوجد مستودع متصل). المشروع ليس لديه مستودع. قم بتوصيل واحد: انظر Connecting a GitHub Repository.
بوابة مشغلة لكن النشرات تمر بأي حال. إنها مشغلة بالدفع فقط. خطاف نشر أو نشر لوحة يدوي لا يتأثر.
بيئة تعرض PAUSED (موقوف). توقف بيئات المعاينة تلقائيًا بمجرد تجاوز انتهاء صلاحيتها. أعد النشر لإرجاع واحدة.
Auto-promote معروض لكن لا شيء يعزز. يتطلب العدد المكون من الساعات الصحية مع اجتياز اختبارات الدخان، ويتم تقييمه بشكل دوري وليس فوري.
أين تذهب بعد ذلك
- Deploying Your Project لمعرفة ما تحجبه كل بوابة فعليًا.
- Orbit Project Settings لتغيير أي من ذلك.
- Rolling Back a Deployment عندما لم تنقذك بوابة.