Implementación de aplicaciones en Spring Boot desde la CLI de Azure

Artículo
10/04/2024

Nota:

Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro 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 de consumo estándar 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 obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.

Este artículo se aplica a:✅ Java ❎ C#

Este artículo se aplica a:✅ Básico/Estándar ❎️ Enterprise

Azure Spring Apps permite aplicaciones de Spring Boot en Azure.

Puede iniciar aplicaciones directamente desde el código fuente de Java o desde un archivo JAR generado previamente. En este artículo se explican los procedimientos de implementación.

Requisitos previos

Antes de empezar, asegúrese de que su suscripción de Azure tiene las dependencias necesarias:

Sugerencia

Azure Cloud Shell es un shell interactivo gratuito que puede usar para ejecutar los pasos de este artículo. Incluye herramientas comunes de Azure preinstaladas, entre las que se incluyen las versiones más recientes de Git, JDK, Maven y la CLI de Azure. Si ha iniciado sesión en su suscripción de Azure, inicie Azure Cloud Shell desde shell.azure.com. Para más información sobre Azure Cloud Shell, lea la documentación.

Instalación de la extensión de la CLI de Azure

Instale la extensión de Azure Spring Apps para la CLI de Azure, para lo cual debe usar el siguiente comando

az extension add --name spring

Aprovisionamiento de una instancia de servicio con la CLI de Azure

Inicie sesión en la CLI de Azure y elija una suscripción activa.

az login
az account list -o table
az account set --subscription <subscription-id>

Cree un grupo de recursos que contenga el servicio en Azure Spring Apps. Más información sobre los grupos de recursos de Azure.

az group create --location eastus --name <resource-group-name>

Ejecute los siguientes comandos para aprovisionar una instancia de Azure Spring Apps. Prepare un nombre para el servicio en 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.

az spring create --resource-group <resource-group-name> --name <resource-name>

La instancia de servicio tardará aproximadamente cinco minutos en implementarse.

Establezca el nombre del grupo de recursos y el nombre de instancia de Azure Spring Apps predeterminados con los siguientes comandos:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Creación de la aplicación en Azure Spring Apps

El siguiente comando crea una aplicación en Azure Spring Apps en su suscripción. Así se crea un servicio vacío en el que puede cargar su aplicación.

az spring app create --name <app-name>

Implementación de una aplicación de Spring Boot

Puede implementar la aplicación desde un archivo JAR pregenerado o desde un repositorio de Gradle o Maven. A continuación, instrucciones para cada caso.

Implementación de un archivo JAR precompilado

Para realizar la implementación desde un archivo JAR compilado en la máquina local, asegúrese de que la compilación genera un archivo fat-JAR.

Para implementar el archivo fat-JAR en una implementación activa

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

Para implementar el archivo fat-JAR en una implementación específica

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Implementación desde el código fuente

Azure Spring Apps usa kpack para compilar el proyecto. Puede usar la CLI de Azure para cargar el código fuente, compilar el proyecto con kpack e implementarlo en la aplicación de destino.

Advertencia

El proyecto solo debe generar un archivo JAR con una entrada main-class en MANIFEST.MF de target (para implementaciones de Maven) o build/libs (para implementaciones de Gradle). Si hay varios archivos JAR con entradas main-class, se producirá un error en la implementación.

Para los proyectos de Maven/Gradle de un solo módulo:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

En caso de proyectos de Maven/Gradle con varios módulos, repita el procedimiento para cada módulo:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Visualización de los registros de implementación

Revise los registros de compilación de kpack con el siguiente comando:

az spring app show-deploy-log --name <app-name>

Nota

Los registros de kpack solo mostrarán la implementación más reciente (si la implementación se compiló a partir del origen con kpack).

Asignación de un punto de conexión público a una aplicación

Abra el panel de Aplicaciones para ver las aplicaciones para la instancia de servicio.
Seleccione una aplicación para ver la página de información general .
Seleccione Asignar punto de conexión para asignar un punto de conexión público a la aplicación. Este proceso puede tardar unos minutos.
Copie la dirección URL de la página de información general y péguela en el explorador para ver la aplicación en ejecución.

Pasos siguientes

Inicio rápido: supervisión de Azure Spring Apps con registros, métricas y seguimiento

Hay más ejemplos disponibles en GitHub: Ejemplos de Azure Spring Apps.

Compartir a través de