Usare bus di servizio di Azure con JMS

Questo articolo descrive come usare bus di servizio di Azure con l'API JMS integrata nel framework Spring JMS.

Funzionalità principali

Connessione senza password

La connessione senza password usa l'autenticazione Microsoft Entra per connettersi ai servizi di Azure senza archiviare credenziali nell'applicazione, nei relativi file di configurazione o nelle variabili di ambiente. Microsoft Entra'autenticazione è un meccanismo per la connessione a bus di servizio di Azure usando le identità definite in Microsoft Entra ID. Con l'autenticazione Microsoft Entra è possibile gestire bus di servizio e altri servizi Microsoft in una posizione centrale, semplificando la gestione delle autorizzazioni.

Come funziona

Spring Cloud Azure prima compila uno dei tipi di credenziali seguenti a seconda della configurazione di autenticazione dell'applicazione:

• ClientSecretCredential
• ClientCertificateCredential
• UsernamePasswordCredential
• ManagedIdentityCredential

Se nessuno di questi tipi di credenziali viene trovato, la catena di credenziali tramite DefaultTokenCredential viene usata per ottenere le credenziali dalle proprietà dell'applicazione, dalle variabili di ambiente, dall'identità gestita o dagli IDE. Per altre informazioni, vedere Spring Cloud Azure authentication.

Configurazione delle dipendenze

Aggiungere le dipendenze seguenti se si vuole eseguire la migrazione dell'applicazione Spring JMS per usare bus di servizio di Azure.

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

Configurazione

Nella tabella seguente vengono descritte le proprietà configurabili quando si usa il supporto spring JMS:

Per altre informazioni, vedere documento Spring JMS.

Utilizzo di base

Connettersi a bus di servizio di Azure JMS usando passwordless

Configurare le proprietà seguenti nel file application.yml:

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

Connettersi a bus di servizio di Azure con JMS usare l'identità gestita

1. Per usare l'identità gestita, abilitare l'identità gestita per il servizio e assegnare il ruolo bus di servizio di Azure Data Owner. Per altre informazioni, vedere Authenticate a managed identity with Microsoft Entra ID to access bus di servizio di Azure resources.

2. Configurare le proprietà seguenti nel file application.yml:

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

   Importante

   Se si usa l'identità gestita assegnata dall'utente, è necessario aggiungere anche la proprietà spring.cloud.azure.credential.client-id con l'ID client dell'identità gestita assegnata dall'utente.

Connettersi a bus di servizio di Azure JMS usando stringa di connessione

Aggiungere le proprietà seguenti ed è consigliabile procedere.

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

Connessioni

Spring Cloud Azure offre le tre opzioni di connection factory seguenti per la connessione a bus di servizio di Azure JMS:

• JmsPoolConnectionFactory: questa factory gestisce un pool di connessioni con opzioni personalizzabili come spring.jms.servicebus.pool.max-connections. Altre impostazioni di configurazione del pool, precedute dal spring.jms.servicebus.pool. prefisso , sono descritte in dettaglio nella sezione Configurazione . Questa configurazione migliora le prestazioni usando la funzionalità di bilanciamento del carico di bus di servizio di Azure, distribuendo il traffico tra più endpoint.

• CachingConnectionFactory: questa factory riutilizza una singola connessione per tutte le chiamate a JmsTemplate, riducendo il sovraccarico di creazione della connessione, ideale per scenari con traffico ridotto. Tuttavia, questa modalità non usa la funzionalità di bilanciamento del carico di bus di servizio di Azure.

• ServiceBusJmsConnectionFactory: in questa modalità, ogni chiamata a JmsTemplate crea una nuova connessione, che può essere a elevato utilizzo di risorse e meno efficiente.

Quando tutte e tre le classi esistono nel classpath, quale classe viene usata? La tabella seguente descrive che viene usata in base alle proprietà di configurazione (dal momento che Spring Cloud Azure 7.2.0 e 6.2.0):

Campioni

Per altre informazioni, vedere il repository azure-spring-boot-samples in GitHub.