Conexión a una puerta de enlace administrada para Spring en Azure Container Apps (versión preliminar)

Gateway for Spring ofrece una manera eficaz y eficaz de enrutar, administrar y controlar las solicitudes de API como parte de una arquitectura de microservicios. Sirve como puerta de enlace de API que enruta las solicitudes externas a diferentes servicios, agregando varias funcionalidades, como el filtrado, el equilibrio de carga, etc. En este artículo, aprenderá a crear una puerta de enlace que dirija las solicitudes a las aplicaciones de contenedor.

En este tutorial, aprenderá a:

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si aún no tiene ninguno, puede crear uno gratis.
• CLI de Azure.

Consideraciones

Al ejecutar en Gateway for Spring en Azure Container Apps, tenga en cuenta los detalles siguientes:

Configuración

Antes de empezar a trabajar con Gateway para Spring, primero debe crear los recursos necesarios.

Ejecute los siguientes comandos para crear el grupo de recursos y el entorno de Container Apps.

1. Cree variables para soportar la configuración de su aplicación. Estos valores se proporcionan para usted con fines de esta lección. En esta lección se usa el punto de conexión del actuador de administrador para la aplicación de ejemplo spring.

   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	Descripción
   LOCATION	La ubicación de la región de Azure donde se crea tu aplicación de contenedor y componente de Java.
   ENVIRONMENT	El nombre del entorno Azure Container Apps para la aplicación de demostración.
   RESOURCE_GROUP	El nombre del grupo de recursos Azure para la aplicación de demostración.
   JAVA_COMPONENT_NAME	Nombre del componente Java creado para la aplicación contenedora. En este caso, creará un componente Gateway for Spring Java.
   IMAGE	Imagen de contenedor utilizada en tu aplicación de contenedor.

2. Inicie sesión en Azure con el CLI de Azure.

   az login
   

3. Cree un grupo de recursos.

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

4. Cree el entorno de aplicaciones de contenedor.

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

   Este entorno se usa para hospedar tanto el componente Gateway para Spring como la aplicación contenedora.

Uso del componente Gateway for Spring Java

Ahora que tiene un entorno de Container Apps, puede crear la aplicación de contenedor mediante una puerta de enlace para los componentes de Spring Java para enrutar la solicitud a ellos.

1. Cree el componente Gateway para Spring Java.

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

2. Cree la aplicación contenedora que tenga el nombre de dominio totalmente calificado (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
   

   Este comando devuelve la dirección URL de la aplicación contenedora que consume datos de configuración. Copie la dirección URL en un editor de texto para poder usarla en el paso siguiente.

Actualización de las rutas de puerta de enlace para enrutar solicitudes

1. Cree un archivo YAML con el siguiente contenido. Reemplaza <MYAPP_URL> por el FQDN de la aplicación de contenedor del paso anterior.

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

2. Ejecute el comando siguiente para actualizar el componente Gateway para Spring con la configuración de ruta.

   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
   

   Este comando actualiza la ruta de la puerta de enlace y devuelve la dirección URL de la puerta de enlace que consume datos de configuración.

   El comando devuelve la dirección URL de la puerta de enlace. Al visitar esta URL con la ruta /myapp/health, debe enrutar la solicitud al endpoint actuator/health de su aplicación, devolviendo {"status":"UP","groups":["liveness","readiness"]}.

Limpieza de recursos

Los recursos creados en este tutorial tienen un efecto en la factura de Azure. Si no va a usar estos servicios a largo plazo, ejecute el siguiente comando para quitar todo lo creado en este tutorial.

az group delete --resource-group $RESOURCE_GROUP

Formato de archivo de ruta

El componente Gateway para Spring admite la definición de rutas a través de propiedades con identificador, URI, predicados y filtros. Para más información, consulte la documentación de Spring Cloud Gateway. A continuación se muestra un archivo YAML de ejemplo que muestra cómo configurar estas propiedades.

  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 de configuración permitida para su Gateway en Spring (#configurable-properties)

En la tabla siguiente se describen las propiedades del componente de puerta de enlace que puede configurar para la aplicación. Para obtener más información, consulte propiedades de aplicación comunes de Spring Cloud Gateway.

Opciones de configuración comunes

En la lista siguiente se describen las configuraciones comunes:

• Registro de configuraciones relacionadas:
  • logging.level.*
  • logging.group.*
  • Se debe prohibir cualquier otra configuración dentro del espacio de nombres logging.*. Por ejemplo, se deben prohibir la escritura de archivos de registro mediante logging.file.