Connettersi a un gateway gestito per Spring in App contenitore di Azure (anteprima)

Il gateway per Spring offre un modo efficiente e potente per instradare, gestire e gestire le richieste API come parte di un'architettura di microservizi. Funge da gateway API che instrada richieste esterne a servizi diversi, aggiungendo diverse funzionalità, ad esempio il filtro, il bilanciamento del carico e altro ancora. Questo articolo illustra come creare un gateway che indirizza le richieste alle app contenitore.

In questa esercitazione, imparerai 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 il Gateway di Spring in App contenitore di Azure, tenere presenti i dettagli seguenti:

Configurazione

Prima di iniziare a usare il gateway per Spring, è prima necessario creare le risorse necessarie.

Eseguire i comandi seguenti per creare il gruppo di risorse e l'ambiente delle App contenitore.

1. Creare le variabili per supportare la configurazione dell'applicazione. Questi valori vengono forniti ai fini dello svolgimento di questa lezione. In questa lezione, usiamo l'endpoint dell'actuator di admin per l'app spring sample.

   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"
   

   Variabile	Descrizione
   LOCATION	Posizione dell'area Azure in cui si crea l'app contenitore e il componente Java.
   ENVIRONMENT	Nome dell'ambiente App contenitore di Azure per l'applicazione demo.
   RESOURCE_GROUP	Nome del gruppo di risorse Azure per l'applicazione demo.
   JAVA_COMPONENT_NAME	Nome del componente Java creato per l'app contenitore. In questo caso, si crea un componente Gateway per Spring Java.
   IMAGE	L'immagine del container utilizzata nell'app del container.

2. Accedere a Azure con il interfaccia della riga di comando di Azure.

   az login
   

3. Creare un gruppo di risorse.

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

4. Crea l'ambiente delle tue app container.

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

   Questo ambiente viene usato per ospitare sia il componente Gateway per Spring che l'app contenitore.

Usare il componente Gateway per Spring Java

Ora che si dispone di un ambiente Container Apps, è possibile creare la container app usando un gateway per i componenti Java Spring per instradare le richieste verso di essi.

1. Creare il componente Gateway per Spring Java.

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

2. Creare l'app contenitore con il nome di dominio completo (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
   

   Questo comando restituisce l'URL dell'app contenitore che utilizza i dati di configurazione. Copiare l'URL in un editor di testo in modo da poterlo usare nel passaggio successivo.

Aggiornare le rotte del gateway per instradare le richieste

1. Creare un file YAML con il contenuto seguente. Sostituire <MYAPP_URL> con il nome di dominio completo dell'app contenitore del passaggio precedente.

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

2. Esegui il comando seguente per aggiornare il componente Gateway per Spring con la configurazione di routing.

   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
   

   Questo comando aggiorna la route del gateway e restituisce l'URL del gateway che utilizza i dati di configurazione.

   Il comando restituisce l'URL del gateway. Visitare questo URL con il percorso /myapp/health dovrebbe instradare la richiesta all'endpoint dell'applicazione actuator/health, restituendo {"status":"UP","groups":["liveness","readiness"]}.

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

Formato del file di route

Il componente Gateway per Spring supporta la definizione di route tramite proprietà con ID, URI, predicati e filtri. Per altre informazioni, vedere la documentazione di Spring Cloud Gateway. Di seguito è riportato un esempio di file YAML che illustra come configurare queste proprietà.

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

Elenco della configurazione autorizzata per il gateway per Spring (#proprietà-configurabili)

La tabella seguente descrive le proprietà del componente gateway che è possibile configurare per l'app. Per altre informazioni, vedere Proprietà comuni dell'applicazione Spring Cloud Gateway.

Configurazioni comuni

L'elenco seguente descrive le configurazioni comuni:

• Registrazione delle configurazioni correlate:
  • logging.level.*
  • logging.group.*
  • Tutte le altre configurazioni nello spazio dei nomi logging.* non devono essere consentite. Ad esempio, la scrittura di file di log tramite logging.file non deve essere consentita.