Herstellen einer Verbindung mit einem verwalteten Gateway für Spring in Azure Container Apps (Vorschau)

Gateway für Spring bietet eine effiziente und leistungsstarke Möglichkeit zum Weiterleiten, Verwalten und Verarbeiten von API-Anforderungen als Teil einer Microservices-Architektur. Es dient als API-Gateway, das externe Anforderungen an verschiedene Dienste weiterleitet und verschiedene Funktionen wie Filtern, Lastenausgleich und vieles mehr hinzufügt. In diesem Artikel erfahren Sie, wie Sie ein Gateway erstellen, das Anforderungen an Ihre Container-Apps weiterleitet.

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 in Gateway für Spring in Azure Container Apps die folgenden Details:

Einrichtung

Bevor Sie mit dem Gateway für Spring arbeiten, müssen Sie zuerst die erforderlichen Ressourcen erstellen.

Führen Sie die folgenden Befehle aus, um Ihre Ressourcengruppe und die Container Apps-Umgebung zu erstellen.

1. Erstellen Sie Variablen, um Ihre Anwendungskonfiguration zu unterstützen. Diese Werte werden Ihnen im Rahmen dieser Lerneinheit bereitgestellt. In dieser Lerneinheit verwenden wir den Actuator-Endpoint von Admin für die Spring-Beispiel-App.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=mygateway
   export APP_NAME=myapp
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Variable	Beschreibung
   LOCATION	Der standort Azure Region, an dem Sie Ihre Container-App und Java Komponente erstellen.
   ENVIRONMENT	Der Azure Container Apps Umgebungsname für Ihre Demoanwendung.
   RESOURCE_GROUP	Der Azure Ressourcengruppenname für Ihre Demoanwendung.
   JAVA_COMPONENT_NAME	Der Name der für Ihre Container-App erstellten Java Komponente. In diesem Fall erstellen Sie ein Gateway für spring Java Komponente.
   IMAGE	Das Container-Image, das in Ihrer Container-App verwendet wird.

2. Melden Sie sich mit dem Azure CLI bei Azure an.

   az login
   

3. Erstellen Sie eine Ressourcengruppe.

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

4. Erstellen Sie die Container Apps-Umgebung.

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

   Diese Umgebung wird verwendet, um sowohl die Komponente für das Gateway für Spring als auch Ihre Container-App zu hosten.

Verwenden der Komponente "Gateway für Spring Java"

Sie haben nun eine Container-Apps-Umgebung erstellt. Nun können Sie Ihre Container-App erstellen und ein Gateway verwenden, um Anforderungen an Ihre Spring-Java-Komponenten weiterzuleiten.

1. Erstellen Sie das Gateway für die Spring Java-Komponente.

   az containerapp env java-component gateway-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
   

2. Erstellen Sie die Container-App mit dem vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN).

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

   Dieser Befehl gibt die URL Ihrer Container-App zurück, die Konfigurationsdaten verwendet. Kopieren Sie die URL in einen Text-Editor, damit Sie sie im nächsten Schritt verwenden können.

Aktualisieren der Gatewayrouten zum Weiterleiten von Anforderungen

1. Erstellen Sie eine YAML-Datei mit dem folgenden Inhalts. Ersetzen Sie <MYAPP_URL> durch den FQDN der Container-App aus dem vorherigen Schritt.

   springCloudGatewayRoutes:
   - id: "route1"
     uri: "<MYAPP_URL>"
     predicates:
       - "Path=/myapp/{path}"
     filters:
       - "SetPath=/actuator/{path}"
   

2. Führen Sie den folgenden Befehl aus, um die Komponente für das Gateway für Spring mit Ihrer Routenkonfiguration zu aktualisieren.

   az containerapp env java-component gateway-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \ 
       --route-yaml <PTAH_TO_ROUTE_YAML_FILE> \
       --query properties.ingress.fqdn
   

   Dieser Befehl aktualisiert die Gatewayroute und gibt die URL Ihres Gateways zurück, das Konfigurationsdaten verwendet.

   Der Befehl gibt die URL des Gateways zurück. Wenn Sie diese URL mit dem Pfad /myapp/health aufrufen, sollte die Anforderung an den actuator/health-Endpunkt Ihrer App weitergeleitet werden, wobei {"status":"UP","groups":["liveness","readiness"]} zurückgegeben wird.

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 erstellten Ressourcen zu entfernen, wenn Sie diese Dienste nicht langfristig verwenden werden.

az group delete --resource-group $RESOURCE_GROUP

Routendateiformat

Die Komponente für Gateway für Spring unterstützt das Definieren von Routen über Eigenschaften mit ID, URI, Prädikaten und Filtern. Weitere Informationen finden Sie in der Dokumentation zu Spring Cloud Gateway. In der folgenden YAML-Beispieldatei wird die Konfiguration dieser Eigenschaften veranschaulicht.

  springCloudGatewayRoutes:
  - id: "route1"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v1/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"
  - id: "route2"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v2/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"

Liste der zulässigen Konfigurationen für Ihr Gateway für Spring (#configurable-properties)

In der folgenden Liste sind die Eigenschaften der Gatewaykomponenten aufgeführt, die Sie für Ihre App konfigurieren können. Weitere Informationen finden Sie im Artikel mit den gängigen Anwendungseigenschaften von Spring Cloud Gateway.

Häufig verwendete Konfigurationen

In der folgenden Liste werden allgemeine Konfigurationen beschrieben:

• Konfigurationen im Zusammenhang mit der Protokollierung:
  • logging.level.*
  • logging.group.*
  • Alle weiteren Konfigurationen unter dem logging.*-Namespace sollten nicht zugelassen werden. Beispiel: Das Schreiben von Protokolldateien mit logging.file sollte nicht zugelassen werden.