Compartir vía


Migrar una instancia de plan Básico o Estándar de Azure Spring Apps al plan Enterprise

Nota:

Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.

Este artículo se aplica a:✅ Básico/Estándar ✅ Enterprise

En este artículo se muestra cómo migrar una aplicación existente en el plan Básico o Estándar al plan Enterprise. Al migrar desde el plan Básico o Estándar al plan Enterprise, los componentes de VMware Tanzu reemplazan los componentes de Spring Cloud de software de código abierto (OSS) para proporcionar más compatibilidad con características.

En este artículo se usan las aplicaciones de ejemplo de Pet Clinic como ejemplos de cómo migrar.

Requisitos previos

  • Suscripción a Azure. Si no tiene una suscripción, cree una cuenta gratuita antes de empezar.
  • CLI de Azure: versión 2.45.0 o superior.
  • La extensión del plan Enterprise de Azure Spring Apps. Use el siguiente comando para eliminar las versiones anteriores e instalar la extensión del plan Enterprise más reciente. Si ya ha instalado la extensión spring-cloud, desinstálela para evitar errores de coincidencia de la configuración y la versión.
    az extension add --upgrade --name spring
    az extension remove --name spring-cloud
    
  • Git.

Aprovisionar una instancia de servicio

En el plan de Azure Spring Apps Enterprise, los componentes de VMware Tanzu reemplazan los componentes de OSS Spring Cloud para proporcionar más compatibilidad con características. Los componentes de Tanzu se habilitan a petición según las necesidades. Debe habilitar los componentes que necesita antes de crear la instancia de servicio de Azure Spring Apps.

Nota:

Para usar los componentes de Tanzu debe habilitarlos al aprovisionar la instancia de servicio de Azure Spring Apps. No se pueden habilitar después del aprovisionamiento.

Siga estos pasos para aprovisionar una instancia de servicio de Azure Spring Apps:

  1. Abra Azure Portal.

  2. En el cuadro de búsqueda superior, busque Azure Spring Apps.

  3. Seleccione Azure Spring Apps en los resultados y a continuación, seleccione Crear.

  4. En la páginaCrear Azure Spring Apps, establezca la Suscripción, elGrupo de recursos y el Nombre para la instancia.

  5. En Plan en Detalles del servicio, seleccione Cambiar.

    Recorte de pantalla de la página de creación de Azure Spring Apps de Azure Portal con el botón Cambiar resaltado en la sección plan.

  6. En la página Elegir el plan, seleccione la fila Enterprise de la tabla y a continuación, seleccione Seleccionar.

    Recorte de pantalla de la página de creación de Azure Spring Apps de Azure Portal con la sección Aspectos básicos y el panel

  7. De nuevo en la página Crear Azure Spring Apps, seleccione Términos para aceptar los términos legales y las declaraciones de privacidad de la oferta del plan Enterprise en Azure Marketplace.

  8. Seleccione Siguiente: configuración de VMware Tanzu.

  9. En la pestaña Configuración de VMWare Tanzu, desplácese por la lista para revisar los componentes de Tanzu. Todos los componentes están habilitados de manera predeterminada.

    Recorte de pantalla de la página de creación de Azure Spring Apps de Azure Portal con la sección Configuración de Tanzu de V M Mware que se muestra.

    Nota:

    Considere con atención los componentes de Tanzu que desea usar o habilitar durante la fase de aprovisionamiento. Después de aprovisionar la instancia de Azure Spring Apps, no puede habilitar ni deshabilitar los componentes de Tanzu.

  10. Seleccione la pestaña Application Insights y después, seleccione Habilitar Application Insights. Revise la siguiente configuración:

    • Debe seleccionar Habilitar Application Insights.
    • Elija una instancia de Application Insights existente o cree una.
    • Escriba una frecuencia de muestreo en el intervalo de 0 a 100 o use el valor predeterminado 10.

    Application Insights también se puede habilitar después de aprovisionar la instancia de Azure Spring Apps. Para más información acerca de los precios de Application Insights, consulte la secciónFacturación de Application Insights de Cálculos de costes y opciones de Azure Monitor Logs.

    Nota:

    Habrá que pagar por el uso de Application Insights cuando esté integrado en Azure Spring Apps.

  11. Seleccione Revisar y crear y espere a que se complete la validación; a continuación, seleccione Crear para iniciar el aprovisionamiento de la instancia de servicio.

