مشاركة عبر

استكشاف مشكلات البناء الشائعة في Azure Spring Apps وإصلاحها

  • مقالة

إشعار

يعد Azure Spring Apps هو الاسم الجديد لخدمة Azure Spring Cloud. رغم أن الخدمة تحمل اسماً جديداً، سترى الاسم القديم في بعض الأماكن لفترة من الوقت بينما نعمل على تحديث الأصول مثل لقطات الشاشة، ومقاطع الفيديو، والرسوم التخطيطية.

تنطبق هذه المقالة على:❌ Basic/Standard ✔️ Enterprise

توضح هذه المقالة كيفية استكشاف مشكلات الإنشاء وإصلاحها مع نشر Azure Spring Apps.

إنشاء رموز الخروج

تستخدم خطة Azure Spring Apps Enterprise Tanzu Buildpacks لتحويل التعليمات البرمجية لمصدر التطبيق الخاص بك إلى صور. لمزيد من المعلومات، راجع Tanzu Buildpacks.

عند نشر تطبيقك في Azure Spring Apps باستخدام Azure CLI، سترى سجل إنشاء في وحدة تحكم Azure CLI. إذا فشل البناء، تعرض Azure Spring Apps رمز خروج ورسالة خطأ في وحدة تحكم CLI تشير إلى سبب فشل تنفيذ buildpack أثناء المراحل المختلفة لدورة حياة buildpack.

تصف القائمة التالية بعض رموز الخروج الشائعة:

  • 20 - فشلت جميع مجموعات buildpack في الكشف.

    ضع في اعتبارك الأسباب المحتملة التالية لرمز الخروج 20:

    • لا يدعم المنشئ الذي تستخدمه اللغة التي استخدمها مشروعك.

      إذا كنت تستخدم المنشئ الافتراضي، فتحقق من اللغة التي يدعمها المنشئ الافتراضي. لمزيد من المعلومات، راجع قسم أنواع APM المدعومة في كيفية تكوين تكامل APM وشهادات CA.

      إذا كنت تستخدم المنشئ المخصص، فتحقق مما إذا كانت buildpack الخاصة بالمنشئ المخصص تدعم اللغة التي استخدمها مشروعك.

    • أنت تركض ضد المسار الخطأ؛ على سبيل المثال، ملف pom.xml مشروع Maven الخاص بك غير موجود في المسار الجذر.

      تعيين BP_MAVEN_POM_FILE لتحديد موقع ملف pom.xml للمشروع.

    • هناك خطأ في التطبيق الخاص بك؛ على سبيل المثال، لا يحتوي ملف .jar على /META-INF/MANIFEST. ملف MF الذي يحتوي على إدخالMain-Class.

  • 51 - خطأ في بناء Buildpack.

    ضع في اعتبارك الأسباب المحتملة التالية لرمز الخروج 51:

    • إذا عرض Azure Spring Apps رسالة Build failed in stage build with reason OOMKilled الخطأ في وحدة تحكم Azure CLI، فشل الإنشاء بسبب عدم كفاية الذاكرة.

      استخدم الأمر التالي لزيادة الذاكرة باستخدام build-memory متغير البيئة:

      az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-app-name> \
    --build-memory 3Gi

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

      تحقق من سجل البناء للعثور على السبب الجذري.

    • فشل الإنشاء بسبب خطأ في تبعية التنزيل؛ على سبيل المثال، تسببت مشكلة في الشبكة في فشل تنزيل تبعية Maven.

    • فشل الإنشاء بسبب إصدار JDK غير مدعوم. على سبيل المثال، تم تحويل ملف JAR برمجيا باستخدام إصدارات غير Java LTS، والتي لا تدعمها buildpack. للحصول على الإصدارات المدعومة، راجع قسم Deploy Java applications في كيفية نشر تطبيقات polyglot في خطة Azure Spring Apps Enterprise.

  • 62 - فشل كتابة صورة إلى Azure Container Registry.

    ضع في اعتبارك السبب المحتمل التالي لرمز الخروج 62:

    • إذا عرض Azure Spring Apps رسالة Failed to write image to the following tags الخطأ في سجل البناء، فقد فشلت البنية بسبب مشكلة في الشبكة.

      أعد المحاولة لإصلاح المشكلة.

إذا كان التطبيق الخاص بك ملفا ثابتا أو تطبيقا ديناميكيا للواجهة الأمامية يقدمه خادم ويب، فشاهد قسم أخطاء الإنشاء والتوزيع الشائعة في نشر ملفات الويب الثابتة.

الخطوات التالية