التشغيل السريع - توزيع التطبيق الأول في Azure Spring Apps

إشعار

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

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

توضح هذه المقالة كيفية نشر تطبيق صغير للتشغيل على Azure Spring Apps.

رمز التطبيق المستخدم في هذا البرنامج التعليمي هو تطبيق بسيط. عند إكمال هذا المثال، يمكن الوصول إلى التطبيق عبر الإنترنت، ويمكنك إدارته من خلال مدخل Microsoft Azure.

توفر هذه المقالة الخيارات التالية للنشر في Azure Spring Apps:

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

• يعد خيار مدخل Microsoft Azure أسهل وأسرع طريقة لإنشاء الموارد ونشر التطبيقات بنقرة واحدة. هذا الخيار مناسب لمطوري Spring الذين يرغبون في نشر التطبيقات بسرعة إلى خدمات سحابة Azure.
• يعد خيار المكون الإضافي لمدخل Azure + Maven طريقة أكثر تقليدية لإنشاء الموارد ونشر التطبيقات خطوة بخطوة. هذا الخيار مناسب لمطوري Spring الذين يستخدمون خدمات سحابة Azure لأول مرة.
• يستخدم خيار Azure CLI أداة سطر أوامر قوية لإدارة موارد Azure. هذا الخيار مناسب لمطوري Spring الذين هم على دراية بخدمات Azure السحابية.
• يستخدم خيار IntelliJ Java IDE قويا لإدارة موارد Azure بسهولة. هذا الخيار مناسب لمطوري Spring الذين هم على دراية بخدمات Azure السحابية وIntelliJ IDEA.
• يستخدم خيار Visual Studio Code محرر تعليمات برمجية مصدر خفيف الوزن ولكنه قوي، والذي يمكنه إدارة موارد Azure بسهولة. هذا الخيار مناسب لمطوري Spring الذين هم على دراية بخدمات Azure السحابية وVisual Studio Code.

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

مدخل Microsoft Azure

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

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

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• Git.
• Java Development Kit (JDK)، الإصدار 17.

Azure Developer CLI

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• Git.
• Java Development Kit (JDK)، الإصدار 17.
• Azure Developer CLI (AZD) ، الإصدار 1.2.0 أو أعلى.

مدخل Microsoft Azure

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

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

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.
• Git.
• Java Development Kit (JDK)، الإصدار 17.

Azure CLI

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.
• Git.
• Java Development Kit (JDK)، الإصدار 17.
• إصدار Azure CLI 2.45.0 أو أعلى.

IntelliJ

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.
• Java Development Kit (JDK)، الإصدار 17.
• IntelliJ IDEA.
• Azure Toolkit لـ IntelliJ.

Visual Studio Code

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
• إذا كنت تقوم بنشر مثيل خطة Azure Spring Apps Enterprise للمرة الأولى في الاشتراك الهدف، فشاهد قسم المتطلبات في خطة المؤسسة في Azure Marketplace.
• Java Development Kit (JDK)، الإصدار 17.
• تعليمة Visual Studio البرمجية.

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة spring-cloud-azure-tools releases على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.

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

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

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

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. استخدم الأمر التالي للانتقال إلى مجلد المشروع:

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. قم بتشغيل نموذج المشروع محليا باستخدام الأمر التالي:

   ./mvnw spring-boot:run
   

Azure Developer CLI

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

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

2. استخدم الأمر التالي لتهيئة المشروع:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

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

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

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

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   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.

مدخل Microsoft Azure

يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.

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

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

3.2. إنشاء موارد Azure

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

1. حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:

   

2. املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:

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

3. حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.

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

   

مدخل 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. املأ نموذج الأساسيات بالمعلومات التالية.

   استخدم الجدول التالي كدليل لإكمال النموذج. الخطة الموصى بها هي Standard consumption & dedicated (preview).

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

