التشغيل السريع: نشر تطبيق RESTful API إلى Azure Spring Apps

إشعار

أول 50 ساعة من وحدة المعالجة المركزية الظاهرية و100 جيجابايت من الذاكرة مجانية كل شهر. لمزيد من المعلومات، راجع خفض الأسعار - تقوم Azure Spring Apps بالمزيد، والتكاليف أقل! على التطبيقات على مدونة Azure.

إشعار

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

توضح هذه المقالة كيفية نشر تطبيق RESTful API محمي بواسطة معرف Microsoft Entra إلى Azure Spring Apps. نموذج المشروع هو إصدار مبسط يستند إلى تطبيق ويب Simple Todo ، والذي يوفر فقط خدمة الواجهة الخلفية ويستخدم معرف Microsoft Entra لحماية واجهات برمجة تطبيقات RESTful.

تتم حماية واجهات برمجة التطبيقات RESTful هذه من خلال تطبيق التحكم في الوصول استنادا إلى الدور (RBAC). لا يمكن للمستخدمين المجهولين الوصول إلى أي بيانات ولا يسمح لهم بالتحكم في الوصول لمستخدمين مختلفين. المستخدمين المجهولين لديهم الأذونات الثلاثة التالية فقط:

• اقرأ: باستخدام هذا الإذن، يمكن للمستخدم قراءة بيانات ToDo.
• الكتابة: باستخدام هذا الإذن، يمكن للمستخدم إضافة بيانات ToDo أو تحديثها.
• حذف: باستخدام هذا الإذن، يمكن للمستخدم حذف بيانات ToDo.

بعد نجاح النشر، يمكنك عرض واجهات برمجة التطبيقات واختبارها من خلال واجهة مستخدم Swagger.

يوضح الرسم التخطيطي التالي بنية النظام:

توضح هذه المقالة الخيارات التالية لإنشاء الموارد ونشرها في Azure Spring Apps:

• يوفر خيار المكون الإضافي لمدخل Azure + Maven طريقة أكثر تقليدية لإنشاء الموارد ونشر التطبيقات خطوة بخطوة. هذا الخيار مناسب لمطوري Spring الذين يستخدمون خدمات سحابة Azure لأول مرة.
• يعد خيار Azure Developer CLI طريقة أكثر كفاءة لإنشاء الموارد ونشر التطبيقات تلقائيا من خلال أوامر بسيطة. يستخدم Azure Developer CLI قالب لتوفير موارد Azure المطلوبة ونشر التعليمات البرمجية للتطبيق. هذا الخيار مناسب لمطوري Spring الذين هم على دراية بخدمات Azure السحابية.

توضح هذه المقالة الخيارات التالية لإنشاء الموارد ونشرها في Azure Spring Apps:

• يوفر خيار المكون الإضافي لمدخل Azure + Maven طريقة أكثر تقليدية لإنشاء الموارد ونشر التطبيقات خطوة بخطوة. هذا الخيار مناسب لمطوري Spring الذين يستخدمون خدمات سحابة Azure لأول مرة.
• يستخدم خيار Azure CLI أداة سطر أوامر قوية لإدارة موارد Azure. هذا الخيار مناسب لمطوري Spring الذين هم على دراية بخدمات Azure السحابية.

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

مدخل Azure + المكون الإضافي ل Maven

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

• أحد الأدوار التالية:

  • المسؤول العام أو مسؤول الدور المتميز، لمنح الموافقة للتطبيقات التي تطلب أي إذن، لأي واجهة برمجة تطبيقات.
  • cloud Application مسؤول istrator أو Application مسؤول istrator، لمنح الموافقة للتطبيقات التي تطلب أي إذن لأي واجهة برمجة تطبيقات، باستثناء أدوار تطبيق Microsoft Graph (أذونات التطبيق).
  • دور دليل مخصص يتضمن الإذن بمنح أذونات للتطبيقات، للأذونات التي يتطلبها التطبيق.

  لمزيد من المعلومات، راجع منح موافقة المسؤول على مستوى المستأجر على أحد التطبيقات.

• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.

• Git.

• Java Development Kit (JDK)، الإصدار 17.

• مستأجر Microsoft Entra. للحصول على إرشادات حول إنشاء مستأجر، راجع التشغيل السريع: إنشاء مستأجر جديد في معرف Microsoft Entra.

Azure CLI

• اشتراك Azure، إذا لم يكن لديك اشتراك Azure، فبادر بإنشاء حساب Azure مجاني قبل البدء.

• أحد الأدوار التالية:

  • المسؤول العام أو مسؤول الدور المتميز، لمنح الموافقة للتطبيقات التي تطلب أي إذن، لأي واجهة برمجة تطبيقات.
  • cloud Application مسؤول istrator أو Application مسؤول istrator، لمنح الموافقة للتطبيقات التي تطلب أي إذن لأي واجهة برمجة تطبيقات، باستثناء أدوار تطبيق Microsoft Graph (أذونات التطبيق).
  • دور دليل مخصص يتضمن الإذن بمنح أذونات للتطبيقات، للأذونات التي يتطلبها التطبيق.

  لمزيد من المعلومات، راجع منح موافقة المسؤول على مستوى المستأجر على أحد التطبيقات.

• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.

• Git.

• Java Development Kit (JDK)، الإصدار 17.

• مستأجر Microsoft Entra. للحصول على إرشادات حول إنشاء مستأجر، راجع التشغيل السريع: إنشاء مستأجر جديد في معرف Microsoft Entra.

• إصدار Azure CLI 2.53.1 أو أعلى.

مدخل Azure + المكون الإضافي ل Maven

• اشتراك Azure، إذا لم يكن لديك اشتراك Azure، فبادر بإنشاء حساب Azure مجاني قبل البدء.

• أحد الأدوار التالية:

  • المسؤول العام أو مسؤول الدور المتميز، لمنح الموافقة للتطبيقات التي تطلب أي إذن، لأي واجهة برمجة تطبيقات.
  • cloud Application مسؤول istrator أو Application مسؤول istrator، لمنح الموافقة للتطبيقات التي تطلب أي إذن لأي واجهة برمجة تطبيقات، باستثناء أدوار تطبيق Microsoft Graph (أذونات التطبيق).
  • دور دليل مخصص يتضمن الإذن بمنح أذونات للتطبيقات، للأذونات التي يتطلبها التطبيق.

  لمزيد من المعلومات، راجع منح موافقة المسؤول على مستوى المستأجر على أحد التطبيقات.

• Git.

• Java Development Kit (JDK)، الإصدار 17.

• مستأجر Microsoft Entra. للحصول على إرشادات حول إنشاء مستأجر، راجع التشغيل السريع: إنشاء مستأجر جديد في معرف Microsoft Entra.

Azure Developer CLI

• اشتراك Azure، إذا لم يكن لديك اشتراك Azure، فبادر بإنشاء حساب Azure مجاني قبل البدء.

• أحد الأدوار التالية:

  • المسؤول العام أو مسؤول الدور المتميز، لمنح الموافقة للتطبيقات التي تطلب أي إذن، لأي واجهة برمجة تطبيقات.
  • cloud Application مسؤول istrator أو Application مسؤول istrator، لمنح الموافقة للتطبيقات التي تطلب أي إذن لأي واجهة برمجة تطبيقات، باستثناء أدوار تطبيق Microsoft Graph (أذونات التطبيق).
  • دور دليل مخصص يتضمن الإذن بمنح أذونات للتطبيقات، للأذونات التي يتطلبها التطبيق.

  لمزيد من المعلومات، راجع منح موافقة المسؤول.

• Git.

• Java Development Kit (JDK)، الإصدار 17.

• مستأجر Microsoft Entra. للحصول على إرشادات حول إنشاء مستأجر، راجع التشغيل السريع: إنشاء مستأجر جديد في معرف Microsoft Entra.

• Azure Developer CLI (AZD) ، الإصدار 1.0.2 أو أعلى.

2. إعداد مشروع الربيع

لنشر تطبيق RESTful API، الخطوة الأولى هي إعداد مشروع Spring للتشغيل محليا.

استخدم الخطوات التالية لاستنساخ التطبيق وتشغيله محليا:

1. استخدم الأمر التالي لاستنساخ نموذج المشروع من GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. إذا كنت ترغب في تشغيل التطبيق محليا، فأكمل الخطوات الموجودة في واجهات برمجة التطبيقات Expose RESTful وقم بتحديث أقسام تكوين التطبيق أولا، ثم استخدم الأمر التالي لتشغيل نموذج التطبيق مع Maven:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

