تحديد المشاكل وحلّها في الأهداف المستضافة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

تعذّر الإنشاء/النشر بسبب عدم توفّر ملف package.json

يجب توفُّر ملف package.json في الدليل الجذر لتطبيق Node.js، وإلا ستفشل أي محاولة لإنشاء/نشر وكيل بدون ملف package.json أثناء مدّة التصميم.

تلقّي رسالة الخطأ "502 Bad Gateway From Proxy"

يمكن أن يحدث الخطأ "502: مدخل غير صالح" عندما يتعذّر بدء العملية. لتصحيح الأخطاء، راجِع سجلّات وقت التشغيل وابحث عن رسائل الخطأ عند البدء. من الأخطاء الشائعة عدم توفّر أمر بدء أو عدم صلاحيته في package.json. يجب أن يحدّد package.json "start": "node ." في السمة scripts كحد أدنى. على سبيل المثال:

{
  "name": "hello-world",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
   "start": "node ."
  },
  "author": "",
  "license": "",
  "description": "Hello World Application",
  "dependencies": {
  }
}

تعليق الخادم الوكيل وعرض رسالة الخطأ "504: انتهت مهلة البوابة"

يمكن أن يحدث الخطأ "504 Gateway Timeout" عندما لا يستجيب التطبيق المستهدف في Hosted Targets خلال مهلة محدّدة. تأكَّد من أنّ تطبيقك يستمع إلى المنفذ الذي تم ضبطه في متغيّر البيئة PORT. يمكنك الوصول إلى هذا المتغيّر باستخدام process.env.PORT في تطبيقك. ويمكنك بدلاً من ذلك مراجعة سجلّات وقت التشغيل بحثًا عن أي رسائل خطأ أخرى. راجِع أيضًا متغيرات البيئة المحدّدة في وقت تشغيل التطبيق.

بالإضافة إلى ذلك، يفرض Google App Engine (GAE) مهلة طلب تبلغ 60 ثانية. يمكنك أيضًا الاطّلاع على الحصص والحدود في مستندات GAE.

حرف غير صالح في المسار

إذا ظهر لك خطأ مشابه لما يلي عند نشر وكيل باستخدام Hosted Targets، قد يكون السبب هو أنّ اسم الوكيل يتضمّن مسافة. يجب عدم استخدام مسافة في اسم وكيل مع "الاستهدافات المستضافة".

Illegal character in path at index 69:
https://my-domain.net/organizations/my-org/apps/MD5 Hash/revision/1733635923

npm ERR! rofs EROFS: نظام ملفات للقراءة فقط

تعمل تطبيقات Hosted Targets في حاويات باستخدام نظام ملفات tmpfs. يمكن لتطبيق Hosted Target الكتابة في الدليل /tmp فقط ضمن نظام الملفات. للأسف، ستحاول الإصدارات الأحدث من NPM الكتابة إلى /root/.npm من أجل ذاكرة التخزين المؤقت والسجلات وما إلى ذلك. لحلّ هذه المشكلة، يُرجى الرجوع إلى مهمتَي تغيير موقع ذاكرة التخزين المؤقت لـ NPM أو تشغيل تطبيقك بدون NPM.