إعدادات مشروع Kapsule Orbit

تعيش كل إعدادات مشروع Kapsule Orbit في علامة تبويب الإعدادات، مجمعة حسب الموضوع لسهولة البحث: المعلومات العامة، البناء والنشر، الأمان، الإشعارات، التكاملات، حدود الاستخدام، أتمتة النشر، الشبكات، القابلية للرصد، المشاركة، ومنطقة خطرة في الأسفل.

مكان الإعدادات

افتح Kapsule Orbit، انقر على المشروع، واختر Settings في شريط علامات تبويب المشروع. تصف الصفحة نفسها بأنها تقوم بتكوين اسم مشروعك وأوامر البناء وتكامل Git، وهذا لا يعكس كل إمكانياتها.

هذا الدليل عبارة عن خريطة. عندما يكون لموضوع ما مقال خاص به، يتم الربط به بدلاً من تكراره.

عام

Project info يعرض slug عنوان URL، تاريخ الإنشاء، المستودع المتصل وعنوان URL الإنتاج، ويتيح لك تغيير Name وDescription للمشروع.

Git يحتوي على Production branch. الدفعات إلى هذا الفرع تشغل نشرات الإنتاج.

Status badge يعطيك SVG حالة نشر مباشر مع أزرار نسخ لعنوان URL والـ markdown والـ HTML، جاهزة للصق في README الخاص بك. انظر Viewing Your Project README In Orbit.

Public status page يربطك إلى تكوين صفحة الحالة. انظر Orbit Status Page.

البناء والنشر

Build settings هي الخمس حقول التي يكتشفها Kapsule Orbit تلقائياً ويمكنك تجاوزها: أمر التثبيت، أمر البناء، دليل الإخراج، دليل الجذر وإصدار Node.js. اترك حقلاً فارغاً للاحتفاظ بالقيمة المكتشفة. التفاصيل الكاملة موجودة في Configuring Your Build Command and Output Directory.

Runtime يحتوي على أربعة مفاتيح تستحق الفهم:

• Server mode يبقي آلة البناء حية تشغل أمر البدء الخاص بك بعد كل نشر. مطلوب لأي شيء يتم تصييره على الخادم بدلاً من تصدير الملفات الثابتة.
• Branch previews ينشئ بيئة تلقائياً لكل دفعة فرع ليست إنتاج أو تدريج، كل واحدة على عنوان URL خاص بها تحت branch-*.kaps.run. انظر Branch Previews.
• Auto-rollback on failure يستعيد آخر نشر إنتاج صحي إذا فشل النشر.
• Scheduled rebuild يعيد بناء الإنتاج على فترات منتظمة، من كل ساعة إلى أسبوعياً، وهو مناسب للمواقع المدارة بالمحتوى التي تحتاج إلى تحديث بدون دفعة git.

Build auto-retry يعيد قائمة البناء الذي فشل بسبب أخطاء البنية الأساسية مثل مشكلة شبكة أو انتهاء المهلة الزمنية، حتى ثلاث مرات. لا يعيد محاولة أخطاء الأكواد، لذا لا يمكنه إخفاء بناء معطوب.