3. إعداد بيئة السحابة

الموارد الرئيسية المطلوبة لتشغيل نموذج التطبيق هذا هي مثيل Azure Spring Apps وقاعدة بيانات Azure لمثيل PostgreSQL. تصف الأقسام التالية كيفية إنشاء هذه الموارد.

مدخل Azure + المكون الإضافي ل Maven

3.1. سجِّل الدخول إلى مدخل Azure

انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.

3.2. إنشاء مثيل Azure Spring Apps

استخدم الخطوات التالية لإنشاء مثيل خدمة Azure Spring Apps:

1. حدد Create a resource في زاوية مدخل Microsoft Azure.

2. حدد حساب>Azure Spring Apps.

3. املأ نموذج «Basics» بالمعلومات التالية:

   الإعدادات	القيمة المقترحة	‏‏الوصف
   الاشتراك	اسم الاشتراك الخاص بك.	اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
   مجموعة الموارد	myresourcegroup	اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
   الاسم	myasa	اسم فريد يعرف خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.
   تخطيط	المؤسسه	خطة التسعير التي تحدد المورد والتكلفة المرتبطة بالمثيل الخاص بك.
   المنطقة	المنطقة الأقرب إلى المستخدمين.	الموقع الأقرب إلى المستخدمين.
   المنطقة زائدة عن الحاجة	غير محدد	خيار إنشاء خدمة Azure Spring Apps في منطقة توفر Azure. هذه الميزة غير مدعومة حاليا في جميع المناطق.
   خطة IP للبرامج	الدفع أولاً بأول	خطة التسعير التي تتيح لك الدفع أثناء استخدام Azure Spring Apps.
   حيث	المحدد	خانة اختيار الاتفاقية المرتبطة بعرض Marketplace. مطلوب منك تحديد خانة الاختيار هذه.
   توزيع نموذج المشروع	غير محدد	خيار استخدام نموذج التطبيق المضمن.

4. حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لتوفير مثيل Azure Spring Apps.

5. من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة.

   

6. حدد Go to resource للانتقال إلى صفحة نظرة عامة على Azure Spring Apps.

3.3. إعداد مثيل PostgreSQL

استخدم الخطوات التالية لإنشاء قاعدة بيانات Azure لخادم PostgreSQL:

1. انتقل إلى مدخل Microsoft Azure وحدد Create a resource.

2. حدد قواعد بيانات>Azure Database لـPostgreSQL.

3. حدد خيار النشر «Flexible server».

   

4. املأ علامة التبويب Basics بالمعلومات التالية:

   • اسم الخادم: my-demo-pgsql
   • المنطقة: شرق الولايات المتحدة
   • إصدار PostgreSQL: 14
   • نوع حمل العمل: التطوير
   • تمكين قابلية الوصول العالية: غير محدد
   • أسلوب المصادقة: مصادقة PostgreSQL فقط
   • اسم المستخدم مسؤول: myadmin
   • كلمة المرور وتأكيد كلمة المرور: أدخل كلمة مرور.

5. استخدم المعلومات التالية لتكوين علامة التبويب Networking :

   • أسلوب الاتصال: الوصول العام (عناوين IP المسموح بها)
   • السماح بالوصول العام من أي خدمة Azure داخل Azure إلى هذا الخادم: محدد

6. حدد Review + create لمراجعة التحديدات الخاصة بك، وحدد Create لتوفير الخادم. قد تستغرق هذه العملية بضع دقائق.

7. انتقل إلى خادم PostgreSQL في مدخل Microsoft Azure. في صفحة نظرة عامة ، ابحث عن قيمة اسم الخادم، ثم سجلها لاستخدامها لاحقا. تحتاج إليه لتكوين متغيرات البيئة للتطبيق في Azure Spring Apps.

8. حدد Databases من قائمة التنقل لإنشاء قاعدة بيانات - على سبيل المثال، todo.

   

3.4. الاتصال مثيل التطبيق إلى مثيل PostgreSQL

استخدم الخطوات التالية لتوصيل مثيلات الخدمة:

1. انتقل إلى مثيل Azure Spring Apps في مدخل Azure.

2. من قائمة التنقل، افتح التطبيقات، ثم حدد إنشاء تطبيق.

3. في صفحة Create App ، املأ اسم التطبيق simple-todo-api، ثم حدد Java artifacts كنوع النشر.

4. حدد إنشاء لإنهاء إنشاء التطبيق ثم حدد التطبيق لعرض التفاصيل.

5. انتقل إلى التطبيق الذي أنشأته في مدخل Microsoft Azure. في صفحة Overview ، حدد Assign endpoint لعرض نقطة النهاية العامة للتطبيق. احفظ عنوان URL للوصول إلى التطبيق بعد النشر.

6. حدد Service الاتصال or من جزء التنقل، ثم حدد Create لإنشاء اتصال خدمة جديد.

   

7. املأ علامة التبويب Basics بالمعلومات التالية:

   • نوع الخدمة: DB لخادم PostgreSQL المرن
   • اسم الاتصال: يتم ملء الاسم الذي تم إنشاؤه تلقائيا، والذي يمكن تعديله أيضا.
   • Subscription: حدد اشتراكك.
   • خادم PostgreSQL المرن: my-demo-pgsql
   • قاعدة بيانات PostgreSQL: حدد قاعدة البيانات التي أنشأتها.
   • نوع العميل: SpringBoot

   

8. قم بتكوين علامة التبويب Next: Authentication بالمعلومات التالية:

   • حدد نوع المصادقة الذي تريد استخدامه بين خدمة الحوسبة والخدمة المستهدفة.: حدد الاتصال سلسلة.
   • متابعة مع...: حدد بيانات اعتماد قاعدة البيانات
   • اسم المستخدم: myadmin
   • كلمة المرور: أدخل كلمة المرور الخاصة بك.

   

9. حدد Next: Networking. استخدم الخيار الافتراضي تكوين قواعد جدار الحماية لتمكين الوصول إلى الخدمة الهدف.

10. حدد Next: Review and Create لمراجعة التحديدات، ثم حدد Create لإنشاء الاتصال.

3.5. كشف واجهات برمجة التطبيقات RESTful

استخدم الخطوات التالية لعرض واجهات برمجة تطبيقات RESTful في معرف Microsoft Entra:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إذا كان لديك حق الوصول إلى عدة مستأجرين، فاستخدم عامل تصفية الدليل + الاشتراك ( ) لتحديد المستأجر الذي تريد تسجيل تطبيق فيه.

3. ابحث عن Microsoft Entra ID وحدده.

4. ضمن Manage، حدد App registrationsتسجيل >جديد.

5. أدخل اسما لتطبيقك في حقل الاسم - على سبيل المثال، Todo. قد يرى مستخدمو التطبيق الخاص بك هذا الاسم، ويمكنك تغييره لاحقًا.

6. بالنسبة إلى أنواع الحسابات المدعومة، حدد الحسابات في أي دليل تنظيمي (أي دليل Microsoft Entra - متعدد المستأجرين) وحسابات Microsoft الشخصية.

7. حدد Register لإنشاء التطبيق.

8. في صفحة "Overview" للتطبيق، ابحث عن قيمة Application (client) ID وسجله للاستخدام لاحقاً. تحتاج إليه لتكوين ملف تكوين YAML لهذا المشروع.

9. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات، وابحث عن معرف التطبيق URI في بداية الصفحة، ثم حدد إضافة.

