Ansluta till en hanterad gateway för Spring i Azure Container Apps (förhandsversion)

Gateway for Spring är ett effektivt och kraftfullt sätt att dirigera, hantera och hantera API-begäranden som en del av en arkitektur för mikrotjänster. Den fungerar som en API Gateway som dirigerar externa begäranden till olika tjänster och lägger till olika funktioner som filtrering, belastningsutjämning med mera. I den här artikeln får du lära dig hur du skapar en gateway som dirigerar begäranden till dina containerappar.

I den här självstudien får du lära dig att:

Förutsättningar

• Ett Azure konto med en aktiv prenumeration. Om du inte redan har en kan du skapa en kostnadsfritt.
• Azure CLI.

Att tänka på

När du kör i Gateway för Spring i Azure Container Apps bör du vara medveten om följande information:

Konfiguration

Innan du börjar arbeta med Gateway for Spring måste du först skapa nödvändiga resurser.

Kör följande kommandon för att skapa resursgruppen och Container Apps-miljön.

1. Skapa variabler som stöd för programkonfigurationen. Dessa värden tillhandahålls för dig i den här lektionen. Vi använder administratörens aktuatorslutpunkt för spring sample-appen i den här lektionen.

   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"
   

   Variabel	beskrivning
   LOCATION	Den Azure region där du skapar din containerapp och Java komponent.
   ENVIRONMENT	Det Azure Container Apps miljönamnet för demoprogrammet.
   RESOURCE_GROUP	Namnet på Azure resursgrupp för demoprogrammet.
   JAVA_COMPONENT_NAME	Namnet på den Java komponent som skapats för containerappen. I det här fallet skapar du en Gateway för Spring Java-komponent.
   IMAGE	Containeravbildningen som används i containerappen.

2. Logga in på Azure med Azure CLI.

   az login
   

3. Skapa en resursgrupp.

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

4. Skapa din containerappmiljö.

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

   Den här miljön används för att vara värd för både Gateway for Spring-komponenten och din containerapp.

Använda komponenten Gateway for Spring Java

Nu när du har en Container Apps-miljö kan du skapa din containerapp med hjälp av en gateway för Spring Java-komponenter för att dirigera begäran till dem.

1. Skapa komponenten Gateway for Spring Java.

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

2. Skapa den containerapp som har det fullständigt kvalificerade domännamnet (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
   

   Det här kommandot returnerar URL:en för din containerapp som använder konfigurationsdata. Kopiera URL:en till en textredigerare så att du kan använda den i nästa steg.

Uppdatera gatewayrutter för att dirigera förfrågningar

1. Skapa en YAML-fil med följande innehåll. Ersätt <MYAPP_URL> med containerappens FQDN från föregående steg.

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

2. Kör följande kommando för att uppdatera gatewayen för Spring-komponenten med din routningskonfiguration.

   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
   

   Det här kommandot uppdaterar gatewayvägen och returnerar URL:en för din gateway som använder konfigurationsdata.

   Kommandot returnerar gatewayens URL. Om du besöker den här URL:en med sökvägen /myapp/health dirigeras begäran till appens actuator/health slutpunkt och returneras {"status":"UP","groups":["liveness","readiness"]}.

Rensa resurser

De resurser som skapas i den här självstudien påverkar din Azure-faktura. Om du inte ska använda dessa tjänster på lång sikt kör du följande kommando för att ta bort allt som skapats i den här självstudien.

az group delete --resource-group $RESOURCE_GROUP

Routningsfilformat

Gateway for Spring-komponenten har stöd för att definiera vägar via egenskaper med ID, URI, predikat och filter. Mer information finns i Dokumentation om Spring Cloud Gateway. Följande är en YAML-exempelfil som visar hur du konfigurerar dessa egenskaper.

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

Lista över tillåtna konfigurationer för din gateway för Spring (#configurable-properties)

I följande tabell beskrivs de gatewaykomponentegenskaper som du kan konfigurera för din app. Mer information finns i Spring Cloud Gateway Vanliga programegenskaper.

Vanliga konfigurationer

I följande lista beskrivs vanliga konfigurationer:

• Loggningsrelaterade konfigurationer:
  • logging.level.*
  • logging.group.*
  • Alla andra konfigurationer under logging.* namnområdet bör förbjudas. Det bör till exempel vara förbjudet att skriva loggfiler med hjälp av logging.file.