Ignored paths وBranch ignore patterns توقف البناء الذي لا تحتاجه: أنماط glob للملفات التي لا ينبغي أن تؤدي تغييراتها إلى نشر، وللفروع مثل dependabot/* التي لا ينبغي أن تشغل واحداً على الإطلاق.

Git tag deploys يعيّن نمط الوسم الذي يحول دفعة وسم إلى نشر إنتاج. انظر Orbit Releases.

أتمتة النشر والحماية

Deploy protection يحتوي على بوابتين: Require approval for production، التي توقف نشرات الإنتاج المشغلة بالدفع حتى يوافق شخص ما، وRequire staging success before production، التي تحبس الإنتاج حتى ينشر التدريج نفس الالتزام بنجاح.

CI required checks يغلق النشر على CI الخاص بك. على GitHub تسرد أسماء الوظائف، وجميعها يجب أن تمر؛ على GitLab أي قيمة غير فارغة تنتظر خط الأنابيب كاملاً. فشل CI يلغي النشر.

Deploy freeze schedule يمنع نشرات المشغلة بالدفع خارج النوافذ المعتمدة، إما نهايات الأسبوع أو نطاق ساعات UTC. النشرات اليدوية وخطافات النشر لا تتأثر.

Branch protection يضيف قواعس نمط glob تمنع النشر على الفروع المطابقة حتى تمر الفحوصات الخارجية المطلوبة وبشكل اختياري يوافق إنسان.

Auto-promote staging يرقي التدريج إلى الإنتاج تلقائياً بمجرد أن يعمل لعدد مكون من ساعات مع عدم وجود فشل الصحة واجتياز الاختبارات.

كل هذه ملخصة في عرض واحد على علامة تبويب Orbit Deployment Pipeline.

بوابات الصحة والجودة

Health check يجلب المسار الذي تختاره بعد كل نشر إنتاج. رد غير 2xx في غضون 15 ثانية يستعيد النشر الصحي السابق.

Smoke tests يشغل طلبات GET مقابل ما يصل إلى عشرة مسارات مفصولة بفواصل بعد كل نشر ناجح ويسجل النجاح أو الفشل. مع الدمج مع الاستعادة التلقائية، فشل الاختبار يرجع النشر.

Performance budgets تحذر أو تفشل البناء التي تتجاوز حداً: إجمالي حجم الأثر في MB، حجم الملف الفردي بـ kB مطابق بواسطة glob، أو وقت البناء بالثواني. يتم تعيين كل ميزانية إما لتحذير أو فشل البناء.

التدريج

يحصل التدريج على مجموعة خاصة به من الطاقات: staging branch، access protection مع كلمة مرور، IP allowlist قبول عناوين IPv4 ونطاقات CIDR واحدة في السطر، auto-rollback on failure، ما إذا كان التدريج inherits production environment variables بأولوية أقل، وbuild overrides للتثبيت والبناء والإخراج والدليل الجذر.

كلمة المرور وقائمة IP allowlist هما الاثنان يجب تعيينهما على أي بيئة تدريج لا تقصد أن تكون عامة. اترك كليهما فارغة وعنوان URL التدريج يمكن الوصول إليه من قبل أي شخص لديه.

الشبكات

Custom domains يضيف وينسق النطاقات لبيئة الإنتاج، بما في ذلك توفير الشهادات. انظر Adding a Custom Domain to Orbit.

Redirects and rewrites هي قواعس مستندة إلى المسار المطبقة قبل الخدمة، اختبرت بالترتيب مع فوز المطابقة الأولى. إعادة توجيه ترسل المتصفح إلى عنوان URL جديد كـ 301 أو 302؛ إعادة كتابة تخدم مسار مختلف صامتاً بدون تغيير عنوان URL. تدعم الأنماط المطابقات الدقيقة والأحرف البدلية والمعاملات المسماة والشقوق. انظر Redirects and Rewrites in Orbit.

Response headers تطبق رؤوس HTTP مخصصة على المسارات المطابقة، مع الإعدادات المسبقة لـ HSTS و CSP و no-embed و no-sniff وسياسة الإحالة و CORS. يتم تطبيق جميع قواعس المطابقة، والمدخلات اللاحقة تستبدل المدخلات السابقة للمفتاح نفسه.

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

The config store يحتوي على إعدادات key/value التي يقرأها النشر الخاص بك أثناء وقت التشغيل، لأعلام الميزات والإعدادات التي تتغير بدون إعادة نشر. يتم إدارتها تحت التخزين، وليس هنا، وهي مجانية: لا توجد رسوم قراءة ولا رسوم كتابة. يتم تخزين القيم في نص عادي، لذا لا تضع أبداً سراً في واحد. ما يصل إلى 100 إدخال لكل مشروع، مفاتيح تصل إلى 200 حرف وقيم تصل إلى 4096. يتم أخذ لقطة ليلية من كل إدخال ويتم الاحتفاظ بثلاثين ليلة على كل خطة، لذا يمكن استعادة إدخال تحذفه: انظر Snapshots and restore.

الاستخدام والحدود

Build usage يعرض البناء الذي شغله هذا المشروع.

Spending cap يعيّن الحد الأقصى للنفقات الشهرية الإضافية، بما يغطي البناء بالدقيقة والنطاق الإضافي خارج تخصيص الخطة الخاص بك. الحد الأدنى هو US$6.32 والحد الأقصى US$6,315.79. تطلق التنبيهات عند 50% و 80%، وعند 100% يتوقف الخدمة حتى ترفع الحد. انظر Orbit Spending Cap.

Build spending cap هو الحد الأكثر بساطة والمنفصل: حد أقصى شهري على إجمالي دقائق البناء، وبعده يتوقف البناء الجديد عن الانتظار حتى الشهر القادم أو ترفع الحد.

Artifact retention يعيّن عدد قطع البناء الناجحة للاحتفاظ بها لكل بيئة. يتم حذف الأقدم يومياً، والنشر المباشر حالياً يتم الاحتفاظ به دائماً بغض النظر عن الحد.

Preview expiry يوقف بيئات المعاينة مؤقتاً بعد 7 أو 14 أو 30 أو 60 يوماً، أو لا يفعل ذلك. تم استعادة تخزين المعاينات المتوقفة مؤقتاً في غضون 24 ساعة.

Artifact size alert يرسل لك بريداً إلكترونياً عندما تتجاوز قطعة بناء حجماً عيّنته.

الإشعارات والتكاملات والقابلية للرصد

Deploy email notifications لها ثلاثة إعدادات: جميع النشرات أو الفشل فقط أو إيقاف. يمكن تعيين notification webhook URL جنباً إلى جنب معه، النشر على كل نجاح أو فشل.

Notification channels هي النسخة الأغنى، مع اختيار حسب الحدث، سجل الإسلام وزر اختبار. التحكم الكامل في webhook موجود في علامة تبويب خاصة به: انظر Orbit Webhooks.

Deploy hooks ينشئ عناوين URL سرية تشغل النشر عندما يرسل شيء POST إليها. انظر Triggering Deployments Via Deploy Hooks.

Log drains ترسل سجلات البناء إلى منصة القابلية للرصد الخاصة بك بعد كل نشر، مع دعم مدمج لـ Datadog و Logtail و Axiom و New Relic، أو webhook مخصص، اختياري مصفى لبيئة واحدة.

Web Analytics يعطيك مقطع جمع Core Web Vitals. انظر Orbit Web Vitals.

Cron triggers يجدول طلبات HTTP إلى بيئة مختارة، حتى عشرة لكل مشروع. النسخة الأكبر والخاصة بالإنتاج فقط موجودة في علامة تبويب خاصة بها: انظر Orbit Cron Jobs.

المشاركة والفريق

Team يدير المتعاونين مع ثلاثة أدوار: admin و developer و viewer.

Share links تولد روابط مؤقتة بدون كلمة مرور بحيث يمكن لمراجع خارجي عرض بيئة بدون كلمة مرور أو حساب. كل رابط يمكن أن ينتهي في 1 ساعة أو 24 ساعة أو 7 أيام أو لا يفعل أبداً، ويعرض عدد زياراته. اسحب واحداً في أي وقت.

Deployment group ينضم هذا المشروع إلى مجموعة بحيث تنشر المشاريع ذات الصلة معاً، اختياري مصفى حسب الفرع.

Clone environment وClone project نسخ التكوين. استنساخ مشروع ينسخ إعدادات البناء وتكوين البيئة ومتغيرات البيئة غير السرية؛ الأسرار لا تُنسخ.

منطقة الخطر

Clear build cache يحذف التبعيات المخزنة مؤقتاً لكل بيئة، بحيث يشغل النشر التالي تثبيت كامل من الصفر. لا يمكن التراجع عنه، على الرغم من أن ذاكرة التخزين المؤقت إعادة نفسها على البناء التالي.

Transfer project ينقل المشروع إلى حساب Kapsule آخر. انظر Transferring an Orbit Project.

Archive project يوقف خدمة المرور فوراً. يمكن استعادته في غضون 30 يوماً من قائمة Kapsule Orbit، وبعدها يتم حذفه بشكل دائم.

الأماكن المراد الذهاب إليها التالية

• Orbit Deployment Pipeline لرؤية تأثير كل إعداد في عرض واحد.
• Shared Environment Variable Groups للقيم المستخدمة عبر المشاريع.
• Orbit Plan Limits لما تسمح به خطتك.