أسباب الفشل الشائعة
عند فشل النشر يبقى الإصدار السابق يعمل، ويكتب السجل السبب. هذه أكثر الحالات شيوعًا.
| ما يظهر في السجل | السبب | الحل |
|---|---|---|
fatal: could not read Username أو Repository not found | المستودع خاص ولم تُعطَ المنصة صلاحية قراءته | استخدم Private Git Repository (with Deploy Key) أو GitHub App |
Remote branch ... not found | اسم الفرع خاطئ | صحّح Branch في إعدادات التطبيق |
خطأ من npm ci أو composer install | ملف القفل (package-lock.json أو composer.lock) غير متوافق أو ناقص | شغّل التثبيت محليًا وارفع ملف القفل |
خطأ من أمر البناء (npm run build ...) | كود لا يُبنى | جرّب الأمر نفسه محليًا بنفس إصدار Node/PHP |
The new container stopped right after starting (exit code N) | التطبيق ينهار عند الإقلاع: متغير بيئة ناقص، أو أمر تشغيل خاطئ | راجع Container logs أسفل السجل، وأضف المتغيرات الناقصة |
Nothing is listening on port N inside the new container | التطبيق لا يستمع على المنفذ المسجّل في Ports exposes | اجعل التطبيق يستمع على PORT، أو صحّح الرقم في الإعدادات |
listens on port N only on localhost | التطبيق يستمع على 127.0.0.1 | استمع على 0.0.0.0 |
Plan limit reached | بلغت عدد الموارد المسموح في خطتك | احذف موردًا لا تحتاجه أو رقِّ الخطة |
Royat security policy: ... | إعداد غير مسموح على الخوادم المشتركة (مثل privileged أو ربط مجلدات من الخادم أو منفذ على المضيف) | أزل الإعداد المذكور. الرسالة تحدد الحقل بالضبط |
Deployment queue is full | ازدحام مؤقت | أعد المحاولة بعد دقائق |
Killed أو exit code 137 | التطبيق تجاوز ذاكرة خطته | خفّف استهلاك الذاكرة أو رقِّ الخطة |
التطبيق يعمل لكن الصفحة تعرض 502 أو 503
- 503 no available server على الرابط: لا توجد حاوية سليمة لهذا التطبيق الآن (أُوقف، أو لم يُنشر بعد).
- 502: الحاوية تعمل لكن الطلب لم يصل إليها. تحقق من Ports exposes.
ما زلت عالقًا؟
راسلنا على support@royat.io مع رابط صفحة النشر (من شريط العنوان)، فهو يكفي لنرى السجل.
آخر تحديث لهذه الصفحة مع إصدار المنصة v4.3.10-royat.37. وجدت خطأ؟ راسلنا على support@royat.io.