10. في صفحة تحرير معرف التطبيق URI ، اقبل معرف التطبيق المقترح URI (api://{client ID}) أو استخدم اسما ذا معنى بدلا من معرف العميل، مثل api://simple-todo، ثم حدد حفظ.

11. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات>إضافة نطاق، ثم أدخل المعلومات التالية:

    • بالنسبة إلى اسم النطاق، أدخل ToDo.Read.
    • للحصول على موافقة روبوت Who، حدد مسؤول فقط.
    • للحصول على اسم عرض الموافقة مسؤول، أدخل قراءة بيانات ToDo.
    • للحصول على وصف الموافقة مسؤول، أدخل السماح للمستخدمين المصادق عليهم بقراءة بيانات ToDo.
    • بالنسبة إلى State، احتفظ به ممكنا.
    • حدد إضافة نطاق.

12. كرر الخطوات السابقة لإضافة النطاقين الآخرين: ToDo.Write و ToDo.Delete.

    

3.6. تحديث تكوين التطبيق

استخدم الخطوات التالية لتحديث ملف YAML لاستخدام معلومات التطبيق المسجلة في Microsoft Entra لإنشاء علاقة مع تطبيق واجهة برمجة تطبيقات RESTful:

1. حدد موقع ملف simple-todo-api src/main/resources/application.yml للتطبيق. قم بتحديث التكوين في spring.cloud.azure.active-directory القسم لمطابقة المثال التالي. تأكد من استبدال العناصر النائبة بالقيم التي قمت بإنشائها مسبقا.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   إشعار

   في الرموز المميزة v1.0، يتطلب التكوين معرف العميل لواجهة برمجة التطبيقات، بينما في الرموز المميزة v2.0، يمكنك استخدام معرف العميل أو معرف التطبيق URI في الطلب. يمكنك تكوين كليهما لإكمال التحقق من صحة الجمهور بشكل صحيح.

   القيم المسموح بها tenant-id هي: commonأو organizationsconsumersأو أو معرف المستأجر. لمزيد من المعلومات حول هذه القيم، راجع قسم استخدام نقطة النهاية الخاطئة (الحسابات الشخصية والمؤسسة) في AAD (دليل Azure النشط)STS50020 الخطأ - حساب المستخدم من موفر الهوية غير موجود في المستأجر. للحصول على معلومات حول تحويل تطبيق المستأجر الفردي، راجع تحويل تطبيق المستأجر الفردي إلى متعدد المستأجرين على معرف Microsoft Entra.

2. استخدم الأمر التالي لإعادة إنشاء نموذج المشروع:

   ./mvnw clean package
   

Azure CLI

3.1. توفير أسماء لكل مورد

إنشاء متغيرات للاحتفاظ بأسماء الموارد باستخدام الأوامر التالية. تأكد من استبدل العناصر النائبة بقيمتك الخاصة.

export RESOURCE_GROUP=myresourcegroup
export LOCATION=<location>
export POSTGRESQL_SERVER=my-demo-pgsql
export POSTGRESQL_DB=Todo
export POSTGRESQL_ADMIN_USERNAME=<admin-username>
export POSTGRESQL_ADMIN_PASSWORD=<admin-password>
export AZURE_SPRING_APPS_NAME=myasa
export APP_NAME=simple-todo-api
export TODO_APP_NAME=Todo
export TODO_APP_URL=api://simple-todo
export TODOWEB_APP_NAME=TodoWeb
export TODOWEB_APP_URL=api://simple-todoweb
export NEW_MEMBER_USERNAME=<new-member-username>
export NEW_MEMBER_PASSWORD=<new-member-password>
export USER_PRINCIPAL_NAME=<user-principal-name>

3.2. إنشاء مجموعة موارد جديدة

استخدم الخطوات التالية لإنشاء مجموعة موارد جديدة:

1. استخدم الأمر التالي لتسجيل الدخول إلى Azure CLI:

   az login
   

2. استخدم الأمر التالي لتعيين الموقع الافتراضي:

   az configure --defaults location=${LOCATION}
   

3. استخدم الأمر التالي لسرد جميع الاشتراكات المتوفرة لتحديد معرف الاشتراك المراد استخدامه:

   az account list --output table
   

4. استخدم الأمر التالي لتعيين الاشتراك الافتراضي:

   az account set --subscription <subscription-ID>
   

5. استخدم الأمر التالي لإنشاء مجموعة موارد:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. استخدم الأمر التالي لتعيين مجموعة الموارد التي تم إنشاؤها حديثا كمجموعة الموارد الافتراضية:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. تثبيت ملحق وتسجيل مساحة الاسم

استخدم الأوامر التالية لتثبيت ملحق Azure Spring Apps ل Azure CLI وتسجيل Microsoft.SaaS مساحة الاسم:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. إنشاء مثيل Azure Spring Apps

استخدم الخطوات التالية لإنشاء مثيل خدمة وتطبيق في المثيل:

1. استخدم الأمر التالي لقبول الشروط القانونية وبيانات الخصوصية لخطة المؤسسة:

   إشعار

   هذه الخطوة ضرورية فقط إذا لم يتم استخدام اشتراكك لإنشاء مثيل خطة Enterprise من Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. استخدم الأمر التالي لإنشاء مثيل خدمة لـ Azure Spring Apps:

   az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
   

3. استخدم الأمر التالي لإنشاء تطبيق في مثيل Azure Spring Apps:

   az spring app create \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --assign-endpoint true
   

3.5. إعداد مثيل PostgreSQL

يستخدم تطبيق ويب Spring H2 لقاعدة البيانات في localhost وAzure Database for PostgreSQL لقاعدة البيانات في Azure.

استخدم الأمر التالي لإنشاء مثيل PostgreSQL:

az postgres flexible-server create \
    --name ${POSTGRESQL_SERVER} \
    --database-name ${POSTGRESQL_DB} \
    --admin-user ${POSTGRESQL_ADMIN_USERNAME} \
    --admin-password ${POSTGRESQL_ADMIN_PASSWORD} \
    --public-access 0.0.0.0

يتيح تحديد 0.0.0.0 الوصول العام من أي موارد تم نشرها داخل Azure للوصول إلى الخادم الخاص بك.

3.6. الاتصال مثيل التطبيق إلى مثيل PostgreSQL

بعد إنشاء مثيل التطبيق ومثيل PostgreSQL، لا يمكن لمثيل التطبيق الوصول إلى مثيل PostgreSQL مباشرة. استخدم الخطوات التالية لتمكين التطبيق من الاتصال بمثيل PostgreSQL:

1. استخدم الأمر التالي للحصول على اسم المجال المؤهل بالكامل لمثيل PostgreSQL:

   export PSQL_FQDN=$(az postgres flexible-server show \
       --name ${POSTGRESQL_SERVER} \
       --query fullyQualifiedDomainName \
       --output tsv)
   

2. استخدم الأمر التالي لتوفير الخصائص spring.datasource. للتطبيق من خلال متغيرات البيئة:

   az spring app update \
       --service ${AZURE_SPRING_APPS_NAME} \
       --name ${APP_NAME} \
       --env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
             SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
             SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
   

3.7. كشف واجهات برمجة التطبيقات RESTful

استخدم الخطوات التالية لعرض واجهات برمجة تطبيقات RESTful:

1. استخدم الأمر التالي لإنشاء تطبيق معرف Microsoft Entra:

   az ad app create \
       --display-name ${TODO_APP_NAME} \
       --sign-in-audience AzureADandPersonalMicrosoftAccount \
       --identifier-uris ${TODO_APP_URL}
   

2. استخدم الأمر التالي لإنشاء كيان خدمة للتطبيق:

   az ad sp create --id ${TODO_APP_URL}
   

3. استخدم الأمر التالي لإنشاء معرفات الأذونات:

   permissionid1=$(uuidgen);permissionid2=$(uuidgen);permissionid3=$(uuidgen)
   

4. أضف النطاقات التالية ك JSON:

   api=$(echo '{
    "oauth2PermissionScopes": [
        {
            "adminConsentDescription": "Allows authenticated users to delete the ToDo data",
            "adminConsentDisplayName": "Delete the ToDo data",
            "id": "'$permissionid1'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Delete"
        },
   
        {
            "adminConsentDescription": "Allows authenticated users to write the ToDo data",
            "adminConsentDisplayName": "Write the ToDo data",
            "id": "'$permissionid2'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Write"
        },
        {
            "adminConsentDescription": "Allows authenticated users to read the ToDo data",
            "adminConsentDisplayName": "Read the ToDo data",
            "id": "'$permissionid3'",
            "isEnabled": true,
            "type": "Admin",
            "userConsentDescription": null,
            "userConsentDisplayName": null,
            "value": "ToDo.Read"
        }
    ]}')
   

5. استخدم الأمر التالي لإضافة نطاقات:

   az ad app update \
       --id ${TODO_APP_URL} \
       --set api="$api"
   

6. استخدم الأمر التالي للحصول على معرف المستأجر لاستخدامه في الخطوة التالية:

   az account show --query "tenantId" --output tsv
   

7. استخدم الأمر التالي للحصول على معرف التطبيق لاستخدامه في الخطوات التالية:

   appid=$(az ad app show \
       --id ${TODO_APP_URL} \
       --query appId \
       --output tsv);
   echo $appid
   

3.8. تحديث تكوين التطبيق

استخدم الخطوات التالية لتحديث ملف YAML لاستخدام معلومات التطبيق المسجلة في Microsoft Entra لإنشاء علاقة مع تطبيق واجهة برمجة تطبيقات RESTful:

1. حدد موقع ملف simple-todo-api src/main/resources/application.yml للتطبيق. قم بتحديث التكوين في spring.cloud.azure.active-directory القسم لمطابقة المثال التالي. تأكد من استبدال العناصر النائبة بالقيم التي قمت بإنشائها مسبقا.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   إشعار

   في الرموز المميزة v1.0، يتطلب التكوين معرف العميل لواجهة برمجة التطبيقات، بينما في الرموز المميزة v2.0، يمكنك استخدام معرف العميل أو معرف التطبيق URI في الطلب. يمكنك تكوين كليهما لإكمال التحقق من صحة الجمهور بشكل صحيح.

   القيم المسموح بها tenant-id هي: commonأو organizationsconsumersأو أو معرف المستأجر. لمزيد من المعلومات حول هذه القيم، راجع قسم استخدام نقطة النهاية الخاطئة (الحسابات الشخصية والمؤسسة) في AAD (دليل Azure النشط)STS50020 الخطأ - حساب المستخدم من موفر الهوية غير موجود في المستأجر. للحصول على معلومات حول تحويل تطبيق المستأجر الفردي، راجع تحويل تطبيق المستأجر الفردي إلى متعدد المستأجرين على معرف Microsoft Entra.

2. استخدم الأمر التالي لإعادة إنشاء نموذج المشروع:

   ./mvnw clean package
   

4. نشر التطبيق إلى Azure Spring Apps

مدخل Azure + المكون الإضافي ل Maven

يمكنك الآن نشر التطبيق إلى Azure Spring Apps.

استخدم الخطوات التالية للنشر باستخدام المكون الإضافي Maven ل Azure Spring Apps:

1. انتقل إلى الدليل الكامل ، ثم قم بتشغيل الأمر التالي لتكوين التطبيق في Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   تصف القائمة التالية تفاعلات الأوامر:

   • تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.
   • حدد subscription: حدد رقم قائمة الاشتراك لمثيل Azure Spring Apps الذي أنشأته، والذي يتم تعيينه افتراضيا إلى الاشتراك الأول في القائمة. إذا كنت تستخدم الرقم الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • استخدام Azure Spring Apps الموجودة في Azure: اضغط على y لاستخدام مثيل Azure Spring Apps الحالي.
   • حدد Azure Spring Apps للنشر: حدد عدد مثيل Azure Spring Apps الذي أنشأته. إذا كنت تستخدم الرقم الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • استخدم التطبيق الموجود في Azure Spring Apps <your-instance-name>: اضغط y لاستخدام التطبيق الذي تم إنشاؤه.
   • تأكد من حفظ جميع التكوينات أعلاه: اضغط على y. إذا قمت بالضغط على n، فلن يتم حفظ التكوين في ملفات POM.

2. استخدم الأمر التالي لنشر التطبيق:

   ./mvnw azure-spring-apps:deploy
   

   تصف القائمة التالية تفاعل الأمر:

   • تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.

   بعد تنفيذ الأمر، يمكنك أن ترى من رسائل السجل التالية أن النشر كان ناجحا:

[INFO] Deployment Status: Running
[INFO]   InstanceName:simple-todo-api-default-15-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A       
[INFO] Getting public url of app(simple-todo-api)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-api.azuremicroservices.io

Azure CLI

استخدم الأمر التالي لنشر التطبيق استنادا إلى التعليمات البرمجية المصدر:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_NAME} \
    --name ${APP_NAME} \
    --build-env BP_JVM_VERSION=17 \
    --source-path .

