Inicio rápido: implementación de la primera aplicación de Spring Batch en Azure Spring Apps

Nota:

Los planes Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retirada de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan Estándar por consumo y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte Migrar el plan Estándar por consumo y dedicado de Azure Spring Apps a Azure Container Apps.

En esta guía de inicio rápido se muestra cómo implementar una aplicación efímera de Spring Batch en Azure Spring Apps. El proyecto de ejemplo se deriva del ejemplo trabajo de fútbol de Spring Batch. Es un trabajo de carga de estadísticas. En el ejemplo original, una prueba unitaria desencadena el trabajo. En el ejemplo adaptado, el método main de FootballJobApplication inicia el trabajo.

Este artículo se aplica a:❌ Básico o Estándar ✔️ Enterprise

El siguiente diagrama muestra la arquitectura del sistema:

En este artículo se proporcionan las siguientes opciones para la implementación en Azure Spring Apps:

• La opción de Azure Portal es la manera más sencilla y rápida de crear recursos e implementar aplicaciones con un solo clic. Esta opción es adecuada para los desarrolladores de Spring que desean implementar rápidamente aplicaciones para los servicios en la nube de Azure.
• La opción CLI de Azure utiliza una potente herramienta de línea de comandos para administrar los recursos de Azure. Esta opción es adecuada para los desarrolladores de Spring que están familiarizados con los servicios en la nube de Azure.

1. Prerrequisitos

Azure Portal

• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita antes de empezar.
• Git.
• Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.

CLI de Azure

• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita antes de empezar.
• Git.
• Kit de desarrollo de Java (JDK), versión 17.
• Versión 2.55.0 o superior de la CLI de Azure. Use los siguientes comandos para instalar la extensión de Azure Spring Apps: az extension add --name spring.
• Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.

2. Preparar el proyecto Spring

Use el siguiente comando para clonar el proyecto de muestra desde GitHub:

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. Preparar el entorno en la nube

El recurso principal necesario para ejecutar este ejemplo es una instancia de Azure Spring Apps. En esta sección se proporcionan los pasos para crear este recurso.

Azure Portal

3.1. Inicio de sesión en Azure Portal

Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.

3.2. Creación de una instancia de Azure Spring Apps

Use los siguientes pasos para crear una instancia de servicio de Azure Spring Apps:

1. En la esquina de Azure Portal, seleccione Crear un recurso.

2. Seleccione Proceso>Azure Spring Apps.

3. Complete el formulario de aspectos básicos con la información siguiente:

   Configuración	Valor sugerido	Descripción
   Suscripción	El nombre de su suscripción.	La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
   Grupos de recursos	myresourcegroup	Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
   Nombre	myasa	Nombre único que identifica al servicio de Azure Spring Apps. El nombre debe tener entre 4 y 32 caracteres, y solo puede contener números, letras minúsculas y guiones. El primer carácter del nombre del servicio debe ser una letra y el último debe ser una letra o un número.
   Plan	Empresa	El plan de precios que determina el recurso y el coste asociado a su instancia.
   Región	La región más cercana a los usuarios.	La ubicación más cercana a los usuarios.
   Redundancia de zona	No seleccionado	La opción para crear el servicio de Azure Spring Apps en una zona de disponibilidad de Azure. Esta característica no se admite actualmente en todas las regiones.
   Plan de IP de software	Pago por uso	Plan de precios que le permite pagar por uso con Azure Spring Apps.
   Términos	Seleccionada	La casilla de verificación del contrato asociado a la oferta de Marketplace. Debe activar esta casilla.
   Implementación del proyecto de ejemplo	No seleccionado	Opción para usar la aplicación de ejemplo integrada.

4. Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para aprovisionar la instancia de Azure Spring Apps.

5. En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio.

   

6. Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.

3.3. Habilitar el registro del servicio

Vaya a la instancia de Azure Spring Apps que creó, expanda Componentes administrados en el panel de navegación y, a continuación, seleccione Registro de servicios. A continuación, en la página de información general, seleccione Administrar para abrir la página Administrar, seleccione Habilitar registro de servicios y, a continuación, seleccione Aplicar.

