التشغيل السريع: نشر أول تطبيق Spring Batch إلى Azure Spring Apps

إشعار

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

إشعار

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

يوضح هذا التشغيل السريع كيفية نشر تطبيق Spring Batch سريع الزوال إلى Azure Spring Apps. يتم اشتقاق نموذج المشروع من نموذج Spring Batch Football Job. إنها مهمة تحميل إحصائيات. في العينة الأصلية، يقوم اختبار الوحدة بتشغيل المهمة. في العينة المتكيفة main ، يبدأ أسلوب FootballJobApplication الوظيفة.

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

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

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

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

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

مدخل Microsoft Azure

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

Azure CLI

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

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

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

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

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

المورد الرئيسي المطلوب لتشغيل هذا النموذج هو مثيل Azure Spring Apps. يوفر هذا القسم الخطوات لإنشاء هذا المورد.

مدخل Microsoft Azure

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. تمكين سجل الخدمة

انتقل إلى مثيل Azure Spring Apps الذي أنشأته، وقم بتوسيع المكونات المدارة في جزء التنقل، ثم حدد سجل الخدمة. ثم، في صفحة Overview، حدد Manage لفتح صفحة Manage، وحدد Enable Service Registry، ثم حدد Apply.

3.4. إعداد مساحة عمل تحليلات السجل

للحصول على معلومات حول الاستعلام عن البيانات في السجلات، راجع التشغيل السريع: إعداد مساحة عمل Log Analytics.

Azure CLI

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

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

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-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 Spring Apps لاستضافة تطبيق ويب Spring. استخدم الخطوات التالية لإنشاء مثيل Azure Spring Apps وتطبيق بداخله:

1. استخدم الأمر التالي لإنشاء مثيل خدمة Azure Spring Apps وتمكين سجل الخدمة:

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. استخدم الأمر التالي للتحقق من إنشاء مثيل خدمة خطة Azure Spring Apps Enterprise بنجاح:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. نشر تطبيق لوحة الفوترة لكرة القدم إلى Azure Spring Apps

مدخل Microsoft Azure

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

1. انتقل إلى مثيل Azure Spring Apps الذي أنشأته، وقم بتوسيع الإعدادات في جزء التنقل، ثم حدد التطبيقات.

2. في جزء التطبيقات ، حدد إنشاء تطبيق لفتح صفحة إنشاء تطبيق .

3. قم بتعيين App name إلى football-billboard، وحدد Service Registry في العمود Bind ، ثم حدد Create.

   

4. بعد إنشاء التطبيق، حدد Deploy App وانسخ أمر Azure CLI لنشر التطبيق. ثم افتح نافذة Bash والصق الأمر في سطر الأوامر، واستبدل مسار البيانات الاصطناعية بالقيمة الصحيحة لنظامك. ثم قم بتشغيل الأمر . انتظر عدة دقائق حتى ينجح الإنشاء والنشر. يجب أن يبدو الأمر والإخراج مشابهين للمثال التالي:

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. بعد النشر، ارجع إلى جزء التطبيقات وحدد football-billboard التطبيق. ثم انتقل إلى صفحة النظرة العامة وحدد تعيين نقطة النهاية لعرض نقطة النهاية العامة للتطبيق.

Azure CLI

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

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

   cd azure-spring-apps-samples/job-samples/football-billboard
   

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

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

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

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. نشر نموذج المهمة إلى Azure Spring Apps

يوفر هذا القسم خطوات نشر العينة.

مدخل Microsoft Azure

5.1. إنشاء المهمة وتنفيذها

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

1. انتقل إلى جزء المهام ثم حدد إنشاء مهمة. املأ اسم الوظيفة ك football. تكوين معلمات الوظيفة، مثل التوازي، وحدود إعادة المحاولة، والمهلة. إضافة متغيرات البيئة ومتغيرات البيئة السرية حسب الحاجة. بعد التأكيد، حدد Create.

   