5. التحقق من صحة التطبيق

مدخل Azure + المكون الإضافي ل Maven

يمكنك الآن الوصول إلى واجهة برمجة تطبيقات RESTful لمعرفة ما إذا كانت تعمل.

5.1. طلب رمز مميز للوصول

تعمل واجهات برمجة تطبيقات RESTful كخادم موارد، وهو محمي بواسطة معرف Microsoft Entra. قبل الحصول على رمز مميز للوصول، يجب عليك تسجيل تطبيق آخر في معرف Microsoft Entra ومنح أذونات لتطبيق العميل، الذي يسمى ToDoWeb.

تسجيل تطبيق العميل

استخدم الخطوات التالية لتسجيل تطبيق في معرف Microsoft Entra، والذي يستخدم لإضافة أذونات ToDo التطبيق:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إذا كان لديك حق الوصول إلى عدة مستأجرين، فاستخدم عامل تصفية الدليل + الاشتراك ( ) لتحديد المستأجر الذي تريد تسجيل تطبيق فيه.

3. ابحث عن Microsoft Entra ID وحدده.

4. ضمن Manage، حدد App registrationsتسجيل >جديد.

5. أدخل اسما للتطبيق الخاص بك في حقل الاسم - على سبيل المثال، ToDoWeb. قد يرى مستخدمو التطبيق الخاص بك هذا الاسم، ويمكنك تغييره لاحقًا.

6. بالنسبة إلى أنواع الحسابات المدعومة، استخدم القيمة الافتراضية حسابات في هذا الدليل التنظيمي فقط.

7. حدد Register لإنشاء التطبيق.

8. في صفحة "Overview" للتطبيق، ابحث عن قيمة Application (client) ID وسجله للاستخدام لاحقاً. تحتاج إليها للحصول على رمز مميز للوصول.

9. حدد أذونات واجهة برمجة التطبيقات> وأضف إذن >واجهات برمجة التطبيقات الخاصة بي. ToDo حدد التطبيق الذي قمت بتسجيله مسبقا، ثم حدد أذونات ToDo.Read و ToDo.Write و ToDo.Delete. حدد إضافة أذونات.

10. حدد منح موافقة المسؤول لاسم <> المستأجر لمنح موافقة المسؤول على الأذونات التي أضفتها.

    

إضافة مستخدم للوصول إلى واجهات برمجة تطبيقات RESTful

استخدم الخطوات التالية لإنشاء مستخدم عضو في مستأجر Microsoft Entra. ثم، يمكن للمستخدم إدارة بيانات التطبيق من ToDo خلال واجهات برمجة تطبيقات RESTful.

1. ضمن Manage، حدد Users>New user>Create new user.

2. في صفحة إنشاء مستخدم جديد، أدخل المعلومات التالية:

   • اسم المستخدم الأساسي: أدخل اسما للمستخدم.
   • اسم العرض: أدخل اسم عرض للمستخدم.
   • كلمة المرور: انسخ كلمة المرور التي تم إنشاؤها تلقائيا والمتوفرة في المربع كلمة المرور .

   إشعار

   يجب على المستخدمين الجدد إكمال مصادقة تسجيل الدخول الأولى وتحديث كلمات المرور الخاصة بهم، وإلا فستتلقى خطأ AADSTS50055: The password is expired عند الحصول على رمز الوصول المميز.

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

3. حدد «Review + create» لمراجعة اختياراتك. حدد Create لإنشاء المستخدم.

تحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger

استخدم الخطوات التالية لتحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger. بعد ذلك، يمكنك تخويل المستخدمين للحصول على رموز الوصول المميزة ToDoWeb من خلال التطبيق.

1. افتح مستأجر Microsoft Entra ID في مدخل Microsoft Azure، وانتقل إلى التطبيق المسجلToDoWeb.

2. ضمن Manage، حدد Authentication، وحدد Add a platform، ثم حدد Single-page application.

3. استخدم التنسيق <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html كعنون URL لإعادة توجيه OAuth2 في حقل Redirect URIs ، ثم حدد Configure.

   

Azure CLI

يمكنك الآن الوصول إلى واجهة برمجة تطبيقات RESTful لمعرفة ما إذا كانت تعمل.

5.1. طلب رمز مميز للوصول

تعمل واجهات برمجة تطبيقات RESTful كخادم موارد، وهو محمي بواسطة معرف Microsoft Entra. قبل الحصول على رمز مميز للوصول، يطلب منك تسجيل تطبيق آخر في معرف Microsoft Entra ومنح أذونات لتطبيق العميل، والذي يسمى ToDoWeb.

تسجيل تطبيق العميل

استخدم الخطوات التالية لتسجيل تطبيق العميل:

1. استخدم الأمر التالي لإنشاء تطبيق معرف Microsoft Entra، والذي يستخدم لإضافة أذونات ToDo التطبيق:

   az ad app create \
       --display-name ${TODOWEB_APP_NAME} \
       --sign-in-audience AzureADMyOrg \
       --identifier-uris ${TODOWEB_APP_URL}
   

