Inicio rápido: Compilación e implementación de aplicaciones en Azure Spring Apps

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.

Este artículo se aplica a: ✔️ Nivel Básico o Estándar ❌ Nivel Enterprise

Esta guía de inicio rápido explica cómo se compilan e implementan aplicaciones de Spring en Azure Spring Apps mediante la CLI de Azure.

Requisitos previos

• Finalización de los inicios rápidos anteriores en esta serie:
  • Aprovisionamiento de una instancia de servicio de Azure Spring Apps.
  • Configuración del servidor de configuración de Azure Spring Apps.

Descarga de la aplicación de ejemplo

Siga los siguientes pasos para descargar la app de muestra. Si ha estado usando Azure Cloud Shell, cambie a un símbolo del sistema local.

1. Cree una carpeta y clone el repositorio de la aplicación de ejemplo.

   mkdir source-code
   

   cd source-code
   

   git clone https://github.com/Azure-Samples/azure-spring-apps-samples
   

2. Navegue al directorio del repositorio.

   cd azure-spring-apps-samples
   

Implementación de PlanetWeatherProvider

Siga estos pasos para implementar el proyecto PlanetWeatherProvider.

1. Cree una aplicación en la instancia de Azure Spring Apps para el proyecto PlanetWeatherProvider.

   az spring app create --name planet-weather-provider --runtime-version NetCore_31
   

   Para habilitar el registro automático de servicios, ha dado a la aplicación el mismo nombre que el valor de spring.application.name en el archivo appsettings.json del proyecto:

   "spring": {
     "application": {
       "name": "planet-weather-provider"
     }
   }
   

   La ejecución de este comando puede llevar varios minutos.

2. Cambie el directorio a la carpeta del proyecto PlanetWeatherProvider.

   cd steeltoe-sample/src/planet-weather-provider
   

3. Cree los archivos binarios y el archivo .zip que se va a implementar.

   dotnet publish -c release -o ./publish
   

   Sugerencia

   El archivo del proyecto contiene el siguiente código XML para empaquetar los archivos binarios en un archivo .zip después de escribirlos en la carpeta ./publish:

   <Target Name="Publish-Zip" AfterTargets="Publish">
     <ZipDirectory SourceDirectory="$(PublishDir)" DestinationFile="$(MSBuildProjectDirectory)/publish-deploy-planet.zip" Overwrite="true" />
   </Target>
   

4. Implemente el proyecto en Azure.

   Asegúrese de que el símbolo del sistema se encuentre en la carpeta del proyecto antes de ejecutar el siguiente comando.

   az spring app deploy \
       --name planet-weather-provider \
       --runtime-version NetCore_31 \
       --main-entry Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll \
       --artifact-path ./publish-deploy-planet.zip
   

   La opción --main-entry especifica la ruta de acceso relativa de la carpeta raíz del archivo .zip al archivo .dll que contiene el punto de entrada de la aplicación. Una vez que el servicio carga el archivo .zip, extrae todos los archivos y carpetas e intenta ejecutar el punto de entrada en el archivo .dll especificado.

   La ejecución de este comando puede llevar varios minutos.

Implementación de SolarSystemWeather

Siga estos pasos para implementar el proyecto SolarSystemWeather.

1. Cree otra aplicación en la instancia de Azure Spring Apps para el proyecto.

   az spring app create --name solar-system-weather --runtime-version NetCore_31
   

   solar-system-weather es el nombre que se especifica en el archivo appsettings.json del proyecto SolarSystemWeather.

   La ejecución de este comando puede llevar varios minutos.

2. Cambie el directorio al proyecto SolarSystemWeather.

   cd ../solar-system-weather
   

3. Cree los archivos binarios y el archivo .zip que se va a implementar.

   dotnet publish -c release -o ./publish
   

4. Implemente el proyecto en Azure.

   az spring app deploy \
       --name solar-system-weather \
       --runtime-version NetCore_31 \
       --main-entry Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll \
       --artifact-path ./publish-deploy-solar.zip
   

   La ejecución de este comando puede llevar varios minutos.

Asignación del punto de conexión público

