الاتصال بخادم يوريكا المدار ل Spring في Azure Container Apps

يوريكا Server for Spring هو سجل خدمة يسمح للخدمات المصغرة بتسجيل نفسها واكتشاف خدمات أخرى. يتوفر خادم Eureka ل Spring كمكون Azure Container Apps. يمكنك ربط تطبيق الحاوية الخاص بك بخادم Eureka ل Spring للتسجيل التلقائي باستخدام خادم يوريكا.

في هذا البرنامج التعليمي، تتعلم كيفية:

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

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

الاعتبارات

عند تشغيل خادم يوريكا ل Spring in Container Apps، كن على دراية بالتفاصيل التالية:

الإعداد

قبل البدء في العمل مع مكون يوريكا Server for Spring، تحتاج أولا إلى إنشاء الموارد المطلوبة.

إنشاء مكون خادم Eureka ل Spring Java

ربط تطبيق الحاوية الخاص بك بخادم يوريكا لمكون Spring Java

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

انتقل إلى /allRegistrationStatus المسار لعرض جميع التطبيقات المسجلة مع مكون Eureka Server for Spring.

يقوم الربط بإدخال عدة تكوينات في التطبيق كمتغيرات بيئة، في المقام الأول الخاصية eureka.client.service-url.defaultZone . تشير هذه الخاصية إلى نقطة النهاية الداخلية لمكون Java لخادم Eureka.

يقوم الربط أيضا بإدخال الخصائص التالية:

"eureka.client.register-with-eureka":    "true"
"eureka.client.fetch-registry":          "true"
"eureka.instance.prefer-ip-address":     "true"

eureka.client.register-with-eureka تم تعيين الخاصية إلى true لفرض التسجيل مع خادم يوريكا. يقوم هذا التسجيل بالكتابة فوق الإعداد المحلي في application.properties، من خادم التكوين وهكذا. إذا كنت تريد تعيينه إلى false، يمكنك الكتابة فوقه عن طريق تعيين متغير بيئة في تطبيق الحاوية.

eureka.instance.prefer-ip-address يتم تعيين الخاصية إلى true بسبب قاعدة تحليل نظام اسم المجال المحددة في بيئة تطبيق الحاوية. لا تقم بتعديل هذه القيمة بحيث لا تقطع الربط.

اختياري: إلغاء ربط تطبيق الحاوية من مكون خادم يوريكا ل Spring Java

az containerapp update \
    --name $APP_NAME \
    --unbind $JAVA_COMPONENT_NAME \
    --resource-group $RESOURCE_GROUP

عرض التطبيق من خلال لوحة معلومات

1. إنشاء تعريف دور مخصص.

   az role definition create --role-definition '{
       "Name": "<YOUR_ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   تأكد من استبدال <SUBSCRIPTION_ID> العنصر النائب في AssignableScopes القيمة بمعرف الاشتراك الخاص بك.

2. تعيين الدور المخصص إلى حسابك على مورد بيئة مدارة.

   احصل على معرف المورد للبيئة المدارة:

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. تعيين الدور إلى حسابك.

   قبل تشغيل هذا الأمر، استبدل العناصر النائبة - المشار إليها بواسطة الأقواس <> - بمعرف المستخدم أو الخدمة الأساسي واسم دورك.

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   إشعار

   <USER_OR_SERVICE_PRINCIPAL_ID> يجب أن تكون القيمة عادة الهوية التي تستخدمها للوصول إلى مدخل Microsoft Azure. <ROLE_NAME> القيمة هي الاسم الذي قمت بتعيينه في الخطوة 1.

4. احصل على عنوان URL للوحة معلومات خادم يوريكا ل Spring.

   az containerapp env java-component eureka-server-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   يقوم هذا الأمر بإرجاع عنوان URL الذي يمكنك استخدامه للوصول إلى خادم Eureka للوحة معلومات Spring. باستخدام لوحة المعلومات، يمكنك أيضا رؤية تطبيق الحاوية، كما هو موضح في لقطة الشاشة التالية.

   

اختياري: دمج خادم يوريكا ل Spring والمسؤول لمكونات Spring Java

إذا كنت ترغب في دمج خادم يوريكا ل Spring والمسؤول لمكونات Spring Java، فشاهد دمج المسؤول المدار ل Spring مع خادم يوريكا ل Spring.

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

الموارد التي تم إنشاؤها في هذا البرنامج التعليمي لها تأثير على فاتورة Azure. إذا كنت لن تستخدم هذه الخدمات على المدى الطويل، فقم بتشغيل الأمر التالي لإزالة كل شيء قمت بإنشائه في هذا البرنامج التعليمي.

az group delete --resource-group $RESOURCE_GROUP

