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

• 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, cree una cuenta gratuita antes de empezar.
• Git.
• Kit de desarrollo de Java (JDK), versión 17.
• Azure Developer CLI, versión 1.2.0 o posterior.

• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita 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.
• (Opcional) Git.
• (Opcional) Kit de desarrollo de Java (JDK), versión 17.

• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita 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.
• (Opcional) Kit de desarrollo de Java (JDK), versión 17.
• (Opcional) Node.js, versión 16.20 o posterior.
• CLI de Azure, versión 2.45.0 o superior.

• Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita 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.55.0 o superior.

Siga los pasos que se indican a continuación para preparar el ejemplo en el sistema local:

1. Clone el proyecto de ejemplo mediante el siguiente comando:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Vaya al directorio raíz del proyecto y, a continuación, use el siguiente comando para ejecutar el proyecto de ejemplo localmente:

   bash ./scripts/run_all_without_infra.sh
   

3. Una vez completado correctamente el script, vaya a http://localhost:8080 en el explorador para acceder a la aplicación Pet Clinic.

Siga estos pasos para inicializar la aplicación Pet Clinic mediante plantillas de Azure Developer CLI:

1. En la ventana de Bash, cree una carpeta vacía y, a continuación, vaya a esta.

2. Use el comando siguiente para inicializar el proyecto:

   azd init --template Azure-Samples/spring-petclinic-microservices
   

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

   • Escriba un nuevo nombre de entorno: proporcione un nombre de entorno que se use como sufijo para que el grupo de recursos que se crea para contener 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)
   
   Downloading template code to: <your-local-path>
   (✓) Done: Initialized git repository
   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.1. Inicio de sesión en Azure Portal

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:

1. En la esquina de Azure Portal, seleccione Crear un recurso.

2. En la pestaña Servicios de Azure, seleccione Proceso>Azure Spring Apps.

   

3. En la página Crear Azure Spring Apps, rellene el formulario en la pestaña Aspectos básicos.

   

   Use la tabla siguiente como guía para completar el formulario. El plan recomendado es Estándar.

   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 quiera 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 la instancia 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 determina los recursos y el coste asociados a la instancia.
   Región	La región más cercana a los usuarios.	La ubicación más cercana a los usuarios.
   Redundancia de zona	No seleccionado	Crea el servicio Azure Spring Apps en una zona de disponibilidad de Azure. Actualmente no se admite en todas las regiones.

4. Vaya a la pestaña Configuración de diagnósticos de la página Crear Azure Spring Apps y seleccione Crear nuevo para crear una nueva instancia de áreas de trabajo de Log Analytics. En la página Crear nueva área de trabajo de Log Analytics, actualice el nombre del área de trabajo de Log Analytics según sea necesario y, a continuación, seleccione Aceptar para confirmar la creación.

   

5. Vaya a la pestaña Application Insights de la página Crear Azure Spring Apps y, a continuación, seleccione Crear nuevo para crear una nueva instancia de Application Insights. En la página Crear nuevo recurso de Application Insights, actualice el nombre de Application Insights según sea necesario, seleccione Basado en área de trabajo para Modo de recurso y, a continuación, seleccione Aceptar para confirmar la creación.

   

6. Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para aprovisionar la instancia de Azure Spring Apps.

7. Seleccione el icono 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 acceso directo en el panel de Azure Portal a la página Información general del servicio.

   

8. Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.

9. Seleccione Config Server en el panel de navegación.

10. En la página Config Server, para URI, escriba https://github.com/Azure-Samples/spring-petclinic-microservices-config.gity seleccione Validar.

    

11. Después de la validación, seleccione Aplicar para finalizar la configuración de Config Server.

Siga estos pasos para crear los recursos necesarios:

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

2. 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 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> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Nota

   Esta operación puede tardar un tiempo en completarse. Se muestra un indicador de progreso a medida que aprovisiona recursos de Azure.

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

1. Vaya al directorio del proyecto de ejemplo y, a continuación, use el siguiente comando para configurar las aplicaciones para Azure Spring Apps:

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

