يعد Azure Spring Apps هو الاسم الجديد لخدمة Azure Spring Cloud. رغم أن الخدمة تحمل اسماً جديداً، سترى الاسم القديم في بعض الأماكن لفترة من الوقت بينما نعمل على تحديث الأصول مثل لقطات الشاشة، ومقاطع الفيديو، والرسوم التخطيطية.
توضح هذه المقالة كيفية نشر تطبيق يستند إلى حدث Spring Boot إلى Azure Spring Apps.
نموذج المشروع هو تطبيق يستند إلى الحدث يشترك في قائمة انتظار ناقل خدمة Microsoft Azure المسماة lower-case، ثم يعالج الرسالة ويرسل رسالة أخرى إلى قائمة انتظار أخرى تسمى upper-case. لجعل التطبيق بسيطا، تقوم معالجة الرسائل فقط بتحويل الرسالة إلى أحرف كبيرة. يوضح الرسم التخطيطي التالي هذه العملية:
توفر هذه المقالة الخيارات التالية للنشر في 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 السحابية.
يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة إصدارات ASA-Samples-Web-Application على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.
استخدم الخطوات التالية لإعداد العينة محليا:
نموذج المشروع جاهز على GitHub. استنساخ نموذج المشروع باستخدام الأمر التالي:
أدخل اسم بيئة جديد: توفير اسم بيئة، والذي يتم استخدامه كلاحقة لمجموعة الموارد التي تم إنشاؤها للاحتفاظ بكافة موارد 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 Key Vault ومثيل ناقل خدمة Azure. استخدم الخطوات التالية لإنشاء هذه الموارد.
يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.
3.1. سجِّل الدخول إلى مدخل Azure
انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء موارد Azure
استخدم الخطوات التالية لإنشاء جميع موارد Azure التي يعتمد عليها التطبيق:
حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
المنطقة
المنطقة الأقرب إلى المستخدمين.
يتم استخدام المنطقة لإنشاء مجموعة الموارد.
حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
3.1. سجِّل الدخول إلى مدخل Azure
افتح مستعرض الويب الخاص بك وانتقل إلى مدخل Microsoft Azure. أدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء مثيل ناقل خدمة Microsoft Azure
استخدم الخطوات التالية لإنشاء مثيل ناقل خدمة Microsoft Azure:
حدد Create a resource في زاوية مدخل Microsoft Azure.
في مربع البحث خدمة البحث والسوق، ابحث عن ناقل الخدمة.
في قسم ناقل خدمة Microsoft Azure ، حدد Create.
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
اسم مساحة الاسم
my-srvbus
اسم فريد يعرف خدمة ناقل خدمة Microsoft Azure.
Location
الموقع الأقرب إلى المستخدمين.
الموقع الأقرب إلى المستخدمين.
خيارات الاستضافة وخططها
الاساسيه
تحدد خطة التسعير المورد والتكلفة المرتبطة بالمثيل الخاص بك.
حدد Review and Create لمراجعة معلمات الإنشاء. ثم حدد إنشاء لإنهاء إنشاء مثيل ناقل خدمة Microsoft Azure.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
حدد الانتقال إلى المورد للانتقال إلى صفحة مساحة اسم ناقل خدمة Microsoft Azure .
حدد Shared access policies في قائمة التنقل ثم حدد RootManageSharedAccessKey.
في صفحة نهج SAS: RootManageSharedAccessKey، انسخ قيمة Primary الاتصال ion String واحفظها، والتي تستخدم لإعداد الاتصالات من تطبيق Spring.
حدد قوائم الانتظار في قائمة التنقل ثم حدد قائمة الانتظار.
في صفحة إنشاء قائمة انتظار، أدخل حالة صغيرة للاسمثم حدد إنشاء.
إنشاء قائمة انتظار أخرى عن طريق تكرار الخطوة السابقة باستخدام الأحرف الكبيرة للاسم.
3.3. إنشاء مثيل Azure Spring Apps
استخدم الخطوات التالية لإنشاء مثيل الخدمة:
حدد Create a resource في زاوية المدخل.
حدد حساب>Azure Spring Apps.
املأ نموذج الاستهلاك القياسي والمخصص (معاينة) بالمعلومات التالية:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
الاسم
myasa
اسم فريد يعرف خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.
تخطيط
الاستهلاك القياسي والمخصص (معاينة)
تحدد خطة التسعير الموارد والتكلفة المرتبطة بالمثيل الخاص بك.
المنطقة
المنطقة الأقرب إلى مستخدميك
الموقع الأقرب إلى المستخدمين.
بيئة تطبيقات الحاوية
myacaenv
البيئة هي حد آمن حول واحد أو أكثر من تطبيقات الحاويات التي يمكنها التواصل مع بعضها البعض ومشاركة شبكة ظاهرية وتسجيل وتكوين Dapr.
(اختياري) استخدم الخطوات التالية لإنشاء بيئة تطبيقات الحاوية:
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد الانتهاء من النشر، يمكنك تحديد تثبيت في لوحة المعلومات، مما يؤدي إلى إنشاء لوحة لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. يؤدي تحديد Go to resource إلى فتح صفحة نظرة عامة على الخدمة.
حدد Go to resource للانتقال إلى صفحة نظرة عامة على Azure Spring Apps.
حدد التطبيقات في قائمة التنقل اليسرى، ثم حدد إنشاء تطبيق.
في صفحة Create App ، أدخل simple-event-driven-app اسم التطبيق، ثم حدد Use quick start sample app to create app.
حدد Create للانتهاء من إنشاء مثيل Azure Spring Apps.
بعد إنشاء التطبيق، حدد اسم التطبيق الذي أنشأته في الخطوة السابقة.
حدد Configuration من جزء التنقل، ثم قم بتكوين الخاصية التالية في علامة التبويب Environment variables .
SERVICE_BUS_CONNECTION_STRING: أدخل سلسلة الاتصال الأساسي لناقل خدمة Microsoft Azure.
حدد حفظ لحفظ خصائص الاتصال.
استخدم الأمر التالي لتسجيل الدخول إلى Azure باستخدام OAuth2. تجاهل هذه الخطوة إذا قمت بتسجيل الدخول بالفعل.
azd auth login
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
Logged in to Azure.
استخدم الأمر التالي لتوفير البنية الأساسية للقالب إلى 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.
تسجيل الدخول إلى 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.
استخدم الأمر التالي لنشر التطبيق:
./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
استخدم الخطوات التالية لاستخدام AZD لحزم التطبيق، وتوفير موارد Azure المطلوبة من قبل تطبيق الويب، ثم النشر إلى Azure Spring Apps.
استخدم الأمر التالي لحزم نسخة قابلة للنشر من تطبيقك:
azd package
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
SUCCESS: Your application was packaged for Azure in xx seconds.
استخدم الأمر التالي لنشر التعليمات البرمجية للتطبيق إلى تلك الموارد التي تم توفيرها حديثا:
azd deploy
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
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 (نشر التعليمات البرمجية للتطبيق). لمزيد من المعلومات، راجع Azure-Samples/ASA-Samples-Event-Driven-Application.
يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة إصدارات ASA-Samples-Web-Application على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.
استخدم الخطوات التالية لإعداد العينة محليا:
نموذج المشروع جاهز على GitHub. استنساخ نموذج المشروع باستخدام الأمر التالي:
أدخل اسم بيئة جديد: توفير اسم بيئة، والذي يتم استخدامه كلاحقة لمجموعة الموارد التي تم إنشاؤها للاحتفاظ بكافة موارد 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 Key Vault ومثيل ناقل خدمة Azure. استخدم الخطوات التالية لإنشاء هذه الموارد.
يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.
3.1. سجِّل الدخول إلى مدخل Azure
انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء موارد Azure
استخدم الخطوات التالية لإنشاء جميع موارد Azure التي يعتمد عليها التطبيق:
حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
المنطقة
المنطقة الأقرب إلى المستخدمين.
يتم استخدام المنطقة لإنشاء مجموعة الموارد.
حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
3.1. سجِّل الدخول إلى مدخل Azure
افتح مستعرض الويب الخاص بك وانتقل إلى مدخل Microsoft Azure. أدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء مثيل ناقل خدمة Microsoft Azure
استخدم الخطوات التالية لإنشاء مثيل ناقل خدمة Microsoft Azure:
حدد Create a resource في زاوية مدخل Microsoft Azure.
في مربع البحث خدمة البحث والسوق، ابحث عن ناقل الخدمة.
في قسم ناقل خدمة Microsoft Azure ، حدد Create.
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
اسم مساحة الاسم
my-srvbus
اسم فريد يعرف خدمة ناقل خدمة Microsoft Azure.
Location
الموقع الأقرب إلى المستخدمين.
الموقع الأقرب إلى المستخدمين.
خيارات الاستضافة وخططها
الاساسيه
تحدد خطة التسعير المورد والتكلفة المرتبطة بالمثيل الخاص بك.
حدد Review and Create لمراجعة معلمات الإنشاء. ثم حدد إنشاء لإنهاء إنشاء مثيل ناقل خدمة Microsoft Azure.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
حدد الانتقال إلى المورد للانتقال إلى صفحة مساحة اسم ناقل خدمة Microsoft Azure .
حدد Shared access policies في قائمة التنقل ثم حدد RootManageSharedAccessKey.
في صفحة نهج SAS: RootManageSharedAccessKey، انسخ قيمة Primary الاتصال ion String واحفظها، والتي تستخدم لإعداد الاتصالات من تطبيق Spring.
حدد قوائم الانتظار في قائمة التنقل ثم حدد قائمة الانتظار.
في صفحة إنشاء قائمة انتظار، أدخل حالة صغيرة للاسمثم حدد إنشاء.
إنشاء قائمة انتظار أخرى عن طريق تكرار الخطوة السابقة باستخدام الأحرف الكبيرة للاسم.
3.3. إنشاء مثيل Azure Spring Apps
استخدم الخطوات التالية لإنشاء مثيل Azure Spring Apps:
حدد Create a resource في زاوية مدخل Microsoft Azure.
حدد حساب>Azure Spring Apps.
املأ نموذج «Basics» بالمعلومات التالية:
استخدم الجدول التالي كدليل لإكمال النموذج. الخطة الموصى بها قياسية.
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
الاسم
myasa
اسم فريد يعرف خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.
تخطيط
قياسي
تحدد الخطة المورد والتكلفة المرتبطة بالمثيل الخاص بك.
المنطقة
المنطقة الأقرب إلى مستخدميك
الموقع الأقرب إلى المستخدمين.
المنطقة زائدة عن الحاجة
غير محدد
سواء كنت تريد إنشاء خدمة Azure Spring Apps في منطقة توفر Azure، يمكن دعمها فقط في عدة مناطق في الوقت الحالي.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بمجرد الانتهاء من النشر، يمكنك تحديد تثبيت في لوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. يؤدي تحديد Go to resource إلى فتح صفحة نظرة عامة على الخدمة.
3.4. الاتصال مثيل التطبيق إلى مثيل ناقل خدمة Microsoft Azure
انتقل إلى مثيل Azure Spring Apps في مدخل Azure.
حدد التطبيقات في قائمة التنقل، ثم حدد إنشاء تطبيق.
في صفحة Create App ، أدخل simple-event-driven-app ل App name وحدد Java 17 for Runtime platform.
بعد إنشاء التطبيق، حدد اسم التطبيق الذي أنشأته في الخطوة السابقة.
في صفحة التكوين، حدد علامة التبويب متغيرات البيئة، وأدخل SERVICE_BUS_CONNECTION_STRING للمفتاح، والصق سلسلة الاتصال ناقل الخدمة للقيمة، ثم حدد حفظ.
استخدم الأمر التالي لتسجيل الدخول إلى Azure باستخدام OAuth2. تجاهل هذه الخطوة إذا قمت بتسجيل الدخول بالفعل.
azd auth login
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
Logged in to Azure.
استخدم الأمر التالي لتعيين القالب باستخدام الخطة القياسية :
azd env set PLAN standard
استخدم الأمر التالي لحزم نسخة قابلة للتوزيع من التطبيق الخاص بك، وتوفير البنية الأساسية للقالب إلى 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/rg-<your-environment-name>/overview
إشعار
قد يستغرق إكمال هذا الأمر بعض الوقت. يظهر لك مؤشر تقدم أثناء توفيره لموارد Azure.
تسجيل الدخول إلى 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.
استخدم الأمر التالي لنشر التطبيق:
./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
استخدم الخطوات التالية لاستخدام AZD لحزم التطبيق، وتوفير موارد Azure المطلوبة من قبل تطبيق الويب، ثم النشر إلى Azure Spring Apps.
استخدم الأمر التالي لحزم نسخة قابلة للنشر من تطبيقك:
azd package
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
SUCCESS: Your application was packaged for Azure in xx seconds.
استخدم الأمر التالي لنشر التعليمات البرمجية للتطبيق إلى تلك الموارد التي تم توفيرها حديثا:
azd deploy
مخرجات وحدة التحكم رسائل مشابهة للمثال التالي:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-event-driven-app
- No endpoints were found
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 (نشر التعليمات البرمجية للتطبيق). لمزيد من المعلومات، راجع Azure-Samples/ASA-Samples-Event-Driven-Application.
يقوم الزر Deploy to Azure في القسم التالي بتشغيل تجربة مدخل Azure التي تقوم بتنزيل حزمة JAR من صفحة إصدارات ASA-Samples-Web-Application على GitHub. لا يلزم اتخاذ خطوات إعداد محلية.
استخدم الخطوات التالية لإعداد العينة محليا:
نموذج المشروع جاهز على GitHub. استنساخ نموذج المشروع باستخدام الأمر التالي:
يستخدم هذا القسم زر Deploy to Azure لبدء تجربة توزيع في مدخل Microsoft Azure. تستخدم هذه التجربة قالب ARM لإنشاء موارد Azure.
3.1. سجِّل الدخول إلى مدخل Azure
انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء موارد Azure
استخدم الخطوات التالية لإنشاء جميع موارد Azure التي يعتمد عليها التطبيق:
حدد زر Deploy to Azure التالي لبدء تجربة النشر في مدخل Microsoft Azure:
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
المنطقة
المنطقة الأقرب إلى المستخدمين.
يتم استخدام المنطقة لإنشاء مجموعة الموارد.
حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لنشر التطبيق إلى Azure Spring Apps.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
3.1. سجِّل الدخول إلى مدخل Azure
انتقل إلى مدخل Microsoft Azure وأدخل بيانات الاعتماد لتسجيل الدخول إلى المدخل. طريقة العرض الافتراضية هي لوحة معلومات الخدمة.
3.2. إنشاء مثيل ناقل خدمة Microsoft Azure
استخدم الخطوات التالية لإنشاء مثيل ناقل خدمة Microsoft Azure:
حدد Create a resource في زاوية مدخل Microsoft Azure.
في مربع البحث خدمة البحث والسوق، ابحث عن ناقل الخدمة.
في قسم ناقل خدمة Microsoft Azure ، حدد Create.
املأ النموذج في علامة التبويب أساسيات . استخدم الجدول التالي كدليل لإكمال النموذج:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
اسم مساحة الاسم
my-srvbus
اسم فريد يعرف خدمة ناقل خدمة Microsoft Azure.
Location
الموقع الأقرب إلى المستخدمين.
الموقع الأقرب إلى المستخدمين.
خيارات الاستضافة وخططها
الاساسيه
تحدد خطة التسعير المورد والتكلفة المرتبطة بالمثيل الخاص بك.
حدد Review and Create لمراجعة معلمات الإنشاء. ثم حدد إنشاء لإنهاء إنشاء مثيل ناقل خدمة Microsoft Azure.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة. حدد الانتقال إلى المورد لفتح صفحة نظرة عامة على الخدمة.
حدد الانتقال إلى المورد للانتقال إلى صفحة مساحة اسم ناقل خدمة Microsoft Azure .
حدد قوائم الانتظار في قائمة التنقل، ثم حدد قائمة الانتظار.
في صفحة إنشاء قائمة انتظار، أدخل حالة صغيرة للاسمثم حدد إنشاء.
إنشاء قائمة انتظار أخرى عن طريق تكرار الخطوة السابقة باستخدام الأحرف الكبيرة للاسم.
3.3. إنشاء مثيل Azure Spring Apps
استخدم الخطوات التالية لإنشاء مثيل الخدمة:
حدد Create a resource في زاوية مدخل Microsoft Azure.
حدد حساب>Azure Spring Apps.
املأ نموذج «Basics» بالمعلومات التالية:
الإعدادات
القيمة المقترحة
الوصف
الاشتراك
اسم الاشتراك الخاص بك.
اشتراك Azure الذي تريد استخدامه لخادمك. إذا كان لديك اشتراكات متعددة، فاختر الاشتراك الذي تود الدفع فيه مقابل المورد.
مجموعة الموارد
myresourcegroup
اسم مجموعة موارد جديد أو اسم موجود من اشتراكك.
الاسم
myasa
اسم فريد يعرف خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.
المنطقة
المنطقة الأقرب إلى المستخدمين.
الموقع الأقرب إلى المستخدمين.
خيارات الاستضافة وخططها
المؤسسه
خطة التسعير التي تحدد المورد والتكلفة المرتبطة بالمثيل الخاص بك.
المنطقة زائدة عن الحاجة
غير محدد
خيار إنشاء خدمة Azure Spring Apps في منطقة توفر Azure. هذه الميزة غير مدعومة حاليا في جميع المناطق.
خطة IP للبرامج
الدفع أولاً بأول
خطة التسعير التي تتيح لك الدفع أثناء استخدام Azure Spring Apps.
توزيع نموذج المشروع
غير محدد
خيار استخدام نموذج التطبيق المضمن.
حدد مراجعة وإنشاء لمراجعة التحديدات. ثم حدد Create لتوفير مثيل Azure Spring Apps.
من شريط الأدوات، حدد رمز «Notifications» (جرس) لمراقبة عملية النشر. بعد انتهاء النشر، يمكنك تحديد تثبيت بلوحة المعلومات، والتي تنشئ تجانبا لهذه الخدمة على لوحة معلومات مدخل Microsoft Azure كاختصار لصفحة نظرة عامة على الخدمة.
حدد Go to resource للانتقال إلى صفحة نظرة عامة على Azure Spring Apps.
3.4. الاتصال مثيل التطبيق إلى مثيل ناقل خدمة Microsoft Azure
استخدم الخطوات التالية لتوصيل مثيلات الخدمة:
انتقل إلى مثيل Azure Spring Apps في مدخل Azure.
من جزء التنقل، افتح جزء التطبيقات ثم حدد إنشاء تطبيق.
في صفحة إنشاء تطبيق ، لاسم التطبيق، استخدم تطبيقا بسيطا يستند إلى الحدث واترك جميع الحقول الأخرى بقيمها الافتراضية.
حدد إنشاء لإنهاء إنشاء التطبيق ثم حدد التطبيق لعرض التفاصيل.
حدد خدمة الاتصال أو من جزء التنقل ثم حدد إنشاء لإنشاء اتصال خدمة جديد.
املأ علامة التبويب Basics بالمعلومات التالية:
نوع الخدمة: حدد ناقل خدمة Microsoft Azure.
اسم الاتصال: يتم ملؤه باسم تم إنشاؤه تلقائيا يمكنك تعديله.
Subscription: حدد اشتراكك.
مساحة الاسم: حدد مساحة الاسم التي أنشأتها.
نوع العميل: حدد SpringBoot.
قم بتكوين علامة التبويب Next: Authentication بالمعلومات التالية:
حدد نوع المصادقة الذي تريد استخدامه بين خدمة الحوسبة والخدمة المستهدفة.: حدد الاتصال سلسلة.
حدد Next: Networking. استخدم الخيار الافتراضي تكوين قواعد جدار الحماية لتمكين الوصول إلى الخدمة الهدف.
حدد Next: Review and Create لمراجعة التحديدات، ثم حدد Create لإنشاء الاتصال.
3.1. توفير أسماء لكل مورد
إنشاء متغيرات للاحتفاظ بأسماء الموارد باستخدام الأوامر التالية. تأكد من استبدل العناصر النائبة بقيمتك الخاصة.
استخدم الأمر التالي لسرد جميع الاشتراكات المتوفرة لتحديد معرف الاشتراك المراد استخدامه:
az account list --output table
استخدم الأمر التالي لتعيين الاشتراك الافتراضي:
az account set --subscription <subscription-ID>
استخدم الأمر التالي لإنشاء مجموعة موارد:
az group create --resource-group ${RESOURCE_GROUP}
استخدم الأمر التالي لتعيين مجموعة الموارد التي تم إنشاؤها حديثا كمجموعة الموارد الافتراضية:
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
استخدم الأمر التالي لإنشاء مثيل Azure Spring Apps:
az spring create \
--name ${AZURE_SPRING_APPS_INSTANCE} \
--sku Enterprise
ثم استخدم الأمر التالي لإنشاء تطبيق في مثيل Azure Spring Apps:
az spring app create \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
3.5. إنشاء مثيل ناقل خدمة Microsoft Azure
استخدم الخطوات التالية لإنشاء مثيل ناقل خدمة Microsoft Azure:
استخدم الأمر التالي لإنشاء مساحة اسم ناقل خدمة Microsoft Azure:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
استخدم الأوامر التالية لإنشاء قائمتي انتظار باسم lower-case و upper-case:
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name lower-case
az servicebus queue create \
--namespace-name ${SERVICE_BUS_NAME_SPACE} \
--name upper-case
3.6. الاتصال مثيل التطبيق إلى مثيل ناقل خدمة Microsoft Azure
لقد قمت الآن بإنشاء كل من ناقل خدمة Microsoft Azure والتطبيق في Azure Spring Apps، ولكن لا يمكن للتطبيق الاتصال بناقل خدمة Microsoft Azure. استخدم الخطوات التالية لتمكين التطبيق من الاتصال بناقل خدمة Microsoft Azure، ثم نشر التطبيق:
احصل على سلسلة الاتصال ناقل خدمة Microsoft Azure باستخدام الأمر التالي:
تسجيل الدخول إلى 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.
استخدم الأمر التالي لنشر التطبيق:
./mvnw azure-spring-apps:deploy
تصف القائمة التالية تفاعل الأمر:
تسجيل الدخول إلى OAuth2: تحتاج إلى تخويل تسجيل الدخول إلى Azure استنادا إلى بروتوكول OAuth2.
بعد تنفيذ الأمر، يمكنك أن ترى من رسائل السجل التالية أن النشر كان ناجحا:
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
بيئة السحابة جاهزة الآن. انشر التطبيق باستخدام الأمر التالي:
az spring app deploy \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME} \
--artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar
5. التحقق من صحة التطبيق
استخدم الخطوات التالية للتأكد من أن التطبيق المستند إلى الحدث يعمل بشكل صحيح. يمكنك التحقق من صحة التطبيق عن طريق إرسال رسالة إلى lower-case قائمة الانتظار، ثم تأكيد وجود رسالة في upper-case قائمة الانتظار.
انتقل إلى صفحة نظرة عامة على مثيل Azure Spring Apps وحدد Logs للتحقق من سجلات التطبيق.
استخدم الأمر التالي للتحقق من سجل التطبيق للتحقيق في أي مشكلة توزيع:
az spring app logs \
--service ${AZURE_SPRING_APPS_INSTANCE} \
--name ${APP_NAME}
6. حذف الموارد
تأكد من حذف الموارد التي قمت بإنشائها في هذه المقالة عندما لم تعد بحاجة إليها. يمكنك حذف مجموعة موارد Azure، التي تتضمن كافة الموارد الموجودة في مجموعة الموارد.