Antes de probar la aplicación, obtenga un punto de conexión público para una solicitud HTTP GET a la aplicación solar-system-weather.

1. Ejecute el siguiente comando para asignar el punto de conexión.

   az spring app update --name solar-system-weather --assign-endpoint true
   

2. Ejecute el siguiente comando para obtener la dirección URL del punto de conexión.

   Windows:

   az spring app show --name solar-system-weather --output table
   

   Linux:

   az spring app show --name solar-system-weather | grep url
   

Prueba de la aplicación

Para probar la aplicación, envíe una solicitud GET a la aplicación solar-system-weather. En un explorador, vaya a la dirección URL pública con /weatherforecast anexado a esta. Por ejemplo: https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

El resultado JSON es:

[{"Key":"Mercury","Value":"very warm"},{"Key":"Venus","Value":"quite unpleasant"},{"Key":"Mars","Value":"very cool"},{"Key":"Saturn","Value":"a little bit sandy"}]

Esta respuesta muestra que las dos ambas aplicaciones de Spring funcionan. La aplicación SolarSystemWeather devuelve los datos recuperados de la aplicación PlanetWeatherProvider.

En este artículo se explica cómo compilar e implementar aplicaciones de Spring en Azure Spring Apps. Puede usar la CLI de Azure, el complemento Maven o Intellij. En este artículo se describe cada alternativa.

Requisitos previos

• Finalización de los inicios rápidos anteriores en esta serie:
  • Aprovisionamiento de una instancia de servicio de Azure Spring Apps.
  • Configuración del servidor de configuración de Azure Spring Apps.
• JDK 17
• Maven 3.0 o cualquier versión superior
• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita antes de empezar.
• Opcionalmente, la versión 2.45.0 o superior de la CLI de Azure . Instale la extensión de Azure Spring Apps, para lo cual debe usar el siguiente comando: az extension add --name spring
• Opcionalmente, el Azure Toolkit for IntelliJ.

CLI

Compilación local de las aplicaciones de Spring

Use los siguientes comandos para clonar el repositorio de ejemplo, vaya a la carpeta de ejemplo y, a continuación, compile el proyecto.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

La compilación del proyecto tarda aproximadamente entre 5 y 10 minutos. Cuando se compile su proyecto, debe tener archivos JAR individuales para cada servicio en sus respectivas carpetas.

Creación e implementación de aplicaciones en Azure Spring Apps

Siga estos pasos para crear e implementar aplicaciones en Azure Spring Apps mediante la CLI.

1. Si no ha ejecutado los siguientes comandos en los inicios rápidos anteriores, hágalo ahora para establecer los valores predeterminados de la CLI.

   az configure --defaults group=<resource-group-name> spring=<service-name>
   

2. Cree las dos aplicaciones de Spring principales para PetClinic: api-gateway y customers-service.

   az spring app create \
       --name api-gateway \
       --runtime-version Java_17 \
       --instance-count 1 \
       --memory 2Gi \
       --assign-endpoint
   az spring app create \
       --name customers-service \
       --runtime-version Java_17 \
       --instance-count 1 \
       --memory 2Gi
   

3. Implemente los archivos JAR creados en el paso anterior.

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/api-gateway-3.0.1.jar \
       --jvm-options="-Xms2048m -Xmx2048m"
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/customers-service-3.0.1.jar \
       --jvm-options="-Xms2048m -Xmx2048m"
   

4. Consulte el estado de la aplicación después de las implementaciones con el siguiente comando.

   az spring app list --output table
   

   Esto genera una salida similar a la del siguiente ejemplo:

   Name               Location    ResourceGroup    Production Deployment    Public Url                                           Provisioning Status    CPU    Memory    Running Instance    Registered Instance    Persistent Storage
   -----------------  ----------  ---------------  -----------------------  ---------------------------------------------------  ---------------------  -----  --------  ------------------  ---------------------  --------------------
   api-gateway        eastus      xxxxxx-sp         default                  https://<service name>-api-gateway.azuremicroservices.io   Succeeded              1      2         1/1                 1/1                    -
   customers-service  eastus      <service name>         default                                                                       Succeeded              1      2         1/1                 1/1                    -
   