2. En la lista siguiente se describen las interacciones del comando:

   • Seleccione módulos secundarios para configurar (números de entrada separados por comas, por ejemplo: [1-2,4,6]; ENTRAR para seleccionar TODO): presione Entrar para seleccionar todo.
   • 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.
   • Seleccione las aplicaciones para exponer el acceso público: (números de entrada separados por comas, por ejemplo: [1-2,4,6]; ENTRAR para seleccionar NINGUNO): escriba 1,5 para admin-server y api-gateway.
   • Confirme para guardar todas las configuraciones anteriores (Y/N): presione y. Si presiona n, la configuración no se guardará en los archivos POM.

3. Use el siguiente comando para compilar e implementar cada aplicación:

   ./mvnw azure-spring-apps:deploy
   

4. Para la solicitud Inicio de sesión de OAuth2, autorice el inicio de sesión a Azure en función del protocolo OAuth2.

   Nota

   La implementación en Azure Spring Apps podría tardar hasta 25 minutos.

Una vez ejecutado el comando, un registro mostrará una salida similar al ejemplo siguiente, que indica que todas las implementaciones se realizaron correctamente:

[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO]   InstanceName:admin-server-default-xx-xx-xxx  Status:Running Reason:null       DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io

...

[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.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:

1. 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 minutes xx seconds.
   

2. 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 admin-server
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
   
   (✓) Done: Deploying service api-gateway
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
   
   (✓) Done: Deploying service customers-service
   - No endpoints were found
   
   (✓) Done: Deploying service vets-service
   - No endpoints were found
   
   (✓) Done: Deploying service visits-service
   - No endpoints were found
   
   
   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
   

El botón Implementar en Azure de la sección siguiente inicia una experiencia de Azure Portal que implementa el código fuente desde el repositorio Spring PetClinic. No se necesitan pasos de preparación locales.

Siga estos pasos en el equipo local cuando quiera comprobar la aplicación antes de implementarla en la nube:

1. Use el comando siguiente para clonar la aplicación Pet Clinic desde GitHub:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Vaya al directorio raíz del proyecto y, a continuación, use el siguiente comando para compilar el proyecto:

   ./mvnw clean package -DskipTests
   

Siga estos pasos si desea ejecutar la aplicación localmente. De lo contrario, puede omitir estos pasos.

1. Abra una nueva ventana de Bash y, a continuación, use el siguiente comando para iniciar Config Server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Abra una nueva ventana de Bash y, a continuación, use el siguiente comando para iniciar el Servidor de detección:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Para los servicios Clientes, Veterinarios, Visitas y Spring Cloud Gateway, abra una nueva ventana de Bash y utilice los siguientes comandos para iniciar los servicios:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Abra una nueva ventana de Bash y vaya al directorio del proyecto spring-petclinic-frontend. Use los siguientes comandos para instalar dependencias y ejecutar la aplicación de front-end:

   npm install
   npm run start
   

5. Una vez completado correctamente el script, vaya a http://localhost:8080 en el explorador para acceder a la aplicación Pet Clinic.

Siga estos pasos en el equipo local cuando quiera comprobar la aplicación antes de implementarla en la nube:

1. Use el comando siguiente para clonar la aplicación Pet Clinic desde GitHub:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Vaya al directorio raíz del proyecto y, a continuación, use el siguiente comando para compilar el proyecto:

   ./mvnw clean package -DskipTests
   

Siga estos pasos si desea ejecutar la aplicación localmente. De lo contrario, puede omitir estos pasos.

1. Abra una nueva ventana de Bash y, a continuación, use el siguiente comando para iniciar Config Server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Abra una nueva ventana de Bash y, a continuación, use el siguiente comando para iniciar el Servidor de detección:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. Para los servicios Clientes, Veterinarios, Visitas y Spring Cloud Gateway, abra una nueva ventana de Bash y utilice los siguientes comandos para iniciar los servicios:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

4. Abra una nueva ventana de Bash y vaya al directorio del proyecto spring-petclinic-frontend. Use los siguientes comandos para instalar dependencias y ejecutar la aplicación de front-end:

   npm install
   npm run start
   

5. Una vez completado correctamente el script, vaya a http://localhost:8080 en el explorador para acceder a la aplicación Pet Clinic.

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, escriba sus credenciales e inicie 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:

1. Seleccione el botón Implementar en Azure para iniciar la experiencia de implementación en Azure Portal:

   

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

   

3. Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para implementar la aplicación en Azure Spring Apps.

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

1. En la esquina de Azure Portal, seleccione Crear un recurso.

2. Seleccione Proceso>Azure Spring Apps.

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

4. Vaya a la pestaña Configuración de diagnósticos de la página Crear Azure Spring Apps y seleccione Crear nuevo para crear una nueva instancia de áreas de trabajo de Log Analytics. En la página Crear nueva área de trabajo de Log Analytics, actualice el nombre del área de trabajo de Log Analytics según sea necesario y, a continuación, seleccione Aceptar para confirmar la creación.

5. Vaya a la pestaña Application Insights de la página Crear Azure Spring Apps y, a continuación, seleccione Crear nuevo para crear una nueva instancia de Application Insights. En la página Crear nuevo recurso de Application Insights, actualice el nombre de Application Insights según sea necesario, seleccione Basado en área de trabajo para Modo de recurso y, a continuación, seleccione Aceptar para confirmar la creación.

6. Seleccione Revisar y crear para revisar las selecciones. A continuación, seleccione Crear para aprovisionar la instancia de Azure Spring Apps.

7. Seleccione el icono 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 acceso directo en el panel de Azure Portal a la página Información general del servicio.

   

8. Seleccione Ir al recurso para ir a la página Información general de Azure Spring Apps.

3.3. Configurar la instancia de Azure Spring Apps

En las secciones siguientes se muestra cómo configurar la instancia de servicio.

Crear las aplicaciones

Siga estos pasos para crear las aplicaciones:

1. En el panel de navegación, seleccione Aplicaciones y seleccione Crear aplicación.

2. En la página Crear aplicación, para el Nombre de la aplicación, use front-end y deje todos los demás campos con sus valores predeterminados.

3. Repita el paso anterior con cada uno de los siguientes nombres de aplicación:

   • customers-service
   • vets-service
   • visits-service

4. Seleccione Crear para finalizar la creación de la aplicación.

   

Configurar el Registro del servicio

Siga estos pasos para configurar el Registro del servicio:

1. En el panel de navegación, seleccione Registro del servicio.

2. Seleccione Enlace de aplicaciones, seleccione Enlazar aplicación, seleccione customers-service en la lista y, a continuación, seleccione Aplicar.

3. Repita el paso anterior para enlazar las siguientes aplicaciones:

   • vets-service
   • visits-service

   

Configurar el Servicio de configuración de aplicaciones

Siga estos pasos para configurar Application Configuration Service:

1. En el panel de navegación, seleccione Servicio de configuración de aplicaciones y, a continuación, seleccione Configuración.

2. Rellene el repositorio con la siguiente información y seleccione Validar:

   • Nombre: predeterminado
   • Patrones: application,api-gateway,customers-service,vets-service,visits-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config.git.
   • Etiqueta: maestro

   

3. Después de la validación, seleccione Aplicar para finalizar la configuración del Servicio de configuración de aplicaciones.

4. Seleccione Enlace de aplicaciones, seleccione Enlazar aplicación, seleccione customers-service en la lista y, a continuación, seleccione Aplicar.

5. Repita el paso anterior para enlazar las siguientes aplicaciones:

   • vets-service
   • visits-service

   

Establecer los patrones de archivo de configuración para las aplicaciones

Siga estos pasos para establecer los patrones de archivo de configuración:

1. En el panel de navegación, seleccione Aplicaciones y, a continuación, seleccione la aplicación customers-service.

2. En la página Información general de aplicación, seleccione Configuración, seleccione Patrones de archivo de configuración en la pestaña Configuración general y, a continuación, seleccione aplicación y customers-service. Seleccione Guardar para establecer los patrones de archivo de configuración.

3. Repita el paso anterior para guardar los patrones de archivo de configuración para las siguientes aplicaciones:

   • vets-service: seleccione aplicación y vets-service.
   • visits-service: seleccione aplicación y visits-service.

Configuración de Spring Cloud Gateway

En esta sección se muestra cómo configurar Spring Cloud Gateway.

En primer lugar, siga estos pasos para asignar un punto de conexión para el acceso a la puerta de enlace:

1. En el panel de navegación, seleccione Spring Cloud Gateway.

2. En la pestaña Información general, seleccione Sí para asignar un punto de conexión. Guarde la dirección URL del punto de conexión para usarla más adelante.

A continuación, configure el enrutamiento de Spring Cloud Gateway. Dado que Azure Portal no admite actualmente la configuración de rutas para Spring Cloud Gateway, abra una ventana de Bash y use los siguientes pasos de la CLI de Azure para configurar el enrutamiento:

1. Use el siguiente comando para iniciar sesión en la CLI de Azure:

   az login
   

2. 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. Use el siguiente comando para aceptar los términos legales y las declaraciones de privacidad:

   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
   

4. 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 SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

5. Use el siguiente comando para establecer la suscripción predeterminada:

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. Use el siguiente comando para establecer el enrutamiento de la aplicación customers-service:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. Use el siguiente comando para establecer el enrutamiento de la aplicación vets-service:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. Use el siguiente comando para establecer el enrutamiento de la aplicación visits-service:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

9. Use el siguiente comando para establecer el enrutamiento de la aplicación de front-end:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Configurar Herramientas de desarrollo

Siga estos pasos para configurar las Herramientas de desarrollo.

1. En el panel de navegación, seleccione Herramientas de desarrollo.

2. Seleccione Asignar punto de conexión para asignar un punto de conexión para Herramientas de desarrollo.

3. Guarde el punto de conexión de App Live View para usarlo más adelante.

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=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Inicio de sesión en la CLI de Azure

Siga estos pasos para iniciar sesión:

1. Use el siguiente comando para iniciar sesión en la CLI de Azure:

   az login
   

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

3. Use el siguiente comando para establecer la suscripción predeterminada:

   az account set --subscription <subscription-ID>
   

3.3. Creación de un nuevo grupo de recursos

Use los siguientes pasos para crear un grupo de recursos:

1. Use el siguiente comando para establecer la ubicación predeterminada:

   az configure --defaults location=${LOCATION}
   

2. Use el siguiente comando para crear un grupo de recursos:

   az group create --resource-group ${RESOURCE_GROUP}
   

3. 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.4. 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.5. Creación de una instancia de Azure Spring Apps

Siga estos pasos para crear la instancia de servicio:

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

2. Use el siguiente comando para crear una instancia del servicio Azure Spring Apps con los componentes de Tanzu necesarios:

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Configuración de la instancia de Azure Spring Apps

Siga estos pasos para configurar la instancia de servicio:

1. Use el siguiente comando para establecer la configuración de diagnóstico de la instancia de Azure Spring Apps:

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

2. Use los siguientes comandos para crear aplicaciones para la instancia de Azure Spring Apps:

   az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
   az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
   az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
   

3. Use los siguientes comandos para enlazar aplicaciones para el Registro de servicios:

   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
   az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
   

4. Use el siguiente comando para crear un repositorio de configuración para Application Configuration Service:

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

5. Use el siguiente comando para crear un repositorio de configuración para Application Configuration Service:

   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_CUSTOMERS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VETS_SERVICE}
   az spring application-configuration-service bind \
       --service ${SPRING_APPS} \
       --app ${APP_VISITS_SERVICE}
   