2. استخدم الأمر التالي لإضافة أذونات:

   az ad app permission add \
       --id api://simple-todowebtest2 \
       --api $appid \
       --api-permissions $permissionid1=Scope $permissionid2=Scope $permissionid3=Scope
   

3. استخدم الأمر التالي لمنح موافقة المسؤول على الأذونات التي أضفتها:

   az ad app permission admin-consent --id ${TODOWEB_APP_URL}
   

4. استخدم الأمر التالي للحصول على معرف ToDoWeb العميل للتطبيق المستخدم في الخطوة الحصول على الرمز المميز للوصول:

   az ad app show \
       --id ${TODOWEB_APP_URL} \
       --query appId \
       --output tsv
   

إضافة مستخدم للوصول إلى واجهات برمجة تطبيقات RESTful

استخدم الأمر التالي لإنشاء مستخدم عضو في مستأجر Microsoft Entra. بعد ذلك، يمكن للمستخدم إدارة بيانات التطبيق من ToDo خلال واجهات برمجة تطبيقات RESTful:

az ad user create \
    --display-name ${NEW_MEMBER_USERNAME} \
    --password ${NEW_MEMBER_PASSWORD} \
    --user-principal-name ${USER_PRINCIPAL_NAME}

تحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger

استخدم الخطوات التالية لتحديث تكوين OAuth2:

1. استخدم الأمر التالي للحصول على معرف ToDoWeb الكائن للتطبيق:

   az ad app show --id ${TODOWEB_APP_URL} --query id
   

2. استخدم الأمر التالي للحصول على عنوان URL لتطبيقك simple-todo-api :

   az spring app show \
       --name ${APP_NAME} \
       --service ${AZURE_SPRING_APPS_NAME} \
       --query properties.url
   

3. استخدم الأمر التالي لتحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger، واستبدال العناصر النائبة <object-id> و <URL> بقيم المعلمة التي حصلت عليها. بعد ذلك، يمكنك تخويل المستخدمين للحصول على رموز الوصول المميزة ToDoWeb من خلال التطبيق.

   az rest \
       --method PATCH \
       --uri "https://graph.microsoft.com/v1.0/applications/<object-id>" \
       --headers 'Content-Type=application/json' \
       --body '{"spa":{"redirectUris":["<URL>/swagger-ui/oauth2-redirect.html"]}}'
   

2. إعداد مشروع الربيع

لنشر تطبيق RESTful API، الخطوة الأولى هي إعداد مشروع Spring للتشغيل محليا.

مدخل Azure + المكون الإضافي ل Maven

استخدم الخطوات التالية لاستنساخ التطبيق وتشغيله محليا:

1. استخدم الأمر التالي لاستنساخ نموذج المشروع من GitHub:

   git clone https://github.com/Azure-Samples/ASA-Samples-Restful-Application.git
   

2. إذا كنت ترغب في تشغيل التطبيق محليا، فأكمل الخطوات الموجودة في واجهات برمجة التطبيقات Expose RESTful وقم بتحديث أقسام تكوين التطبيق أولا، ثم استخدم الأمر التالي لتشغيل نموذج التطبيق مع Maven:

   cd ASA-Samples-Restful-Application
   ./mvnw spring-boot:run
   

Azure Developer CLI

استخدم الخطوات التالية لتهيئة تطبيق الويب من قوالب Azure Developer CLI:

1. افتح terminal، وأنشئ مجلدا فارغا جديدا، ثم غير الدليل إليه.

2. قم بتشغيل الأمر التالي لتهيئة المشروع:

   azd init --template Azure-Samples/ASA-Samples-Restful-Application
   

   تصف القائمة التالية تفاعلات الأوامر:

   • تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.
   • الرجاء إدخال اسم بيئة جديد: توفير اسم بيئة. يتم استخدام هذا الاسم كلاحقة لمجموعة الموارد التي تم إنشاؤها للاحتفاظ بجميع موارد Azure. يجب أن يكون هذا الاسم فريدا داخل اشتراك Azure الخاص بك.

   مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:

   Initializing a new project (azd init)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. إعداد بيئة السحابة

الموارد الرئيسية المطلوبة لتشغيل نموذج التطبيق هذا هي مثيل Azure Spring Apps وقاعدة بيانات Azure لمثيل PostgreSQL. تصف الأقسام التالية كيفية إنشاء هذه الموارد.

مدخل Azure + المكون الإضافي ل Maven

3.1. سجِّل الدخول إلى مدخل Azure

انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.

3.2. إنشاء مثيل Azure Spring Apps

استخدم الخطوات التالية لإنشاء مثيل خدمة:

1. حدد Create a resource في زاوية المدخل.

2. حدد حساب>Azure Spring Apps.

3. املأ نموذج Basics. استخدم الجدول التالي كدليل لإكمال النموذج. قيمة الخطة الموصى بها هي الاستهلاك القياسي والمخصصة (معاينة).

   الإعدادات	القيمة المقترحة	‏‏الوصف
   الاشتراك	اسم الاشتراك الخاص بك.	اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
   مجموعة الموارد	myresourcegroup	اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
   الاسم	myasa	اسم فريد يعرف خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.
   تخطيط	الاستهلاك القياسي والمخصص (معاينة)	تحدد خطة التسعير الموارد والتكلفة المرتبطة بالمثيل الخاص بك.
   المنطقة	المنطقة الأقرب إلى المستخدمين.	الموقع الأقرب إلى المستخدمين.
   بيئة تطبيقات الحاوية	myenvironment	خيار تحديد مثيل بيئة Container Apps لمشاركة نفس الشبكة الظاهرية مع الخدمات والموارد الأخرى.

   استخدم الجدول التالي كدليل لإنشاء بيئة تطبيقات الحاوية:

   الإعدادات	القيمة المقترحة	‏‏الوصف
   اسم البيئة	myenvironment	اسم فريد يعرف خدمة بيئة Azure Container Apps.
   تخطيط	الاستهلاك	تحدد خطة التسعير الموارد والتكلفة المرتبطة بالمثيل الخاص بك.
   المنطقة زائدة عن الحاجة	مُعطل	خيار إنشاء خدمة Container Apps Environment في منطقة توفر Azure.

4. حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لتوفير مثيل Azure Spring Apps.

5. من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة.

6. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.

   

هام

يحتوي ملف تعريف حمل عمل الاستهلاك على نموذج فوترة الدفع أولا بأول، دون تكلفة بدء. تتم محاسبتك على ملف تعريف حمل العمل المخصص استنادا إلى الموارد المقدمة. لمزيد من المعلومات، راجع ملفات تعريف حمل العمل في Azure Container Apps وأسعار Azure Spring Apps.

3.3. إعداد مثيل PostgreSQL

استخدم الخطوات التالية لإنشاء قاعدة بيانات Azure لخادم PostgreSQL:

1. انتقل إلى مدخل Microsoft Azure وحدد Create a resource.

2. حدد قواعد بيانات>Azure Database لـPostgreSQL.

3. حدد خيار النشر «Flexible server».

   

4. املأ علامة التبويب Basics بالمعلومات التالية:

   • اسم الخادم: my-demo-pgsql
   • المنطقة: شرق الولايات المتحدة
   • إصدار PostgreSQL: 14
   • نوع حمل العمل: التطوير
   • تمكين قابلية الوصول العالية: غير محدد
   • أسلوب المصادقة: مصادقة PostgreSQL فقط
   • اسم المستخدم مسؤول: myadmin
   • كلمة المرور وتأكيد كلمة المرور: أدخل كلمة مرور.

5. استخدم المعلومات التالية لتكوين علامة التبويب Networking :

   • أسلوب الاتصال: الوصول العام (عناوين IP المسموح بها)
   • السماح بالوصول العام من أي خدمة Azure داخل Azure إلى هذا الخادم: محدد

6. حدد Review + create لمراجعة التحديدات الخاصة بك، وحدد Create لتوفير الخادم. قد تستغرق هذه العملية بضع دقائق.

7. انتقل إلى خادم PostgreSQL في مدخل Microsoft Azure. في صفحة نظرة عامة ، ابحث عن قيمة اسم الخادم، ثم سجلها لاستخدامها لاحقا. تحتاج إليه لتكوين متغيرات البيئة للتطبيق في Azure Spring Apps.