4. (اختياري) إنشاء بيئة تطبيقات الحاوية.

   حمل عمل الاستهلاك

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

      • اسم البيئة: myacaenv
      • الخطة: الاستهلاك
      • تكرار المنطقة: معطل

   2. حدد إنشاء لإنشاء بيئة تطبيقات الحاوية.

   حمل عمل مخصص

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

      • اسم البيئة: myacaenv
      • الخطة: (معاينة) الاستهلاك وملفات تعريف حمل العمل المخصصة
      • تكرار المنطقة: معطل

   2. حدد علامة التبويب ملفات تعريف حمل العمل (معاينة)، ثم حدد إضافة ملف تعريف حمل العمل لإضافة ملف تعريف حمل العمل.

   3. في صفحة إضافة ملف تعريف حمل العمل (معاينة)، أضف المعلومات التالية:

      • اسم ملف تعريف حمل العمل: my-wlp
      • حجم ملف تعريف حمل العمل: حدد Dedicated-D4
      • نطاق عدد مثيلات التحجيم التلقائي: حدد 3 و5

      

   4. حدد إضافة. يعيدك هذا التحديد إلى صفحة إضافة ملف تعريف حمل العمل (معاينة ). حدد my-wlp، ثم حدد Create لإنشاء بيئة تطبيقات الحاوية.

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

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

   

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

Azure Developer CLI

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

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

   azd auth login
   

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

   Logged in to Azure.
   

2. استخدم الأمر التالي لتوفير البنية الأساسية للقالب إلى 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>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   إشعار

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

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم السابق بتشغيل تجربة مدخل Azure التي تتضمن نشر التطبيق، لذلك لا توجد حاجة إلى أي شيء آخر.

مدخل 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>: اضغط على n لإنشاء تطبيق جديد.
   • إدخال اسم التطبيق (عرض توضيحي): توفير اسم تطبيق. إذا كنت تستخدم معرف البيانات الاصطناعية للمشروع الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • كشف الوصول العام لهذا التطبيق (boot-for-azure): اضغط على 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
   

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

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

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

   azd deploy
   

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

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://demo.xxx.<your-azure-location>.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
   

إشعار

يمكنك أيضا استخدام azd up لدمج الأوامر الثلاثة السابقة: azd provision (توفير موارد Azure)، azd package (حزم نسخة قابلة للتوزيع من التطبيق الخاص بك)، و azd deploy (نشر التعليمات البرمجية للتطبيق). لمزيد من المعلومات، راجع spring-guides/gs-spring-boot-for-azure.

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة spring-cloud-azure-tools releases على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.

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

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

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

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. استخدم الأمر التالي للانتقال إلى مجلد المشروع:

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. قم بتشغيل نموذج المشروع محليا باستخدام الأمر التالي:

   ./mvnw spring-boot:run
   

Azure Developer CLI

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

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

2. استخدم الأمر التالي لتهيئة المشروع:

   azd init --template spring-guides/gs-spring-boot-for-azure
   

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

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

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

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   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.

مدخل Microsoft Azure

يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.

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

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

3.2. إنشاء موارد Azure

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

1. حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:

   

2. املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:

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

3. حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.

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

   

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

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

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

3.2. إنشاء مثيل 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. هذه الميزة غير مدعومة حاليا في جميع المناطق.

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

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

   

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

Azure Developer CLI

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

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

   azd auth login
   

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

   Logged in to Azure.
   

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

   azd env set PLAN standard
   

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>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   إشعار

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

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم السابق بتشغيل تجربة مدخل Azure التي تتضمن نشر التطبيق، لذلك لا توجد حاجة إلى أي شيء آخر.

مدخل 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>: اضغط على n لإنشاء تطبيق جديد.
   • إدخال اسم التطبيق (عرض توضيحي): توفير اسم تطبيق. إذا كنت تستخدم معرف البيانات الاصطناعية للمشروع الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • كشف الوصول العام لهذا التطبيق (boot-for-azure): اضغط على 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-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
   [INFO]   InstanceName:demo-default-x-xxxxxxxxx-xxxxx  Status:Terminating Reason:null       DiscoverStatus:UNREGISTERED
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Azure Developer CLI

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

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

   azd package
   

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

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

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

   azd deploy
   

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

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.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
   

إشعار

يمكنك أيضا استخدام azd up لدمج الأوامر الثلاثة السابقة: azd package (حزم نسخة قابلة للتوزيع من التطبيق الخاص بك)، azd provision (توفير موارد Azure)، و azd deploy (نشر التعليمات البرمجية للتطبيق). لمزيد من المعلومات، راجع spring-guides/gs-spring-boot-for-azure.

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة spring-cloud-azure-tools releases على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.

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

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

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

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. استخدم الأمر التالي للانتقال إلى مجلد المشروع:

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. قم بتشغيل نموذج المشروع محليا باستخدام الأمر التالي:

   ./mvnw spring-boot:run
   

