Uso de Azure Service Bus con JMS

En este artículo se describe cómo usar Azure Service Bus con la API de JMS integrada en el marco de Spring JMS.

Características principales

Conexión sin contraseña

La conexión sin contraseña usa Microsoft Entra autenticación para conectarse a servicios Azure sin almacenar credenciales en la aplicación, sus archivos de configuración o en variables de entorno. Microsoft Entra autenticación es un mecanismo para conectarse a Azure Service Bus mediante identidades definidas en Microsoft Entra ID. Con la autenticación Microsoft Entra, puede administrar Service Bus y otros servicios Microsoft en una ubicación central, lo que simplifica la administración de permisos.

Cómo funciona

Spring Cloud Azure primero compila uno de los siguientes tipos de credenciales en función de la configuración de autenticación de la aplicación:

• ClientSecretCredential
• ClientCertificateCredential
• UsernamePasswordCredential
• ManagedIdentityCredential

Si no se encuentra ninguno de estos tipos de credenciales, la cadena de credenciales a través de DefaultTokenCredential se usa para obtener credenciales de las propiedades de la aplicación, las variables de entorno, la identidad administrada o los IDE. Para obtener más información, consulte Spring Cloud Azure authentication.

Configuración de dependencias

Agregue las siguientes dependencias si desea migrar la aplicación de Spring JMS para usar Azure Service Bus.

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-servicebus-jms</artifactId>
</dependency>

Configuración

En la tabla siguiente se describen las propiedades configurables al usar la compatibilidad con Spring JMS:

Para obtener más información, vea documento de Spring JMS.

Uso básico

Conexión a Azure Service Bus JMS con contraseña sin contraseña

Configure las siguientes propiedades en el archivo application.yml:

spring:
  jms:
    servicebus:
      namespace: ${AZURE_SERVICEBUS_NAMESPACE}
      pricing-tier: ${PRICING_TIER}
      passwordless-enabled: true

Conexión a Azure Service Bus con JMS mediante identidad administrada

1. Para usar la identidad administrada, habilite la identidad administrada para el servicio y asigne el rol de Azure Service Bus Data Owner. Para obtener más información, consulte Authenticate una identidad administrada con Microsoft Entra ID para acceder a los recursos de Azure Service Bus.

2. Configure las siguientes propiedades en el archivo application.yml:

   spring:
     cloud:
       azure:
         credential:
           managed-identity-enabled: true
     jms:
       servicebus:
         namespace: ${AZURE_SERVICEBUS_NAMESPACE}
         pricing-tier: ${PRICING_TIER}
         passwordless-enabled: true
   

   Importante

   Si usa la identidad administrada asignada por el usuario, también debe agregar la propiedad spring.cloud.azure.credential.client-id con el identificador de cliente de identidad administrada asignada por el usuario.

Conexión a Azure Service Bus JMS mediante cadena de conexión

Agregue las siguientes propiedades y es bueno ir.

spring:
  jms:
    servicebus:
      connection-string: ${AZURE_SERVICEBUS_CONNECTION_STRING}
      pricing-tier: ${PRICING_TIER}

Conexiones

Spring Cloud Azure proporciona las tres opciones siguientes de Connection Factory para conectarse a Azure Service Bus JMS:

• JmsPoolConnectionFactory: este generador mantiene un grupo de conexiones con opciones personalizables como spring.jms.servicebus.pool.max-connections. En la sección spring.jms.servicebus.pool. se detallan más opciones de configuración de grupo ( con prefijo con ). Esta configuración mejora el rendimiento mediante la funcionalidad de equilibrio de carga de Azure Service Bus, lo que distribuye el tráfico entre varios puntos de conexión.

• CachingConnectionFactory: esta fábrica reutiliza una única conexión para todas las llamadas a JmsTemplate, lo que reduce la sobrecarga de creación de conexiones, lo que es ideal para escenarios de tráfico bajo. Sin embargo, este modo no usa la funcionalidad de equilibrio de carga de Azure Service Bus.

• ServiceBusJmsConnectionFactory: en este modo, cada llamada a JmsTemplate crea una nueva conexión, que puede ser de uso intensivo de recursos y menos eficaz.

Cuando existen las tres clases en la ruta de clase, ¿cuál se usa? En la tabla siguiente se describe qué se usa en función de las propiedades de configuración (desde Spring Cloud Azure 7.2.0 y 6.2.0):

Muestras

Para obtener más información, consulte el repositorio azure-spring-boot-samples en GitHub.