2. بعد إنشاء المهمة، قم بتوسيع المكونات المدارة في جزء التنقل وحدد سجل الخدمة. ثم حدد ربط الوظيفة، وحدد ربط الوظيفة لتحديد مهمة كرة القدم، ثم حدد تطبيق للربط.

   

3. ارجع إلى جزء Jobs بعد ربط المهمة، وحدد Deploy Job، ثم انسخ أمر Azure CLI لنشر المهمة. ثم افتح نافذة Bash والصق الأمر في سطر الأوامر، واستبدل مسار البيانات الاصطناعية بالقيمة الصحيحة لنظامك. ثم قم بتشغيل الأمر . انتظر عدة دقائق حتى ينجح الإنشاء والنشر. يجب أن يبدو الأمر والإخراج مشابهين للمثال التالي:

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. بعد النشر، افتح صفحة النظرة العامة للوظيفة football عن طريق تحديد اسم الوظيفة. حدد Run لبدء تنفيذ المهمة. يمكنك تخصيص كل تنفيذ للوظيفة باستخدام معلمات مختلفة، مثل متغيرات البيئة، أو ما عليك سوى تحديد تشغيل لتشغيل التنفيذ. تشير رسالة إلى أن المهمة قيد التشغيل.

   

Azure CLI

5.1. إنشاء المهمة وتنفيذها

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

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

   cd ..
   cd football
   

2. استخدم الأمر التالي لإنشاء وظيفة في مثيل Azure Spring Apps وربط سجل الخدمة:

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. استخدم الأمر التالي لنشر football نموذج المشروع إلى المهمة. يقوم هذا الأمر بتحميل التعليمات البرمجية المصدر وتحويلها برمجيا على Azure ويجعلها جاهزة للبدء.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. استخدم الأمر التالي لبدء المهمة وتعيين EXECUTION_NAME المتغير إلى اسم تنفيذ المهمة:

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. تحقق من نتيجة تنفيذ المهمة وواجهة مستخدم لوحة الفوترة

يمكنك الآن الوصول إلى تنفيذ المهمة والتحقق من نتيجتها.

مدخل Microsoft Azure

استخدم الخطوات التالية للتحقق من الصحة:

1. في جزء عمليات التنفيذ ، تحقق من نتيجة تنفيذ المهمة. انتظر بضع ثوان وقم بالتحديث لرؤية الحالة تتحول إلى مكتمل. تعني هذه القيمة أن تنفيذ المهمة ينتهي بنجاح.

2. حدد عرض السجلات للاستعلام عن سجلات تنفيذ المهمة.

   

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

   

4. ارجع إلى صفحة النظرة العامة للوظيفة football وحدد تشغيل لتشغيل التنفيذ مرة أخرى.

5. ارجع إلى صفحة نقطة النهاية في المستعرض وحدد Refresh لمشاهدة تغيير واجهة المستخدم، كما هو موضح في لقطة الشاشة التالية:

   

Azure CLI

استخدم الخطوات التالية للتحقق من الصحة:

1. استخدم الأمر التالي للاستعلام عن نتيجة التنفيذ باستخدام اسم المهمة واسم التنفيذ الخاص بها:

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   يجب أن يبدو تدفق سجل الوظائف لتنفيذ المهمة مشابها للمثال التالي:

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. استخدم الأمر التالي لاسترداد نقطة football-billboard نهاية التطبيق:

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

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

   

4. استخدم الأمر التالي لبدء المهمة مرة أخرى:

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. ارجع إلى صفحة نقطة النهاية في المستعرض وحدد Refresh لمشاهدة تغيير واجهة المستخدم، كما هو موضح في لقطة الشاشة التالية:

   

7. تنظيف الموارد

تأكد من حذف الموارد التي قمت بإنشائها في هذه المقالة عندما لم تعد بحاجة إليها. يمكنك حذف مجموعة موارد Azure، التي تتضمن كافة الموارد الموجودة في مجموعة الموارد.

مدخل Microsoft Azure

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

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

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

Azure CLI

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

az group delete --name ${RESOURCE_GROUP}

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

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

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