خدمات المشروع: خدمات الويب والعمّال والمهام المجدولة.
أضف عمّالًا خلفيين ومهامًا مجدولة وخدمات ويب إضافية وقواعد بيانات وValkey إلى المشروع — من شيفرته أو من مستودع آخر أو من صورة جاهزة — يمكن الوصول إليها بالاسم وفي فاتورة واحدة.
المشروع أكثر من عملية واحدة. إلى جانب التطبيق الرئيسي يمكنك تشغيل عامل طوابير، ومهمة ليلية، وواجهة API مستقلة، وقاعدة بيانات — كلٌّ منها خدمة بمواردها الخاصة، وكلها في فاتورة واحدة.
تُعرض الخدمات في التطبيق: نظرة عامة ← الخدمات ← إضافة خدمة. يمكن أن يضم المشروع حتى 10 خدمات. يجب إطلاق الخدمة الرئيسية أولًا، ويجب أن يكون اشتراك المشروع نشطًا (والتجربة تُحتسب).
أنواع الخدمات
| النوع | ما هو |
|---|---|
| خدمة ويب | موقع آخر أو API — بعنوان عام أو داخلي فقط |
| عامل خلفي | يعمل باستمرار: الطوابير وHorizon وCelery والمستهلكون |
| مهمة مجدولة | تبدأ وفق جدول (بصيغة cron، بتوقيت UTC)، تؤدي عملها ثم تتوقف |
| PostgreSQL وMySQL وValkey | قواعد بيانات مُدارة — راجع قواعد البيانات |
| NATS وRabbitMQ | وسطاء رسائل للأحداث والطوابير، داخلية فقط — راجع الأحداث والطوابير |
عنوان عام أو داخلي فقط
عند إضافة خدمة ويب، اختر طريقة الوصول إليها — لا يوجد خيار محدد مسبقًا:
- عنوان عام — متاحة من الإنترنت على
https://<name>.rivervo.app؛ ويمكن أن تكون لها نطاقاتك الخاصة. - داخلي فقط — بلا عنوان على الإنترنت وبلا نطاقات؛ ولا تصل إليها إلا الخدمات الأخرى في التطبيق. مناسبة لواجهة API خلف موقعك، أو واجهة إدارة خلفية، أو محرك بحث.
العمّال الخلفيون والمهام المجدولة وقواعد البيانات ليست عامة أبدًا، لذا لا خيار لها. ويمكنك تغيير ذلك لاحقًا من الإعدادات ← العنوان العام في الخدمة — راجع التواصل بين الخدمات.
مصدر الشيفرة
شيفرة هذا المشروع
الشيفرة نفسها تُشغَّل بطريقة أخرى: عامل طوابير، أو مُجدوِل، أو خادم WebSocket (مثل Laravel Reverb)، أو مجلد من مستودع أحادي، أو واجهة API مستقلة.
- الأمر مطلوب — ما تشغّله الخدمة، مثل
php artisan queue:workأوnode worker.js. - يجب أن تستمع خدمة الويب على المنفذ الموجود في
$PORT. - تحتاج المهمة المجدولة أيضًا إلى جدول بصيغة cron (بتوقيت UTC)، مثل
*/5 * * * *. - كل نسخة جديدة من الخدمة الرئيسية تُنشر إلى هذه الخدمات أيضًا، فتعمل دائمًا بالشيفرة نفسها.
مستودع آخر
خدمة ويب أو عامل خلفي من مستودع مختلف في حساب Git المرتبط، بفرعه الخاص، ومع مجلد المشروع وأوامر البناء والبدء عند الحاجة (اترك الحقل فارغًا لاستخدام ما نكتشفه). تحصل على عمليات نشر ونسخ خاصة بها، وتُنشر كل عملية push إلى فرعها. ولا تُنشأ معاينات الفروع للخدمات حتى الآن.
صورة جاهزة
خدمة ويب أو عامل خلفي من صورة جاهزة (صورة Docker) على Docker Hub أو GitHub Container Registry أو أي سجل آخر — مثل nginx:1.27 أو ghcr.io/org/app:tag.
- المنفذ — المنفذ الذي تستمع عليه الصورة؛ ونمرّره أيضًا في
$PORT. - الأمر — اختياري؛ إذا تُرك فارغًا تبدأ الصورة كما بُنيت.
- سجل خاص — اسم مستخدم وكلمة مرور أو رمز وصول. تُحفظ مشفّرة، وتُستخدم لتنزيل الصورة فقط، ولا تُعرض مجددًا.
- مع تفعيل النشر التلقائي، نتحقق مرة يوميًا مما إذا كان الوسم يشير إلى إصدار أحدث وننشره. ويفعل تنزيل الصورة مجددًا في تبويب عمليات النشر ذلك فورًا.
Kafka (قالب)
Kafka في إضافة خدمة إعداد مسبق بنقرة واحدة: ينشئ خدمة من صورة Apache Kafka الرسمية (3.9) — وسيط واحد في وضع KRaft، دون ZooKeeper. يناسب التطوير والأحمال المتوسطة.
- داخلي فقط — بلا عنوان عام وبلا وصول من الخارج؛ ولا تصل إليه إلا خدمات التطبيق.
- تحصل خدمات الشيفرة الأخرى في التطبيق على
KAFKA_BROKERS=<service name>:9092وRIVERVO_<NAME>_URL=<service name>:9092. - تُنشأ الموضوعات (topics) تلقائيًا عند أول استخدام لها.
- يبدأ بذاكرة 1 GB · نواة معالج واحدة · قرص 10 GB. ومثل أي خدمة من صورة جاهزة، يمكنك تغيير موارده ومتغيراته.
- تُحفظ بياناته في مجلد بيانات الخدمة على قرصها.
ما لا يتوفر فيه:
- وسيط واحد — بلا نسخ متماثل؛ ومعامل النسخ لكل موضوع هو 1.
- لا نسخ احتياطية مُدارة لـ Kafka. تنسخ النسخة الاحتياطية اليومية مجلد بياناته كملفات أثناء عمل Kafka. وهذه ليست نسخة احتياطية متسقة لـ Kafka: فبعد الاستعادة قد تنقص الرسائل الأخيرة، أو قد يحتاج Kafka إلى استرداد سجلاته عند بدئه.
- لا وقت صيانة، ولا وصول من الخارج، ولا واجهة Kafka UI.
- ترقية Kafka مسؤوليتك: غيّر الصورة من الإعدادات في الخدمة.
للطوابير والأحداث مع نسخ احتياطية ومتغيرات اتصال مضبوطة لك، راجع الأحداث والطوابير — NATS وRabbitMQ.
الوصول المتبادل بالاسم
تتواصل خدمات المشروع عبر شبكة خاصة بالاسم: الخدمة المسماة api تصل إليها الخدمات الأخرى بالاسم api، وقاعدة البيانات المسماة db بالاسم db، والخدمة الرئيسية بالاسم web. ولا تُحتسب حركة المرور بين خدمات المشروع ضمن حركة المرور.
تعرض كل خدمة ويب العنوان الداخلي لها — مثل http://api:8080 — وتحصل عليه الخدمات الأخرى في متغير، RIVERVO_API_URL. كيف يعمل ذلك، والخدمات الداخلية فقط، والنسخ المتعددة، والمهل: التواصل بين الخدمات.
تحصل كل خدمة على متغيرات المشروع — بما فيها اتصال قاعدة البيانات — إضافة إلى متغيراتها الخاصة التي تتقدّم على متغيرات المشروع. راجع متغيرات البيئة.
الموارد والسعر
لكل خدمة ذاكرة ومعالج وقرص خاصة بها، وتُسعَّر مثل أي تطبيق: 6.90 US$ لكل GB من الذاكرة و**4.60 US$ لكل نواة معالج** شهريًا، مع 10 GB من القرص مضمّنة لكل GB من الذاكرة، ثم 0.17 US$ لكل GB. ويمكن أن تصل ذاكرة الخدمة إلى 8 GB.
عند إضافة خدمة، يُضاف سعرها إلى فاتورة المشروع — وللشهر الحالي يُحتسب الجزء المتبقي منه فقط. وما دام المشروع في فترة التجربة المجانية، تكون الخدمات الجديدة مجانية حتى انتهاء التجربة.
تعرض نظرة عامة إجمالي المشروع — تكلفة جميع خدمات المشروع معًا شهريًا.
العمّال داخل التطبيق نفسه
لا تحتاج دائمًا إلى خدمة مستقلة. يحتوي تبويب العمليات في التطبيق الرئيسي على:
- العمّال الخلفيون — حتى 5 عمليات طويلة التشغيل إلى جانب الموقع، مثل عامل الطوابير. تتشارك موارد التطبيق ويُعاد تشغيلها مع كل نشر.
- الأوامر المجدولة — حتى 10 أوامر وفق جدول (بصيغة cron، بتوقيت UTC). وتظهر مخرجاتها في السجل تحت الجدولة.
- وحدة التحكم — شغّل أمرًا لمرة واحدة داخل التطبيق العامل، مع متغيراته وقاعدة بياناته. يمكن أن يعمل الأمر حتى 15 دقيقة؛ ولا تُدعم هنا الأوامر التفاعلية (tinker أو shell).
الخدمة المستقلة هي الخيار الأفضل عندما يحتاج العامل إلى موارده الخاصة، حتى لا تُبطئ الطوابير الثقيلة الموقع أبدًا.
تغيير خدمة
افتح الخدمة من قائمة الخدمات. تضم الإعدادات فيها الأمر، أو الجدول، أو الصورة، أو الفرع، ومواردها؛ وتُحفظ التغييرات ويُعاد تشغيل الخدمة بها. ولكل خدمة أيضًا السجلات والمراقبة الخاصة بها.