6. Use el siguiente comando para asignar un punto de conexión a Spring Cloud Gateway:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. Use el siguiente comando para establecer el enrutamiento de la aplicación customers-service:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. Use el siguiente comando para establecer el enrutamiento de la aplicación vets-service:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. Use el siguiente comando para establecer el enrutamiento de la aplicación visits-service:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

10. Use el siguiente comando para establecer el enrutamiento de la aplicación frontend:

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

11. Use el siguiente comando para asignar un punto de conexión a Application Live View:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

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.

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

1. Vaya al directorio raíz del proyecto y ejecute el siguiente comando para configurar las aplicaciones en Azure Spring Apps:

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   En la lista siguiente se describen las interacciones del comando:

   • Seleccione los módulos secundarios para configurar: presione Entrar para seleccionar todos.
   • 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 las aplicaciones para exponer el acceso público: presione Entrar para seleccionar ninguno.
   • Confirmar para guardar todas las configuraciones anteriores: presione y. Si presiona n, la configuración no se guardará en los archivos POM.

2. Use el siguiente comando para implementar las aplicaciones de back-end:

   ./mvnw azure-spring-apps:deploy
   

   Una vez ejecutado el comando, puede ver en los siguientes mensajes de registro que la implementación se ha realizado correctamente:

   [INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
   [INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
   [INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   
   ...
   
   [INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
   [INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

3. Azure Portal no admite la implementación de las aplicaciones de front-end, por lo que use el siguiente comando de la CLI de Azure para implementar la aplicación de front-end:

   az spring app deploy \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --source-path spring-petclinic-frontend \
       --build-env BP_WEB_SERVER=nginx
   

   Una vez ejecutado el comando, puede ver en los siguientes mensajes de registro que la implementación se ha realizado correctamente:

   [5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
   Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
   The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
   Your application is successfully deployed.
   

Siga estos pasos para implementar las aplicaciones:

1. Escriba el directorio raíz del proyecto y use el siguiente comando para compilar e implementar la aplicación de front-end:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_FRONTEND} \
       --build-env BP_WEB_SERVER=nginx \
       --source-path ./spring-petclinic-frontend
   

2. Use el siguiente comando para desarrollar e implementar la aplicación de customers-service:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

3. Use el siguiente comando para desarrollar e implementar la aplicación de vets-service:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. Use el siguiente comando para desarrollar e implementar la aplicación de visits-service:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5.1. Acceso a las aplicaciones

Una vez finalizada la implementación, puede encontrar la dirección URL de Spring Cloud Gateway en las salidas de implementación, como se muestra en la captura de pantalla siguiente:

Abra la dirección URL de la puerta de enlace. La aplicación debería ser similar a la captura de pantalla siguiente:

5.2. Consulta de los registros de la aplicación

Después de examinar cada función de Pet Clinic, el área de trabajo de Log Analytics recopila registros de cada aplicación. Es posible comprobar los registros mediante consultas personalizadas, tal y como se muestra en la captura de pantalla siguiente:

5.3. Supervisión de las aplicaciones

Application Insights supervisa las dependencias de las aplicaciones, tal y como se muestra en la siguiente asignación de seguimiento de aplicaciones:

Puede encontrar la URL de Application Live View en los resultados de la implementación. Abra la dirección URL de Application Live View para supervisar los runtimes de la aplicación, como se muestra en la captura de pantalla siguiente:

5.1. Acceso a las aplicaciones

Use el punto de conexión asignado desde Spring Cloud Gateway (por ejemplo, https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.io). La aplicación debería ser similar a la captura de pantalla siguiente:

5.2. Consulta de los registros de la aplicación

Después de examinar cada función de Pet Clinic, el área de trabajo de Log Analytics recopila registros de cada aplicación. Es posible comprobar los registros mediante consultas personalizadas, tal y como se muestra en la captura de pantalla siguiente:

5.3. Supervisión de las aplicaciones

Application Insights supervisa las dependencias de las aplicaciones, tal y como se muestra en la siguiente asignación de seguimiento de aplicaciones:

Abra la dirección URL de Application Live View expuesta por las Herramientas de desarrollo para supervisar los runtimes de la aplicación, como se muestra en la captura de pantalla siguiente:

5.1. Acceso a las aplicaciones

Use los siguientes comandos para recuperar la dirección URL de la puerta de enlace de Spring Cloud:

export GATEWAY_URL=$(az spring gateway show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${GATEWAY_URL}"

La aplicación debería ser similar a la captura de pantalla siguiente:

5.2. Consulta de los registros de la aplicación

Después de examinar cada función de Pet Clinic, el área de trabajo de Log Analytics recopila registros de cada aplicación. Es posible comprobar los registros mediante consultas personalizadas, tal y como se muestra en la captura de pantalla siguiente:

5.3. Supervisión de las aplicaciones

Application Insights supervisa las dependencias de las aplicaciones, tal y como se muestra en la siguiente asignación de seguimiento de aplicaciones:

Use los siguientes comandos para recuperar la dirección URL de Application Live View:

export DEV_TOOL_URL=$(az spring dev-tool show \
    --service ${SPRING_APPS} \
    --query properties.url \
    --output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"

Abra la dirección URL de Application Live View para supervisar los runtimes de la aplicación, como se muestra en la captura de pantalla siguiente:

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

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

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

Siga estos pasos para eliminar todo el grupo de recursos:

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

2. 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 estos pasos para eliminar todo el grupo de recursos:

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

2. 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 comando siguiente para eliminar el grupo de recursos:

az group delete --name ${RESOURCE_GROUP}