Azure CLI

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

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

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. استخدم الأمر التالي للانتقال إلى مجلد المشروع:

   cd gs-spring-boot-for-azure/complete
   

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

   ./mvnw clean package
   

4. قم بتشغيل نموذج المشروع محليا باستخدام الأمر التالي:

   ./mvnw spring-boot:run
   

IntelliJ

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

1. استخدم الأمر التالي لإنشاء نموذج مشروع من start.spring.io مع التبعيات الموصى بها ل Azure Spring Apps:

   curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -
   

2. إنشاء وحدة تحكم ويب لتطبيق الويب الخاص بك عن طريق إضافة الملف src/main/java/com/example/demo/HelloController.java بالمحتويات التالية:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Hello World";
        }
   }
   

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

   ./mvnw clean package
   

4. قم بتشغيل نموذج المشروع محليا باستخدام الأمر التالي:

   ./mvnw spring-boot:run
   

Visual Studio Code

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

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

يصف هذا القسم كيفية إنشاء مثيل خدمة Azure Spring Apps وإعداد بيئة سحابة Azure.

مدخل Microsoft Azure

يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.

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

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

3.2. إنشاء موارد Azure

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

1. حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:

   

2. املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:

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

3. حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.

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

   

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

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

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

3.2. إنشاء مثيل 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.
   توزيع نموذج المشروع	غير محدد	خيار استخدام نموذج التطبيق المضمن.

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

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

   

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

Azure CLI

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

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

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

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 ${SERVICE_NAME} \
       --sku Enterprise
   

3.5. إنشاء تطبيق في مثيل Azure Spring Apps

التطبيق هو تجريد لتطبيق عمل واحد. لمزيد من المعلومات، راجع التطبيق والتوزيع في Azure Spring Apps. تعمل التطبيقات في مثيل خدمة Azure Spring Apps، كما هو موضح في الرسم التخطيطي التالي.

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

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

IntelliJ

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

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

3.2. إنشاء مثيل 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.
   توزيع نموذج المشروع	غير محدد	خيار استخدام نموذج التطبيق المضمن.

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

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

   

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

Visual Studio Code

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

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

مدخل Microsoft Azure

يقوم الزر Deploy to Azure في القسم السابق بتشغيل تجربة مدخل Azure التي تتضمن نشر التطبيق، لذلك لا توجد حاجة إلى أي شيء آخر.

مدخل 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>: اضغط على n لإنشاء تطبيق جديد.
   • إدخال اسم التطبيق (عرض توضيحي): توفير اسم تطبيق. إذا كنت تستخدم معرف البيانات الاصطناعية للمشروع الافتراضي، فاضغط على مفتاح الإدخال Enter مباشرة.
   • كشف الوصول العام لهذا التطبيق (boot-for-azure): اضغط على 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-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Azure CLI

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

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

قد يستغرق نشر التطبيق بضع دقائق.

IntelliJ

يوفر هذا القسم خطوات نشر التطبيق الخاص بك إلى Azure Spring Apps.

4.1. قم باستيراد المشروع

استخدم الخطوات التالية لاستيراد المشروع:

1. افتح IntelliJ IDEA وحدد Open.

2. في مربع الحوار فتح ملف أو مشروع ، حدد المجلد التجريبي .

   

4.2. بناء التطبيق ونشره

استخدم الخطوات التالية لإنشاء تطبيقك ونشره:

1. إذا لم تقم بالفعل بتثبيت مجموعة أدوات Azure ل IntelliJ، فاتبع الخطوات الواردة في تثبيت مجموعة أدوات Azure ل IntelliJ.

   إشعار

   توفر مجموعة أدوات Azure ل IntelliJ أربع طرق لتسجيل الدخول إلى Azure، ويمكن بدء النشر فقط بعد تسجيل الدخول.

2. انقر بزر الماوس الأيمن فوق مشروعك في نافذة مشروع IntelliJ ثم حدد Azure ->Deploy to Azure Spring Apps.

   

3. قبول اسم التطبيق في الحقل Name. يشير Name إلى التكوين وليس إلى اسم التطبيق. لا تحتاج عادة إلى تغييره.

4. في مربع النص Artifact ، حدد Maven:demo(Java 17).

5. في مربع النص Subscription ، تحقق من صحة اشتراكك.