3.4. Configuración de un área de trabajo de Log Analytics

Para obtener información sobre cómo consultar los datos en los registros, consulte Inicio rápido: configuración de un área de trabajo de Log Analytics.

CLI de Azure

3.1. Proporcione nombres para cada recurso

Cree variables para contener los nombres del recurso mediante los siguientes comandos. Asegúrese de reemplazar los marcadores de posición por sus propios valores.

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>

3.2. Creación de un nuevo grupo de recursos

Use los siguientes pasos para crear un grupo de recursos:

1. Use el siguiente comando para iniciar sesión en la CLI de Azure:

   az login
   

2. Use el siguiente comando para establecer la ubicación predeterminada:

   az configure --defaults location=${LOCATION}
   

3. Use el siguiente comando para enumerar todas las suscripciones disponibles y determinar el id. de suscripción que se va a usar:

   az account list --output table
   

4. Use el siguiente comando para establecer la suscripción predeterminada:

   az account set --subscription <subscription-ID>
   

5. Use el siguiente comando para crear un grupo de recursos:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Use el siguiente comando para establecer el grupo de recursos recién creado como el grupo de recursos predeterminado:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Creación de una instancia de Azure Spring Apps

Azure Spring Apps se usa para hospedar la aplicación web de Spring. Siga los pasos siguientes para crear una instancia de Azure Spring Apps y una aplicación dentro de ella:

1. Use el comando siguiente para crear una instancia de servicio de Azure Spring Apps y habilitar el registro de servicios:

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. Use el siguiente comando para comprobar que la instancia de servicio del plan Enterprise de Azure Spring Apps se creó correctamente:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Implementación de la aplicación football-billboard en Azure Spring Apps

Azure Portal

Siga estos pasos para implementar la aplicación:

1. Vaya a la instancia de Azure Spring Apps que creó, expanda Configuración en el panel de navegación y, a continuación, seleccione Aplicaciones.

2. En el panel Aplicaciones, seleccione Crear aplicación para abrir la página Crear aplicación.

3. Establezca Nombre de la aplicación en football-billboard, seleccione Registro de servicios en la columna Enlazar y, a continuación, seleccione Crear.

   

4. Después de crear la aplicación, seleccione Implementar aplicación y copie el comando de la CLI de Azure para implementarla. A continuación, abra una ventana de Bash, pegue el comando en la línea de comandos y reemplace la ruta de acceso del artefacto por el valor correcto del sistema. Después, ejecute el comando. Espere varios minutos hasta que la compilación y la implementación se realicen correctamente. El comando y la salida deben ser similares al ejemplo siguiente:

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. Después de la implementación, vuelva al panel Aplicaciones y seleccione la aplicación football-billboard. A continuación, vaya a la página de información general y seleccione Asignar punto de conexión para exponer el punto de conexión público de la aplicación.

CLI de Azure

Siga estos pasos para implementar la aplicación:

1. Use el siguiente comando para ir a la carpeta del proyecto de ejemplo desde la carpeta raíz del repositorio:

   cd azure-spring-apps-samples/job-samples/football-billboard
   

2. Use el siguiente comando para crear una aplicación en la instancia de Azure Spring Apps y enlazar el registro de servicios:

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

3. Use el siguiente comando para implementar la aplicación:

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. Implementación del ejemplo de trabajo en Azure Spring Apps

En esta sección se proporcionan los pasos para implementar el ejemplo.

Azure Portal

5.1. Creación y ejecución del trabajo

Siga estos pasos para crear y ejecutar el trabajo:

1. Vaya al panel Trabajos y seleccione Crear trabajo. Rellene el nombre del trabajo como football. Configure los parámetros del trabajo, como paralelismo, límite de reintentos y tiempo de espera. Agregue variables de entorno y variables de entorno secretas según sea necesario. Después de la confirmación, seleccione Crear.

   

2. Después de crear el trabajo, expanda Componentes administrados en el panel de navegación y seleccione Registro de servicios. A continuación, seleccione Enlace del trabajo, seleccione Enlazar trabajo para seleccionar el trabajo de fútbol y, a continuación, seleccione Aplicar para enlazar.

   

