Condividi tramite

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

  • Articolo

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:

  • Creare un componente Eureka Server per Spring Java.
  • Associare l'app contenitore al componente Eureka Server for Spring Java.

Importante

Questa esercitazione usa i servizi che possono influire sulla fattura di Azure. Se si decide di seguire questa procedura, assicurarsi di eliminare le risorse in primo piano in questo articolo per evitare la fatturazione imprevista.

Prerequisiti

Considerazioni

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

Articolo Spiegazione
Ambito Il componente di Eureka Server per Spring viene eseguito nello stesso ambiente dell'app contenitore connessa.
Scalabilità Il server Eureka per Spring non può ridimensionare. Le proprietà di ridimensionamento minReplicas e maxReplicas sono entrambe impostate su 1. Per ottenere la disponibilità elevata, vedere Creare un servizio Eureka a disponibilità elevata in App contenitore.
Risorse L'allocazione delle risorse del contenitore per Eureka Server per Spring è fissa. Il numero di core CPU è 0,5 e la dimensione della memoria è 1 Gi.
Prezzi La fatturazione di Eureka Server per Spring rientra nei prezzi basati sul consumo. Le risorse utilizzate dai componenti Java gestiti vengono fatturate in base alle tariffe attive/inattive. È possibile eliminare i componenti che non sono più in uso per interrompere la fatturazione.
Binding Le app contenitore si connettono a un componente di Eureka Server per Spring tramite un'associazione. Le associazioni inseriscono le configurazioni nelle variabili di ambiente dell'app contenitore. Dopo aver stabilito un'associazione, l'app contenitore può leggere i valori di configurazione dalle variabili di ambiente e connettersi al componente Eureka Server for Spring.

Attrezzaggio

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

Eseguire i comandi seguenti per creare il gruppo di risorse in un ambiente dell'app contenitore.

  1. Creare le variabili per supportare la configurazione dell'applicazione. Questi valori vengono forniti ai fini dello svolgimento di questa lezione.

    export LOCATION=eastus
export RESOURCE_GROUP=my-services-resource-group
export ENVIRONMENT=my-environment
export EUREKA_COMPONENT_NAME=eureka
export APP_NAME=my-eureka-client
export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-service-eureka-client:latest"
    Variabile Descrizione
    LOCATION Posizione dell'area di Azure in cui si creano l'app contenitore e il componente Java.
    ENVIRONMENT Nome dell'ambiente dell'app contenitore per l'applicazione demo.
    RESOURCE_GROUP Nome del gruppo di risorse di Azure per l'applicazione demo.
    EUREKA_COMPONENT_NAME Nome del componente Java creato per l'app contenitore. In questo caso, creare un componente Java di Eureka Server per Spring.
    IMAGE Immagine del contenitore usata nell'app contenitore.

  2. Accedere ad Azure con l'interfaccia della riga di comando di Azure.

    az login

  3. Creare un gruppo di risorse.

    az group create --name $RESOURCE_GROUP --location $LOCATION

  4. Creare l'ambiente dell'app contenitore.

    az containerapp env create \
  --name $ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION

Creare il componente Java di Eureka Server per Spring

Ora che si dispone di un ambiente esistente, è possibile creare l'app contenitore e associarla a un'istanza del componente Java di Eureka Server per Spring.

  1. Creare il componente Java per Eureka Server per Spring.

    az containerapp env java-component eureka-server-for-spring create \
    --environment $ENVIRONMENT \
    --resource-group $RESOURCE_GROUP \
    --name $EUREKA_COMPONENT_NAME

  2. Facoltativo: aggiornare la configurazione del componente Java per Eureka Server per Spring.

    az containerapp env java-component eureka-server-for-spring update \
    --environment $ENVIRONMENT \
    --resource-group $RESOURCE_GROUP \
    --name $EUREKA_COMPONENT_NAME
    --configuration eureka.server.renewal-percent-threshold=0.85 eureka.server.eviction-interval-timer-in-ms=10000

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

  1. Creare l'app contenitore e associarla al componente Eureka Server for Spring.

    az containerapp create \
    --name $APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --environment $ENVIRONMENT \
    --image $IMAGE \
    --min-replicas 1 \
    --max-replicas 1 \
    --ingress external \
    --target-port 8080 \
    --bind $EUREKA_COMPONENT_NAME \
    --query properties.configuration.ingress.fqdn

  2. Copiare l'URL dell'app in un editor di testo in modo da poterlo usare in un passaggio successivo.

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

