Service Connector を使用して Azure Cache for Redis を統合する

このページでは、サポートされている認証方法とクライアントを示し、サービス コネクタを使って Azure Cache for Redis を他のクラウド サービスに接続するために使用できるサンプル コードを示します。 Service Connector を使用しなくても、他のプログラミング言語で Azure Cache for Redis に接続できる場合があります。 このページには、サービス接続を作成するときに取得する既定の環境変数の名前と値 (つまり、Spring Boot 構成) も示されています。

サポートされているコンピューティング サービス

サービス コネクタを使うと、次のコンピューティング サービスを Azure Cache for Redis に接続できます。

• Azure App Service
• Azure Container Apps
• Azure Functions
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

サポートされている認証の種類とクライアントの種類

次の表は、サービス コネクタを使った Azure Cache for Redis へのコンピューティング サービスの接続でサポートされている認証方法とクライアントの組み合わせを示したものです。 "はい" はその組み合わせがサポートされていることを示し、"いいえ" はサポートされていないことを示します。

クライアント タイプ	システム割り当てマネージド ID	ユーザー割り当てマネージド ID	シークレット/接続文字列	サービス プリンシパル
.NET	いいえ	番号	有効	いいえ
Go	いいえ	番号	有効	いいえ
Java	いいえ	番号	有効	いいえ
Java - Spring Boot	いいえ	番号	有効	いいえ
Node.js	いいえ	番号	有効	いいえ
Python	いいえ	番号	有効	いいえ
なし	いいえ	番号	有効	いいえ

この表は、表内の全種のクライアントでサポートされている唯一の認証方法はシークレット/接続文字列方法であることを示しています。 Service Connector を使用して Azure Cache for Redis に接続する場合、その他の認証方法は、どのクライアントの種類でもサポートされていません。

既定の環境変数名またはアプリケーション プロパティとサンプル コード

コンピューティング サービスを Redis Server に接続するには、次に示す環境変数名とアプリケーション プロパティを使用します。 下の各例では、プレースホルダー　テキスト <redis-server-name>、<redis-key> を自分の Redis サーバー名およびキーに置き換えます。 名前付け規則の詳細については、Service Connector の内部の記事を参照してください。

Connection String

警告

Microsoft では、使用可能な最も安全な認証フローを使用することをお勧めします。 この手順で説明されている認証フローでは、アプリケーションで非常に高い信頼度が要求されるため、他のフローには存在しないリスクが伴います。 このフローは、マネージド ID など、より安全なフローが実行可能ではない場合にのみ使用してください。

.NET

既定の環境変数名	説明	例値
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Redis 接続文字列	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

既定の環境変数名	説明	例値
AZURE_REDIS_CONNECTIONSTRING	Jedis 接続文字列	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Application properties	説明	例値
spring.redis.host	Redis ホスト	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Redis ポート	6380
spring.redis.database	Redis データベース	0
spring.redis.password	Redis キー	<redis-key>
spring.redis.ssl	SSL 設定	true

Python

既定の環境変数名	説明	例値
AZURE_REDIS_CONNECTIONSTRING	redis-py 接続文字列	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

既定の環境変数名	説明	例値
AZURE_REDIS_CONNECTIONSTRING	redis-py 接続文字列	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

既定の環境変数名	説明	例値
AZURE_REDIS_CONNECTIONSTRING	node-redis 接続文字列	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

その他

既定の環境変数名	説明	値の例
AZURE_REDIS_HOST	Redis ホスト	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Redis ポート	6380
AZURE_REDIS_DATABASE	Redis データベース	0
AZURE_REDIS_PASSWORD	Redis キー	<redis-key>
AZURE_REDIS_SSL	SSL 設定	true

サンプル コード

接続文字列を使って Azure Cache for Redis に接続するには、以下の手順とコードを参照してください。

.NET

1. 依存関係をインストールします。

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Service Connector によって追加された環境変数から Redis 接続文字列を取得します。

   using StackExchange.Redis;
   var connectionString = Environment.GetEnvironmentVariable("AZURE_REDIS_CONNECTIONSTRING");
   var _redisConnection = await RedisConnection.InitializeAsync(connectionString: connectionString);
   

Java

1. pom.xml ファイルに次の依存関係を追加します。

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

2. Service Connector によって追加された環境変数から Redis 接続文字列を取得します。

   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   import redis.clients.jedis.JedisShardInfo;
   import java.net.URI;
   
   String connectionString = System.getenv("AZURE_REDIS_CONNECTIONSTRING");
   URI uri = new URI(connectionString);
   JedisShardInfo shardInfo = new JedisShardInfo(uri);
   shardInfo.setSsl(true);
   Jedis jedis = new Jedis(shardInfo);
   

SpringBoot

Spring アプリケーションを設定するには、「Spring で Azure Redis Cache を使用する」を参照してください。 構成プロパティは、Spring Apps by Service Connector に追加されます。

Python

1. 依存関係をインストールします。

   pip install redis
   

2. Service Connector によって追加された環境変数から Redis 接続文字列を取得します。

   import os
   import redis
   
   url = os.getenv('AZURE_REDIS_CONNECTIONSTRING')
   url_connection = redis.from_url(url)
   url_connection.ping()
   

Go

1. 依存関係をインストールします。

   go get github.com/redis/go-redis/v9
   

2. Service Connector によって追加された環境変数から Redis 接続文字列を取得します。

   import (
       "context"
       "fmt"
   
       "github.com/redis/go-redis/v9"
   )
   
   connectionString := os.Getenv("AZURE_REDIS_CONNECTIONSTRING")
   opt, err := redis.ParseURL(connectionString)
   if err != nil {
   	panic(err)
   }
   
   client := redis.NewClient(opt)
   

NodeJS

1. 依存関係をインストールします。

   npm install redis
   

2. Service Connector によって追加された環境変数から Redis 接続文字列を取得します。

   const redis = require("redis");
   
   const connectionString = process.env.AZURE_REDIS_CONNECTIONSTRING;
   const cacheConnection = redis.createClient({
       url: connectionString,
   });
   await cacheConnection.connect();
   

その他

他の言語の場合は、サービス コネクタが環境変数に設定する接続情報を使って、Azure Cache for Redis に接続できます。 環境変数の詳細については、「Service Connector を使用して Azure App Configuration を統合する」を参照してください。

次のステップ

Service Connector の詳細については、以下のチュートリアルに従ってください。

Service Connector の概念について学習する