قائمة التكوين المسموح بها لخادم Eureka ل Spring

تصف الأقسام التالية التكوينات المدعومة. لمزيد من المعلومات، راجع خادم Spring Cloud Eureka.

خيارات الإعداد

az containerapp update يستخدم الأمر المعلمة --configuration للتحكم في كيفية تكوين خادم Eureka ل Spring. يمكنك استخدام معلمات متعددة في وقت واحد طالما أنها مفصولة بمسافة. لمزيد من المعلومات، راجع خادم Spring Cloud Eureka.

تتوفر إعدادات التكوين التالية في eureka.server خاصية التكوين:

التكوينات الشائعة

• تسجيل التكوينات ذات الصلة:
  • logging.level.*
  • logging.group.*
  • يجب منع أي تكوينات أخرى تحت logging.* مساحة الاسم - على سبيل المثال، يجب حظر كتابة ملفات السجل باستخدام logging.file .

الاتصال بين التطبيقات

يوضح لك هذا المثال كيفية كتابة تعليمة Java البرمجية للاتصال بين التطبيقات المسجلة مع مكون Eureka Server for Spring. عندما تكون تطبيقات الحاوية مرتبطة ب Eureka، فإنها تتواصل مع بعضها البعض من خلال خادم يوريكا.

ينشئ المثال تطبيقين، المتصل والمتصل. يتصل كلا التطبيقين بين بعضهما البعض باستخدام مكون خادم يوريكا ل Spring. يعرض تطبيق المتصل نقطة نهاية يتم استدعاؤها بواسطة تطبيق المتصل.

1. إنشاء تطبيق المتصل. قم بتمكين عميل Eureka في تطبيق Spring Boot الخاص بك عن طريق إضافة التعليق التوضيحي @EnableDiscoveryClient إلى فئتك الرئيسية.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CalleeApplication {
     public static void main(String[] args) {
       SpringApplication.run(CalleeApplication.class, args);
     }
   }
   

2. إنشاء نقطة نهاية في تطبيق المتصل الذي يتم استدعاؤه بواسطة تطبيق المتصل.

   @RestController
   public class CalleeController {
   
       @GetMapping("/call")
       public String calledByCaller() {
           return "Hello from Application callee!";
       }
   }
   

3. تعيين اسم تطبيق المتصل في ملف تكوين التطبيق - على سبيل المثال، في application.yml.

   spring.application.name=callee
   

4. إنشاء تطبيق المتصل.

   أضف التعليق التوضيحي @EnableDiscoveryClient لتمكين وظيفة عميل Eureka. أيضا، قم بإنشاء bean WebClient.Builder مع @LoadBalanced التعليق التوضيحي لإجراء مكالمات متوازنة التحميل إلى خدمات أخرى.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CallerApplication {
     public static void main(String[] args) {
       SpringApplication.run(CallerApplication.class, args);
     }
   
     @Bean
     @LoadBalanced
     public WebClient.Builder loadBalancedWebClientBuilder() {
       return WebClient.builder();
     }
   }
   

5. إنشاء وحدة تحكم في تطبيق المتصل الذي يستخدم WebClient.Builder لاستدعاء تطبيق المتصل باستخدام اسم التطبيق الخاص به، المتصل.

   @RestController
   public class CallerController {
       @Autowired
       private WebClient.Builder webClientBuilder;
   
       @GetMapping("/call-callee")
       public Mono<String> callCallee() {
           return webClientBuilder.build()
               .get()
               .uri("http://callee/call")
               .retrieve()
               .bodyToMono(String.class);
       }
   }
   

الآن لديك تطبيق المتصل والمتصل الذي يتصل مع بعضها البعض باستخدام يوريكا Server لمكونات Spring Java. تأكد من تشغيل كلا التطبيقين وربطهما بخادم يوريكا قبل اختبار /call-callee نقطة النهاية في تطبيق المتصل.

القيود

• يأتي مكون Eureka Server Java مع تكوين افتراضي، ، eureka.server.enable-self-preservationتم تعيينه إلى false. يساعد هذا التكوين الافتراضي على تجنب الأوقات التي لا يتم فيها حذف المثيلات بعد تمكين الاحتفاظ الذاتي. إذا تم حذف المثيلات مبكرا جدا، فقد يتم توجيه بعض الطلبات إلى مثيلات غير موجودة. إذا كنت تريد تغيير هذا الإعداد إلى true، يمكنك الكتابة فوقه عن طريق تعيين التكوينات الخاصة بك في مكون Java.
• لوحة معلومات يوريكا غير متوفرة في Azure China 21Vianet.

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

المحتوى ذو الصلة

دمج المسؤول المدار ل Spring مع خادم يوريكا ل Spring