8. حدد Databases من قائمة التنقل لإنشاء قاعدة بيانات - على سبيل المثال، todo.

   

3.4. الاتصال مثيل التطبيق إلى مثيل PostgreSQL

استخدم الخطوات التالية لتوصيل مثيلات الخدمة:

1. انتقل إلى مثيل Azure Spring Apps في مدخل Azure.

2. من قائمة التنقل، افتح التطبيقات، ثم حدد إنشاء تطبيق.

3. في صفحة Create App ، املأ اسم التطبيق simple-todo-api وحدد Java artifacts كنوع النشر.

4. حدد Create لإنهاء إنشاء التطبيق وحدد التطبيق لعرض التفاصيل.

5. انتقل إلى التطبيق الذي أنشأته في مدخل Microsoft Azure. في صفحة Overview ، حدد Assign endpoint لعرض نقطة النهاية العامة للتطبيق. احفظ عنوان URL للوصول إلى التطبيق بعد النشر.

6. انتقل إلى التطبيق الذي أنشأته، وقم بتوسيع الإعدادات وحدد التكوين من قائمة التنقل، ثم حدد متغيرات البيئة لتعيين متغيرات البيئة.

7. أضف متغيرات البيئة التالية لاتصال PostgreSQL، ثم حدد حفظ لإنهاء تحديث تكوين التطبيق. تأكد من استبدال العناصر النائبة بالقيم الخاصة بك التي قمت بإنشائها مسبقا.

   متغير البيئة	القيمة‬
   SPRING_DATASOURCE_URL	jdbc:postgresql://<your-PostgreSQL-server-name>:5432/<your-PostgreSQL-database-name>
   SPRING_DATASOURCE_USERNAME	<your-PostgreSQL-admin-user>
   SPRING_DATASOURCE_PASSWORD	<your-PostgreSQL-admin-password>

   

3.5. كشف واجهات برمجة التطبيقات RESTful

استخدم الخطوات التالية لعرض واجهات برمجة تطبيقات RESTful في معرف Microsoft Entra:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إذا كان لديك حق الوصول إلى عدة مستأجرين، فاستخدم عامل تصفية الدليل + الاشتراك ( ) لتحديد المستأجر الذي تريد تسجيل تطبيق فيه.

3. ابحث عن Microsoft Entra ID وحدده.

4. ضمن Manage، حدد App registrationsتسجيل >جديد.

5. أدخل اسما لتطبيقك في حقل الاسم - على سبيل المثال، Todo. قد يرى مستخدمو التطبيق الخاص بك هذا الاسم، ويمكنك تغييره لاحقًا.

6. بالنسبة إلى أنواع الحسابات المدعومة، حدد الحسابات في أي دليل تنظيمي (أي دليل Microsoft Entra - متعدد المستأجرين) وحسابات Microsoft الشخصية.

7. حدد Register لإنشاء التطبيق.

8. في صفحة "Overview" للتطبيق، ابحث عن قيمة Application (client) ID وسجله للاستخدام لاحقاً. تحتاج إليه لتكوين ملف تكوين YAML لهذا المشروع.

9. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات، وابحث عن معرف التطبيق URI في بداية الصفحة، ثم حدد إضافة.

