Inicio rápido: Implementación de la primera aplicación en Azure Spring Apps
Artículo
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.
En este artículo se explica cómo implementar una sencilla aplicación para que se ejecute en Azure Spring Apps.
El código de aplicación que se usa en este tutorial es una aplicación sencilla. En cuanto complete este ejemplo, la aplicación será accesible en línea y podrá administrarla a través de Azure Portal.
En este artículo se proporcionan las siguientes opciones para la implementación en Azure Spring Apps:
La opción de Azure Portal es la manera más sencilla y rápida de crear recursos e implementar aplicaciones con un solo clic. Esta opción es adecuada para los desarrolladores de Spring que desean implementar rápidamente aplicaciones para los servicios en la nube de Azure.
La opción Azure Portal y complemento Maven es una manera más convencional de crear recursos e implementar aplicaciones paso a paso. Esta opción es adecuada para los desarrolladores de Spring que usan servicios en la nube de Azure por primera vez.
La opción de la Azure Developer CLI es una manera más eficaz de crear recursos e implementar aplicaciones automáticamente a través de comandos sencillos. La Azure Developer CLI usa una plantilla para aprovisionar los recursos de Azure necesarios e implementar el código de la aplicación. Esta opción es adecuada para los desarrolladores de Spring que están familiarizados con los servicios en la nube de Azure.
La opción de Azure Portal es la manera más sencilla y rápida de crear recursos e implementar aplicaciones con un solo clic. Esta opción es adecuada para los desarrolladores de Spring que desean implementar rápidamente aplicaciones para los servicios en la nube de Azure.
La opción Azure Portal y complemento Maven es una manera más convencional de crear recursos e implementar aplicaciones paso a paso. Esta opción es adecuada para los desarrolladores de Spring que usan servicios en la nube de Azure por primera vez.
La opción CLI de Azure utiliza una potente herramienta de línea de comandos para administrar los recursos de Azure. Esta opción es adecuada para los desarrolladores de Spring que están familiarizados con los servicios en la nube de Azure.
La opción IntelliJ utiliza un potente IDE de Java para administrar fácilmente los recursos de Azure. Esta opción es adecuada para los desarrolladores de Spring que están familiarizados con los servicios en la nube de Azure e IntelliJ IDEA.
La opción Visual Studio Code utiliza un editor de código fuente ligero pero potente, que puede administrar fácilmente los recursos de Azure. Esta opción es adecuada para desarrolladores de Spring que estén familiarizados con los servicios en la nube de Azure y Visual Studio Code.
Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.
Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.
Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.
Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.
Si va a implementar la instancia del plan Enterprise de Azure Spring Apps por primera vez en la suscripción de destino, vea la sección Requisitos del plan Enterprise en Azure Marketplace.
El botón Implementar en Azure de la sección siguiente inicia una experiencia de Azure Portal que descarga un paquete JAR de la página versiones de spring-cloud-azure-tools de GitHub. No se necesitan pasos de preparación locales.
En la lista siguiente se describen las interacciones del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Escriba un nuevo nombre de entorno: proporcione un nombre de entorno que se use como sufijo para que el grupo de recursos creado contenga todos los recursos de Azure. El nombre debe ser único en la suscripción de Azure.
La consola genera mensajes similares al ejemplo siguiente:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Preparar el entorno en la nube
En esta sección se describe cómo crear una instancia de servicio de Azure Spring Apps y preparar el entorno en la nube de Azure.
En esta sección se usa un botón Implementar en Azure para iniciar una experiencia de implementación en Azure Portal. Esta experiencia usa una plantilla de ARM para crear recursos de Azure.
3.1. Inicio de sesión en Azure Portal
Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de recursos de Azure
Siga estos pasos para crear todos los recursos de Azure de los que depende la aplicación:
Seleccione el botón Implementar en Azure para iniciar la experiencia de implementación en Azure Portal:
Rellene el formulario en la pestaña Aspectos básicos. Use la siguiente tabla como guía para completar el formulario:
Configuración
Valor sugerido
Descripción
Suscripción
El nombre de su suscripción.
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Grupos de recursos
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Región
La región más cercana a los usuarios.
La región se usa para crear el grupo de recursos.
Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para implementar la aplicación en Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio. Seleccione Ir al recurso para abrir la página Información general del servicio.
3.1. Inicio de sesión en Azure Portal
Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de una instancia de Azure Spring Apps
Use los siguientes pasos para crear una instancia de servicio de Azure Spring Apps:
En la esquina de Azure Portal, seleccione Crear un recurso.
Seleccione Proceso>Azure Spring Apps.
Complete el formulario Conceptos básicos con la siguiente información.
Use la tabla siguiente como guía para completar el formulario. El plan recomendado es Standard consumption & dedicated (preview).
Configuración
Valor sugerido
Descripción
Subscription
Nombre de la suscripción
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Resource group
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Nombre
myasa
Nombre único que identifica al servicio de 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.
Plan
Consumo estándar y dedicado (versión preliminar)
El plan de precios determina los recursos y el coste asociados a la instancia.
Region
Región más cercana a los usuarios
La ubicación más cercana a los usuarios.
Entorno de Container Apps
myacaenv
El entorno es un límite seguro alrededor de una o varias aplicaciones de contenedor que se pueden comunicar entre sí y compartir una red virtual, un registro y una configuración de Dapr.
Complete la pestaña Datos básicos con la información siguiente:
Nombre del entorno: myacaenv
Plan: Consumo
Redundancia de zona: Deshabilitada
Seleccione Crear para crear el entorno de aplicaciones de contenedor.
Complete la pestaña Datos básicos con la información siguiente:
Nombre del entorno: myacaenv
Plan: (Versión preliminar) Perfiles de carga de trabajo dedicados y consumo
Redundancia de zona: Deshabilitada
Seleccione la pestaña Perfiles de carga de trabajo (versión preliminar) y, a continuación, seleccione Agregar perfil de carga de trabajo para agregar un perfil de carga de trabajo.
En la página Agregar perfil de carga de trabajo (versión preliminar), agregue la siguiente información:
Nombre del perfil de carga de trabajo: my-wlp
Tamaño del perfil de carga de trabajo: seleccione Dedicated-D4
Intervalo de recuento de instancias de escalado automático: seleccione 3 y 5
Seleccione Agregar. Esta selección le lleva de vuelta a la página Agregar perfil de carga de trabajo (versión preliminar). Seleccione my-wlp y, a continuación, seleccione Crear para crear el entorno de Container Apps.
Seleccione Revisar y crear para revisar las selecciones. Seleccione Crear para aprovisionar la instancia de Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un icono para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio.
Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.
Siga estos pasos para crear los recursos necesarios:
Use el siguiente comando para iniciar sesión en Azure con OAuth2. Omita este paso si ya ha iniciado sesión.
azd auth login
La consola genera mensajes similares al ejemplo siguiente:
Logged in to Azure.
Use el siguiente comando para aprovisionar la infraestructura de la plantilla en Azure:
azd provision
En la lista siguiente se describen las interacciones del comando:
Seleccione una suscripción de Azure para usar: use las flechas para moverse, escriba para filtrar las opciones y presione Entrar.
Seleccione una ubicación de Azure para usar: use las flechas para moverse, escriba para filtrar las opciones y presione Entrar.
La consola genera mensajes similares al ejemplo siguiente:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota:
Esta operación puede tardar varios minutos en completarse. Verá un indicador de progreso a medida que se aprovisionan los recursos de Azure.
4. Implementación de la aplicación en Azure Spring Apps
El botón Implementar en Azure de la sección anterior inicia una experiencia de Azure Portal que incluye la implementación de aplicaciones, por lo que no se necesita nada más.
En la lista siguiente se describen las interacciones del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Seleccionar suscripción: seleccione el número de lista de suscripciones de la instancia de Azure Spring Apps que creó, que tiene como valor predeterminado la primera suscripción de la lista. Si usa el número predeterminado, presione Entrar directamente.
Usar Azure Spring Apps existente en Azure: presione y para usar la instancia de Azure Spring Apps existente.
Seleccione Azure Spring Apps para la implementación: seleccione el número de lista de la instancia de Azure Spring Apps que creó. Si usa el número predeterminado, presione Entrar directamente.
Use la aplicación existente en Azure Spring Apps <your-instance-name>: Presione n para crear una nueva aplicación.
Escriba el nombre de la aplicación (demostración): Proporcione un nombre de aplicación. Para usar el identificador de artefacto del proyecto predeterminado, presione Entrar.
¿Exponer el acceso público para esta aplicación (boot-for-azure)?: Presione y.
Confirmar para guardar todas las configuraciones anteriores: presione y. Si presiona n, la configuración no se guardará en los archivos POM.
Use el siguiente comando para implementar la aplicación:
./mvnw azure-spring-apps:deploy
En la lista siguiente se describe la interacción del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Una vez ejecutado el comando, puede ver en los siguientes mensajes de registro que la implementación se ha realizado correctamente:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
Siga estos pasos para empaquetar la aplicación, aprovisionar los recursos de Azure necesarios para la aplicación web y, a continuación, implementarlos en Azure Spring Apps:
Use el siguiente comando para empaquetar una copia implementable de la aplicación:
azd package
La consola genera mensajes similares al ejemplo siguiente:
SUCCESS: Your application was packaged for Azure in xx seconds.
Use el siguiente comando para implementar el código de la aplicación en los recursos recién aprovisionados:
azd deploy
La consola genera mensajes similares al ejemplo siguiente:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota:
También puede usar azd up para combinar los tres comandos anteriores: azd provision (aprovisiona recursos de Azure), azd package (empaqueta una copia implementable de la aplicación) y azd deploy (implementa el código de la aplicación). Para obtener más información, consulte spring-guides/gs-spring-boot-for-azure.
El botón Implementar en Azure de la sección siguiente inicia una experiencia de Azure Portal que descarga un paquete JAR de la página versiones de spring-cloud-azure-tools de GitHub. No se necesitan pasos de preparación locales.
En la lista siguiente se describen las interacciones del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Escriba un nuevo nombre de entorno: proporcione un nombre de entorno que se use como sufijo para que el grupo de recursos creado contenga todos los recursos de Azure. El nombre debe ser único en la suscripción de Azure.
La consola genera mensajes similares al ejemplo siguiente:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Preparar el entorno en la nube
En esta sección se describe cómo crear una instancia de servicio de Azure Spring Apps y preparar el entorno en la nube de Azure.
En esta sección se usa un botón Implementar en Azure para iniciar una experiencia de implementación en Azure Portal. Esta experiencia usa una plantilla de ARM para crear recursos de Azure.
3.1. Inicio de sesión en Azure Portal
Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de recursos de Azure
Siga estos pasos para crear todos los recursos de Azure de los que depende la aplicación:
Seleccione el botón Implementar en Azure para iniciar la experiencia de implementación en Azure Portal:
Rellene el formulario en la pestaña Aspectos básicos. Use la siguiente tabla como guía para completar el formulario:
Configuración
Valor sugerido
Descripción
Suscripción
El nombre de su suscripción.
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Grupos de recursos
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Región
La región más cercana a los usuarios.
La región se usa para crear el grupo de recursos.
Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para implementar la aplicación en Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio. Seleccione Ir al recurso para abrir la página Información general del servicio.
3.1. Inicio de sesión en Azure Portal
Abra el explorador web y vaya a Azure Portal. Introduzca sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de una instancia de Azure Spring Apps
Siga estos pasos para crear una instancia de servicio:
En la esquina de Azure Portal, seleccione Crear un recurso.
Seleccione Proceso>Azure Spring Apps.
Complete el formulario de aspectos básicos con la información siguiente:
Configuración
Valor sugerido
Descripción
Subscription
Nombre de la suscripción
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Resource group
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Nombre
myasa
Nombre único que identifica al servicio de 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.
Plan
Estándar
El plan de precios que determina el recurso y el coste asociado a su instancia.
Region
Región más cercana a los usuarios
La ubicación más cercana a los usuarios.
Redundancia de zona
No seleccionado
Indica si se debe crear el servicio Azure Spring Apps en una zona de disponibilidad de Azure. Esta característica no se admite actualmente en todas las regiones.
Seleccione Revisar y crear para revisar las selecciones. Seleccione Crear para aprovisionar la instancia de Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un icono para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio.
Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.
Siga estos pasos para crear los recursos necesarios:
Use el siguiente comando para iniciar sesión en Azure con OAuth2. Omita este paso si ya ha iniciado sesión.
azd auth login
La consola genera mensajes similares al ejemplo siguiente:
Logged in to Azure.
Utilice el siguiente comando para configurar la plantilla utilizando el plan Estándar:
azd env set PLAN standard
Use el siguiente comando para empaquetar una copia implementable de la aplicación, aprovisionar la infraestructura de la plantilla en Azure e implementar el código de aplicación en esos recursos recién aprovisionados:
azd provision
En la lista siguiente se describen las interacciones del comando:
Seleccione una suscripción de Azure para usar: use las flechas para moverse, escriba para filtrar las opciones y presione Entrar.
Seleccione una ubicación de Azure para usar: use las flechas para moverse, escriba para filtrar y luego, presione Entrar.
La consola muestra mensajes similares a los del siguiente ejemplo:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota:
Esta operación puede tardar varios minutos en completarse. Verá un indicador de progreso a medida que se aprovisionan los recursos de Azure.
4. Implementación de la aplicación en Azure Spring Apps
El botón Implementar en Azure de la sección anterior inicia una experiencia de Azure Portal que incluye la implementación de aplicaciones, por lo que no se necesita nada más.
En la lista siguiente se describen las interacciones del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Seleccionar suscripción: seleccione el número de lista de suscripciones de la instancia de Azure Spring Apps que creó, que tiene como valor predeterminado la primera suscripción de la lista. Si usa el número predeterminado, presione Entrar directamente.
Usar Azure Spring Apps existente en Azure: presione y para usar la instancia de Azure Spring Apps existente.
Seleccione Azure Spring Apps para la implementación: seleccione el número de lista de la instancia de Azure Spring Apps que creó. Si usa el número predeterminado, presione Entrar directamente.
Use la aplicación existente en Azure Spring Apps <your-instance-name>: Presione n para crear una nueva aplicación.
Escriba el nombre de la aplicación (demostración): Proporcione un nombre de aplicación. Para usar el identificador de artefacto del proyecto predeterminado, presione Entrar.
¿Exponer el acceso público para esta aplicación (boot-for-azure)?: Presione y.
Confirmar para guardar todas las configuraciones anteriores: presione y. Si presiona n, la configuración no se guardará en los archivos POM.
Use el siguiente comando para implementar la aplicación:
./mvnw azure-spring-apps:deploy
En la lista siguiente se describe la interacción del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Una vez ejecutado el comando, puede ver en los siguientes mensajes de registro que la implementación se ha realizado correctamente:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:demo-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Siga estos pasos para empaquetar la aplicación, aprovisionar los recursos de Azure necesarios para la aplicación web y, a continuación, implementarlos en Azure Spring Apps:
Use el siguiente comando para empaquetar una copia implementable de la aplicación:
azd package
La consola genera mensajes similares al ejemplo siguiente:
SUCCESS: Your application was packaged for Azure in xx seconds.
Use el siguiente comando para implementar el código de la aplicación en los recursos recién aprovisionados:
azd deploy
La consola muestra mensajes similares a los del siguiente ejemplo:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota:
También puede usar azd up para combinar los tres comandos anteriores: azd package (empaqueta una copia implementable de la aplicación), azd provision (aprovisiona recursos de Azure) y azd deploy (implementa el código de la aplicación). Para obtener más información, consulte spring-guides/gs-spring-boot-for-azure.
El botón Implementar en Azure de la sección siguiente inicia una experiencia de Azure Portal que descarga un paquete JAR de la página versiones de spring-cloud-azure-tools de GitHub. No se necesitan pasos de preparación locales.
En esta sección se usa un botón Implementar en Azure para iniciar una experiencia de implementación en Azure Portal. Esta experiencia usa una plantilla de ARM para crear recursos de Azure.
3.1. Inicio de sesión en Azure Portal
Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de recursos de Azure
Siga estos pasos para crear todos los recursos de Azure de los que depende la aplicación:
Seleccione el botón Implementar en Azure para iniciar la experiencia de implementación en Azure Portal:
Rellene el formulario en la pestaña Aspectos básicos. Use la siguiente tabla como guía para completar el formulario:
Configuración
Valor sugerido
Descripción
Suscripción
El nombre de su suscripción.
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Grupos de recursos
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Región
La región más cercana a los usuarios.
La región se usa para crear el grupo de recursos.
Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para implementar la aplicación en Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio. Seleccione Ir al recurso para abrir la página Información general del servicio.
3.1. Inicio de sesión en Azure Portal
Vaya a Azure Portal y escriba sus credenciales para iniciar sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de una instancia de Azure Spring Apps
Siga estos pasos para crear la instancia de servicio:
En la esquina de Azure Portal, seleccione Crear un recurso.
Seleccione Proceso>Azure Spring Apps.
Complete el formulario de aspectos básicos con la información siguiente:
Configuración
Valor sugerido
Descripción
Suscripción
El nombre de su suscripción.
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Grupos de recursos
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Nombre
myasa
Nombre único que identifica al servicio de 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.
Región
La región más cercana a los usuarios.
La ubicación más cercana a los usuarios.
Opciones y planes de hospedaje
Empresa
El plan de precios que determina el recurso y el coste asociado a su instancia.
Redundancia de zona
No seleccionado
La opción para crear el servicio de Azure Spring Apps en una zona de disponibilidad de Azure. Esta característica no se admite actualmente en todas las regiones.
Plan de IP de software
Pago por uso
Plan de precios que le permite pagar por uso con Azure Spring Apps.
Implementación del proyecto de ejemplo
No seleccionado
Opción para usar la aplicación de ejemplo integrada.
Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para aprovisionar la instancia de Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio.
Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.
3.1. Proporcione nombres para cada recurso
Cree variables para contener los nombres del recurso mediante los siguientes comandos. Asegúrese de reemplazar los marcadores de posición por sus propios valores.
Use los siguientes pasos para crear un grupo de recursos:
Use el siguiente comando para iniciar sesión en la CLI de Azure:
az login
Use el siguiente comando para establecer la ubicación predeterminada:
az configure --defaults location=${LOCATION}
Use el siguiente comando para enumerar todas las suscripciones disponibles y determinar el id. de suscripción que se va a usar:
az account list --output table
Use el siguiente comando para establecer la suscripción predeterminada:
az account set --subscription <subscription-ID>
Use el siguiente comando para crear un grupo de recursos:
az group create --resource-group ${RESOURCE_GROUP}
Use el siguiente comando para establecer el grupo de recursos recién creado como el grupo de recursos predeterminado:
az configure --defaults group=${RESOURCE_GROUP}
3.3. Instalación de la extensión y registro del espacio de nombres
Use los siguientes comandos para instalar la extensión Azure Spring Apps para la CLI de Azure y registrar el espacios de nombres Microsoft.SaaS:
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. Creación de una instancia de Azure Spring Apps
Siga estos pasos para crear la instancia de servicio:
Use el siguiente comando para aceptar los términos legales y las declaraciones de privacidad del plan Enterprise:
Nota:
Este paso solo es necesario si la suscripción nunca se ha usado para crear un plan Enterprise de Azure Spring Apps.
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
Use el siguiente comando para crear una instancia de servicio de Azure Spring Apps:
az spring create \
--name ${SERVICE_NAME} \
--sku Enterprise
3.5. Creación de una aplicación en la instancia de Azure Spring Apps
Una Aplicación es una abstracción de una aplicación empresarial. Para más información, vea Aplicación e implementación en Azure Spring Apps. Las aplicaciones se ejecutan en una instancia de servicio de Azure Spring Apps, como se muestra en el diagrama siguiente.
Use el siguiente comando para crear la aplicación en Azure Spring Apps:
az spring app create \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.1. Inicio de sesión en Azure Portal
Abra el explorador web y vaya a Azure Portal, escriba sus credenciales e inicie sesión en el portal. La vista predeterminada es el panel del servicio.
3.2. Creación de una instancia de Azure Spring Apps
Siga estos pasos para crear la instancia de servicio:
En la esquina de Azure Portal, seleccione Crear un recurso.
Seleccione Proceso>Azure Spring Apps.
Complete el formulario de aspectos básicos con la información siguiente:
Configuración
Valor sugerido
Descripción
Suscripción
El nombre de su suscripción.
La suscripción de Azure que desea usar para el servidor. Si tiene varias suscripciones, elija aquella en la que quiere que se le facture el recurso.
Grupos de recursos
myresourcegroup
Un nuevo nombre de grupo de recursos o uno existente de la suscripción.
Nombre
myasa
Nombre único que identifica al servicio de 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.
Región
La región más cercana a los usuarios.
La ubicación más cercana a los usuarios.
Opciones y planes de hospedaje
Empresa
El plan de precios que determina el recurso y el coste asociado a su instancia.
Redundancia de zona
No seleccionado
La opción para crear el servicio de Azure Spring Apps en una zona de disponibilidad de Azure. Esta característica no se admite actualmente en todas las regiones.
Plan de IP de software
Pago por uso
Plan de precios que le permite pagar por uso con Azure Spring Apps.
Implementación del proyecto de ejemplo
No seleccionado
Opción para usar la aplicación de ejemplo integrada.
Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para aprovisionar la instancia de Azure Spring Apps.
En la barra de herramientas, seleccione el símbolo de Notificaciones (una campana) para supervisar el proceso de implementación. Una vez realizada la implementación, puede seleccionar Anclar al panel para crear un mosaico para este servicio en el panel de Azure Portal como un acceso directo a la página Información general del servicio.
Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.
El botón Implementar en Azure de la sección anterior inicia una experiencia de Azure Portal que incluye la implementación de aplicaciones, por lo que no se necesita nada más.
En la lista siguiente se describen las interacciones del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Seleccionar suscripción: seleccione el número de lista de suscripciones de la instancia de Azure Spring Apps que creó, que tiene como valor predeterminado la primera suscripción de la lista. Si usa el número predeterminado, presione Entrar directamente.
Usar Azure Spring Apps existente en Azure: presione y para usar la instancia de Azure Spring Apps existente.
Seleccione Azure Spring Apps para la implementación: seleccione el número de lista de la instancia de Azure Spring Apps que creó. Si usa el número predeterminado, presione Entrar directamente.
Use la aplicación existente en Azure Spring Apps <your-instance-name>: Presione n para crear una nueva aplicación.
Escriba el nombre de la aplicación (demostración): Proporcione un nombre de aplicación. Para usar el identificador de artefacto del proyecto predeterminado, presione Entrar.
¿Exponer el acceso público para esta aplicación (boot-for-azure)?: Presione y.
Confirmar para guardar todas las configuraciones anteriores: presione y. Si presiona n, la configuración no se guardará en los archivos POM.
Use el siguiente comando para implementar la aplicación:
./mvnw azure-spring-apps:deploy
En la lista siguiente se describe la interacción del comando:
Inicio de sesión de OAuth2: debe autorizar el inicio de sesión en Azure basado en el protocolo OAuth2.
Una vez ejecutado el comando, puede ver en los siguientes mensajes de registro que la implementación se ha realizado correctamente:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Use el siguiente comando para implementar el archivo .jar en la aplicación:
az spring app deploy \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--artifact-path target/demo-0.0.1-SNAPSHOT.jar
La implementación de la aplicación puede tardar unos minutos.
En esta sección se proporcionan los pasos para implementar la aplicación en Azure Spring Apps.
4.1. Importación del proyecto
Siga estos pasos para importar el proyecto:
Abra IntelliJ IDEA y seleccione Abrir.
En el cuadro de diálogo Open File or Project (Abrir archivo o proyecto), seleccione la carpeta demo.
4.2. Compilación e implementación de la aplicación
Siga estos pasos para compilar e implementar la aplicación:
El Azure Toolkit for IntelliJ proporciona cuatro maneras de iniciar sesión en Azure y la implementación solo se puede iniciar después de iniciar sesión.
Haga clic con el botón derecho en el proyecto en la ventana del proyecto de IntelliJ y, después, seleccione Azure ->Deploy to Azure Spring Apps (Implementar en Azure Spring Apps).
Acepte el nombre de la aplicación en el campo Name (Nombre). El nombre hace referencia a la configuración, no al nombre de la aplicación. Normalmente, no es necesario cambiarlo.
En el cuadro de texto Artifact (Artefacto), seleccione Maven:demo(Java 17).
En el cuadro de texto Subscription (Suscripción), compruebe que la suscripción sea correcta.
En el cuadro de texto Spring Apps, seleccione la instancia de Azure Spring Apps que ha creado.
En el cuadro de texto App (Aplicación), seleccione el signo más (+) para crear una aplicación.
En el cuadro de texto App name: (Nombre de la aplicación:) de App Basics (Aspectos básicos de la aplicación), escriba demo y, a continuación, seleccione More settings (Más opciones).
Seleccione el botón Habilitar situado junto a Punto de conexión público. El botón cambia a Disable <to be enabled> (Deshabilitado ). Después, seleccione Aceptar.
En Before launch (Antes del inicio), seleccione la línea Run Maven Goal "demo:package" (Ejecutar el objetivo de Maven "demo:package") y, a continuación, seleccione el icono de lápiz para editar la línea de comandos.
En el cuadro de texto Command line (Línea de comandos), escriba -DskipTests después de package y seleccione OK (Aceptar).
Para iniciar la implementación, seleccione el botón Run (Ejecutar) en la parte inferior del cuadro de diálogo Deploy to Azure (Implementar en Azure). El complemento ejecuta el comando package -DskipTests en lademo aplicación e implementa el archivo .jar generado por el comando package.
La implementación de la aplicación puede tardar unos minutos. Puede ver la dirección URL pública de la aplicación en el registro de la consola de salida.
Una vez finalizada la implementación, busque la dirección URL de la aplicación en las salidas de implementación. Utilice los pasos siguientes para validarla:
Acceda a la dirección URL de la aplicación desde la página Salidas de la Implementación. Al abrir la aplicación, obtendrá la respuesta Hello World.
Consulte los detalles de la implementación de cada recurso, que son útiles para investigar cualquier problema de implementación.
Una vez finalizada la implementación, acceda a la aplicación con la dirección URL de la aplicación de salida. Siga estos pasos para comprobar los registros de la aplicación para investigar cualquier problema de implementación:
Acceda a la dirección URL de la aplicación de salida desde la página Salidas en la Implementación. Al abrir la aplicación, obtendrá la respuesta Hello World.
En el panel de navegación de la página Información general de la instancia de Azure Spring Apps, seleccione Registros para comprobar los registros de la aplicación.
Una vez finalizada la implementación, acceda a la aplicación con el punto de conexión de salida. Al abrir la aplicación, obtendrá la respuesta Hello World.
Una vez finalizada la implementación, siga estos pasos para buscar la dirección URL de la aplicación desde las salidas de implementación:
Acceda a la dirección URL de la aplicación desde la página Salidas de la Implementación. Al abrir la aplicación, obtendrá la respuesta Hello World.
Consulte los detalles de la implementación de cada recurso, que son útiles para investigar cualquier problema de implementación.
Una vez finalizada la implementación, siga estos pasos para comprobar los registros de la aplicación para investigar cualquier problema de implementación:
Acceda a la dirección URL de la aplicación desde la página Salidas de la Implementación. Al abrir la aplicación, obtendrá la respuesta Hello World.
En el panel de navegación de la página de información general de la instancia de Azure Spring Apps, seleccione Registros para comprobar los registros de la aplicación.
Una vez finalizada la implementación, acceda a la aplicación con el punto de conexión de salida. Al abrir la aplicación, obtendrá la respuesta Hello World.
Una vez finalizada la implementación, siga estos pasos para buscar la dirección URL de la aplicación desde las salidas de implementación:
Acceda a la dirección URL de la aplicación desde la página Salidas de la Implementación. Al abrir la aplicación, obtendrá la respuesta Hello World.
Consulte los detalles de la implementación de cada recurso, que son útiles para investigar cualquier problema de implementación.
Una vez finalizada la implementación, siga estos pasos para validar la aplicación:
Acceda al URL de la aplicación. Al abrir la aplicación, obtendrá la respuesta Hello World.
Compruebe los registros de la consola, que son útiles para investigar cualquier problema de implementación.
Una vez finalizada la implementación, siga estos pasos para comprobar los registros de la aplicación para investigar cualquier problema de implementación:
Acceda a la aplicación con la dirección URL de la aplicación de salida. Al abrir la aplicación, obtendrá la respuesta Hello World.
Use el siguiente comando para comprobar el registro de la aplicación para investigar cualquier problema de implementación:
az spring app logs \
--service ${SERVICE_NAME} \
--name ${APP_NAME}
Siga estos pasos para transmitir los registros de aplicaciones:
Acceda a la aplicación con la dirección URL de la aplicación de salida. Al abrir la aplicación, obtendrá la respuesta Hello World.
Abra la ventana Azure Explorer, expanda el nodo Azure, expanda el nodo de servicio Azure Spring Apps, expanda la instancia de Azure Spring Apps que ha creado y, a continuación, seleccione la instancia de demo de la aplicación que ha creado.
Haga clic con el botón derecho y seleccione Iniciar registros de streaming y, después, seleccione Aceptar para ver los registros de aplicaciones en tiempo real.
Siga estos pasos para transmitir los registros de aplicaciones:
Acceda a la aplicación con la dirección URL de la aplicación de salida. Al abrir la aplicación, obtendrá la respuesta Hello World.
Si planea seguir trabajando en otros inicios rápidos y tutoriales, considere la posibilidad de dejar estos recursos activos. Cuando ya no necesite los recursos, puede limpiar los recursos innecesarios para evitar cargos de Azure.
Siga los siguientes pasos para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:
Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos y, a continuación, seleccione el nombre del grupo de recursos.
En la página Grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación, luego seleccione Eliminar.
Siga los siguientes pasos para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:
Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos y, a continuación, seleccione el nombre del grupo de recursos.
En la página Grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación, luego seleccione Eliminar.
Use el siguiente comando para eliminar el grupo de recursos mediante la CLI de Azure:
az group delete --name ${RESOURCE_GROUP}
Siga estos pasos para eliminar el grupo de recursos mediante IntelliJ:
Vaya a Intellij IDEA y busque el nombre del grupo de recursos.
Haga clic con el botón derecho en el grupo de recursos y seleccione Eliminar para eliminar todos los recursos de Azure relacionados.
Siga estos pasos para eliminar el grupo de recursos mediante Visual Studio Code:
Vaya a Visual Studio Code, seleccione Agrupar por para habilitar Agrupar por grupo de recursos y, a continuación, busque el nombre del grupo de recursos.
Haga clic con el botón derecho en el grupo de recursos y seleccione Eliminar grupo de recursos... para eliminar todos los recursos de Azure relacionados.
Siga los siguientes pasos para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:
Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos y, a continuación, seleccione el nombre del grupo de recursos.
En la página Grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación, luego seleccione Eliminar.
Siga los siguientes pasos para eliminar todo el grupo de recursos, incluyendo la instancia de servicio recién creada:
Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos y, a continuación, seleccione el nombre del grupo de recursos.
En la página Grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación, luego seleccione Eliminar.
Use el siguiente comando para eliminar todos los recursos de Azure usados en esta aplicación de ejemplo:
azd down
En la lista siguiente se describe la interacción del comando:
Número total de recursos que se van a eliminar: <your-resources-total>, ¿está seguro de que desea continuar?: presione y.
La consola genera mensajes similares al ejemplo siguiente:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