6. في مربع النص Spring Apps ، حدد مثيل Azure Spring Apps الذي قمت بإنشائه.

7. في مربع نص التطبيق ، حدد علامة الجمع (+) لإنشاء تطبيق جديد.

   

8. في مربع النص اسم التطبيق: ضمن أساسيات التطبيق، أدخل العرض التوضيحي، ثم حدد المزيد من الإعدادات.

9. حدد الزر Enable بجوار Public endpoint. يتغير الزر إلى تعطيل ليتم تمكينه>.< ثم حدد OK.

   

10. ضمن Before launch، حدد Run Maven Goal 'demo:package'، ثم حدد رمز القلم الرصاص لتحرير سطر الأوامر.

    

11. في مربع النص سطر الأوامر، أدخل -DskipTests بعد الحزمة، ثم حدد موافق.

    

12. لبدء النشر، حدد الزر Run في أسفل مربع الحوار Deploy to Azure . يعمل المكون الإضافي على تشغيل الأمر package -DskipTests Maven على demo التطبيق وينشر ملف .jar الذي تم إنشاؤه بواسطة package الأمر .

قد يستغرق نشر التطبيق بضع دقائق. يمكنك مشاهدة عنوان URL العام للتطبيق في سجل وحدة تحكم الإخراج.

Visual Studio Code

لنشر التطبيق إلى Azure Spring Apps، اتبع الخطوات الواردة في قسم Build and deploy the app في Java على Azure Spring Apps.

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

يصف هذا القسم كيفية التحقق من صحة التطبيق الخاص بك.

مدخل Microsoft Azure

بعد انتهاء النشر، ابحث عن عنوان URL للتطبيق من مخرجات التوزيع. استخدم الخطوات التالية للتحقق من الصحة:

1. الوصول إلى عنوان URL للتطبيق من صفحة المخرجات الخاصة بالنشر. عند فتح التطبيق، تحصل على الاستجابة Hello World.

   

2. تحقق من تفاصيل كل نشر مورد، وهو أمر مفيد للتحقيق في أي مشكلات في التوزيع.

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

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

1. الوصول إلى عنوان URL لتطبيق الإخراج من صفحة Outputs في Deployment. عند فتح التطبيق، تحصل على الاستجابة Hello World.

   

2. من جزء التنقل في صفحة نظرة عامة على مثيل Azure Spring Apps، حدد Logs للتحقق من سجلات التطبيق.

   

Azure Developer CLI

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

مدخل Microsoft Azure

بعد انتهاء النشر، استخدم الخطوات التالية للعثور على عنوان URL للتطبيق من مخرجات النشر:

1. الوصول إلى عنوان URL للتطبيق من صفحة المخرجات الخاصة بالنشر. عند فتح التطبيق، تحصل على الاستجابة Hello World.

   

2. تحقق من تفاصيل كل نشر مورد، وهو أمر مفيد للتحقيق في أي مشكلات في التوزيع.

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

بعد انتهاء النشر، استخدم الخطوات التالية للتحقق من سجلات التطبيق للتحقيق في أي مشكلة توزيع:

1. الوصول إلى عنوان URL للتطبيق من صفحة المخرجات الخاصة بالنشر. عند فتح التطبيق، تحصل على الاستجابة Hello World.

   

2. من جزء التنقل في صفحة نظرة عامة على مثيل Azure Spring Apps، حدد Logs للتحقق من سجلات التطبيق.

   

Azure Developer CLI

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

مدخل Microsoft Azure

بعد انتهاء النشر، استخدم الخطوات التالية للعثور على عنوان URL للتطبيق من مخرجات النشر:

1. الوصول إلى عنوان URL للتطبيق من صفحة المخرجات الخاصة بالنشر. عند فتح التطبيق، تحصل على الاستجابة Hello World.

   

2. تحقق من تفاصيل كل نشر مورد، وهو أمر مفيد للتحقيق في أي مشكلات في التوزيع.

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

بعد انتهاء النشر، استخدم الخطوات التالية للتحقق من صحة التطبيق:

1. الوصول إلى عنوان URL للتطبيق. عند فتح التطبيق، تحصل على الاستجابة Hello World.

2. تحقق من سجلات وحدة التحكم، والتي تعد مفيدة للتحقيق في أي مشكلات في النشر.

Azure CLI

بعد انتهاء النشر، استخدم الخطوات التالية للتحقق من سجلات التطبيق للتحقيق في أي مشكلة توزيع:

1. الوصول إلى التطبيق باستخدام عنوان URL لتطبيق الإخراج. عند فتح التطبيق، تحصل على الاستجابة Hello World.

2. استخدم الأمر التالي للتحقق من سجل التطبيق للتحقيق في أي مشكلة توزيع:

   az spring app logs \
       --service ${SERVICE_NAME} \
       --name ${APP_NAME}
   

IntelliJ

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

1. الوصول إلى التطبيق باستخدام عنوان URL لتطبيق الإخراج. عند فتح التطبيق، تحصل على الاستجابة Hello World.

2. افتح نافذة Azure Explorer، وقم بتوسيع العقدة Azure، وقم بتوسيع عقدة الخدمة Azure Spring Apps، وقم بتوسيع مثيل Azure Spring Apps الذي أنشأته، ثم حدد مثيل العرض التوضيحي للتطبيق الذي أنشأته.

3. انقر بزر الماوس الأيمن وحدد Start Streaming Logs، ثم حدد OK لمشاهدة سجلات التطبيقات في الوقت الفعلي.

   

Visual Studio Code

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

1. الوصول إلى التطبيق باستخدام عنوان URL لتطبيق الإخراج. عند فتح التطبيق، تحصل على الاستجابة Hello World.

2. اتبع الخطوات الواردة في قسم Stream your application logs في Java على Azure Spring Apps.

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

إذا كنت تخطط لمواصلة العمل بالبدايات السريعة والبرامج التعليمية اللاحقة، فقد ترغب في ترك هذه الموارد في مكانها. عندما لم تعد بحاجة إلى الموارد، يمكنك تنظيف الموارد غير الضرورية لتجنب رسوم Azure.

مدخل Microsoft Azure

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

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure. في قائمة التنقل، حدد Resource groups، ثم حدد اسم مجموعة الموارد الخاصة بك.

2. في صفحة Resource group ، حدد Delete. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف، ثم حدد حذف.

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

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

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure. في قائمة التنقل، حدد Resource groups، ثم حدد اسم مجموعة الموارد الخاصة بك.

2. في صفحة Resource group ، حدد Delete. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف، ثم حدد حذف.

Azure CLI

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

az group delete --name ${RESOURCE_GROUP}

IntelliJ

استخدم الخطوات التالية لحذف مجموعة الموارد باستخدام IntelliJ:

1. انتقل إلى Intellij IDEA وابحث عن اسم مجموعة الموارد الخاصة بك.

2. انقر بزر الماوس الأيمن فوق مجموعة الموارد وحدد Delete لحذف جميع موارد Azure ذات الصلة.

Visual Studio Code

استخدم الخطوات التالية لحذف مجموعة الموارد باستخدام Visual Studio Code:

1. انتقل إلى Visual Studio Code، وحدد Group By لتمكين Group by Resource Group، ثم ابحث عن اسم مجموعة الموارد الخاصة بك.

2. انقر بزر الماوس الأيمن فوق مجموعة الموارد وحدد Delete Resource Group... لحذف جميع موارد Azure ذات الصلة.

مدخل Microsoft Azure

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

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure. في قائمة التنقل، حدد Resource groups، ثم حدد اسم مجموعة الموارد الخاصة بك.

2. في صفحة Resource group ، حدد Delete. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف، ثم حدد حذف.

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

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

1. حدد موقع مجموعة الموارد الخاصة بك في مدخل Microsoft Azure. في قائمة التنقل، حدد Resource groups، ثم حدد اسم مجموعة الموارد الخاصة بك.

2. في صفحة Resource group ، حدد Delete. أدخل اسم مجموعة الموارد في مربع النص لتأكيد الحذف، ثم حدد حذف.

Azure Developer CLI

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

azd down

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

• إجمالي الموارد المراد حذفها: إجمالي الموارد>، هل تريد بالتأكيد المتابعة؟: اضغط على y. <

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

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

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

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

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

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

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

استخدام الهويات المدارة للتطبيقات في Azure Spring Apps

التشغيل السريع: إنشاء اتصال خدمة في Azure Spring Apps باستخدام Azure CLI

مقدمة إلى نموذج التطبيق

مقدمة إلى تطبيق عينة 'متجر اللياقة البدنية'

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

• نماذج Azure Spring Apps.
• Azure لمطوري Spring
• وثائق Spring Cloud Azure