Azure Container Apps'te spring için yönetilen eureka sunucusuna bağlanma

Spring için Eureka Server, mikro hizmetlerin kendilerini kaydetmesine ve diğer hizmetleri keşfetmesine olanak tanıyan bir hizmet kayıt defteridir. Spring için Eureka Server, Azure Container Apps bileşeni olarak kullanılabilir. Eureka sunucusuna otomatik kayıt için kapsayıcı uygulamanızı Spring için Eureka Server'a bağlayabilirsiniz.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Henüz bir hesabınız yoksa ücretsiz olarak oluşturabilirsiniz.
• Azure CLI.

Dikkat edilmesi gereken noktalar

Container Apps'te Spring için Eureka Server'ı çalıştırdığınızda aşağıdaki ayrıntılara dikkat edin:

Ayarlama

Spring için Eureka Server bileşeniyle çalışmaya başlamadan önce gerekli kaynakları oluşturmanız gerekir.

Spring Java için Eureka Server bileşenini oluşturma

Kapsayıcı uygulamanızı Spring Java için Eureka Server bileşenine bağlama

Portalda kapsayıcı uygulamasına dönün. Uygulamanızın URL'sini bir metin düzenleyicisine kopyalayarak gelecek bir adımda kullanabilirsiniz.

/allRegistrationStatus Spring için Eureka Server bileşenine kayıtlı tüm uygulamaları görüntülemek için yola gidin.

Bağlama, uygulamaya öncelikle özelliği olmak üzere ortam değişkenleri olarak çeşitli yapılandırmalar eureka.client.service-url.defaultZone ekler. Bu özellik, Eureka Server Java bileşeninin iç uç noktasını gösterir.

Bağlama ayrıca aşağıdaki özellikleri de eklemektedir:

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

özelliği, eureka.client.register-with-eureka Eureka sunucusuna kaydı zorunlu kılmak için olarak ayarlanır true . Bu kayıt, içindeki yerel ayarın application.propertiesüzerine yapılandırma sunucusundan yazar ve bu şekilde devam eder. olarak ayarlamak falseisterseniz, kapsayıcı uygulamanızda bir ortam değişkeni ayarlayarak üzerine yazabilirsiniz.

eureka.instance.prefer-ip-address Özelliği, kapsayıcı uygulaması ortamındaki belirli etki alanı adı sistem çözümleme kuralı nedeniyle olarak ayarlanırtrue. Bağlamayı bozmak için bu değeri değiştirmeyin.

İsteğe bağlı: Spring Java için Eureka Server bileşeninden kapsayıcı uygulamanızın bağlantısını kaldırın

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

Uygulamayı pano aracılığıyla görüntüleme

1. Özel bir rol tanımı oluşturun.

   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>"]
   }'
   

   Değerdeki AssignableScopes yer tutucuyu <SUBSCRIPTION_ID> abonelik kimliğiniz ile değiştirdiğinden emin olun.

2. Özel rolü yönetilen bir ortam kaynağındaki hesabınıza atayın.

   Yönetilen ortamın kaynak kimliğini alın:

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

3. Rolü hesabınıza atayın.

   Bu komutu çalıştırmadan önce, köşeli ayraçlarla gösterilen <> yer tutucuları kullanıcı veya hizmet sorumlusu kimliğiniz ve rol adınız ile değiştirin.

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

   Not

   <USER_OR_SERVICE_PRINCIPAL_ID> Değer genellikle Azure portalına erişmek için kullandığınız kimlik olmalıdır. <ROLE_NAME> Değer, 1. adımda atadığınız addır.

4. Spring için Eureka Server panosunun URL'sini alın.

   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
   

   Bu komut, Spring için Eureka Sunucusu panosuna erişmek için kullanabileceğiniz URL'yi döndürür. Panoyla, aşağıdaki ekran görüntüsünde gösterildiği gibi kapsayıcı uygulamanızı da görebilirsiniz.

   

İsteğe bağlı: Spring için Eureka Server ve Spring Java bileşenleri için Yönetici'yi tümleştirme

Spring için Eureka Server ve Spring Java bileşenleri için Yönetici'yi tümleştirmek istiyorsanız bkz . Spring için yönetilen Yöneticiyi Spring için Eureka Server ile tümleştirme.

Kaynakları temizleme

