Spring Cloud Azure Redis のサポート

この記事の対象: ✔️ バージョン 4.14.0 ✔️ バージョン 5.8.0

Spring Redis ライブラリを使用して Azure Cache for Redis に接続します。 アプリケーションに spring-cloud-azure-starter および spring-cloud-azure-resourcemanager を追加することで、Azure Resource Manager を介して Azure Cache for Redis 接続情報を読み取り、Redis プロパティを自動構成できます。

依存関係のセットアップ

Redis を使用して Spring Boot アプリケーションに Spring Cloud Azure Redis サポートを使用する場合は、次の依存関係を追加します。

<dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-starter</artifactId>
    </dependency>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-resourcemanager</artifactId>
    </dependency>
</dependencies>

構成

Note

セキュリティ プリンシパルを使用して、Azure リソースにアクセスするための Microsoft Entra ID による認証と承認を行う場合は、「Microsoft Entra ID によるアクセスの承認」を参照して、Azure リソースにアクセスするための十分なアクセス許可がセキュリティ プリンシパルに付与されていることを確認してください。

Redis のサポートを使用するときに構成可能なプロパティ:

プロパティ Description 既定値 必須
spring.cloud.azure.redis.enabled Azure Cache for Redis を有効にするかどうか。 true いいえ
spring.cloud.azure.redis.name Azure Cache for Redis のインスタンス名 はい
spring.cloud.azure.redis.resource.resource-group Azure Cache for Redis のリソース グループ。 はい
spring.cloud.azure.profile.subscription-id サブスクリプション ID です。 はい

Note

Azure Resource Manager の認証には認証情報も必要です。 Resource Manager の資格情報関連の構成は、プレフィックス spring.cloud.azure で構成する必要があります。 詳細については、「Spring Cloud Azure の認証」を参照してください。

基本的な使用方法

次のプロパティを追加すると準備できます。

spring.cloud.azure.redis.name=${AZURE_CACHE_REDIS_NAME}
spring.cloud.azure.redis.resource.resource-group=${AZURE_CACHE_REDIS_RESOURCE_GROUP}

サンプル

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