تصحيح أخطاء تطبيقاتك عن بعد في Azure Spring Apps

إشعار

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

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

توضح هذه الميزة كيفية تمكين تصحيح أخطاء تطبيقاتك عن بعد في Azure Spring Apps.

المتطلبات الأساسية

• Azure CLI مع ملحق Azure Spring Apps. استخدم الأمر التالي لإزالة الإصدارات السابقة وتثبيت أحدث ملحق. إذا قمت مسبقا بتثبيت ملحق spring-cloud، قم بإلغاء تثبيته لتجنب عدم تطابق التكوين والإصدار.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• تطبيق منشور في Azure Spring Apps.

تمكين تصحيح الأخطاء عن بعد أو تعطيله

لأسباب أمنية، يقوم Azure Spring Apps بتعطيل تصحيح الأخطاء عن بعد بشكل افتراضي. استنادا إلى نهج شركتك، يمكنك تمكين تصحيح الأخطاء عن بعد لتطبيقك بنفسك أو رؤية مسؤول لتمكينه لك. يمكنك تمكين تصحيح الأخطاء عن بعد أو تعطيله باستخدام Azure CLI أو مدخل Azure أو ملحق VS Code.

مدخل Microsoft Azure

استخدم الخطوات التالية لتمكين تصحيح الأخطاء عن بعد لتطبيقك باستخدام مدخل Microsoft Azure:

1. انتقل إلى صفحة التطبيق الخاص بك.

2. ضمن الإعدادات في جزء التنقل الأيمن، حدد تصحيح الأخطاء عن بعد.

3. في صفحة تصحيح الأخطاء عن بعد، قم بتمكين تصحيح الأخطاء عن بعد وحدد منفذ تصحيح الأخطاء.

   

Azure CLI

استخدم الأمر التالي لتمكين تصحيح الأخطاء عن بعد للتطبيق الخاص بك باستخدام Azure CLI:

az spring app enable-remote-debugging \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \
    --port <port>

استخدم الأمر التالي لتعطيل تصحيح الأخطاء عن بعد للتطبيق الخاص بك:

az spring app disable-remote-debugging \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \

استخدم الأمر التالي لعرض تكوين تصحيح الأخطاء عن بعد:

az spring app get-remote-debugging-config \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \

تعيين دور Azure

لتصحيح أخطاء مثيل تطبيق عن بعد، يجب أن يتم منحك الدور Azure Spring Apps Remote Debugging Role، والذي يتضمن Microsoft.AppPlatform/Spring/apps/deployments/remotedebugging/action إذن إجراء البيانات.

يمكنك تعيين دور Azure باستخدام مدخل Azure أو Azure CLI.

مدخل Microsoft Azure

استخدم الخطوات التالية لتعيين دور Azure باستخدام مدخل Microsoft Azure.

1. افتح مدخل Azure.

2. افتح مثيل خدمة Azure Spring Apps.

3. في جزء التنقل، حدد Access Control (IAM).

4. في صفحة Access Control (IAM)، حدد Add، ثم حدد Add role assignment.

   

5. في صفحة إضافة تعيين دور، في قائمة الاسم، ابحث عن دور تصحيح الأخطاء عن بعد ل Azure Spring Apps وحدده، ثم حدد التالي.

   

6. حدد الأعضاء، ثم ابحث عن اسم المستخدم وحدده.

7. حدد مراجعة + تعيين.

Azure CLI

استخدم الأمر التالي للحصول على دور تصحيح الأخطاء عن بعد ل Azure Spring Apps.

az role assignment create \
    --role "Azure Spring Apps Remote Debugging Role" \
    --scope "<service-instance-resource-id>" \
    --assignee "<your-identity>"

تصحيح أخطاء مثيل تطبيق عن بعد

يمكنك تصحيح أخطاء مثيل تطبيق عن بعد باستخدام مجموعة أدوات Azure ل IntelliJ أو ملحق Azure Spring Apps for VS Code.

مجموعة أدوات Azure ل IntelliJ

يصف هذا القسم كيفية تصحيح أخطاء مثيل تطبيق عن بعد باستخدام مجموعة أدوات Azure ل IntelliJ.

المتطلبات الأساسية

• Azure Toolkit لـ IntelliJ.
• IntelliJ IDEA أو Ultimate أو إصدار Community.

تمكين تصحيح الأخطاء عن بعد أو تعطيله

استخدم الخطوات التالية لتمكين تصحيح الأخطاء عن بعد أو تعطيله:

1. سجل الدخول إلى حساب Azure الخاص بك في Azure Explorer.

2. حدد مثيل تطبيق، ثم حدد Enable Remote Debugging.

   

إرفاق مصحح الأخطاء

استخدم الخطوات التالية لإرفاق مصحح الأخطاء.

