Tutorial: 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 im Rahmen einer Microservicearchitektur. 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-Befehlszeilenschnittstelle.

Überlegungen

Beachten Sie bei der Ausführung im Gateway für Spring in Azure Container Apps die folgenden Details:

Setup

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 Sie den Aktuatorendpunkt des Administrators 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 der Azure-Region, an dem Sie Ihre Container-App und die Java-Komponente erstellen
   ENVIRONMENT	Der Name der Azure Container Apps-Umgebung für Ihre Demoanwendung.
   RESOURCE_GROUP	Der Name der Azure-Ressourcengruppe für Ihre Demoanwendung
   JAVA_COMPONENT_NAME	Der Name der für Ihre Container-App erstellten Java-Komponente. In diesem Fall erstellen Sie eine Java-Komponente vom Typ „Gateway für Spring“.
   IMAGE	Das containerimage, das in Ihrer Container-App verwendet wird.

2. Melden Sie sich mit der Azure-Befehlszeilenschnittstelle (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 Java-Komponente in Gateway für Spring

Sie verfügen nun über eine Container Apps-Umgebung und können Ihre Container-App erstellen und für Java-Komponenten für Spring ein Gateway verwenden, um Anforderungen weiterzuleiten.

1. Erstellen Sie die Java-Komponente in Gateway for Spring.

   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-Abrechnung 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.