التشغيل السريع: إعداد خادم تكوين Spring Cloud لتطبيقات Azure Spring

إشعار

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

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

خادم التكوين هو خدمة تكوين مركزية للأنظمة الموزعة. وتستخدم طبقة تخزين قابلة للتوصيل تدعم حالياً التخزين المحلي وGit وSubversion. في هذا التشغيل السريع، يمكنك إعداد خادم التكوين للحصول على البيانات من تخزين Git.

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

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

إجراءات خادم التكوين

قم بإعداد خادم التكوين الخاص بك مع موقع مستودع Git للمشروع عن طريق تشغيل الأمر التالي. استبدل <service-instance-name> باسم الخدمة التي قمت بإنشائها سابقاً. لا تعمل القيمة الافتراضية لاسم مثيل الخدمة الذي قمت بتعيينه في التشغيل السريع السابق مع هذا الأمر.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/Azure-Samples/azure-spring-apps-samples \
    --search-paths steeltoe-sample/config

يخبر هذا الأمر خادم التكوين للبحث عن بيانات التكوين في المجلد عينة steeltoe/ التكوين من مخزن التطبيق الخاص بالنموذج. نظرا لأن اسم التطبيق الذي يحصل على بيانات التكوين هو planet-weather-provider، فإن الملف المستخدم planet-weather-provider.yml.

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

• JDK 17
• اشتراك Azure. في حال لم يكن لديك اشتراك Azure، أنشئ حسابًا مجانيًا قبل البدء.
• اختياريا، إصدار Azure CLI 2.45.0 أو أعلى. تثبيت ملحق Azure Spring Apps باستخدام الأمر التالي: az extension add --upgrade --name spring
• اختياريا، مجموعة أدوات Azure ل IntelliJ.

إجراءات خادم التكوين

مدخل Microsoft Azure

يقوم الإجراء التالي بإعداد خادم التكوين باستخدام مدخل Azure لتوزيع نموذج PetClinic.

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

2. في قسم المخزن الافتراضي، قم بتعيين محدد موقع الويب لـ https://github.com/azure-samples/spring-petclinic-microservices-config.

3. حدد التحقق من الصحة. يتحقق التحقق من الصحة من مخطط مستودع git وإمكانية الوصول إليه للتأكد من أنه صحيح.

   

4. عند اكتمال عملية التحقق، حدد التطبيق لحفظ التغييرات.

   

يمكن أن تأخذ عملية تحديث التكوين بضع دقائق. يجب أن تتلقى إعلاماً عند اكتمال التكوين.

Azure CLI

يستخدم الإجراء التالي CLI Azure لإعداد خادم التكوين لتوزيع نموذج Pet Clinic.

قم بتشغيل الأمر التالي لتعيين المخزن الافتراضي.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/azure-samples/spring-petclinic-microservices-config

تلميح

للحصول على معلومات حول استخدام مستودع خاص لخادم التكوين، راجع تكوين خادم تكوين Spring Cloud مدار في Azure Spring Apps.

إجراء عملية استكشاف الأخطاء وتصحيحها لخادم تكوين Azure Spring Apps

يوضح الإجراء التالي كيفية استكشاف أخطاء إعدادات خادم التكوين وإصلاحها.

1. في مدخل Azure، انتقل إلى صفحة نظرة عامة على الخدمة وحدد السجلات.

2. في جزء Queries ضمن Show the application logs التي تحتوي على شروط "error" أو "exception"، حدد Run.

   

   يشير الخطأ التالي في السجلات إلى أن خدمة Spring Apps لا يمكنها تحديد موقع الخصائص من خادم التكوين: java.lang.illegalStateException

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

4. حدد تشخيص المشكلات وحلها.

5. ضمن التوفر والأداء، حدد استكشاف الأخطاء وإصلاحها.

   

   يعرض مدخل Microsoft Azure صفحة التوفر والأداء ، والتي توفر معلومات مختلفة حول حالة حماية خادم التكوين.

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

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

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

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

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