Esercitazione: Connettersi a un gateway gestito per Spring in App Azure Container (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.

Questa esercitazione apprendi come:

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 nel gateway per Spring nelle app Azure Container, tenere presenti i dettagli seguenti:

Attrezzaggio

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 viene usato l'endpoint dell'attuatore dell'amministratore 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 di Azure in cui si creano l'app contenitore e il componente Java.
   ENVIRONMENT	Nome dell'ambiente di App contenitore di Azure per l'applicazione demo.
   RESOURCE_GROUP	Nome del gruppo di risorse di 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	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 nelle app contenitore.

   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 App contenitore, è possibile creare l'app contenitore usando un gateway per i componenti Java spring per instradarli.

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 route 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. Eseguire il comando seguente per aggiornare il componente Gateway per Spring con la configurazione della route.

   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 deve instradare la richiesta all'endpoint dell'app 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 di configurazione consentito per il gateway per Spring (proprietà #configurable)

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.