El aprovisionamiento de recursos tarda unos aproximadamente 5 minutos en finalizar.

Creación y configuración de aplicaciones

Los pasos de creación de la aplicación son los mismos que el plan Estándar.

  1. Use el siguiente comando para establecer los valores predeterminados de la CLI de Azure. Asegúrese de reemplazar los marcadores de posición por sus propios valores.

    az config set defaults.group=<resource-group-name>
    az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
    
  2. Use los siguientes comandos para crear las dos aplicaciones principales para PetClinic, api-gateway y customers-service:

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

Uso de Application Configuration Service para la configuración externa

Para la configuración externalizada en un sistema distribuido, El servidor de configuración de Spring Cloud administrado (OSS) solo está disponible en los planes Básico y Estándar. En el plan Enterprise, Application Configuration Service para Tanzu proporciona funciones similares para sus aplicaciones. En la tabla siguiente se describen algunas diferencias de uso entre el servidor de configuración del sistema operativo (SSO) y el servicio de configuración de aplicaciones.

Componente Planes de soporte técnico habilitado Enlace a la aplicación Perfil
Spring Cloud Config Server Básico o Estándar Siempre habilitado. Enlazado automático Configurado en el código fuente de la aplicación.
Servicio de configuración de aplicaciones para Tanzu Empresa Habilitación bajo demanda. Enlace manual Se proporciona como config-file-pattern en una implementación de Azure Spring Apps.

A diferencia del modo cliente-servidor del servidor de configuración del sistema operativo (OSS), el servicio de configuración de aplicaciones administra la configuración usando el Kubernetes nativo ConfigMap, que se rellena a partir de las propiedades definidas en los repositorios Git del backend. El servicio de configuración de aplicaciones no puede configurar el perfil activo en el código fuente de la aplicación para que coincida con la configuración correcta, por lo que la configuración explícita config-file-pattern debe especificarse en el nivel de implementación de Azure Spring Apps.

Configuración del servicio de configuración de aplicaciones para Tanzu

Siga estos pasos para usar Application Configuration Service para Tanzu como servicio de configuración centralizado.

  1. En la instancia de Azure Spring Apps Enterprise, seleccione Servicio de configuración de aplicaciones en el panel de navegación. Vea el estado de ejecución y los recursos asignados al servicio de configuración de aplicaciones para Tanzu.

    Recorte de pantalla de Azure Portal que muestra la pestaña Información general de la página Servicio de configuración de aplicaciones.

  2. Seleccione Configuración y complete el formulario en Repositorios para agregar una nueva entrada con la siguiente información:

    • Nombre: default
    • Patrones: api-gateway,customers-service
    • Identificador URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
    • Etiqueta: master

    Recorte de pantalla de Azure Portal en la que se muestra la pestaña Configuración de la página Servicio de configuración de aplicaciones.

  3. Seleccione Validar para validar el acceso al URI de destino.

  4. Una vez completada correctamente la validación, seleccione Aplicar para actualizar los valores de configuración.

Enlace de aplicaciones al servicio de configuración de aplicaciones para Tanzu

Al usar Application Configuration Service para Tanzu con un back-end de Git, debe enlazar la aplicación a Application Configuration Service para Tanzu. Después de enlazar la aplicación, deberá configurar qué patrón usa la aplicación. Siga estos pasos para enlazar y configurar el patrón de la aplicación.

Siga estos pasos para enlazar aplicaciones a Application Configuration Service para VMware Tanzu.

  1. En la instancia de Azure Spring Apps Enterprise, seleccione Servicio de configuración de aplicaciones en el panel de navegación.

  2. Seleccione Enlace de aplicaciones y, a continuación, seleccione Enlazar aplicación.

    Recorte de pantalla de Azure Portal que muestra la pestaña Enlace de aplicaciones de la página Servicio de configuración de aplicaciones y el menú desplegable Enlazar aplicación que se muestra.

  3. Seleccione una aplicación en el menú desplegable y a continuación, seleccione Aplicar para enlazar la aplicación al servicio de configuración de aplicaciones para Tanzu.

Para más información, consulte Uso de Application Configuration Service para Tanzu.

Uso de Service Registry for Tanzu

