Esercitazione: connettersi a Eureka Server gestito per Spring in App contenitore di Azure

Eureka Server gestito per Spring è un registro di servizi che consente ai microservizi di registrarsi e individuare altri servizi. Il server Eureka per Spring è disponibile come componente app contenitore di Azure. È possibile associare l'app contenitore a Eureka Server per Spring per la registrazione automatica con il server Eureka.

In questa esercitazione apprenderai a:

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non ne hai già uno, puoi crearne uno gratuitamente.
• Interfaccia della riga di comando di Azure.

Considerazioni

Quando si esegue Eureka Server per Spring in App contenitore, tenere presenti i dettagli seguenti:

Attrezzaggio

Prima di iniziare a usare il componente Eureka Server for Spring, è prima necessario creare le risorse necessarie.

Creare il componente Java di Eureka Server per Spring

Associare l'app contenitore al componente Java di Eureka Server per Spring

Tornare all'app contenitore nel portale. Copiare l'URL dell'app in un editor di testo in modo da poterlo usare in un passaggio successivo.

Passare alla /allRegistrationStatus route per visualizzare tutte le applicazioni registrate con il componente Eureka Server for Spring.

L'associazione inserisce diverse configurazioni nell'applicazione come variabili ambiente, principalmente la proprietà eureka.client.service-url.defaultZone. Questa proprietà indica l'endpoint interno del componente Java di Eureka Server.

L'associazione inserisce anche le proprietà seguenti:

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

La proprietà eureka.client.register-with-eureka è impostata su true per applicare la registrazione al server Eureka. Questa registrazione sovrascrive l'impostazione locale in application.properties, dal server di configurazione e così via. Se si vuole impostarlo su false, è possibile sovrascriverlo impostando una variabile di ambiente nell'app contenitore.

La eureka.instance.prefer-ip-address proprietà è impostata su a true causa della regola di risoluzione specifica del sistema dei nomi di dominio nell'ambiente dell'app contenitore. Non modificare questo valore in modo da non interrompere l'associazione.

Facoltativo: annullare l'associazione dell'app contenitore dal componente Eureka Server for Spring Java

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

Esaminare l'applicazione tramite il dashboard

1. Creare una definizione di ruolo personalizzata.

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

   Assicurarsi di sostituire il <SUBSCRIPTION_ID> segnaposto nel valore con l'ID AssignableScopes sottoscrizione.

2. Assegnare il ruolo personalizzato all'account in una risorsa dell'ambiente gestito.

   Ottenere l'ID risorsa dell'ambiente gestito:

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

3. Assegnare il ruolo all'account.

   Prima di eseguire questo comando, sostituire i segnaposto, indicati dalle <> parentesi quadre, con l'ID utente o l'entità servizio e il nome del ruolo.

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

   Nota

   Il <USER_OR_SERVICE_PRINCIPAL_ID> valore deve in genere essere l'identità usata per accedere al portale di Azure. Il <ROLE_NAME> valore è il nome assegnato nel passaggio 1.

4. Ottenere l'URL del dashboard di Eureka Server per 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
   

   Questo comando restituisce l'URL che è possibile usare per accedere al dashboard Eureka Server for Spring. Con il dashboard è anche possibile visualizzare l'app contenitore, come illustrato nello screenshot seguente.

   

Facoltativo: integrare i componenti Java per Eureka Server per Spring e Amministrazione per Spring

Per integrare i componenti Java per Eureka Server per Spring e Amministrazione per Spring, vedere Integrare l'Amministrazione gestita per Spring con Eureka Server per Spring.

Pulire le risorse

Le risorse create in questa esercitazione hanno effetto sulla fattura di Azure. Se non si intende usare questi servizi a lungo termine, eseguire il comando seguente per rimuovere tutti gli elementi creati in questa esercitazione.

az group delete --resource-group $RESOURCE_GROUP

Elenco di configurazione consentito per il server Eureka per Spring

Le sezioni seguenti descrivono le configurazioni supportate. Per altre informazioni, vedere Spring Cloud Eureka Server.

Opzioni di configurazione

Il az containerapp update comando usa il --configuration parametro per controllare la configurazione del server Eureka per Spring. È possibile usare più parametri contemporaneamente, purché siano separati da uno spazio. Per altre informazioni, vedere Spring Cloud Eureka Server.

Nella proprietà di configurazione sono disponibili le eureka.server impostazioni di configurazione seguenti:

Configurazioni comuni

• Registrazione delle configurazioni correlate:
  • logging.level.*
  • logging.group.*
  • Tutte le altre configurazioni nello logging.* spazio dei nomi devono essere vietate, ad esempio la scrittura di file di log tramite logging.file deve essere vietata.

Chiamare tra applicazioni

Questo esempio illustra come scrivere codice Java per chiamare tra applicazioni registrate con il componente Eureka Server for Spring. Quando le app contenitore sono associate a Eureka, comunicano tra loro tramite il server Eureka.

Nell'esempio vengono create due applicazioni, un chiamante e un chiamato. Entrambe le applicazioni comunicano tra loro usando il componente Eureka Server for Spring. L'applicazione chiamata espone un endpoint chiamato dall'applicazione chiamante.

1. Creare l'applicazione chiamata. Abilitare il client Eureka nell'applicazione Spring Boot aggiungendo l'annotazione @EnableDiscoveryClient alla classe principale.

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

2. Creare un endpoint nell'applicazione chiamata dall'applicazione chiamante.

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

3. Impostare il nome dell'applicazione chiamata nel file di configurazione dell'applicazione, ad esempio in application.yml.

   spring.application.name=callee
   

4. Creare l'applicazione chiamante.

   Aggiungere l'annotazione per abilitare la @EnableDiscoveryClient funzionalità client Eureka. Creare inoltre un WebClient.Builder bean con l'annotazione @LoadBalanced per eseguire chiamate con carico bilanciato ad altri servizi.

   @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. Creare un controller nell'applicazione chiamante che usa WebClient.Builder per chiamare l'applicazione chiamata usando il nome dell'applicazione, chiamato.

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

A questo punto è disponibile un chiamante e un'applicazione chiamata che comunicano tra loro usando Eureka Server per i componenti Spring Java. Assicurarsi che entrambe le applicazioni siano in esecuzione e associate al server Eureka prima di testare l'endpoint /call-callee nell'applicazione chiamante.

Limiti

Il componente Java Eureka Server include una configurazione predefinita, eureka.server.enable-self-preservation, impostata su false. Questa configurazione predefinita consente di evitare momenti in cui le istanze non vengono eliminate dopo l'abilitazione della conservazione automatica. Se le istanze vengono eliminate troppo presto, alcune richieste potrebbero essere indirizzate a istanze inesistenti. Se si vuole modificare questa impostazione in true, è possibile sovrascriverla impostando le proprie configurazioni nel componente Java.

Passaggi successivi

Contenuto correlato

Integrare l'Amministrazione gestita per Spring con Eureka Server per Spring