Per rimuovere un'associazione da un'app contenitore, usare l'opzione --unbind.

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

Esaminare l'applicazione tramite il dashboard

Importante

Per visualizzare il dashboard, è necessario che all'account sia assegnato almeno il ruolo Microsoft.App/managedEnvironments/write nella risorsa ambiente gestita. È possibile assegnare in modo esplicito il Owner ruolo o Contributor nella risorsa. È anche possibile seguire la procedura per creare una definizione di ruolo personalizzata e assegnarla all'account.

  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.

    Screenshot che mostra il dashboard Eureka Server for Spring.

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.

Nota

Inviare ticket di supporto per le nuove richieste di funzionalità.

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:

Nome Descrizione Default value
eureka.server.enable-self-preservation Se abilitata, il server tiene traccia del numero di rinnovi che deve ricevere dal server. Ogni volta che il numero di rinnovi scende al di sotto della percentuale di soglia definita da eureka.server.renewal-percent-threshold. Il valore predefinito è impostato su true nel server Eureka originale, ma nel componente Eureka Server Java il valore predefinito è impostato su false. Vedere Limitazioni del componente Eureka Server per Spring Java. false
eureka.server.renewal-percent-threshold Percentuale minima di rinnovi previsti dai client nel periodo specificato da eureka.server.renewal-threshold-update-interval-ms. Se i rinnovi diminuiscono al di sotto della soglia, le scadenze vengono disabilitate se eureka.server.enable-self-preservation è abilitato. 0.85
eureka.server.renewal-threshold-update-interval-ms L'intervallo con cui deve essere aggiornata la soglia, come specificato in eureka.server.renewal-percent-threshold . 0
eureka.server.expected-client-renewal-interval-seconds Intervallo con cui i client devono inviare i relativi heartbeat. Il valore predefinito è 30 secondi. Se i client inviano heartbeat con frequenza diversa, ad esempio, ogni 15 secondi, questo parametro deve essere ottimizzato di conseguenza. In caso contrario, la conservazione automatica non funzionerà come previsto. 30
eureka.server.response-cache-auto-expiration-in-seconds Ottiene l'ora per cui il payload del Registro di sistema deve essere mantenuto nella cache se non è invalidato dagli eventi di modifica. 180
eureka.server.response-cache-update-interval-ms Ottiene l'intervallo di tempo con cui deve essere aggiornata la cache del payload del client. 0
eureka.server.use-read-only-response-cache Attualmente com.netflix.eureka.registry.ResponseCache usa una strategia di memorizzazione nella cache a due livelli per le risposte. Una readWrite cache con un criterio di scadenza e una readonly cache che memorizza nella cache senza scadenza. true
eureka.server.disable-delta Verifica se le informazioni differenziali possono essere gestite al client o meno. false
eureka.server.retention-time-in-m-s-in-delta-queue Ottenere il tempo per il quale le informazioni differenziali devono essere memorizzate nella cache per i client per recuperare il valore senza mancante. 0
eureka.server.delta-retention-timer-interval-in-ms Ottenere l'intervallo di tempo con cui l'attività di pulizia deve riattivarsi e verificare la presenza di informazioni delta scadute. 0
eureka.server.eviction-interval-timer-in-ms Ottenere l'intervallo di tempo con cui l'attività che scade le istanze deve riattivarsi ed eseguire. 60000
eureka.server.sync-when-timestamp-differs Controlla se sincronizzare le istanze quando il timestamp è diverso. true
eureka.server.rate-limiter-enabled Indica se il limite di velocità deve essere abilitato o disabilitato. false
eureka.server.rate-limiter-burst-size Limiter di frequenza, proprietà dell'algoritmo del bucket del token. 10
eureka.server.rate-limiter-registry-fetch-average-rate Limiter di frequenza, proprietà dell'algoritmo del bucket del token. Specifica la frequenza media richiesta applicata. 500
eureka.server.rate-limiter-privileged-clients Elenco di client certificati. Oltre ai client Java eureka standard. N/A
eureka.server.rate-limiter-throttle-standard-clients Indicare se i client standard del limite di velocità. Se impostato su false, solo i client non standard sono limitati. false
eureka.server.rate-limiter-full-fetch-average-rate Limiter di frequenza, proprietà dell'algoritmo del bucket del token. Specifica la frequenza media richiesta applicata. 100

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

Creare un cluster componente server Eureka a disponibilità elevata in App Azure Container

Contenuto correlato

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