Implementación de una aplicación de Java en Azure Web App for Containers con Azure Toolkit for IntelliJ

Los contenedores de Docker son un método muy utilizado para implementar aplicaciones web. Usando contenedores de Docker, los desarrolladores pueden consolidar todos sus archivos de proyecto y dependencias en un único paquete para implementarlo en un servidor. Azure Toolkit for IntelliJ simplifica este proceso para los desarrolladores de Java, ya que agrega características para implementar contenedores en Microsoft Azure.

En este artículo se muestran los pasos necesarios para crear una aplicación web de Hola mundo básica y publicar la aplicación web en un contenedor de Linux en Azure mediante el kit de herramientas de Azure para IntelliJ.

Requisitos previos

• Un kit de desarrollo de Java (JDK) admitido Para más información sobre los JDK disponibles para desarrollar en Azure, consulte Compatibilidad con Java en Azure y Azure Stack.
• IntelliJ IDEA, Ultimate o Community Edition.
• El kit de herramientas de Azure para IntelliJ. Para más información, consulte Instalación del kit de herramientas de Azure para IntelliJ. También necesitas iniciar sesión en tu cuenta de Azure para usar el Azure Toolkit de IntelliJ. Para obtener más información, consulte Instrucciones de inicio de sesión para Azure Toolkit for IntelliJ.

• Un cliente de Docker.

Nota:

Para completar los pasos de este tutorial, debe configurar Docker para exponer el servicio en el puerto 2375 sin el uso de TLS. Puede configurar esta opción al instalar Docker o mediante el menú de configuración de Docker.

Instalación e inicio de sesión

Los pasos siguientes le guiarán en el proceso de inicio de sesión de Azure en el entorno de desarrollo de IntelliJ.

1. Si no ha instalado el complemento, consulte Instalación de Azure Toolkit for IntelliJ.

2. Para iniciar sesión en su cuenta de Azure, vaya a la barra lateral Azure Explorer y, a continuación, haga clic en el icono Azure Sign In. Como alternativa, puede ir a Tools (Herramientas), expandir Azure y hacer clic en Azure Sign in (Inicio de sesión en Azure).

   

3. En la ventana Inicio de sesión de Azure, seleccione Inicio de sesión de dispositivo y, a continuación, haga clic en Iniciar sesión (otras opciones de inicio de sesión).

4. Haga clic en Copy&Open (Copiar y abrir) en el cuadro de diálogo Azure Device Login (Inicio de sesión de dispositivo de Azure).

5. En el explorador, pegue el código del dispositivo (que se ha copiado al hacer clic en Copiar y abrir en el último paso) y, a continuación, haga clic en Siguiente.

6. Seleccione la cuenta de Azure y complete los procedimientos de autenticación necesarios para iniciar sesión.

7. Una vez que haya iniciado sesión, cierre el explorador y vuelva al IDE de IntelliJ. En el cuadro de diálogo Select Subscriptions (Seleccionar suscripciones), elija las suscripciones que desea usar y, a continuación, haga clic en Select (Seleccionar).

Creación de un nuevo proyecto de aplicación web

1. Haga clic en File (Archivo), expanda New (Nuevo) y, a continuación, haga clic en Project (Proyecto).

2. En el cuadro de diálogo Nuevo proyecto, seleccione Maveny asegúrese de que la opción Crear desde arquetipo está activada. En la lista, seleccione maven-archetype-webapp y, a continuación, haga clic en Next (Siguiente).

   

3. Despliegue la lista desplegable de coordenadas de artefactos para ver todos los campos de entrada y especifique la siguiente información para su nueva aplicación web y haga clic en Siguiente:

   • Name : el nombre de la aplicación web. Se rellenará automáticamente el campo ArtifactId de la aplicación web.
   • GroupId: el nombre del grupo de artefactos, normalmente un dominio de la empresa. - por ejemplo, com.microsoft.azure.
   • Versión: conservaremos la versión predeterminada 1.0-SNAPSHOT.

4. Personalice la configuración de Maven o acepte los valores predeterminados y haga clic en Finish (Finalizar).

5. Vaya al proyecto en la pestaña Project (Proyecto) de la izquierda y abra el archivo src/main/webapp/index.jsp. Reemplace el código por el código siguiente y guarde los cambios:

   <html>
    <body>
      <b><% out.println("Hello World!"); %></b>
    </body>
   </html>
   

   

Creación de una instancia de Azure Container Registry para usarla como un registro de Docker privado

Los siguientes pasos le muestran cómo usar Azure Portal para crear una instancia de Azure Container Registry.

Nota:

Si quiere usar la CLI de Azure en lugar de Azure Portal, siga los pasos descritos en Creación de un registro de contenedor privado de Docker con la CLI de Azure 2.0.

