Inicio rápido: Implementación de la primera aplicación en Azure Spring Apps

Artículo
09/04/2023

Nota:

Las primeras 50 horas de vCPU y 100 GB de memoria al mes son gratuitos. Para más información, consulte el artículo Price Reduction - Azure Spring Apps does more, costs less! ("Reducción de precios: Azure Spring Apps te da más por menos") en el Blog de Apps on Azure.

Nota

Azure Spring Apps es el nuevo nombre del servicio Azure Spring Cloud. Aunque el servicio tiene un nuevo nombre, verá el nombre antiguo en algunos lugares durante un tiempo mientras trabajamos para actualizar recursos, como capturas de pantalla, vídeos y diagramas.

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. Cuando haya completado este ejemplo, se podrá acceder en línea a la aplicación y la podrá administrar mediante Azure Portal.

En este artículo se describen las siguientes dos opciones para la implementación en Azure Spring Apps:

El Azure Portal es una manera más convencional de crear recursos e implementar aplicaciones paso a paso. Es adecuado para los desarrolladores de Spring que usan los servicios en la nube de Azure por primera vez.
El Azure Developer CLI es una manera más eficaz de crear automáticamente recursos e implementar aplicaciones a través de comandos sencillos. Abarca el código de la aplicación y la infraestructura como archivos de código necesarios para aprovisionar los recursos de Azure. Es adecuado para los desarrolladores de Spring que están familiarizados con los servicios en la nube de Azure.

Suscripción a Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Git.
Kit de desarrollo de Java (JDK), versión 17.

Suscripción a Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
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.
Git.
Kit de desarrollo de Java (JDK), versión 17.
CLI de Azure: versión 2.45.0 o superior.

2. Preparar el proyecto Spring

Azure Portal
CLI de desarrollo de Azure

Siga estos pasos para preparar el proyecto:

Use el siguiente comando para clonar el proyecto de ejemplo de Spring Boot desde GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Use el siguiente comando para ir a la carpeta del proyecto:
```
cd gs-spring-boot-for-azure/complete
```
Use el siguiente comando de Maven para compilar el proyecto:
```
./mvnw clean package
```
Ejecute el proyecto de ejemplo localmente mediante el comando siguiente:
```
./mvnw spring-boot:run
```

Siga estos pasos para inicializar la aplicación desde las plantillas de Azure Developer CLI:

Abra una ventana de terminal, cree una nueva carpeta y cambie de directorio en ella.

Use el comando siguiente para inicializar el proyecto:

azd init --template spring-guides/gs-spring-boot-for-azure

En la lista siguiente se describen las interacciones del comando:

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

El recurso principal que necesita para ejecutar este ejemplo es una instancia de Azure Spring Apps. Siga estos pasos para crear este recurso.

Azure Portal
CLI de desarrollo de Azure

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

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 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.

(Opcional) Crear un entorno de Container Apps.
- Carga de trabajo de consumo
- Carga de trabajo dedicada
1. Complete la pestaña Datos básicos con la información siguiente:
  - Nombre del entorno: myacaenv
  - Plan: Consumo
  - Redundancia de zona: Deshabilitada
2. Seleccione Crear para crear el entorno de aplicaciones de contenedor.
1. 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
2. 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.
3. 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
4. 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 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.

Ejecute 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 y luego, presione Entrar.
- Seleccione una ubicación de Azure para usar: use las flechas para moverse, escriba para filtrar y luego, 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/<your-resource-group>/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

En esta sección se proporcionan los pasos para implementar la aplicación en Azure Spring Apps.

Azure Portal
CLI de desarrollo de Azure

Siga estos pasos para implementar mediante el complemento de Maven para Azure Spring Apps:

Navegue hasta el directorio completo y ejecute el siguiente comando para configurar la aplicación en Azure Spring Apps:
```
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
```
En la lista siguiente se describen las interacciones del comando:
- Inicio de sesión de OAuth2: autorice el inicio de sesión a Azure en función del 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.
- 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.
- Introduzca el nombre de la aplicación: Introduzca un nombre para la 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.
- Confirme para guardar todas las configuraciones anteriores (Y/N): 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 com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

En la lista siguiente se describe la interacción del comando:

Inicio de sesión de OAuth2: autorice el inicio de sesión a Azure en función del 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 updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running 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 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.