1. حدد مثيل تطبيق، ثم حدد إرفاق مصحح الأخطاء. يتصل IntelliJ بمثيل التطبيق ويبدأ تصحيح الأخطاء عن بعد.

   

2. تنشئ مجموعة أدوات Azure ل IntelliJ تكوين تصحيح الأخطاء عن بعد. يمكنك العثور عليه ضمن Remote Jvm Debug" تكوين مسار فئة الوحدة النمطية إلى التعليمات البرمجية المصدر التي تستخدمها لتصحيح الأخطاء عن بعد.

   

استكشاف الأخطاء وإصلاحها

يوفر هذا القسم معلومات استكشاف الأخطاء وإصلاحها.

• اتخاذ الإجراءات التالية إذا فشلت في إرفاق مصحح الأخطاء وتلقي خطأ مشابه ل java.net.SocketException, connection reset أو Failed to attach to remote debugger, ClosedConnectionException:

  • تحقق من دور التحكم في الوصول استنادا إلى الدور للتأكد من أنك مخول بتصحيح مثيل تطبيق عن بعد.

  • تأكد من اتصالك بمثيل صالح. قم بتحديث النشر للحصول على أحدث المثيلات.

    

• اتخذ الإجراءات التالية إذا قمت بإرفاق مصحح الأخطاء بنجاح ولكن لا يمكنك تتبع أخطاء مثيل التطبيق عن بعد:

  • تأكد من أن IDE يحتوي على التعليمات البرمجية المصدر التي تريد تصحيحها.
  • تأكد من أن تكوين التصحيح يحتوي على مسار فئة الوحدة النمطية الصحيح.

ملحق VS Code

يصف هذا القسم كيفية تصحيح أخطاء مثيل تطبيق عن بعد باستخدام ملحق VS Code.

المتطلبات الأساسية

• Azure Spring Apps for VS Code Plugin.
• تعليمة Visual Studio البرمجية.

تمكين تصحيح الأخطاء عن بعد أو تعطيله

استخدم الخطوات التالية لتمكين تصحيح الأخطاء عن بعد أو تعطيله:

1. سجل الدخول إلى اشتراك Azure الخاص بك.

2. حدد مثيل تطبيق، ثم حدد Enable Remote Debugging.

   

إرفاق مصحح الأخطاء

استخدم الخطوات التالية لإرفاق مصحح الأخطاء.

1. حدد مثيل تطبيق، ثم حدد إرفاق مصحح الأخطاء. يتصل VS Code بمثيل التطبيق ويبدأ تصحيح الأخطاء عن بعد.

   

استكشاف الأخطاء وإصلاحها

يوفر هذا القسم معلومات استكشاف الأخطاء وإصلاحها.

• اتخاذ الإجراءات التالية إذا فشلت في إرفاق مصحح الأخطاء وتلقي خطأ مشابه ل java.net.SocketException, connection reset أو Failed to attach to remote debugger, ClosedConnectionException:

  • تحقق من دور التحكم في الوصول استنادا إلى الدور للتأكد من أنك مخول بتصحيح مثيل تطبيق عن بعد.

  • تأكد من اتصالك بمثيل صالح. قم بتحديث النشر للحصول على أحدث المثيلات.

    

• اتخذ الإجراء التالي إذا قمت بإرفاق مصحح الأخطاء بنجاح ولكن لا يمكنك تتبع أخطاء مثيل التطبيق عن بعد:

  • تأكد من أن IDE يحتوي على التعليمات البرمجية المصدر التي تريد تصحيحها.

القيود

يتم دعم تصحيح الأخطاء عن بعد فقط لتطبيقات Java.

الخطة	نوع التوزيع	مدعوم
خطة قياسية وأساسية	jar	‏‏نعم‬
خطة قياسية وأساسية	التعليمات البرمجية المصدر (Java)	‏‏نعم‬
خطة قياسية وأساسية	صورة مخصصة	لا
خطة المؤسسة	تطبيق Java	‏‏نعم‬
خطة المؤسسة	التعليمات البرمجية المصدر (Java)	‏‏نعم‬
خطة المؤسسة	صورة مخصصة	لا

تلميحات

• تصحيح أخطاء Java عن بعد خطير لأنه يسمح بتنفيذ التعليمات البرمجية عن بعد. تساعدك Azure Spring Apps على تأمين الاتصال بين IDE العميل والتطبيق البعيد. ومع ذلك، يجب تعطيل تصحيح الأخطاء عن بعد وإزالة دور RBAC بعد الانتهاء.
• يجب تغيير حجم مثيل التطبيق إلى مثيل للتأكد من أن نسبة استخدام الشبكة يمكن أن تنتقل إلى المثيل.

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

• Azure Spring Apps