Comprobación de los servicios

Acceda a api-gateway y customers-service desde un explorador con la dirección URL pública que se mostró anteriormente, en el formato de https://<service name>-api-gateway.azuremicroservices.io.

Sugerencia

Para solucionar los problemas de las implementaciones, puede usar el siguiente comando para obtener el streaming de registros en tiempo real cada vez que la aplicación ejecute az spring app logs --name <app name> --follow.

Implementación de aplicaciones adicionales

Para que la aplicación PetClinic funcione con todas las características como Servidor de administración, Visitas y Veterinarios, implemente las otras aplicaciones con los siguientes comandos:

az spring app create \
    --name admin-server \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name vets-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app create \
    --name visits-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app deploy \
    --name admin-server \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-admin-server/target/admin-server-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name vets-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-vets-service/target/vets-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name visits-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-visits-service/target/visits-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"

Maven

Compilación local de las aplicaciones de Spring

Use los siguientes comandos para clonar el repositorio de ejemplo, vaya a la carpeta de ejemplo y, a continuación, compile el proyecto.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

La compilación del proyecto tarda aproximadamente entre 5 y 10 minutos. Cuando se compile su proyecto, debe tener archivos JAR individuales para cada servicio en sus respectivas carpetas.

Generación de configuraciones e implementación en Azure Spring Apps

En los pasos siguientes se muestra cómo generar configuraciones e implementarlas en Azure Spring Apps:

1. Ir a la carpeta spring-petclinic-customers-service. Ejecute el siguiente comando para generar una configuración. Si ya inició sesión con la CLI de Azure, el comando tomará automáticamente las credenciales. Si no, se iniciará sesión mediante una solicitud con instrucciones. Para más información, consulte Autenticación en la wiki azure-maven-plugins.

   mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config -DappName=customers-service
   

   Se le pedirá que proporcione los siguientes valores:

   • Suscripción:: La suscripción que usó para crear una instancia de Azure Spring Apps.
   • Instancia de servicio:: El nombre de la instancia de Azure Spring Apps.
   • Punto de conexión público: Si se va a asignar un punto de conexión público a la aplicación. así que seleccione No.

2. Compruebe que los elementos appName de los archivos POM son correctos:

   <build>
       <plugins>
           <plugin>
               <groupId>com.microsoft.azure</groupId>
               <artifactId>azure-spring-apps-maven-plugin</artifactId>
               <version>1.17.0</version>
               <configuration>
                   <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId>
                   <clusterName>v-spr-cld</clusterName>
                   <appName>customers-service</appName>
   

   El archivo POM ahora contiene las dependencias y configuraciones del complemento.

3. Implemente las aplicaciones mediante el siguiente comando:

   mvn azure-spring-apps:deploy
   

4. Vaya a la carpeta spring-petclinic-api-gateway. Ejecute los comandos siguientes para generar la configuración e implementar api-gateway. Seleccione Sí para Punto de conexión público.

   mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config -DappName=api-gateway
   mvn azure-spring-apps:deploy
   

Comprobación de los servicios

Un comando de implementación correcto devuelve una dirección URL con el formato: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io. Úsela para ir al servicio en ejecución.

También puede navegar por el Azure Portal para buscar la dirección URL.

1. Vaya al servicio.
2. Seleccione Aplicaciones.
3. Seleccione api-gateway.
4. Busque la dirección URL en la página api-gateway | Información general.

Implementación de aplicaciones adicionales

Para que la aplicación PetClinic funcione con todas las secciones como Servidor de administración, Visitas y Veterinarios, puede implementar los otras aplicaciones de Spring. Vuelva a ejecutar el comando de configuración y seleccione las siguientes aplicaciones.

• admin-server
• vets-service
• visits-service

Corrija los nombres de la aplicación en cada archivo pom.xml en los módulos anteriores y, a continuación, vuelva a ejecutar el comando deploy.

IntelliJ

Importación del proyecto de ejemplo en IntelliJ

Siga estos pasos para importar el proyecto de ejemplo en IntelliJ.

