Inicio rápido: Creación de una aplicación Java en Azure App Service

Azure App Service proporciona un servicio de hospedaje de aplicaciones web altamente escalable y autoparchado. En esta guía de inicio rápido, usará el complemento Maven para Azure App Service Web Apps para implementar una aplicación web de Java en un servidor Tomcat en Linux en Azure App Service.

Si Maven no es su herramienta de desarrollo preferida, consulte artículos similares para desarrolladores de Java:

Prerrequisitos

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
Ejecute los comandos de este inicio rápido mediante Azure Cloud Shell, un shell interactivo que puede usar a través del explorador para trabajar con los servicios de Azure. Para usar Cloud Shell:
1. Seleccione el siguiente botón Iniciar Cloud Shell o vaya a https://shell.azure.com para abrir Cloud Shell en el explorador.
2. Inicie sesión en Azure si es necesario y asegúrese de que está en el entorno de Bash de Cloud Shell.
3. Seleccione Copiar en un bloque de código, pegue el código en Cloud Shell y ejecútelo.

Creación de una aplicación Java

Ejecute el siguiente comando de Maven en Cloud Shell para crear una aplicación denominada helloworld:

mvn archetype:generate "-DgroupId=example.demo" "-DartifactId=helloworld" "-DarchetypeArtifactId=maven-archetype-webapp" "-DarchetypeVersion=1.4" "-Dversion=1.0-SNAPSHOT"

A continuación, cambie el directorio de trabajo a la carpeta del proyecto mediante la ejecución de cd helloworld.

Configuración del complemento maven

El proceso de implementación de App Service usa las credenciales de Azure de Cloud Shell automáticamente. El complemento Maven se autentica mediante OAuth o inicio de sesión del dispositivo. Para obtener más información, consulte Autenticación.

Ejecute el siguiente comando de Maven para configurar la implementación estableciendo el sistema operativo de App Service, la versión de Java y la versión de Tomcat.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

En Crear nueva configuración de ejecución, escriba Y y presione Entrar.
En Definir valor para sistema operativo, escriba 2 para Linux y presione Entrar.
En Definir valor para javaVersion, escriba 1 para Java 21 y presione Entrar.
En Definir valor para webContainer, escriba 1 para Tomcat 10.1 y presione Entrar.
En Definir valor para pricingTier, escriba 3 para P1V2 y presione Entrar.
En Confirmar, escriba Y y presione Entrar.

La salida debe tener un aspecto similar al código siguiente:

Please confirm webapp properties
AppName : helloworld-1745408005556
ResourceGroup : helloworld-1745408005556-rg
Region : centralus
PricingTier : P1V2
OS : Linux
Java Version: Java 21
Web server stack: Tomcat 10.1
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:34:44Z
[INFO] ------------------------------------------------------------------------

Después de confirmar las opciones, el complemento agrega el elemento de complemento y la configuración necesaria al archivo pom.xml del proyecto, que configura la aplicación web para que se ejecute en App Service.

La parte pertinente del archivo pom.xml debe ser similar al ejemplo siguiente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>helloworld-1745408005556-rg</resourceGroup>
                <appName>helloworld-1745408005556</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Los valores de <appName> y <resourceGroup>helloworld-1745408005556 y helloworld-1745408005556-rg para la aplicación de demostración se usan más adelante.

Puede modificar las configuraciones de App Service directamente en el archivo pom.xml .

Para obtener la lista completa de configuraciones, consulte Configuraciones comunes.
Para conocer las configuraciones específicas de App Service, consulte Aplicación web de Azure: Detalles de configuración.

Implementación de la aplicación

Con toda la configuración lista en el archivo pom.xml , puede implementar la aplicación Java en Azure con el siguiente comando único.

mvn package azure-webapp:deploy

Una vez que haya seleccionado una lista de suscripciones disponibles, Maven se implementa en Azure App Service. Cuando se completa la implementación, la aplicación está lista.

Para esta demostración, la dirección URL es http://helloworld-1745408005556.azurewebsites.net. Al abrir la dirección URL con el explorador web local, debería ver la siguiente aplicación:

Recorte de pantalla de la aplicación web Hello World de Maven que se ejecuta en Azure App Service.

Felicidades. Ha implementado una aplicación de Java en App Service.

Limpieza de recursos

Ha creado los recursos de este tutorial en un grupo de recursos de Azure. Si ya no los necesita, puede eliminar el grupo de recursos y todos sus recursos ejecutando el siguiente comando de la CLI de Azure en Cloud Shell.

az group delete --name helloworld-1745408005556-rg --yes

El comando puede tardar un tiempo en ejecutarse.

Azure App Service proporciona un servicio de hospedaje de aplicaciones web altamente escalable y autoparchado. En este inicio rápido, usará el complemento Maven para Azure App Service Web Apps para implementar una aplicación web de Java con un servidor de Spring Boot, Quarkus o Tomcat insertado en App Service. Para más información, consulte azure-webapp-maven-plugin.