3. Vuelva al panel Trabajos después de enlazar el trabajo, seleccione Implementar trabajo y, a continuación, copie el comando de la CLI de Azure para implementar el trabajo. A continuación, abra una ventana de Bash, pegue el comando en la línea de comandos y reemplace la ruta de acceso del artefacto por el valor correcto del sistema. Después, ejecute el comando. Espere varios minutos hasta que la compilación y la implementación se realicen correctamente. El comando y la salida deben ser similares al ejemplo siguiente:

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. Después de la implementación, abra la página de información general del trabajo football seleccionando el nombre del trabajo. Seleccione Ejecutar para iniciar la ejecución de la tarea. Personalice cada ejecución del trabajo con parámetros diferentes, como variables de entorno o, simplemente, seleccionando Ejecutar para desencadenar la ejecución. Un mensaje indica que el trabajo se está ejecutando.

   

CLI de Azure

5.1. Creación y ejecución del trabajo

Siga estos pasos para crear y ejecutar el trabajo:

1. Use el comando siguiente para ir a la carpeta del proyecto de ejemplo desde la carpeta football-billboard donde lo dejó anteriormente:

   cd ..
   cd football
   

2. Use el siguiente comando para crear un trabajo en la instancia de Azure Spring Apps y enlazar el registro de servicios:

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. Use el comando siguiente para implementar el proyecto de ejemplo football en el trabajo. Este comando carga y compila el código fuente en Azure y lo prepara para el inicio.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. Use el siguiente comando para iniciar el trabajo y establecer la variable EXECUTION_NAME en el nombre de ejecución del trabajo:

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. Comprobar el resultado de la ejecución del trabajo y la interfaz de usuario de la cartelera

Ya puede acceder a la ejecución del trabajo y comprobar el resultado.

Azure Portal

Utilice los pasos siguientes para validarla:

1. En el panel Ejecuciones, compruebe el resultado de la ejecución del trabajo. Espere unos segundos y actualice para comprobar que el estado cambie a Completado. Este valor significa que la ejecución del trabajo finalizó correctamente.

2. Seleccione Ver registros para consultar los registros de la ejecución del trabajo.

   

3. Abra el punto de conexión público de la aplicación en una ventana del explorador para ver la interfaz de usuario de la cartelera. Deje la aplicación abierta.

   

4. Vuelva a la página de información general del trabajo football y seleccione Ejecutar para desencadenar la ejecución de nuevo.

5. Vuelva a la página del punto de conexión en el explorador y seleccione Actualizar para ver la interfaz de usuario modificada, tal y como se muestra en la captura de pantalla siguiente:

   

CLI de Azure

Utilice los pasos siguientes para validarla:

1. Use el siguiente comando para consultar el resultado de la ejecución con el nombre del trabajo y su nombre de ejecución:

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   El registro de trabajos que transmita la ejecución del trabajo debería ser similar al ejemplo siguiente:

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. Use el comando siguiente para recuperar el punto de conexión de la aplicación football-billboard:

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

3. Abra el punto de conexión público de la aplicación en una ventana del explorador para ver la interfaz de usuario de la cartelera. Deje la aplicación abierta.

   

4. Use el siguiente comando para iniciar el trabajo de nuevo:

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. Vuelva a la página del punto de conexión en el explorador y seleccione Actualizar para ver la interfaz de usuario modificada, tal y como se muestra en la captura de pantalla siguiente:

   

7. Limpieza de recursos

Asegúrate de eliminar los recursos creados en este tutorial cuando ya no los necesites. Puede eliminar el grupo de recursos de Azure, lo que incluye todos los recursos del grupo de recursos.

Azure Portal

Siga estos pasos para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:

1. Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos y, a continuación, seleccione el nombre del grupo de recursos.

2. En la página Grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación, luego seleccione Eliminar.

CLI de Azure

Use el siguiente comando para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:

az group delete --name ${RESOURCE_GROUP}

8. Pasos siguientes

Para más información, consulte los siguientes artículos.

• Muestras de Azure Spring Apps.
• Azure para desarrolladores de Spring
• Documentación de Azure de Spring Cloud