Tanzu Service Registry es uno de los componentes comerciales de VMware Tanzu. Proporciona las aplicaciones con una implementación del patrón Detección de servicios, uno de los conceptos clave de una arquitectura basada en microservicios. En el plan Enterprise, Service Registry para Tanzu proporciona el registro de servicio y detecta compatibilidad con las aplicaciones. Managed Spring Cloud Eureka solo está disponible en el plan Básico y Estándar y no está disponible en el plan Enterprise.

Componente Plan Estándar Plan Enterprise
Registro del servicio OSS eureka
Enlazado automático (siempre inyección)
Siempre aprovisionado
Service Registry for Tanzu
Necesita enlace manual a la aplicación
Habilitación a petición

Enlace de una aplicación a Tanzu Service Registry

Para enlazar aplicaciones a Application Configuration Service para VMware Tanzu, siga estos pasos.

  1. En la instancia de Azure Spring Apps Enterprise, seleccione Registro de servicio.

  2. Seleccione Enlace de aplicaciones. Las aplicaciones enlazadas aparecen actualmente en Nombre de aplicación.

  3. Seleccione Enlazar aplicación.

  4. Seleccione una aplicación en el menú desplegable y a continuación, seleccione Aplicar para enlazar la aplicación a Tanzu Service Registry.

    Recorte de pantalla de la página Azure Spring Apps de Azure Portal con el Registro de servicio y el cuadro de diálogo

Nota:

Al cambiar el estado entre enlazado y desenlazado, debe reiniciar o volver a implementar la aplicación para que el cambio surta efecto.

Para más información, consulte Uso de Tanzu Service Registry.

Compilación e implementación de aplicaciones

En el plan Enterprise, el servicio de compilación de Tanzu se usa para compilar aplicaciones. Proporciona más características de tipo las aplicaciones políglotas para implementar desde artefactos, como código fuente y archivos ZIP.

Para usar Tanzu Build Service, debe especificar un recurso para que usen la tarea de compilación y el compilador. También puede especificar el parámetro --build-env para establecer entornos de compilación.

Si la aplicación se enlaza con el servicio de configuración de aplicaciones para Tanzu, debe especificar un argumento adicional —config-file-pattern.

Para obtener más información, vea Usar el servicio de compilación de Tanzu.

Compilación de aplicaciones localmente

Siga estos pasos para compilar localmente:

  1. Use los siguientes comandos para clonar el repositorio de aplicaciones de ejemplo en la cuenta de Azure, cambiar el directorio y compilar el proyecto:

    git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
    cd spring-petclinic-microservices
    mvn clean package -DskipTests
    

    La compilación del proyecto puede tardar varios minutos. Cuando haya finalizado, tendrá archivos JAR individuales para cada servicio en su carpeta respectiva.

  2. Use los siguientes comandos para implementar los archivos JAR integrados en el paso anterior:

    az spring app deploy \
        --name api-gateway \
        --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
        --config-file-patterns api-gateway
    az spring app deploy \
        --name customers-service \
        --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
        --config-file-patterns customers-service
    
  3. Use el comando siguiente para consultar el estado de la aplicación después de la implementación:

    az spring app list --output table
    

    Esto genera una salida similar a la del siguiente ejemplo:

    Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
    --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
    api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
    customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
    

Uso de Application Insights

El plan Enterprise de Azure Spring Apps usa enlaces buildpack para integrar Application Insights con el tipo ApplicationInsights en lugar del agente en proceso. Para más información, consulte Cómo configurar la integración de APM y los certificados de CA.

En la tabla siguiente se enumeran los proveedores de APM disponibles los planes.

Plan Estándar Plan Enterprise
Application Insights
New Relic
Dynatrace
AppDynamics
Application Insights
New Relic
Dynatrace
AppDynamics
ElasticAPM

Para comprobar o actualizar la configuración actual en Application Insights, siga estos pasos:

  1. En la instancia de Azure Spring Apps Enterprise, seleccione Application Insights.

  2. Habilite o deshabilite Application Insights seleccionando Editar enlace o Enlace desenlace.

    Recorte de pantalla de la página de Application Insights de Azure Portal con el menú desplegable Editar opción de enlace que se muestra.

  3. Seleccione Editar enlace. Edite la configuración de enlace y seleccione Guardar.

    Recorte de pantalla del panel

Pasos siguientes