JMS でAzure Service Busを使用する

この記事では、Spring JMS フレームワークに統合された JMS API でAzure Service Busを使用する方法について説明します。

コア機能

パスワードレス接続

パスワードレス接続では、Microsoft Entra認証を使用して、アプリケーション、その構成ファイル、または環境変数に資格情報を格納せずに、Azure サービスに接続します。 Microsoft Entra認証は、Microsoft Entra IDで定義された ID を使用してAzure Service Busに接続するためのメカニズムです。 Microsoft Entra認証を使用すると、一元的な場所でService Busやその他のMicrosoft サービスを管理できるため、アクセス許可の管理が簡素化されます。

しくみ

Spring Cloud Azureでは、まず、アプリケーション認証の構成に応じて、次のいずれかの種類の資格情報を構築します。

• ClientSecretCredential
• ClientCertificateCredential
• UsernamePasswordCredential
• ManagedIdentityCredential

これらの種類の資格情報が見つからない場合は、DefaultTokenCredential 経由の資格情報チェーンを使用して、アプリケーションのプロパティ、環境変数、マネージド ID、または IDE から資格情報を取得します。 詳細については、「Spring Cloud Azure 認証」を参照>。

依存関係のセットアップ

Azure Service Busを使用するように Spring JMS アプリケーションを移行する場合は、次の依存関係を追加します。

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

構成

次の表では、Spring JMS サポートを使用する場合の構成可能なプロパティについて説明します。

詳細については、Spring JMS ドキュメントを参照してください。

基本的な使用方法

パスワードレスを使用して Azure Service Bus JMS に接続する

application.yml ファイルで次のプロパティを構成します。

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

JMS でマネージド ID を使用してAzure Service Busに接続する

1. マネージド ID を使用するには、サービスのマネージド ID を有効にして、Azure Service Bus Data Owner ロールを割り当てます。 詳細については、「Azure Service Bus リソースにアクセスするためのMicrosoft Entra IDを使用してマネージド ID を認証するを参照してください。

2. application.yml ファイルで次のプロパティを構成します。

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

   重要

   ユーザー割り当てマネージド ID を使用している場合は、ユーザー割り当てマネージド ID クライアント ID を持つプロパティ spring.cloud.azure.credential.client-id も追加する必要があります。

接続文字列 を使用して Azure Service Bus JMS に接続する

次のプロパティを追加すれば、準備完了です。

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

コネ

Spring Cloud Azure には、Azure Service Bus JMS に接続するための次の 3 つの接続ファクトリ オプションが用意されています。

• JmsPoolConnectionFactory:このファクトリは、 spring.jms.servicebus.pool.max-connectionsなどのカスタマイズ可能なオプションを持つ接続プールを維持します。 その他のプール構成設定 (プレフィックスは spring.jms.servicebus.pool. ) については、「 構成」 セクションで詳しく説明します。 このセットアップでは、Azure Service Busの負荷分散機能を使用して、複数のエンドポイントにトラフィックを分散することで、パフォーマンスが向上します。

• CachingConnectionFactory: このファクトリは、 JmsTemplateへのすべての呼び出しに対して 1 つの接続を再利用するため、トラフィックの少ないシナリオに最適な接続作成のオーバーヘッドが削減されます。 ただし、このモードでは、Azure Service Busの負荷分散機能は使用されません。

• ServiceBusJmsConnectionFactory: このモードでは、 JmsTemplate を呼び出すたびに新しい接続が作成されます。これは、リソースを集中的に消費し、効率が低下する可能性があります。

クラスパスに 3 つのクラスがすべて存在する場合、どれが使用されますか? 次の表では、構成プロパティ (Spring Cloud Azure 7.1.0 および 6.2.0 以降) に基づいて使用される内容について説明します。

サンプル

詳細については、GitHubの azure-spring-boot-samples リポジトリを参照してください。