10. في صفحة تحرير معرف التطبيق URI ، اقبل معرف التطبيق المقترح URI (api://{client ID}) أو استخدم اسما ذا معنى بدلا من معرف العميل، مثل api://simple-todo، ثم حدد حفظ.

11. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات>إضافة نطاق، ثم أدخل المعلومات التالية:

    • بالنسبة إلى اسم النطاق، أدخل ToDo.Read.
    • للحصول على موافقة روبوت Who، حدد مسؤول فقط.
    • للحصول على اسم عرض الموافقة مسؤول، أدخل قراءة بيانات ToDo.
    • للحصول على وصف الموافقة مسؤول، أدخل السماح للمستخدمين المصادق عليهم بقراءة بيانات ToDo.
    • بالنسبة إلى State، احتفظ به ممكنا.
    • حدد إضافة نطاق.

12. كرر الخطوات السابقة لإضافة النطاقين الآخرين: ToDo.Write و ToDo.Delete.

    

3.6. تحديث تكوين التطبيق

استخدم الخطوات التالية لتحديث ملف YAML لاستخدام معلومات التطبيق المسجلة في Microsoft Entra لإنشاء علاقة مع تطبيق واجهة برمجة تطبيقات RESTful:

1. حدد موقع ملف simple-todo-api src/main/resources/application.yml للتطبيق. قم بتحديث التكوين في spring.cloud.azure.active-directory القسم لمطابقة المثال التالي. تأكد من استبدال العناصر النائبة بالقيم التي قمت بإنشائها مسبقا.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   إشعار

   في الرموز المميزة v1.0، يتطلب التكوين معرف العميل لواجهة برمجة التطبيقات، بينما في الرموز المميزة v2.0، يمكنك استخدام معرف العميل أو معرف التطبيق URI في الطلب. يمكنك تكوين كليهما لإكمال التحقق من صحة الجمهور بشكل صحيح.

   القيم المسموح بها tenant-id هي: commonأو organizationsconsumersأو أو معرف المستأجر. لمزيد من المعلومات حول هذه القيم، راجع قسم استخدام نقطة النهاية الخاطئة (الحسابات الشخصية والمؤسسة) في AAD (دليل Azure النشط)STS50020 الخطأ - حساب المستخدم من موفر الهوية غير موجود في المستأجر. للحصول على معلومات حول تحويل تطبيق المستأجر الفردي، راجع تحويل تطبيق المستأجر الفردي إلى متعدد المستأجرين على معرف Microsoft Entra.

2. استخدم الأمر التالي لإعادة إنشاء نموذج المشروع:

   ./mvnw clean package
   

Azure Developer CLI

3.1. إعداد موارد Azure

استخدم الخطوات التالية لتوفير موارد Azure المطلوبة:

1. قم بتشغيل الأمر التالي لتسجيل الدخول إلى Azure باستخدام OAuth2. تجاهل هذه الخطوة إذا قمت بتسجيل الدخول بالفعل.

   azd auth login
   

2. قم بتشغيل الأمر التالي لتمكين ميزة Azure Spring Apps:

   azd config set alpha.springapp on
   

3. قم بتشغيل الأمر التالي لحزم نسخة قابلة للتوزيع من التطبيق الخاص بك، وتوفير البنية الأساسية للقالب إلى Azure، ونشر التعليمات البرمجية للتطبيق إلى تلك الموارد التي تم توفيرها حديثا:

   azd provision
   

   تصف القائمة التالية تفاعلات الأوامر:

   • حدد اشتراك Azure لاستخدامه: استخدم الأسهم للتنقل، واكتب للتصفية، ثم اضغط على مفتاح الإدخال Enter.
   • حدد موقع Azure لاستخدامه: استخدم الأسهم للتنقل، واكتب للتصفية، ثم اضغط على مفتاح الإدخال Enter.

   مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/overview
   

   إشعار

   قد يستغرق هذا الأمر بعض الوقت لإكماله. ترى مؤشر تقدم أثناء توفير موارد Azure.

3.2. كشف واجهات برمجة التطبيقات RESTful

استخدم الخطوات التالية لعرض واجهات برمجة تطبيقات RESTful في معرف Microsoft Entra:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إذا كان لديك حق الوصول إلى عدة مستأجرين، فاستخدم عامل تصفية الدليل + الاشتراك ( ) لتحديد المستأجر الذي تريد تسجيل تطبيق فيه.

3. ابحث عن Microsoft Entra ID وحدده.

4. ضمن Manage، حدد App registrationsتسجيل >جديد.

5. أدخل اسما لتطبيقك في حقل الاسم - على سبيل المثال، Todo. قد يرى مستخدمو التطبيق الخاص بك هذا الاسم، ويمكنك تغييره لاحقًا.

6. بالنسبة إلى أنواع الحسابات المدعومة، حدد الحسابات في أي دليل تنظيمي (أي دليل Microsoft Entra - متعدد المستأجرين) وحسابات Microsoft الشخصية.

7. حدد Register لإنشاء التطبيق.

8. في صفحة "Overview" للتطبيق، ابحث عن قيمة Application (client) ID وسجله للاستخدام لاحقاً. تحتاج إليه لتكوين ملف تكوين YAML لهذا المشروع.

9. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات، وابحث عن معرف التطبيق URI في بداية الصفحة، ثم حدد إضافة.

10. في صفحة تحرير معرف التطبيق URI ، اقبل معرف التطبيق المقترح URI (api://{client ID}) أو استخدم اسما ذا معنى بدلا من معرف العميل، مثل api://simple-todo، ثم حدد حفظ.

11. ضمن إدارة، حدد كشف واجهة برمجة التطبيقات>إضافة نطاق، ثم أدخل المعلومات التالية:

    • بالنسبة إلى اسم النطاق، أدخل ToDo.Read.
    • للحصول على موافقة روبوت Who، حدد مسؤول فقط.
    • للحصول على اسم عرض الموافقة مسؤول، أدخل قراءة بيانات ToDo.
    • للحصول على وصف الموافقة مسؤول، أدخل السماح للمستخدمين المصادق عليهم بقراءة بيانات ToDo.
    • بالنسبة إلى State، احتفظ به ممكنا.
    • حدد إضافة نطاق.

12. كرر الخطوات السابقة لإضافة النطاقين الآخرين: ToDo.Write و ToDo.Delete.

    

3.3. تحديث تكوين التطبيق

استخدم الخطوات التالية لتحديث ملف YAML لاستخدام معلومات التطبيق المسجلة في Microsoft Entra لإنشاء علاقة مع تطبيق واجهة برمجة تطبيقات RESTful:

1. حدد موقع ملف simple-todo-api src/main/resources/application.yml للتطبيق. قم بتحديث التكوين في spring.cloud.azure.active-directory القسم لمطابقة المثال التالي. تأكد من استبدال العناصر النائبة بالقيم التي قمت بإنشائها مسبقا.

   spring:
     cloud:
       azure:
         active-directory:
           profile:
             tenant-id: <tenant>
           credential:
             client-id: <your-application-ID-of-ToDo>
           app-id-uri: <your-application-ID-URI-of-ToDo>
   

   إشعار

   في الرموز المميزة v1.0، يتطلب التكوين معرف العميل لواجهة برمجة التطبيقات، بينما في الرموز المميزة v2.0، يمكنك استخدام معرف العميل أو معرف التطبيق URI في الطلب. يمكنك تكوين كليهما لإكمال التحقق من صحة الجمهور بشكل صحيح.

   القيم المسموح بها tenant-id هي: commonأو organizationsconsumersأو أو معرف المستأجر. لمزيد من المعلومات حول هذه القيم، راجع قسم استخدام نقطة النهاية الخاطئة (الحسابات الشخصية والمؤسسة) في AAD (دليل Azure النشط)STS50020 الخطأ - حساب المستخدم من موفر الهوية غير موجود في المستأجر. للحصول على معلومات حول تحويل تطبيق المستأجر الفردي، راجع تحويل تطبيق المستأجر الفردي إلى متعدد المستأجرين على معرف Microsoft Entra.

2. استخدم الأمر التالي لإعادة إنشاء نموذج المشروع:

   ./mvnw clean package
   

4. نشر التطبيق إلى Azure Spring Apps

يمكنك الآن نشر التطبيق إلى Azure Spring Apps.

مدخل Azure + المكون الإضافي ل Maven

استخدم الخطوات التالية للنشر باستخدام المكون الإضافي Maven ل Azure Spring Apps:

1. انتقل إلى الدليل الكامل ، ثم قم بتشغيل الأمر التالي لتكوين التطبيق في Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   تصف القائمة التالية تفاعلات الأوامر:

   • تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.
   • حدد subscription: حدد رقم قائمة الاشتراك لمثيل Azure Spring Apps الذي أنشأته، والذي يتم تعيينه افتراضيا إلى الاشتراك الأول في القائمة. إذا كنت تستخدم الرقم الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • استخدام Azure Spring Apps الموجودة في Azure: اضغط على y لاستخدام مثيل Azure Spring Apps الحالي.
   • حدد Azure Spring Apps للنشر: حدد عدد مثيل Azure Spring Apps الذي أنشأته. إذا كنت تستخدم الرقم الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • استخدم التطبيق الموجود في Azure Spring Apps <your-instance-name>: اضغط y لاستخدام التطبيق الذي تم إنشاؤه.
   • تأكد من حفظ جميع التكوينات أعلاه: اضغط على y. إذا قمت بالضغط على n، فلن يتم حفظ التكوين في ملفات POM.

2. استخدم الأمر التالي لنشر التطبيق:

   ./mvnw azure-spring-apps:deploy
   

   تصف القائمة التالية تفاعل الأمر:

   • تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.

   بعد تنفيذ الأمر، يمكنك أن ترى من رسائل السجل التالية أن النشر كان ناجحا:

[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io

Azure Developer CLI

استخدم الخطوات التالية لحزم التطبيق، وتوفير موارد Azure المطلوبة من قبل تطبيق الويب، ثم النشر إلى Azure Spring Apps.

1. قم بتشغيل الأمر التالي لحزم نسخة قابلة للنشر من التطبيق الخاص بك:

   azd package
   

2. قم بتشغيل الأمر التالي لنشر التعليمات البرمجية للتطبيق إلى تلك الموارد التي تم توفيرها حديثا:

   azd deploy
   

   مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:

   Deploying services (azd deploy)
   
   WARNING: Feature 'springapp' is in alpha stage.
   To learn more about alpha features and their support, visit https://aka.ms/azd-feature-stages.
   
   ...
   
   Deploying service simple-todo-api (Fetching endpoints for spring app service)
   - Endpoint: https://simple-todo-api.xxxxxxxx-xxxxxxxx.xxxxxx.azurecontainerapps.io
   
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   نقطة نهاية الإخراج هي نقطة النهاية الأساسية للوصول إلى تطبيق ToDo API.

إشعار

يمكنك أيضا استخدام azd up لدمج الأوامر الثلاثة السابقة: azd provision (توفير موارد Azure)، azd package (حزم نسخة قابلة للتوزيع من التطبيق الخاص بك)، و azd deploy (نشر التعليمات البرمجية للتطبيق). لمزيد من المعلومات، راجع Azure-Samples/ASA-Samples-Restful-Application.

5. التحقق من صحة التطبيق

يمكنك الآن الوصول إلى واجهة برمجة تطبيقات RESTful لمعرفة ما إذا كانت تعمل.

5.1. طلب رمز مميز للوصول

تعمل واجهات برمجة تطبيقات RESTful كخادم موارد، وهو محمي بواسطة معرف Microsoft Entra. قبل الحصول على رمز مميز للوصول، يجب عليك تسجيل تطبيق آخر في معرف Microsoft Entra ومنح أذونات لتطبيق العميل، الذي يسمى ToDoWeb.

تسجيل تطبيق العميل

استخدم الخطوات التالية لتسجيل تطبيق في معرف Microsoft Entra، والذي يستخدم لإضافة أذونات ToDo التطبيق:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إذا كان لديك حق الوصول إلى عدة مستأجرين، فاستخدم عامل تصفية الدليل + الاشتراك ( ) لتحديد المستأجر الذي تريد تسجيل تطبيق فيه.

3. ابحث عن Microsoft Entra ID وحدده.

4. ضمن Manage، حدد App registrationsتسجيل >جديد.

5. أدخل اسما للتطبيق الخاص بك في حقل الاسم - على سبيل المثال، ToDoWeb. قد يرى مستخدمو التطبيق الخاص بك هذا الاسم، ويمكنك تغييره لاحقًا.

6. بالنسبة إلى أنواع الحسابات المدعومة، استخدم القيمة الافتراضية حسابات في هذا الدليل التنظيمي فقط.

7. حدد Register لإنشاء التطبيق.

8. في صفحة "Overview" للتطبيق، ابحث عن قيمة Application (client) ID وسجله للاستخدام لاحقاً. تحتاج إليها للحصول على رمز مميز للوصول.

9. حدد أذونات واجهة برمجة التطبيقات> وأضف إذن >واجهات برمجة التطبيقات الخاصة بي. ToDo حدد التطبيق الذي قمت بتسجيله مسبقا، ثم حدد أذونات ToDo.Read و ToDo.Write و ToDo.Delete. حدد إضافة أذونات.

10. حدد منح موافقة المسؤول لاسم <> المستأجر لمنح موافقة المسؤول على الأذونات التي أضفتها.

    

إضافة مستخدم للوصول إلى واجهات برمجة تطبيقات RESTful

استخدم الخطوات التالية لإنشاء مستخدم عضو في مستأجر Microsoft Entra. ثم، يمكن للمستخدم إدارة بيانات التطبيق من ToDo خلال واجهات برمجة تطبيقات RESTful.

1. ضمن Manage، حدد Users>New user>Create new user.

2. في صفحة إنشاء مستخدم جديد، أدخل المعلومات التالية:

   • اسم المستخدم الأساسي: أدخل اسما للمستخدم.
   • اسم العرض: أدخل اسم عرض للمستخدم.
   • كلمة المرور: انسخ كلمة المرور التي تم إنشاؤها تلقائيا والمتوفرة في المربع كلمة المرور .

   إشعار

   يجب على المستخدمين الجدد إكمال مصادقة تسجيل الدخول الأولى وتحديث كلمات المرور الخاصة بهم، وإلا فستتلقى خطأ AADSTS50055: The password is expired عند الحصول على رمز الوصول المميز.

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

3. حدد «Review + create» لمراجعة اختياراتك. حدد Create لإنشاء المستخدم.

تحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger

استخدم الخطوات التالية لتحديث تكوين OAuth2 لتخويل واجهة مستخدم Swagger. بعد ذلك، يمكنك تخويل المستخدمين للحصول على رموز الوصول المميزة ToDoWeb من خلال التطبيق.

1. افتح مستأجر Microsoft Entra ID في مدخل Microsoft Azure، وانتقل إلى التطبيق المسجلToDoWeb.

2. ضمن Manage، حدد Authentication، وحدد Add a platform، ثم حدد Single-page application.

3. استخدم التنسيق <your-app-exposed-application-URL-or-endpoint>/swagger-ui/oauth2-redirect.html كعنون URL لإعادة توجيه OAuth2 في حقل Redirect URIs ، ثم حدد Configure.

   

الحصول على الرمز المميز للوصول

استخدم الخطوات التالية لاستخدام أسلوب تدفق رمز التخويل OAuth 2.0 للحصول على رمز وصول باستخدام معرف Microsoft Entra، ثم الوصول إلى واجهات برمجة تطبيقات ToDo RESTful للتطبيق:

1. افتح عنوان URL الذي يعرضه التطبيق، ثم حدد تخويل لإعداد مصادقة OAuth2.

2. في نافذة التخويلات المتوفرة، أدخل معرف ToDoWeb العميل للتطبيق في حقل client_id، وحدد جميع النطاقات لحقل النطاقات، وتجاهل حقل client_secret، ثم حدد تخويل لإعادة التوجيه إلى صفحة تسجيل الدخول إلى Microsoft Entra.

بعد إكمال تسجيل الدخول مع المستخدم السابق، يتم إرجاعك إلى نافذة التخويلات المتوفرة .

5.2. الوصول إلى واجهات برمجة تطبيقات RESTful

استخدم الخطوات التالية للوصول إلى واجهات برمجة تطبيقات ToDo RESTful للتطبيق في واجهة مستخدم Swagger:

1. حدد API POST /api/simple-todo/lists ثم حدد Try it out. أدخل نص الطلب التالي، ثم حدد Execute لإنشاء قائمة ToDo.

   {
     "name": "My List"
   }
   

   بعد اكتمال التنفيذ، سترى نص الاستجابة التالي:

   {
     "id": "<ID-of-the-ToDo-list>",
     "name": "My List",
     "description": null
   }
   

2. حدد API POST /api/simple-todo/lists/{listId}/items ثم حدد Try it out. بالنسبة إلى listId، أدخل معرف قائمة ToDo الذي قمت بإنشائه مسبقا، وأدخل نص الطلب التالي، ثم حدد Execute لإنشاء عنصر ToDo.

   {
     "name": "My first ToDo item", 
     "listId": "<ID-of-the-ToDo-list>",
     "state": "todo"
   }
   

   يقوم هذا الإجراء بإرجاع عنصر ToDo التالي:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": null,
     "state": "todo",
     "dueDate": "2023-07-11T13:59:24.9033069+08:00",
     "completedDate": null
   }
   

3. حدد API GET /api/simple-todo/lists ثم حدد Execute للاستعلام عن قوائم ToDo. يقوم هذا الإجراء بإرجاع قوائم ToDo التالية:

   [
     {
       "id": "<ID-of-the-ToDo-list>",
       "name": "My List",
       "description": null
     }
   ]
   

4. حدد واجهة برمجة التطبيقات GET /api/simple-todo/lists/{listId}/items ثم حدد Try it out. بالنسبة إلى listId، أدخل معرف قائمة ToDo الذي أنشأته مسبقا، ثم حدد Execute للاستعلام عن عناصر ToDo. يقوم هذا الإجراء بإرجاع عنصر ToDo التالي:

   [
     {
       "id": "<ID-of-the-ToDo-item>",
       "listId": "<ID-of-the-ToDo-list>",
       "name": "My first ToDo item",
       "description": null,
       "state": "todo",
       "dueDate": "2023-07-11T13:59:24.903307+08:00",
       "completedDate": null
     }
   ]
   

5. حدد واجهة برمجة التطبيقات PUT /api/simple-todo/lists/{listId}/items/{itemId} ثم حدد Try it out. بالنسبة إلى listId، أدخل معرف قائمة ToDo. بالنسبة إلى itemId، أدخل معرف عنصر ToDo، وأدخل نص الطلب التالي، ثم حدد Execute لتحديث عنصر ToDo.

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "dueDate": "2023-07-11T13:59:24.903307+08:00",
     "state": "inprogress"
   }
   

   يقوم هذا الإجراء بإرجاع عنصر ToDo المحدث التالي:

   {
     "id": "<ID-of-the-ToDo-item>",
     "listId": "<ID-of-the-ToDo-list>",
     "name": "My first ToDo item",
     "description": "Updated description.",
     "state": "inprogress",
     "dueDate": "2023-07-11T05:59:24.903307Z",
     "completedDate": null
   }
   

6. حدد API DELETE /api/simple-todo/lists/{listId}/items/{itemId} ثم حدد Try it out. بالنسبة إلى listId، أدخل معرف قائمة ToDo. بالنسبة إلى itemId، أدخل معرف عنصر ToDo، ثم حدد Execute لحذف عنصر ToDo. يجب أن ترى أن رمز استجابة الخادم هو 204.

6. حذف الموارد

يمكنك حذف مجموعة موارد Azure، التي تتضمن كافة الموارد الموجودة في مجموعة الموارد.

مدخل Azure + المكون الإضافي ل Maven

استخدم الخطوات التالية لحذف مجموعة الموارد بأكملها، بما في ذلك الخدمة التي تم إنشاؤها حديثا:

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure.

2. في قائمة التنقل، حدد Resource groups. ثم حدد اسم مجموعة الموارد الخاصة بك - على سبيل المثال، myresourcegroup.

3. في صفحة مجموعة الموارد الخاصة بك، حدد حذف. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف - على سبيل المثال، myresourcegroup. ثم حدد Delete.

Azure CLI

استخدم الأمر التالي لحذف مجموعة الموارد بأكملها، بما في ذلك الخدمة التي تم إنشاؤها حديثا:

az group delete --name ${RESOURCE_GROUP}

مدخل Azure + المكون الإضافي ل Maven

استخدم الخطوات التالية لحذف مجموعة الموارد بأكملها، بما في ذلك الخدمة التي تم إنشاؤها حديثا:

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure.

2. في قائمة التنقل، حدد Resource groups. ثم حدد اسم مجموعة الموارد الخاصة بك - على سبيل المثال، myresourcegroup.

3. في صفحة مجموعة الموارد الخاصة بك، حدد حذف. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف - على سبيل المثال، myresourcegroup. ثم حدد Delete.

Azure Developer CLI

استخدم الأمر التالي لحذف جميع موارد Azure المستخدمة في نموذج التطبيق هذا:

azd down

تصف القائمة التالية تفاعل الأمر:

• إجمالي الموارد المراد حذفها: [your-resources-total]، هل تريد بالتأكيد المتابعة؟: اضغط على y.

مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

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

التشغيل السريع: نشر تطبيق يستند إلى الحدث إلى Azure Spring Apps

التشغيل السريع: نشر تطبيقات الخدمات المصغرة إلى Azure Spring Apps

سجل التطبيقات المنظم لـ Azure Spring Apps

تعيين مجال مخصص موجود إلى Azure Spring Apps

استخدام Azure Spring Apps CI/CD مع إجراءات GitHub

أتمتة نشر التطبيقات في Azure Spring Apps

لمزيد من المعلومات، راجع المقالات التالية:

• نماذج Azure Spring Apps.
• Spring on Azure
• Spring Cloud Azure