Connettersi a un server Eureka 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. Eureka Server for 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, essere consapevoli dei dettagli seguenti:

Configurazione

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

Creare il componente Eureka Server per Spring Java

Associare l'app contenitore al componente Eureka Server for Spring Java

Tornare all'applicazione 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 server Eureka.

Il binding 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 proprietà eureka.instance.prefer-ip-address è impostata su true a 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: dissociare l'app container dal componente Eureka Server per 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 segnaposto <SUBSCRIPTION_ID> nel valore AssignableScopes con l'ID della sottoscrizione.

2. Assegna il ruolo personalizzato al tuo account su 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 <>, con l'ID utente o l'ID 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 valore <USER_OR_SERVICE_PRINCIPAL_ID> deve essere in genere l'identità usata per accedere al portale di Azure. Il <ROLE_NAME> valore è il nome assegnato nel passaggio 1.

4. Ottieni l'URL del server Eureka per il dashboard di 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. Attraverso il dashboard è possibile visualizzare anche la tua applicazione container, come mostrato nello screenshot seguente.

   

Facoltativo: integrare il server Eureka per i componenti Spring e Admin per Spring Java

Per integrare i componenti Eureka Server for Spring e Admin for Spring Java, vedere Integrate l'amministratore gestito per Spring con Eureka Server for 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 Java codice da chiamare tra le 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 mandante e un destinatario. Entrambe le applicazioni comunicano tra loro usando il componente Eureka Server for Spring. L'applicazione destinataria espone un endpoint a cui si connette l'applicazione chiamante.

1. Crea l’applicazione destinataria. 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 destinataria che sia chiamato 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 @EnableDiscoveryClient per abilitare la funzionalità client Eureka. Creare inoltre un bean WebClient.Builder 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 utilizza WebClient.Builder per chiamare l'applicazione destinataria utilizzando il suo nome, destinataria.

   @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, si dispone di un'applicazione chiamante e un'applicazione chiamata che comunicano tra loro utilizzando 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 Server Eureka 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.
• Il dashboard eureka non è disponibile in Azure gestito da 21Vianet.

Passaggi successivi

Contenuto correlato

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