2. Preparar el proyecto Spring

Azure Portal
CLI de desarrollo de Azure

Siga estos pasos para preparar el proyecto:

Use el siguiente comando para clonar el proyecto de ejemplo de Spring Boot desde GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Use el siguiente comando para ir a la carpeta del proyecto:
```
cd gs-spring-boot-for-azure/complete
```
Use el siguiente comando de Maven para compilar el proyecto:
```
./mvnw clean package
```
Ejecute el proyecto de ejemplo localmente mediante el comando siguiente:
```
./mvnw spring-boot:run
```

Siga estos pasos para inicializar la aplicación web desde las plantillas de Azure Developer CLI.

Abra una ventana de terminal, cree una nueva carpeta y cambie de directorio en ella.

Use el comando siguiente para inicializar el proyecto:

azd init --template spring-guides/gs-spring-boot-for-azure

En la lista siguiente se describen las interacciones del comando:

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

El recurso principal que necesita para ejecutar este ejemplo es una instancia de Azure Spring Apps. Siga estos pasos para crear este recurso.

Azure Portal
CLI de desarrollo de Azure

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 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.

Ejecute 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 y luego, 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/<your-resource-group>/overview
```
Nota

Esta operación puede tardar varios minutos en completarse. Verás un indicador de progreso a medida que se aprovisionan los recursos de Azure.

4. Implementación de la aplicación en Azure Spring Apps

En esta sección se proporcionan los pasos para implementar la aplicación en Azure Spring Apps.

Azure Portal
CLI de desarrollo de Azure

Siga estos pasos para implementar mediante el complemento de Maven para Azure Spring Apps:

Navegue hasta el directorio completo y ejecute el siguiente comando para configurar la aplicación en Azure Spring Apps:
```
./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:config
```
En la lista siguiente se describen las interacciones del comando:
- Inicio de sesión de OAuth2: autorice el inicio de sesión a Azure en función del 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.
- 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.
- Introduzca el nombre de la aplicación: Introduzca un nombre para la 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.
- Confirme para guardar todas las configuraciones anteriores (Y/N): 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 com.microsoft.azure:azure-spring-apps-maven-plugin:1.18.0:deploy

En la lista siguiente se describen las interacciones del comando:

Inicio de sesión de OAuth2: autorice el inicio de sesión a Azure en función del 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 updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running 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.

2. Preparar el proyecto Spring

Siga estos pasos para preparar el proyecto:

Use el siguiente comando para clonar el proyecto de ejemplo de Spring Boot desde GitHub.
```
git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
```
Use el siguiente comando para ir a la carpeta del proyecto:
```
cd gs-spring-boot-for-azure/complete
```
Use el siguiente comando de Maven para compilar el proyecto:
```
./mvnw clean package
```
Ejecute el proyecto de ejemplo localmente mediante el comando siguiente:
```
./mvnw spring-boot:run
```

Siga estos pasos para crear el proyecto:

Utilice el siguiente comando para generar un proyecto de start.spring.iocomo ejemplo con las dependencias recomendadas para Azure Spring Apps:

curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -

Cree un controlador web para su aplicación web añadiendo el archivo src/main/java/com/example/demo/HelloController.java con el siguiente contenido:

package com.example.demo;

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController
public class HelloController {

    @RequestMapping("/")
    public String index() {
        return "Hello World";
     }
}

Use el siguiente comando de Maven para compilar el proyecto:
```
./mvnw clean package
```
Ejecute el proyecto de ejemplo localmente mediante el comando siguiente:
```
./mvnw spring-boot:run
```

3. Preparar el entorno en la nube

Use los siguientes pasos para crear una instancia de servicio 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.

export LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

3.2. Creación de un nuevo grupo de recursos

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 Container 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.

Diagrama que muestra la relación entre las aplicaciones y una instancia del servicio Azure Spring Apps.

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

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 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
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	Empresa	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 activado	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.
Plan de IP de software	Pago por uso	Pago por uso con Azure Spring Apps.
Términos	Seleccionado	Debe activar la casilla de verificación del contrato asociado a la oferta de Marketplace.

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 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.

4. Implementación de la aplicación en Azure Spring Apps

En esta sección se proporcionan los pasos para implementar la aplicación en Azure Spring Apps.

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.

4.1. Importación del proyecto

Siga estos pasos para importar el proyecto:

Abra IntelliJ IDEA y, a continuación, seleccione Open (Abrir).
En el cuadro de diálogo Abrir archivo o proyecto, seleccione la carpeta de demostración.

4.2. Compilación e implementación de la aplicación

Utilice los pasos siguientes para compilar e implementar la aplicación:

Si aún no ha instalado Azure Toolkit for IntelliJ, siga los pasos descritos en Instalación de Azure Toolkit for IntelliJ.

Nota

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 ->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 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 Nombre de la aplicación: en Conceptos básicos de la aplicación, introduzca demo y, a continuación, seleccione Más ajustes.
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, selecciona Run Maven Goal 'demo:package', y luego selecciona el icono del 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 Ejecutar en la parte inferior del cuadro de diálogo 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.

5. Validación de la aplicación

Después de la implementación, puede acceder a la aplicación en https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io. 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.

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}

6. Limpieza de recursos

Asegúrate de eliminar los recursos creados en este tutorial cuando ya no los necesites. Para eliminar los recursos, basta con eliminar el grupo de recursos que los contiene. Puedes eliminar el grupo de recursos mediante Azure Portal. Como alternativa, puede eliminar el grupo de recursos mediante la CLI de Azure con el siguiente comando:

az group delete --name ${RESOURCE_GROUP}

Puede eliminar el grupo de recursos de Azure, lo que incluye todos los recursos del grupo de recursos.

Azure Portal
CLI de desarrollo de Azure

Siga los siguientes pasos para eliminar todo el grupo de recursos, incluyendo el servicio recién creado:

Elimine el grupo de recursos en Azure Portal. En el menú de navegación, seleccione Grupos de recursos. A continuación, seleccione el nombre de su grupo de recursos (por ejemplo, myresourcegroup).
En la página del grupo de recursos, seleccione Eliminar. Escriba el nombre del grupo de recursos en el cuadro de texto para confirmar la eliminación (por ejemplo myresourcegroup) y, a continuación, 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 describen las interacciones 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.

7. Pasos siguientes

Registro de aplicaciones estructurado para Azure Spring Apps

Asignación de un dominio personalizado existente a Azure Spring Apps

Uso de CI/CD de Azure Spring Apps con Acciones de GitHub

Automatización de implementaciones de aplicaciones en Azure Spring Apps

Uso de identidades administradas para aplicaciones en Azure Spring Apps

Crear una conexión de servicio en Azure Spring Apps con la CLI de Azure

Introducción a la aplicación de ejemplo

Introducción a la aplicación de muestra de Fitness Store

Para más información, consulte los siguientes artículos.

Inicio rápido: Implementación de la primera aplicación en Azure Spring Apps

1. Prerrequisitos

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.2. Creación de una instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.2. Creación de una instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.1. Proporcione nombres para cada recurso

3.2. Creación de un nuevo grupo de recursos

3.3. Instalación de la extensión y registro del espacio de nombres

3.4. Creación de una instancia de Azure Spring Apps

3.5. Creación de una aplicación en la instancia de Azure Spring Apps

3.2. Creación de una instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

4.1. Importación del proyecto

4.2. Compilación e implementación de la aplicación

5. Validación de la aplicación

6. Limpieza de recursos

7. Pasos siguientes

Recursos adicionales

Recursos adicionales

Inicio rápido: Implementación de la primera aplicación en Azure Spring Apps

1. Prerrequisitos

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.1. Inicio de sesión en Azure Portal

3.2. Creación de una instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.1. Inicio de sesión en Azure Portal

3.2. Creación de una instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

2. Preparar el proyecto Spring

3. Preparar el entorno en la nube

3.1. Proporcione nombres para cada recurso

3.2. Creación de un nuevo grupo de recursos

3.3. Instalación de la extensión y registro del espacio de nombres

3.4. Creación de una instancia de Azure Spring Apps

3.5. Creación de una aplicación en la instancia de Azure Spring Apps

4. Implementación de la aplicación en Azure Spring Apps

5. Validación de la aplicación

6. Limpieza de recursos

7. Pasos siguientes

Recursos adicionales

Recursos adicionales