Si Maven no es su herramienta de desarrollo preferida, consulte artículos similares para desarrolladores de Java:

Prerrequisitos

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
Ejecute los comandos de este inicio rápido mediante Azure Cloud Shell, un shell interactivo que puede usar a través del explorador para trabajar con los servicios de Azure. Para usar Cloud Shell:
1. Seleccione el siguiente botón Iniciar Cloud Shell o vaya a https://shell.azure.com para abrir Cloud Shell en el explorador.
2. Inicie sesión en Azure si es necesario y asegúrese de que está en el entorno de Bash de Cloud Shell.
3. Seleccione Copiar en un bloque de código, pegue el código en Cloud Shell y ejecútelo.

Descarga la aplicación de ejemplo

Elija la pestaña adecuada y siga las instrucciones para obtener la aplicación web Spring Boot, Quarkus o Embedded Tomcat de ejemplo.

Descargue y extraiga la plantilla de aplicación web de Spring Boot predeterminada o clonela mediante la ejecución del comando siguiente. Al ejecutar el comando de la spring boot new my-webapp también se clona la aplicación web.

git clone https://github.com/rd-1-2022/rest-service my-webapp

A continuación, cambie el directorio de trabajo a la carpeta del proyecto mediante la ejecución de cd my-webapp.

Genere una nueva aplicación de Quarkus denominada quarkus-hello-azure mediante la ejecución del siguiente comando de Maven:

mvn io.quarkus.platform:quarkus-maven-plugin:3.21.3:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=quarkus-hello-azure  \
    -Dextensions='resteasy-reactive'

Cambie el directorio de trabajo a la carpeta del proyecto ejecutando cd quarkus-hello-azure.

Descargue y extraiga el repositorio embeddedTomcatExample o clonelo localmente mediante la ejecución del comando siguiente git clone .
```
git clone https://github.com/Azure-Samples/java-docs-embedded-tomcat
```
Cambie el directorio de trabajo a la carpeta del proyecto ejecutando cd java-docs-embedded-tomcat.
Ejecute la aplicación mediante la clase Tomcat estándar. Consulte Main.java en el ejemplo.

Configuración del complemento maven

El proceso de implementación de App Service usa las credenciales de Azure de Cloud Shell automáticamente. El complemento Maven se autentica mediante OAuth o inicio de sesión del dispositivo. Para obtener más información, consulte Autenticación.

Ejecute el siguiente comando de Maven para configurar la implementación estableciendo el sistema operativo de App Service y la versión de Java.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

En Crear nueva configuración de ejecución, escriba Y y presione Entrar.
En Definir valor para sistema operativo, escriba 2 para Linux y presione Entrar.
En Definir valor para javaVersion, escriba 1 para Java 21 y presione Entrar.
En Definir valor para pricingTier, escriba 3 para P1v2 y presione Entrar.
En Confirmar, escriba Y y presione Entrar.

La salida debe tener un aspecto similar al código siguiente:

Please confirm webapp properties
AppName : <generated-app-name>
ResourceGroup : <generated-app-name>-rg
Region : centralus
PricingTier : P1v2
OS : Linux
Java Version: Java 21
Web server stack: Java SE
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  47.533 s
[INFO] Finished at: 2025-04-23T12:20:08Z
[INFO] ------------------------------------------------------------------------

Después de confirmar las opciones, el complemento agrega el elemento de complemento y la configuración necesaria al archivo pom.xml del proyecto, que configura la aplicación web para que se ejecute en App Service.

La parte pertinente del archivo pom.xml debe ser similar al ejemplo siguiente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>generated-app-name-rg</resourceGroup>
                <appName>generated-app-name</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Los valores de <appName> y <resourceGroup> se usan más adelante.

Puede modificar las configuraciones de App Service directamente en el archivo pom.xml .

Para obtener la lista completa de configuraciones, consulte Configuraciones comunes.
Para conocer las configuraciones específicas de App Service, consulte Aplicación web de Azure: Detalles de configuración.

Implementación de la aplicación

Con toda la configuración lista en el archivo pom.xml , puede implementar la aplicación Java en Azure.

Compile el archivo JAR con el comando siguiente.
```
 mvn clean package
```
Sugerencia

Spring Boot genera dos archivos JAR con mvn package, pero azure-webapp-maven-plugin elige el archivo JAR adecuado para implementarse automáticamente.

Implemente la aplicación en Azure mediante el comando siguiente:

mvn azure-webapp:deploy

Una vez que haya seleccionado una lista de suscripciones disponibles, Maven se implementa en Azure App Service. Una vez completada la implementación, la aplicación está lista y verá la siguiente salida:

[INFO] Successfully deployed the artifact to <URL>
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2023-07-26T12:47:50Z
[INFO] ------------------------------------------------------------------------

Abra el dominio predeterminado de la aplicación desde la página Información general de Azure Portal y anexe /greeting a la dirección URL. Debería ver la siguiente aplicación:

Compile el archivo JAR con el comando siguiente.
```
echo '%prod.quarkus.http.port=${PORT}' >> src/main/resources/application.properties
mvn clean package -Dquarkus.package.jar.type=uber-jar
```
Establezca el puerto de Quarkus en el archivo application.properties en la PORT variable de entorno en el contenedor de Java de Linux. Dquarkus.package.jar.type=uber-jar indica a Maven que genere un Uber-Jar, que incluya todas las dependencias del archivo JAR.

Sugerencia

Quarkus genera dos archivos JAR con mvn package, pero azure-webapp-maven-plugin elige el archivo JAR adecuado para implementarse automáticamente.

Implemente la aplicación en Azure mediante el comando siguiente:

mvn azure-webapp:deploy

Una vez que haya seleccionado una lista de suscripciones disponibles, Maven se implementa en Azure App Service. Una vez completada la implementación, la aplicación está lista y verá la siguiente salida:

[INFO] Successfully deployed the artifact to <URL>
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2023-07-26T12:47:50Z
[INFO] ------------------------------------------------------------------------

Abra el dominio predeterminado de la aplicación en Información general en Azure Portal y anexe /hello a la dirección URL. Debería ver la siguiente aplicación:

Compile el archivo JAR con el comando siguiente.
```
mvn clean package
```
Para que la aplicación se implemente mediante azure-webapp-maven-plugin y se ejecute en Azure App Service, el ejemplo configura el objetivo de la package siguiente manera:
- Compila un único archivo JAR de Uber, que contiene todo lo que la aplicación necesita para ejecutarse.
- Crea un archivo JAR ejecutable especificando la clase Tomcat como clase de inicio.
- Reemplaza el artefacto original por Uber-Jar para asegurarse de que el paso de implementación implementa el archivo correcto.

Implemente la aplicación en Azure mediante el comando siguiente:

mvn azure-webapp:deploy

Una vez que haya seleccionado una lista de suscripciones disponibles, Maven se implementa en Azure App Service. Una vez completada la implementación, la aplicación está lista y verá la siguiente salida:

[INFO] Successfully deployed the artifact to <URL>
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:20 min
[INFO] Finished at: 2023-07-26T12:47:50Z
[INFO] ------------------------------------------------------------------------

Abra la dirección URL del dominio predeterminado de la aplicación en Información general en Azure Portal. Debería ver la siguiente aplicación:

Felicidades. Ha implementado una aplicación de Java en App Service.

Limpieza de recursos

Ha creado los recursos de este tutorial en un grupo de recursos de Azure. Si ya no los necesita, puede eliminar el grupo de recursos y todos sus recursos ejecutando el siguiente comando de la CLI de Azure en Cloud Shell.

az group delete --name <resource group name>  --yes

Por ejemplo, ejecute az group delete --name quarkus-hello-azure-1690375364238-rg --yes. Este comando puede tardar un tiempo en ejecutarse.

Azure App Service proporciona un servicio de hospedaje de aplicaciones web altamente escalable y autoparchado. En este inicio rápido, usará el complemento Maven para Azure App Service Web Apps para implementar una aplicación web de Java en un servidor JBoss EAP linux en Azure App Service.

Nota:

JBoss EAP en App Service ahora admite la facturación "Bring Your Own License" (BYOL), lo que permite a los clientes con suscripciones existentes de Red Hat aplicar esas licencias directamente a sus implementaciones de JBoss EAP en Azure App Service. Más información.

Si Maven no es su herramienta de desarrollo preferida, consulte artículos similares para desarrolladores de Java:

Prerrequisitos

Si no tiene una cuenta de Azure, cree una cuenta gratuita antes de comenzar.
Ejecute los comandos de este inicio rápido mediante Azure Cloud Shell, un shell interactivo que puede usar a través del explorador para trabajar con los servicios de Azure. Para usar Cloud Shell:
1. Seleccione el siguiente botón Iniciar Cloud Shell o vaya a https://shell.azure.com para abrir Cloud Shell en el explorador.
2. Inicie sesión en Azure si es necesario y asegúrese de que está en el entorno de Bash de Cloud Shell.
3. Seleccione Copiar en un bloque de código, pegue el código en Cloud Shell y ejecútelo.

Creación de una aplicación Java

Clone la aplicación de demostración Pet Store (Tienda para mascotas).

git clone https://github.com/Azure-Samples/app-service-java-quickstart

