Inicio rápido: Creación de una aplicación de Java en Azure App Service
Azure App Service proporciona un servicio de hospedaje de aplicaciones web muy escalable y con aplicación de revisiones de un modo automático. Interfaz de la línea de comandos de AzureEn este inicio rápido se muestra cómo usar la CLI de Azure con el complemento Aplicación web de Azure para Maven para implementar un archivo .jar, .war o un archivo .ear. Use las pestañas para cambiar entre las instrucciones de Java SE, Tomcat y JBoss EAP.
Si Maven no es su herramienta de desarrollo preferida, consulte nuestros tutoriales análogos para desarrolladores de Java:
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
1: Uso de Azure Cloud Shell
En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.
Para iniciar Azure Cloud Shell:
| Opción | Ejemplo o vínculo |
|---|---|
| Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Solo con seleccionar Pruébelo no se copia automáticamente el código o comando en Cloud Shell. |  |
| Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. |  |
| Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. |  |
Para usar Azure Cloud Shell:
Inicie Cloud Shell.
Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.
Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.
Seleccione Enter para ejecutar el código o comando.
2. Creación de una aplicación Java
Clone el proyecto de ejemplo y consulte el código fuente que se ejecuta con esta versión del artículo.
git clone https://github.com/Azure-Samples/app-service-java-quickstart
Cambie el directorio al proyecto completado y compile desde el nivel superior. A continuación cd al subdirectorio para booty duke.
cd app-service-java-quickstart
git checkout 20230308
mvn clean install
cd booty-duke-app-service
3. Configuración del complemento Maven
Sugerencia
El complemento Maven admite Java 17 y Tomcat 10.0. Para obtener más información sobre la compatibilidad más reciente, consulte Java 17 y Tomcat 10.0 están disponibles en Azure App Service.
El proceso de implementación en Azure App Service usa sus credenciales de Azure desde la CLI de Azure automáticamente. El complemento Maven se autentica con OAuth o el inicio de sesión del dispositivo si la CLI de Azure no está instalada localmente. Para más información, consulte Autenticación con los complementos de Maven.
Ejecute el siguiente comando de Maven para configurar la implementación. Este comando le ayuda a configurar 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.9.0:config
Si se le solicita Crear nueva configuración de ejecución, seleccione Y.
Cuando se le solicite la opción Suscripción, escribe el número impreso al principio de la línea para seleccionar el valor de
Subscriptionadecuado.Cuando se le solicite la opción Aplicación web, presione Entrar para seleccionar la opción predeterminada,
<create>.Cuando se le solicite la opción SO, presione Entrar para seleccionar Linux.
Cuando se le solicite la opción javaVersion, seleccione Java 17.
Cuando se le solicite la opción Plan de tarifa, seleccione P1v2.
Por último, presione Entrar en la última solicitud para confirmar las selecciones.
Please confirm webapp properties AppName : booty-duke-1678285507374 ResourceGroup : booty-duke-1678285507374-rg Region : centralus PricingTier : P1v2 OS : Linux Java Version: Java 17 Web server stack: Java SE Deploy to slot : false Confirm (Y/N) [Y]: Y [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:03 min [INFO] Finished at: 2023-03-08T15:25:47+01:00 [INFO] ------------------------------------------------------------------------
Las configuraciones de App Service se pueden modificar directamente en el archivo pom.xml. A continuación se enumeran algunas configuraciones habituales:
| Propiedad | Obligatorio | Descripción | Versión |
|---|---|---|---|
<schemaVersion> |
false | Especifique la versión del esquema de configuración. Los valores admitidos son: v1, v2. |
1.5.2 |
<subscriptionId> |
false | Especifique el identificador de suscripción. | 0.1.0+ |
<resourceGroup> |
true | Grupo de recursos de Azure para la aplicación web. | 0.1.0+ |
<appName> |
true | El nombre de la aplicación web. | 0.1.0+ |
<region> |
false | Especifica la región para hospedar la aplicación web; el valor predeterminado es centralus. Todas las regiones válidas en la sección Regiones admitidas. | 0.1.0+ |
<pricingTier> |
false | El plan de tarifa de la aplicación web. El valor predeterminado es P1V2 para cargas de trabajo de producción, mientras que B2 es el mínimo recomendado para desarrollo y pruebas de Java. Para más información, consulte Precios de App Service | 0.1.0+ |
<runtime> |
false | Configuración del entorno en runtime. Para obtener más información, consulte Detalles de configuración. | 0.1.0+ |
<deployment> |
false | Configuración de implementación. Para obtener más información, consulte Detalles de configuración. | 0.1.0+ |
Para obtener la lista completa de configuraciones, consulte la documentación de referencia del complemento. Todos los complementos de Azure Maven comparten un conjunto común de configuraciones. Para ver estas configuraciones, consulte Configuraciones comunes. Para conocer las configuraciones específicas de App Service, consulte Aplicación web de Azure: Detalles de configuración.
Tenga cuidado con los valores de <appName> y <resourceGroup> (helloworld-1590394316693 y helloworld-1590394316693-rg en la demostración), ya que se usarán más adelante.
4. Implementación de la aplicación
Con toda la configuración lista en el archivo pom, puede implementar la aplicación de Java en Azure con un solo comando.
Una vez finalizada la implementación, la aplicación está lista en http://<appName>.azurewebsites.net/ (http://helloworld-1590394316693.azurewebsites.net en la demostración). Abra la dirección URL con un explorador web local; debería ver
¡Enhorabuena! Ha implementado su primera aplicación Java en App Service.
5 - Limpieza de los recursos
En los pasos anteriores, creó recursos de Azure en un grupo de recursos. Si no va a necesitar estos recursos en el futuro, elimine el grupo de recursos del portal, para lo que debe ejecutar el siguiente comando en Cloud Shell:
az group delete --name <your resource group name; for example: helloworld-1558400876966-rg> --yes
Este comando puede tardar varios segundos en ejecutarse.
Azure App Service proporciona un servicio de hospedaje de aplicaciones web muy escalable y con aplicación de revisiones de un modo automático. En este inicio rápido se muestra cómo usar la CLI de Azure con el complemento Aplicación web de Azure para Maven para implementar un archivo .jar o un archivo .war. Use las pestañas para cambiar entre las instrucciones para Java SE y Tomcat.
Si Maven no es su herramienta de desarrollo preferida, consulte nuestros tutoriales análogos para desarrolladores de Java:
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
1: Uso de Azure Cloud Shell
En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.
Para iniciar Azure Cloud Shell:
| Opción | Ejemplo o vínculo |
|---|---|
| Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Solo con seleccionar Pruébelo no se copia automáticamente el código o comando en Cloud Shell. | |
| Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. | |
| Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. | |
Para usar Azure Cloud Shell:
Inicie Cloud Shell.
Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.
Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.
Seleccione Enter para ejecutar el código o comando.
2. Creación de una aplicación Java
Clone el proyecto de ejemplo Primeros pasos de Spring Boot.
git clone https://github.com/spring-guides/gs-spring-boot
Cambie de directorio al del proyecto completado.
cd gs-spring-boot/complete
3. Configuración del complemento Maven
Sugerencia
El complemento Maven admite Java 17 y Tomcat 10.0. Para obtener más información sobre la compatibilidad más reciente, consulte Java 17 y Tomcat 10.0 están disponibles en Azure App Service.
El proceso de implementación en Azure App Service utilizará sus credenciales de Azure desde la CLI de Azure automáticamente. El complemento Maven se autenticará con OAuth o el inicio de sesión del dispositivo si la CLI de Azure no está instalada localmente. Para más información, consulte Autenticación con los complementos de Maven.
Ejecute el siguiente comando de Maven para configurar la implementación. Este comando le ayudará a configurar 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.5.0:config
Si se le solicita la opción Suscripción, escriba el número impreso en el comienzo de línea para seleccionar el valor de
Subscriptionadecuado.Cuando se le solicite la opción Aplicación web, presione Entrar para seleccionar la opción predeterminada,
<create>.Cuando se le solicite la opción SO, especifique
1para seleccionar Windows.Cuando se le solicite la opción javaVersion para seleccionar Java 11 escriba
2.Cuando se le solicite la opción Plan de tarifa, especifique
10para seleccionar P1v2.Por último, presione Entrar en la última solicitud para confirmar las selecciones.
La salida del resumen tendrá un aspecto similar al fragmento de código que se muestra a continuación.
Please confirm webapp properties Subscription Id : ********-****-****-****-************ AppName : spring-boot-1599007390755 ResourceGroup : spring-boot-1599007390755-rg Region : centralus PricingTier : P1v2 OS : Windows Java : Java 11 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: 41.118 s [INFO] Finished at: 2020-09-01T17:43:45-07:00 [INFO] ------------------------------------------------------------------------
Las configuraciones de App Service se pueden modificar directamente en el archivo pom.xml. A continuación se enumeran algunas configuraciones habituales:
| Propiedad | Obligatorio | Descripción | Versión |
|---|---|---|---|
<schemaVersion> |
false | Especifique la versión del esquema de configuración. Los valores admitidos son: v1, v2. |
1.5.2 |
<subscriptionId> |
false | Especifique el identificador de suscripción. | 0.1.0+ |
<resourceGroup> |
true | Grupo de recursos de Azure para la aplicación web. | 0.1.0+ |
<appName> |
true | El nombre de la aplicación web. | 0.1.0+ |
<region> |
false | Especifica la región donde se hospedará la aplicación web; el valor predeterminado es centralus. Todas las regiones válidas en la sección Regiones admitidas. | 0.1.0+ |
<pricingTier> |
false | El plan de tarifa de la aplicación web. El valor predeterminado es P1V2 para cargas de trabajo de producción, mientras que B2 es el mínimo recomendado para desarrollo y pruebas de Java. Para más información, consulte Precios de App Service | 0.1.0+ |
<runtime> |
false | Configuración del entorno en runtime. Para obtener más información, consulte Detalles de configuración. | 0.1.0+ |
<deployment> |
false | Configuración de implementación. Para obtener más información, consulte Detalles de configuración. | 0.1.0+ |
Tenga cuidado con los valores de <appName> y <resourceGroup> (helloworld-1590394316693 y helloworld-1590394316693-rg en la demostración), ya que se usarán más adelante.
4. Implementación de la aplicación
Con toda la configuración lista en el archivo pom, puede implementar la aplicación de Java en Azure con un solo comando.
Una vez finalizada la implementación, la aplicación estará lista en http://<appName>.azurewebsites.net/ (http://helloworld-1590394316693.azurewebsites.net en la demostración). Abra la dirección URL con un explorador web local; debería ver
¡Enhorabuena! Ha implementado su primera aplicación Java en App Service.
5 - Limpieza de los recursos
En los pasos anteriores, creó recursos de Azure en un grupo de recursos. Si no va a necesitar estos recursos en el futuro, elimine el grupo de recursos del portal, para lo que debe ejecutar el siguiente comando en Cloud Shell:
az group delete --name <your resource group name; for example: helloworld-1558400876966-rg> --yes
Este comando puede tardar varios segundos en ejecutarse.
Azure App Service proporciona un servicio de hospedaje de aplicaciones web muy escalable y con aplicación de revisiones de un modo automático. En este tutorial de inicio rápido se muestra cómo implementar una aplicación de Java SE en Azure App Service en Linux mediante Azure Portal. Para seguir un inicio rápido de implementación en Tomcat o JBoss EAP, seleccione una de las opciones de Maven anteriores.
En este inicio rápido se configura una aplicación de App Service en el nivel Gratis y no supone ningún costo para la suscripción de Azure.
En este inicio rápido se muestra cómo realizar estos cambios en el explorador, sin tener que instalar las herramientas del entorno de desarrollo en la máquina.
Estos pasos se pueden realizar en este caso con una máquina Mac, Windows o Linux. Una vez instalados los requisitos previos, tardará aproximadamente cinco minutos en completar los pasos.
Para completar este inicio rápido, necesita lo siguiente:
- Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
- Una cuenta de GitHub para bifurcar un repositorio.
1. Bifurcación del repositorio de ejemplo
En el explorador, vaya al repositorio que contiene el código de ejemplo.
En la esquina superior derecha, seleccione Bifurcar.
En la pantalla Crear una nueva bifurcación, confirme los campos Propietario y Nombre del repositorio. Seleccione Crear bifurcación.
Nota
Esto le llevará a la nueva bifurcación. La dirección URL de la bifurcación se parecerá a esta:
https://github.com/YOUR_GITHUB_ACCOUNT_NAME/java-docs-spring-hello-world
2- Creación de recursos de Azure y configuración de la implementación
Inicie sesión en el Portal de Azure.
Escriba app services en la búsqueda. En Servicios, seleccione App Services.
En la página App Services, seleccione Crear.
Rellene la página Crear aplicación web tal como se indica a continuación.
- Grupo de recursos: cree un grupo de recursos llamado myResourceGroup.
- Nombre: escriba un nombre único global para la aplicación web.
- Publicar: seleccione Código.
- Pila en tiempo de ejecución: seleccione Java 11.
- Pila de servidores web de Java: seleccione Java SE (Servidor web insertado).
- Sistema operativo: seleccione Linux.
- Región: seleccione una región de Azure cercana.
- Plan de App Service: cree un plan de App Service llamado myAppServicePlan.
Para cambiar al nivel de servicio de App Service, junto a SKU y tamaño, seleccione Cambiar tamaño.
En Selector de especificaciones, en la pestaña Producción, seleccione P1V3. Seleccione el botón Aplicar en la parte inferior de la página.
Seleccione el botón Revisar y crear de la parte inferior de la página.
Después de que se ejecute la validación, seleccione el botón Crear en la parte inferior de la página. Se crearán un grupo de recursos de Azure, un plan de App Service y un servicio de aplicaciones.
Una vez creados los recursos de Azure, seleccione Ir al recurso.
En el panel de navegación izquierdo, seleccione Centro de implementación.
En Configuración, seleccione un Origen. En este inicio rápido, seleccione GitHub.
En la sección bajo GitHub, seleccione los valores siguientes:
- Organización: seleccione su organización.
- Repositorio: seleccione java-docs-spring-hello-world.
- Rama: seleccione main.
Seleccione Guardar.
Sugerencia
En este inicio rápido se usa GitHub. Entre los orígenes de implementación continua adicionales se incluyen Bitbucket, Git local, Azure Repos y Git externo. FTPS también es un método de implementación compatible.
Una vez que se guarda la integración de GitHub, seleccione Overview>URL.
El código de ejemplo de Java SE se ejecuta en una aplicación web de Linux de Azure App Service.
Felicidades. Ha implementado su primera aplicación Java en App Service mediante Azure Portal.
3 - Actualización de la bifurcación en GitHub e implementación de los cambios
Vaya a la bifurcación de GitHub de java-docs-spring-hello-world.
En la página del repositorio, presione
.para iniciar Visual Studio Code dentro del explorador.Nota
La dirección URL cambiará de GitHub.com a GitHub.dev. Esta característica solo funciona con repositorios que tienen archivos. No funciona en repositorios vacíos.
Vaya a src/main/java/com/example/demo/DemoApplication.java.
Edite index.php para que muestre "Hello Azure" en lugar de "Hello World"
@RequestMapping("/") String sayHello() { return "Hello Azure!"; }En el panel Control de código fuente, seleccione el botón Almacenar cambios provisionalmente para almacenar provisionalmente el cambio.
Escriba un mensaje de confirmación como
Hello Azure. A continuación, seleccione Confirmar e insertar.
Una vez que la implementación haya finalizado, vuelva a la ventana del explorador que abrió en el paso Navegación hasta la aplicación y actualice la página.
4 - Administración de la nueva aplicación de Azure
Vaya a Azure Portal para administrar la aplicación web que ha creado. Busque y seleccione App Services.
Seleccione el nombre de la aplicación de Azure.
Se mostrará la página de información general de la aplicación web. En ella, puede realizar tareas de administración básicas como examinar, detener, reiniciar y eliminar.
En el menú de la aplicación web se proporcionan distintas opciones para configurar la aplicación.
5 - Limpieza de los recursos
Cuanda haya terminado con la aplicación de muestra, puede quitar todos los recursos de la aplicación de Azure. No incurrirá en cargos adicionales y mantendrá la suscripción de Azure sin riesgo alguno. Al quitar el grupo de recursos también se quitan todos los recursos que haya dentro; es la manera más rápida de quitar todos los recursos de Azure de la aplicación.
En la página Información general de App Service, seleccione el grupo de recursos que creó anteriormente.
En la página del grupo de recursos, seleccione Eliminar grupo de recursos. Confirme el nombre del grupo de recursos para terminar de eliminar los recursos.
Azure App Service proporciona un servicio de hospedaje de aplicaciones web muy escalable y con aplicación de revisiones de un modo automático. En este tutorial de inicio rápido se muestra cómo implementar una aplicación de Java SE en Azure App Service en Windows mediante Azure Portal. Para seguir un inicio rápido de implementación en Tomcat o JBoss EAP, seleccione una de las opciones de Maven anteriores.
En este inicio rápido se configura una aplicación de App Service en el nivel Gratis y no supone ningún costo para la suscripción de Azure.
En este inicio rápido se muestra cómo realizar estos cambios en el explorador, sin tener que instalar las herramientas del entorno de desarrollo en la máquina.
Estos pasos se pueden realizar en este caso con una máquina Mac, Windows o Linux. Una vez instalados los requisitos previos, tardará aproximadamente cinco minutos en completar los pasos.
Para completar este inicio rápido, necesita lo siguiente:
- Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
- Una cuenta de GitHub para bifurcar un repositorio.
1. Bifurcación del repositorio de ejemplo
En el explorador, vaya al repositorio que contiene el código de ejemplo.
En la esquina superior derecha, seleccione Bifurcar.
En la pantalla Crear una nueva bifurcación, confirme los campos Propietario y Nombre del repositorio. Seleccione Crear bifurcación.
Nota
Esto le llevará a la nueva bifurcación. La dirección URL de la bifurcación se parecerá a esta:
https://github.com/YOUR_GITHUB_ACCOUNT_NAME/java-docs-spring-hello-world
2. Implementación en Azure
Inicie sesión en el Portal de Azure.
Escriba app services en la búsqueda. En Servicios, seleccione App Services.
En la página App Services, seleccione Crear.
Rellene la página Crear aplicación web tal como se indica a continuación.
- Grupo de recursos: cree un grupo de recursos llamado myResourceGroup.
- Nombre: escriba un nombre único global para la aplicación web.
- Publicar: seleccione Código.
- Pila en tiempo de ejecución: seleccione Java 11.
- Pila de servidores web de Java: seleccione Java SE (Servidor web insertado).
- Sistema operativo: seleccione Windows.
- Región: seleccione una región de Azure cercana.
- Plan de App Service: cree un plan de App Service llamado myAppServicePlan.
Para cambiar al nivel de servicio de App Service, junto a SKU y tamaño, seleccione Cambiar tamaño.
En Selector de especificaciones, en la pestaña Producción, seleccione P1V3. Seleccione el botón Aplicar en la parte inferior de la página.
Seleccione la sección Deployment. En GitHub Actions settings, en Continuous deployment, seleccione Enable.
En la sección bajo GitHub Actions details, seleccione los valores siguientes:
- Cuenta de GitHub: inicie sesión en su cuenta de GitHub.
- Organización: seleccione su organización.
- Repositorio: seleccione java-docs-spring-hello-world.
- Rama: seleccione main.
Seleccione el botón Revisar y crear de la parte inferior de la página.
Después de que se ejecute la validación, seleccione el botón Crear en la parte inferior de la página. Se crearán un grupo de recursos de Azure, un plan de App Service y un servicio de aplicaciones.
Cuando se creen los recursos, seleccione Go to resource. En la página de App Service creada, seleccione Overview>URL.
El código de ejemplo de Java SE se ejecuta en una aplicación web de Linux de Azure App Service.
Felicidades. Ha implementado su primera aplicación Java en App Service mediante Azure Portal.
3. Actualización en GitHub y reimplementación del código
Vaya a la bifurcación de GitHub de java-docs-spring-hello-world.
En la página del repositorio, presione
.para iniciar Visual Studio Code dentro del explorador.Nota
La dirección URL cambiará de GitHub.com a GitHub.dev. Esta característica solo funciona con repositorios que tienen archivos. No funciona en repositorios vacíos.
Vaya a src/main/java/com/example/demo/DemoApplication.java.
Edite index.php para que muestre "Hello Azure" en lugar de "Hello World"
@RequestMapping("/") String sayHello() { return "Hello Azure!"; }En el panel Control de código fuente, seleccione el botón Almacenar cambios provisionalmente para almacenar provisionalmente el cambio.
Escriba un mensaje de confirmación como
Hello Azure. A continuación, seleccione Confirmar e insertar.Una vez que la implementación haya finalizado, vuelva a la ventana del explorador que abrió en el paso Navegación hasta la aplicación y actualice la página.
4 - Administración de la nueva aplicación de Azure
Vaya a Azure Portal para administrar la aplicación web que ha creado. Busque y seleccione App Services.
Seleccione el nombre de la aplicación de Azure.
Se mostrará la página de información general de la aplicación web. En ella, puede realizar tareas de administración básicas como examinar, detener, reiniciar y eliminar.
En el menú de la aplicación web se proporcionan distintas opciones para configurar la aplicación.
5 - Limpieza de los recursos
Cuanda haya terminado con la aplicación de muestra, puede quitar todos los recursos de la aplicación de Azure. No incurrirá en cargos adicionales y mantendrá la suscripción de Azure sin riesgo alguno. Al quitar el grupo de recursos también se quitan todos los recursos que haya dentro; es la manera más rápida de quitar todos los recursos de Azure de la aplicación.
En la página Información general de App Service, seleccione el grupo de recursos que creó anteriormente.
En la página del grupo de recursos, seleccione Eliminar grupo de recursos. Confirme el nombre del grupo de recursos para terminar de eliminar los recursos.