1. Vaya a Azure Portal e inicie sesión.

   Una vez que haya iniciado sesión en su cuenta en Azure Portal, puede seguir los pasos descritos en el artículo Creación de un registro de contenedor privado de Docker mediante el Azure Portal, que se resumen en los pasos siguientes para mayor comodidad.

2. Haga clic en el icono de menú + Crear un recurso, haga clic en la categoría Contenedores y, a continuación, haga clic en Registro de contenedor.

3. Cuando aparezca la página Crear registro de contenedor, especifique la información siguiente:

   • Suscripción: Especifica la suscripción de Azure que desea usar para el nuevo registro de contenedor.

   • Resource Group: especifica el grupo de recursos para el registro de contenedor. Seleccione una de las siguientes opciones:

     • Crear nuevo: Especifica que desea crear un nuevo grupo de recursos.
     • Use Existing: especifica que se va a elegir de una lista de grupos de recursos asociados a la cuenta de Azure.

   • Nombre del Registro: especifica el nombre del nuevo registro de contenedor.

   • Ubicación: especifica la región donde se creará el registro de contenedor; por ejemplo, Oeste de EE. UU..

   • SKU: especifica el nivel de servicio del registro de contenedor. Para este tutorial, seleccione Básico. Para más información, consulte Niveles de servicio de Azure Container Registry.

4. Haga clic en Revisar y crear y compruebe que la información es correcta. Para finalizar, haga clic en Crear.

Implementación de una aplicación web en un contenedor de Docker

Los siguientes pasos le guiarán en la configuración de la compatibilidad de Docker para la aplicación web y la implementación de la aplicación web en un contenedor de Docker.

1. Ve a tu proyecto en la pestaña Proyecto a la izquierda y haz clic con el botón derecho en tu proyecto. Expanda Azure y haga clic en Add Docker Support (Agregar compatibilidad con Docker).

   Se creará automáticamente un archivo de Docker con una configuración predeterminada.

   

2. Después de haber agregado soporte para Docker, haga clic con el botón derecho en su proyecto en el explorador de proyectos, expanda Azurey luego haga clic en Implementar imagen en Aplicación Web.

3. En el cuadro de diálogo Implementar imagen en aplicación web, rellene la siguiente información:

   • Name: especifica el nombre descriptivo que se muestra en el kit de herramientas de Azure.

   • Container Registry: cree un nuevo registro de contenedores o elija el registro de contenedores del menú desplegable que creó en la sección anterior de este artículo. Los campos Server URL (URL del servidor), Username (Nombre de usuario) y Password (Contraseña) se rellenarán automáticamente.

   • Image and tag: especifica el nombre de imagen de contenedor; se suele utilizar la sintaxis siguiente: <registry>.azurecr.io/<appname>:latest, donde:

     • <registry> es el registro de contenedor de la sección anterior de este artículo
     • <appname> es el nombre de la aplicación web.

   • Usar la aplicación web existente o Crear nueva aplicación web: especifica si se implementa el contenedor en una aplicación web existente o se crea una aplicación web nueva. Con el nombre de aplicación que especifique se creará la dirección URL de la aplicación web; por ejemplo: wingtiptoys.azurewebsites.net.

   • Grupo de recursos: especifica si va a utilizar un grupo de recursos existente o va a crear uno nuevo.

   • App Service Plan: Especifica si va a usar un App Service Plan existente o crear uno nuevo.

4. Cuando haya terminado de configurar los valores enumerados anteriormente, haga clic en Run (Ejecutar). Cuando la aplicación web se ha implementado correctamente, se muestra el estado en la ventana Ejecutar.

5. Una vez publicada la aplicación web, puede ir a la dirección URL que especificó anteriormente para ella. Por ejemplo: wingtiptoys.azurewebsites.net.

   

Opcional: modificación de la configuración de publicación de la aplicación web

1. Después de publicar la aplicación web, la configuración se guardará como valor predeterminado y podrá ejecutar la aplicación en Azure al hacer clic en el icono de flecha verde de la barra de herramientas. Para modificar esta configuración, haga clic en el menú desplegable de la aplicación web y, luego, en Edit Configurations (Editar configuraciones).

   

2. Cuando aparezca el cuadro de diálogo Run/Debug Configurations (Ejecutar/Depurar configuraciones), podrá modificar cualquiera de los valores predeterminados y hacer clic en OK (Aceptar).

Pasos siguientes

Para más recursos de Docker, consulte el sitio web de Docker oficial.

Para notificar errores o solicitar nuevas características, abra una incidencia en nuestro repositorio de GitHub o haga preguntas en Stack Overflow con la etiqueta azure-java-tools.

Para más información acerca del uso de Java con Azure, consulte los siguientes vínculos:

• Azure para desarrolladores de Java
• Java con Azure DevOps Services
• Compatibilidad con Java en Azure y Azure Stack