Herstellen einer Verbindung mit einem verwalteten Eureka-Server für Spring in Azure Container Apps

Eureka Server für Spring ist eine Dienstregistrierung, die es Microservices ermöglicht, sich selbst zu registrieren und andere Dienste zu entdecken. Eureka Server für Spring ist als Azure Container Apps Komponente verfügbar. Sie können Ihre Container-App für Spring an den Eureka Server binden, um eine automatische Registrierung beim Eureka-Server zu ermöglichen.

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

• Ein Azure Konto mit einem aktiven Abonnement. Wenn Sie noch keines haben, können Sie kostenlos eins erstellen.
• Azure CLI.

Überlegungen

Beachten Sie bei der Ausführung des Eureka Servers für Spring-Anwendungen in Container Apps die folgenden Details:

Einrichtung

Bevor Sie mit dem Eureka Server für die Spring-Komponente arbeiten, müssen Sie zuerst die erforderlichen Ressourcen erstellen.

Erstellen der Eureka-Server für Spring Java-Komponente

Binden der Containeranwendung an den Eureka-Server für die Spring-Java-Komponente

Kehren Sie zur Container-App im Portal zurück. Kopieren Sie die URL Ihrer App in einen Text-Editor, damit Sie sie in einem der anstehenden Schritte verwenden können.

Navigieren Sie zur Route /allRegistrationStatus, um alle Anwendungen anzuzeigen, die beim Eureka Server für Spring-Komponenten registriert sind.

Die Bindung fügt mehrere Konfigurationen als Umgebungsvariablen in die Anwendung ein, in erster Linie die eureka.client.service-url.defaultZone Eigenschaft. Diese Eigenschaft gibt den internen Endpunkt der Eureka Server-Java-Komponente an.

Die Bindung fügt auch die folgenden Eigenschaften ein:

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

Die eureka.client.register-with-eureka-Eigenschaft wird auf true festgelegt, um die Registrierung beim Eureka-Server zu erzwingen. Diese Registrierung überschreibt die lokale Einstellung in application.properties, vom Konfigurationsserver usw. Wenn Sie sie falseauf festlegen möchten, können Sie sie überschreiben, indem Sie eine Umgebungsvariable in Ihrer Container-App festlegen.

Die eureka.instance.prefer-ip-address-Eigenschaft wird aufgrund der spezifischen Systemauflösungsregel für Domänennamen in der Container-App-Umgebung auf true festgelegt. Ändern Sie diesen Wert nicht, sodass Sie die Bindung nicht unterbrechen.

Optional: Trennen Sie Ihre Container-App vom Eureka-Server für die Spring Java-Komponente.

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

Anzeigen der Anwendung über ein Dashboard

1. Erstellen Sie eine Definition einer benutzerdefinierten Rolle.

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

   Stellen Sie sicher, dass Sie den Platzhalter <SUBSCRIPTION_ID> im Wert AssignableScopes durch Ihre Abonnement-ID ersetzen.

2. Weisen Sie Ihrem Konto die benutzerdefinierte Rolle in der Ressource einer verwalteten Umgebung zu.

   Rufen Sie die Ressourcen-ID der verwalteten Umgebung ab:

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

3. Weisen Sie Ihrem Konto die Rolle zu.

   Ersetzen Sie vor dem Ausführen dieses Befehls die Platzhalter, die durch die <>-Klammern angegeben sind, durch Ihre Benutzer- oder Dienstprinzipal-ID und ihren Rollennamen.

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

   Hinweis

   Der Wert <USER_OR_SERVICE_PRINCIPAL_ID> sollte in der Regel die Identität sein, die Sie für den Zugriff auf das Azure-Portal verwenden. Der <ROLE_NAME>-Wert ist der Name, den Sie in Schritt 1 zugewiesen haben.

4. Rufen Sie die URL des Dashboards „Eureka-Server für Spring“ ab.

   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
   

   Dieser Befehl gibt die URL zurück, die Sie für den Zugriff auf das Dashboard „Eureka Server für Spring“ verwenden können. Mit dem Dashboard können Sie auch Ihre Container-App sehen, wie im folgenden Screenshot dargestellt.

   

Optional: Integrieren des Eureka-Servers für Spring und Admin für Spring Java-Komponenten

Wenn Sie den Eureka-Server für Spring und den Administrator für Spring Java Komponenten integrieren möchten, lesen Sie Integrieren des verwalteten Administrators für Spring mit Eureka Server für Spring.

Bereinigen von Ressourcen

