Inicio rápido: Inicio de la primera aplicación de Java en Azure Container Apps

En este artículo se muestra cómo implementar la aplicación de ejemplo Spring PetClinic para que se ejecute en Azure Container Apps. En lugar de crear manualmente un Dockerfile y usar directamente un registro de contenedor, la aplicación Java se puede implementar directamente desde un archivo JAR (Java Archive), o bien desde un archivo WAR (Web Application Archive).

Al final de este tutorial, implementará una aplicación web, que puede administrar desde Azure Portal.

La siguiente imagen es una captura de pantalla del aspecto de la aplicación una vez que se ha implementado en Azure.

Requisitos previos

Requisito	Instructions
Cuenta de Azure	Si no tiene ninguna cuenta, cree una gratuita. Necesita el permiso Colaborador o Propietario en la suscripción de Azure para continuar. Consulte Asignación de roles de Azure mediante Azure Portal para obtener más información.
Cuenta de GitHub	Obtenga una gratis.
git	Instalación de git
Azure CLI	Instale la CLI de Azure.
Extensión de la CLI de Container Apps	Use la versión 0.3.47 o superior. Use el comando az extension add --name containerapp --upgrade --allow-preview para instalar la versión más reciente.
Java	Instale el kit de desarrollo de Java. Use la versión 17 o una posterior.
Maven	Instalar el Maven.

Preparación del proyecto

Clone la aplicación de ejemplo Spring PetClinic en la máquina.

git clone https://github.com/spring-projects/spring-petclinic.git

git clone https://github.com/spring-petclinic/spring-framework-petclinic.git

Compilación del proyecto

Abra la carpeta spring-pet clinic.

cd spring-petclinic

Limpie el área de compilación de Maven, compile el código del proyecto y cree un archivo JAR, todo ello omitiendo cualquier prueba.

mvn clean package -DskipTests

Después de ejecutar el comando de compilación, se genera un archivo denominado petclinic.war en la carpeta /target.

Nota:

Si fuera necesario, especifique la versión de Tomcat en las variables del entorno de compilación Java.

Vaya a la carpeta spring-framework-petclinic.

cd spring-framework-petclinic

Limpie el área de compilación de Maven, compile el código del proyecto y cree un archivo WAR, todo ello omitiendo cualquier prueba.

mvn clean package -DskipTests

Después de ejecutar el comando de compilación, se genera un archivo denominado petclinic.war en la carpeta /target.

Implementación del proyecto

Implemente el paquete JAR en Azure Container Apps.

Nota:

Si fuera necesario, especifique la versión de JDK en las variables del entorno de compilación Java.

Ahora puede implementar el archivo WAR con el comando az containerapp up de la CLI.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --subscription <SUBSCRIPTION_ID>\
  --location <LOCATION> \
  --environment <ENVIRONMENT_NAME> \
  --artifact <JAR_FILE_PATH_AND_NAME> \
  --ingress external \
  --target-port 8080 \
  --query properties.configuration.ingress.fqdn

Nota:

La versión predeterminada de JDK es 17. Si necesita cambiar la versión de JDK por problemas de compatibilidad con la aplicación, puede usar el argumento --build-env-vars BP_JVM_VERSION=<YOUR_JDK_VERSION> para ajustar el número de versión.

Puede encontrar más variables de entorno de compilación aplicables en el artículo Compilación de variables de entorno para Java en Azure Container Apps.

Implemente el paquete WAR en Azure Container Apps.

Ahora puede implementar el archivo WAR con el comando az containerapp up de la CLI.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --subscription <SUBSCRIPTION>\
  --location <LOCATION> \
  --environment <ENVIRONMENT_NAME> \
  --artifact <WAR_FILE_PATH_AND_NAME> \
  --build-env-vars BP_TOMCAT_VERSION=10.* \
  --ingress external \
  --target-port 8080 \
  --query properties.configuration.ingress.fqdn

Nota:

La versión predeterminada es Tomcat 9. Si necesita cambiar la versión de Tomcat por problemas de compatibilidad con la aplicación, puede usar el argumento --build-env-vars BP_TOMCAT_VERSION=<YOUR_TOMCAT_VERSION> para ajustar el número de versión.

En este ejemplo, la versión de Tomcat se establece en 10 (incluidas las versiones secundarias) estableciendo la variable de entorno en BP_TOMCAT_VERSION=10.*.

Puede encontrar más variables de entorno de compilación aplicables en el artículo Compilación de variables de entorno para Java en Azure Container Apps.

Comprobación del estado de la aplicación

En este ejemplo, el comando containerapp up incluye el argumento --query properties.configuration.ingress.fqdn, que devuelve el nombre de dominio completo (FQDN), también conocido como la dirección URL de la aplicación.

Para ver la aplicación, pegue esta dirección URL en un explorador. La aplicación será similar a la que se muestra en la captura de pantalla siguiente.

Pasos siguientes

Variables de entorno de compilación de Java