1. Descargue y descomprima el repositorio de origen de este tutorial o clónelo con Git: git clone https://github.com/azure-samples/spring-petclinic-microservices.

2. Abra el cuadro de diálogo de Bienvenida de IntelliJ y seleccione Import Project (Importar proyecto) para abrir el asistente para importar.

3. Seleccione la carpeta spring-petclinic-microservices.

   

Implementación de la aplicación api-gateway en Azure Spring Apps

Para realizar la implementación en Azure, debe iniciar sesión con su cuenta de Azure con Azure Toolkit for IntelliJ y elegir su suscripción. Para más información sobre el inicio de sesión, consulte Creación de una aplicación web Hola mundo para Azure App Service mediante IntelliJ.

1. Vaya al explorador de proyectos de IntelliJ, haga clic con el botón derecho en el proyecto y seleccione Azure ->Implementar en Azure Spring Apps.

   

2. En el campo Nombre, anexe :api-gateway al Nombre existente.

3. En el cuadro de texto Artefacto, seleccione spring-petclinic-api-gateway-3.0.1.

4. En el cuadro de texto Suscripción, compruebe su suscripción.

5. En el cuadro de texto Spring Apps, seleccione la instancia de Azure Spring Apps que creó en el artículo sobre el aprovisionamiento de una instancia de Azure Spring Apps.

6. En el cuadro de texto Aplicación: , seleccione Crear aplicación... .

7. Escriba api-gateway y, a continuación, seleccione Aceptar.

8. En Punto de conexión público, seleccione Habilitar.

9. Establezca las opcionesMemoria en 2.0Gi y opciones de JVM en -Xms2048m -Xmx2048m.

   

10. En la sección Before launch (Antes del inicio) del cuadro de diálogo, haga doble clic en Run Maven Goal (Ejecutar objetivo de Maven).

11. En el cuadro de texto Directorio de trabajo, vaya a la carpeta spring-petclinic-microservices/spring-petclinic-api-gateway.

12. En el cuadro de texto Command line (Línea de comandos), escriba package -DskipTests. Seleccione Aceptar.

    

13. Para iniciar la implementación, seleccione el botón Ejecutar en la parte inferior del cuadro de diálogo Implementar una aplicación de Azure Spring Apps. El complemento ejecuta el comando mvn package en la aplicación api-gateway e implementa el archivo JAR generado por el comando package.

Implementación de customers-service y de otras aplicaciones en Azure Spring Apps

Repita los pasos anteriores para implementar customers-service y las demás aplicaciones de Pet Clinic en Azure Spring Apps:

1. Modifique los valores de Nombre y Artefacto para identificar la aplicación customers-service.
2. En el cuadro de texto Aplicación: , seleccione Crear aplicación... para crear la aplicación customers-service.
3. Compruebe que en la opción Punto de conexión público se ha seleccionado Deshabilitado.
4. En la sección Before launch (Antes del inicio) del cuadro de diálogo, cambie el valor de Working directory (Directorio de trabajo) a la carpeta petclinic/customers-service.
5. Para iniciar la implementación, seleccione el botón Ejecutar en la parte inferior del cuadro de diálogo Implementar una aplicación de Azure Spring Apps.

Comprobación de los servicios

Vaya a la dirección URL con el formato: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io

También puede navegar por el Azure Portal para buscar la dirección URL.

1. Vaya al servicio.
2. Seleccione Aplicaciones.
3. Seleccione api-gateway.
4. Busque la dirección URL en la página api-gateway | Información general.

Implementación de aplicaciones adicionales

Otras aplicaciones de Spring que se incluyen en este ejemplo se pueden implementar de forma similar.

• admin-server
• vets-service
• visits-service

Limpieza de recursos

Si planea seguir trabajando en otros inicios rápidos y tutoriales, considere la posibilidad de dejar estos recursos activos. Cuando ya no lo necesite, elimine el grupo de recursos, que elimina los recursos que contiene. Para eliminar el grupo de recursos mediante la CLI de Azure, use estos comandos:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Pasos siguientes

Inicio rápido: Configuración de un área de trabajo de Log Analytics