النشر والمعاينات والتراجع.
كيف تصبح عمليات الدفع متاحة للزوار، ومعاينات الفروع، والعودة إلى إصدار سابق، وأمر الإصدار للترحيلات، وإعدادات البناء، وروابط النشر، ووضع الصيانة، وكلمات مرور المعاينات.
بعد إطلاق التطبيق، نادرًا ما تحتاج إلى لوحة التحكم لنشر التغييرات: ادفع (push) إلى الفرع وسيصبح الإصدار الجديد متاحًا تلقائيًا. يغطي هذا المقال كل ما يتعلق بذلك — علامة التبويب النشر والمعاينات وعلامة التبويب العمليات وبعض المفاتيح في الإعدادات.
نشر تلقائي مع كل دفع
كل دفع إلى فرع التطبيق يبني آخر commit وينشره. يبدأ الإصدار الجديد بجانب الإصدار العامل ولا يستقبل الزوار إلا بعد أن يستجيب، وإذا لم يبدأ يستمر الإصدار السابق في العمل ونُبلغك بالبريد الإلكتروني (وعبر Telegram إذا ربطته).
الدفع الذي يتم بينما بناء آخر لا يزال ينتظر في الطابور ينضم إلى ذلك البناء، لذا لا تُنشئ سلسلة دفعات متتالية طابورًا طويلًا.
يمكنك إيقاف ذلك من الإعدادات ← النشر مع كل دفع. عند إيقافه، تنشر من لوحة التحكم أو عبر API أو رابط نشر.
النشر من لوحة التحكم
تعرض علامة التبويب النشر كل عمليات النشر: ما الذي بدأها (دفع، أو لوحة التحكم، أو تراجع، أو رابط نشر)، والـ commit، والمدة التي استغرقتها، وحالتها. انقر على عملية نشر لترى سجل البناء كاملًا.
يوفر إعادة النشر خيارين:
- بناء آخر commit — يأخذ أحدث كود من الفرع ويبنيه.
- نشر الإصدار العامل مجددًا — يطبّق المتغيرات المعدّلة دون بناء جديد. استخدمه بعد تعديل المتغيرات.
تحتوي القائمة بجانب فتح على الإجراءين نفسيهما إضافةً إلى إعادة التشغيل.
التراجع
يمكنك العودة إلى أي من آخر 5 إصدارات ناجحة. في علامة التبويب النشر، انقر تراجع على الإصدار الذي تريده وأكّد. يبدأ الإصدار السابق بجانب الحالي ويتولى العمل بمجرد أن يستجيب — دون بناء جديد.
لا يُلغي التراجع تغييرات قاعدة البيانات. إذا غيّر إصدارٌ بنية قاعدة البيانات، فاستعد قاعدة البيانات أيضًا — راجع قواعد البيانات.
معاينات الفروع
يحصل الدفع إلى أي فرع آخر على معاينة خاصة به — عنوان منفصل تتحقق فيه من التغييرات قبل أن تصبح متاحة للزوار. افتحها من علامة التبويب المعاينات.
- حتى 3 معاينات في وقت واحد، مشمولة في سعرك.
- تُحذف المعاينة التي لم تتلقَّ دفعات جديدة لمدة 7 أيام. وتُنشأ مجددًا مع الدفع التالي إلى ذلك الفرع.
- تحصل المعاينات فقط على المتغيرات المخصصة لها — راجع متغيرات البيئة.
- تُنشأ المعاينات للخدمة الرئيسية في المشروع، وليس لخدماته الأخرى.
كلمة مرور للمعاينات
في علامة التبويب المعاينات، كلمة مرور المعاينات ← طلب كلمة مرور. أدخل اسم مستخدم وكلمة مرور (8 أحرف على الأقل). من الآن فصاعدًا لا يفتح المعاينات إلا من لديه كلمة المرور، ويبقى التطبيق نفسه مفتوحًا للجميع.
أمر الإصدار (الترحيلات)
علامة التبويب العمليات ← أمر الإصدار. يُنفَّذ مرة واحدة مع كل نشر، قبل أن يستقبل الإصدار الجديد الزوار — وعادةً ما يكون ترحيلات قاعدة البيانات. إذا فشل، يتوقف النشر ويستمر الإصدار الحالي في العمل، فلا يصل ترحيل معطوب إلى زوارك أبدًا.
نقترح أمرًا لأُطر العمل التي لديها أمر كهذا:
| إطار العمل | أمر الإصدار الموصى به |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
يحتفظ استخدام الأمر الموصى به به، ويمكنك أيضًا إدخال أمرك الخاص أو اختيار لا شيء. تُطبَّق التغييرات من النشر التالي.
إعدادات البناء
يتيح لك الإعدادات ← إعدادات البناء تغيير ما اكتشفناه:
- أمر التثبيت — مثل
npm ci - أمر البناء — مثل
npm run build - أمر التشغيل — الأمر الذي يشغّل تطبيقك. يجب أن يستمع على المنفذ الموجود في
$PORT. - مجلد المخرجات — للمواقع الثابتة، المجلد الذي يحتوي على الملفات المبنية.
- مجلد المشروع — لمستودع يضم عدة مشاريع.
اترك الحقل فارغًا لاستخدام ما اكتشفناه. يُبنى النشر التالي بالإعدادات الجديدة، ويبدأه البناء الآن فورًا.
يحتوي الإعدادات أيضًا على الفرع الذي يُنشر.
روابط النشر
الإعدادات ← روابط النشر ← إنشاء رابط. رابط النشر عنوان خاص: عندما ترسل إليه خدمة أخرى طلب POST، يُبنى آخر commit من فرعك ويُنشر. من الاستخدامات الشائعة نظام CMS يعيد بناء الموقع بعد النشر فيه.
curl -X POST "<عنوان الرابط من لوحة التحكم>"- يُعرض العنوان مرة واحدة — انسخه عند إنشاء الرابط. يستطيع أي شخص لديه العنوان بدء نشر، لذا احتفظ به سرًا.
- حتى 10 عمليات نشر في الساعة لكل رابط. والطلب الذي يصل بينما بناء لا يزال ينتظر ينضم إليه.
- يوقف إلغاء العنوان فورًا، وتحتاج الخدمات التي تستدعيه بعدها إلى عنوان جديد.
وضع الصيانة
الإعدادات ← وضع الصيانة ← عرض صفحة الصيانة. يرى الزوار صفحة قصيرة برسالتك بدلًا من التطبيق، واترك الرسالة فارغة لعرض «نجري بعض التحسينات. يُرجى العودة بعد قليل.»
يستمر التطبيق نفسه في العمل، لتتمكن من التحقق من كل شيء قبل فتحه مجددًا. يعرض رابط خاص لك التطبيق كالمعتاد على الجهاز الذي يفتحه، لمدة 12 ساعة. ويُنشئ رابط جديد رابطًا جديدًا، ويتوقف الرابط القديم عن العمل.
أوقف المفتاح لفتح التطبيق للزوار مجددًا.
إشعارات النشر
نراسلك بالبريد الإلكتروني (ونرسل رسالة Telegram إذا ربطته) عندما لا يكتمل النشر. ولإرسال الأحداث إلى فريقك أيضًا — إصدار جديد أصبح متاحًا، نشر لم يكتمل، خدمة توقفت أو عادت، استخدام مرتفع للذاكرة أو المعالج، نسخة احتياطية أو قرص قاعدة بيانات — أضف Slack أو Discord أو webhook خاصًا بك في الإعدادات ← إشعارات فريقك. رسائل webhook بصيغة JSON وموقّعة بمفتاح سري يُعرض مرة واحدة، في الترويسة X-Rivervo-Signature.