Die in diesem Tutorial erstellten Ressourcen wirken sich auf Ihre Azure-Rechnung aus. Führen Sie den folgenden Befehl aus, um alle in diesem Tutorial von Ihnen erstellten Ressourcen zu entfernen, wenn Sie diese Dienste nicht langfristig verwenden werden.

az group delete --resource-group $RESOURCE_GROUP

Liste der zulässigen Konfigurationen für Eureka Server für Spring

In den folgenden Abschnitten werden die unterstützten Konfigurationen beschrieben. Weitere Informationen finden Sie unter Spring Cloud Eureka Server.

Konfigurationsoptionen

Der az containerapp update-Befehl verwendet den --configuration-Parameter, um zu steuern, wie der Eureka Server für Spring konfiguriert ist. Sie können mehrere Parameter gleichzeitig verwenden, solange sie durch ein Leerzeichen getrennt sind. Weitere Informationen finden Sie unter Spring Cloud Eureka Server.

Die folgenden Konfigurationseinstellungen sind in der eureka.server-Konfigurationseigenschaft verfügbar:

Häufig verwendete Konfigurationen

• Konfigurationen im Zusammenhang mit der Protokollierung:
  • logging.level.*
  • logging.group.*
  • Alle anderen Konfigurationen unter dem logging.*-Namespace sollten verboten sein, z. B. das Schreiben von Protokolldateien mithilfe der Verwendung von logging.file.

Aufruf zwischen Anwendungen

In diesem Beispiel wird gezeigt, wie Sie Java Code schreiben, um zwischen Anwendungen aufzurufen, die mit der Eureka Server for Spring-Komponente registriert sind. Wenn Container-Apps mit Eureka verbunden sind, kommunizieren sie untereinander über den Eureka-Server.

Das Beispiel erstellt zwei Anwendungen, einen Anrufer und einen Angerufenen. Beide Anwendungen kommunizieren miteinander mithilfe der Eureka Server for Spring-Komponente. Die aufgerufene Anwendung stellt einen Endpunkt zur Verfügung, der von der aufrufenden Anwendung aufgerufen wird.

1. Erstellen Sie die aufgerufene Anwendung. Aktivieren Sie den Eureka-Client in Ihrer Spring Boot-Anwendung, indem Sie der Klasse „main“ die Anmerkung @EnableDiscoveryClient hinzufügen.

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

2. Erstellen Sie einen Endpunkt in der aufgerufenen Anwendung, der von der aufrufenden Anwendung aufgerufen wird.

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

3. Setzen Sie den Namen der Zielanwendung in der Anwendungskonfigurationsdatei - etwa in application.yml - fest.

   spring.application.name=callee
   

4. Erstellen Sie die aufrufende Anwendung.

   Fügen Sie die Anmerkung @EnableDiscoveryClient hinzu, um die Clientfunktionen von Eureka zu aktivieren. Erstellen Sie außerdem eine WebClient.Builder-Bean mit der Anmerkung @LoadBalanced, um Lastenausgleichsaufrufe an andere Dienste auszuführen.

   @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. Erstellen Sie in der aufrufenden Anwendung einen Controller, der WebClient.Builder verwendet, um die aufgerufene Anwendung mithilfe des Anwendungsnamens „callee“ aufzurufen.

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

Jetzt verfügen Sie über eine Anrufer- und Angerufene-Anwendung, die mit Eureka Server für Spring Java-Komponenten miteinander kommunizieren. Stellen Sie sicher, dass beide Anwendungen ausgeführt und an den Eureka-Server gebunden werden, bevor Sie den Endpunkt /call-callee in der aufrufenden Anwendung testen.

Begrenzungen

• Die Eureka Server-Java-Komponente enthält eine Standardkonfiguration, eureka.server.enable-self-preservation, die auf false festgelegt ist. Diese Standardkonfiguration hilft zu vermeiden, dass Instanzen nach der Aktivierung der Selbsterhaltung nicht gelöscht werden. Wenn Instanzen zu früh gelöscht werden, könnten einige Anforderungen an nicht existierende Instanzen weitergeleitet werden. Wenn Sie diese Einstellung in true ändern möchten, können Sie sie überschreiben, indem Sie ihre eigenen Konfigurationen in der Java Komponente festlegen.
• Das Eureka-Dashboard ist in Azure von 21Vianet nicht verfügbar.

Nächste Schritte

Zugehöriger Inhalt

Integrieren des verwalteten Administrators für Spring in Eureka Server für Spring