Bu öğreticide oluşturulan kaynakların Azure faturanız üzerinde etkisi vardır. Bu hizmetleri uzun vadeli kullanmayacaksanız, bu öğreticide oluşturduğunuz her şeyi kaldırmak için aşağıdaki komutu çalıştırın.

az group delete --resource-group $RESOURCE_GROUP

Spring için Eureka Sunucunuz için izin verilen yapılandırma listesi

Aşağıdaki bölümlerde desteklenen yapılandırmalar açıklanmaktadır. Daha fazla bilgi için bkz . Spring Cloud Eureka Server.

Yapılandırma seçenekleri

komutu, az containerapp update Spring için Eureka Sunucusunun nasıl yapılandırıldığını denetlemek için parametresini kullanır --configuration . Bir boşlukla ayrıldığı sürece aynı anda birden çok parametre kullanabilirsiniz. Daha fazla bilgi için bkz . Spring Cloud Eureka Server.

Yapılandırma özelliğinde eureka.server aşağıdaki yapılandırma ayarları kullanılabilir:

Ortak yapılandırmalar

• İlgili yapılandırmaları günlüğe kaydetme:
  • logging.level.*
  • logging.group.*
  • Ad alanı altındaki logging.* diğer tüm yapılandırmalar yasak olmalıdır; örneğin, kullanarak logging.file günlük dosyaları yazmak yasak olmalıdır.

Uygulamalar arasında arama

Bu örnekte, Spring için Eureka Server bileşenine kayıtlı uygulamalar arasında çağrı yapmak için Java kodu yazma işlemi gösterilmektedir. Kapsayıcı uygulamaları Eureka ile ilişkili olduğunda, Eureka sunucusu aracılığıyla birbirleriyle iletişim kurarlar.

Örnek, çağıran ve çağıran olmak üzere iki uygulama oluşturur. Her iki uygulama da Spring için Eureka Server bileşenini kullanarak birbirleriyle iletişim kurar. Çağıran uygulaması, çağıran uygulama tarafından çağrılan bir uç noktayı kullanıma sunar.

1. Çağıran uygulamasını oluşturun. Ana sınıfınıza ek açıklama ekleyerek Spring Boot uygulamanızda Eureka istemcisini @EnableDiscoveryClient etkinleştirin.

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

2. Çağıran uygulamasında çağıran uygulaması tarafından çağrılan bir uç nokta oluşturun.

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

3. Çağrılan uygulamanın adını uygulama yapılandırma dosyasında (örneğin, application.yml) ayarlayın.

   spring.application.name=callee
   

4. Çağıran uygulamasını oluşturun.

   @EnableDiscoveryClient Eureka istemci işlevselliğini etkinleştirmek için ek açıklamayı ekleyin. Ayrıca, diğer hizmetlere yük dengeli çağrılar gerçekleştirmek için ek açıklamayla @LoadBalanced bir WebClient.Builder fasulye oluşturun.

   @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. Çağıran uygulamasında çağıran uygulamasını çağıran adlı uygulama adını kullanarak çağırmak için öğesini kullanan WebClient.Builder bir denetleyici oluşturun.

   @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);
       }
   }
   

Artık Spring Java bileşenleri için Eureka Server'ı kullanarak birbirleriyle iletişim kuran bir çağıran ve çağıran uygulamanız var. Çağıran uygulamasında uç noktayı test etmeden önce her iki uygulamanın da çalıştığından /call-callee emin olun ve Eureka sunucusuna bağlanın.

Sınırlamalar

• Eureka Server Java bileşeni, eureka.server.enable-self-preservationolarak ayarlanmış falsevarsayılan bir yapılandırmayla birlikte gelir. Bu varsayılan yapılandırma, kendini koruma etkinleştirildikten sonra örneklerin silinmediği zamanları önlemeye yardımcı olur. Örnekler çok erken silinirse, bazı istekler var olmayan örneklere yönlendirilebilir. Bu ayarı olarak truedeğiştirmek istiyorsanız, Java bileşeninde kendi yapılandırmalarınızı ayarlayarak bu ayarın üzerine yazabilirsiniz.
• Eureka panosu Azure China 21Vianet'te kullanılamaz.

Sonraki adımlar

İlgili içerik

Spring için yönetilen Yöneticiyi Spring için Eureka Server ile tümleştirme