Cambie de directorio al del proyecto petstore-ee7 y compílelo.
```
cd app-service-java-quickstart
git checkout 20230308
cd petstore-ee7
mvn clean install
```
Si ve un mensaje sobre estar en estado HEAD desasociado, omita este mensaje. No realiza ninguna confirmación de Git en este inicio rápido, por lo que el estado HEAD desasociado es adecuado.

Sugerencia

El petstore-ee7 ejemplo requiere Java 11 o posterior. El booty-duke-app-service proyecto de ejemplo requiere Java 17. Si la versión instalada de Java es inferior a 17, ejecute la compilación desde el directorio petstore-ee7 en lugar de en el nivel superior.

Configuración del complemento maven

El proceso de implementación de App Service usa las credenciales de Azure de Cloud Shell automáticamente. El complemento Maven se autentica mediante OAuth o inicio de sesión del dispositivo. Para obtener más información, consulte Autenticación.

Ejecute el siguiente comando de Maven para configurar la implementación estableciendo el sistema operativo de App Service, la versión de Java y la versión de Jbosseap.

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.14.1:config

En Crear nueva configuración de ejecución, escriba Y y presione Entrar.
En Definir valor para sistema operativo, escriba 2 para Linux y presione Entrar.
En Definir valor para javaVersion, escriba 2 para Java 17 y presione Entrar. Si selecciona Java 21, no verá Jbosseap como opción más adelante.
En Definir valor para webContainer, escriba 4 para Jbosseap 7 y presione Entrar.
En Definir valor para pricingTier, escriba 1 para P1v3 y presione Entrar.
En Confirmar, escriba Y y presione Entrar.

La salida debe tener un aspecto similar al código siguiente:

Please confirm webapp properties
AppName : petstoreee7-1745409173307
ResourceGroup : petstoreee7-1745409173307-rg
Region : centralus
PricingTier : P1v3
OS : Linux
Java Version: Java 17
Web server stack: Jbosseap 4
Deploy to slot : false
Confirm (Y/N) [Y]: 
[INFO] Saving configuration to pom.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:36 min
[INFO] Finished at: 2025-04-23T11:54:22Z
[INFO] ------------------------------------------------------------------------

Después de confirmar las opciones, el complemento agrega el elemento de complemento y la configuración necesaria al archivo pom.xml del proyecto, que configura la aplicación web para que se ejecute en App Service.

La parte pertinente del archivo pom.xml debe ser similar al ejemplo siguiente.

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>>azure-webapp-maven-plugin</artifactId>
            <version>x.xx.x</version>
            <configuration>
                <schemaVersion>v2</schemaVersion>
                <resourceGroup>petstoreee7-1745409173307-rg</resourceGroup>
                <appName>petstoreee7-1745409173307</appName>
            ...
            </configuration>
        </plugin>
    </plugins>
</build>

Los valores de <appName> y <resourceGroup>, petstoreee7-1745409173307 y petstoreee7-1745409173307-rg en la aplicación de demostración, se usan más adelante.

Puede modificar las configuraciones de App Service directamente en el archivo pom.xml .

Para obtener la lista completa de configuraciones, consulte Configuraciones comunes.
Para conocer las configuraciones específicas de App Service, consulte Aplicación web de Azure: Detalles de configuración.

Implementación de la aplicación

Con toda la configuración lista en el archivo pom.xml , puede implementar la aplicación Java en Azure con el siguiente comando único.

# Disable testing, as it requires Wildfly to be installed locally.
mvn package azure-webapp:deploy -DskipTests

Una vez que haya seleccionado una lista de suscripciones disponibles, Maven se implementa en Azure App Service. Cuando se completa la implementación, la aplicación está lista.

Para esta aplicación de demostración, la dirección URL es http://petstoreee7-1745409173307.azurewebsites.net. Al abrir la dirección URL con el explorador web local, debería ver la siguiente aplicación:

Recorte de pantalla de la aplicación web Hello World de Maven que se ejecuta en Azure App Service.

Felicidades. Ha implementado una aplicación de Java en App Service.

Limpieza de recursos

Ha creado los recursos de este tutorial en un grupo de recursos de Azure. Si ya no los necesita, puede eliminar el grupo de recursos y todos sus recursos ejecutando el siguiente comando de la CLI de Azure en Cloud Shell.

az group delete --name petstoreee7-1745409173307-rg  --yes

El comando puede tardar un tiempo en ejecutarse.

Compartir vía

Prerrequisitos

Creación de una aplicación Java

Configuración del complemento maven

Implementación de la aplicación

Limpieza de recursos

Prerrequisitos

Descarga la aplicación de ejemplo

Configuración del complemento maven

Implementación de la aplicación

Limpieza de recursos

Prerrequisitos

Creación de una aplicación Java

Configuración del complemento maven

Implementación de la aplicación

Limpieza de recursos

Contenido relacionado

Comentarios

Recursos adicionales