クイックスタート: Node.js で Azure Redis を使用する

[アーティクル]
12/21/2024

このクイックスタートでは、Azure Managed Redis (プレビュー) または Azure Cache for Redis をNode.js アプリに組み込みます。このアプリは、Azure 内の任意のアプリケーションからアクセスできるセキュリティで保護された専用キャッシュにアクセスできます。

前提条件

Azure サブスクリプション - 無料アカウントを作成する
Node.js がインストールされている - Node.js をインストールするには、「Windows に Node.js をインストールする」を参照して、Windows コンピューターに Node と npm をインストールする方法を確認してください。

Azure Managed Redis (プレビュー) インスタンスを作成する

Azure Managed Redis (プレビュー) インスタンスを作成するには、Azure portal にサインインし、[リソースの作成] を選択します。
[新規] ページ上で、検索ボックス内に「Azure Cache for Redis」と入力します。

[新規 Redis Cache] ページで、新しいキャッシュの設定を構成します。

設定	値を選択する	説明
サブスクリプション	ドロップダウンで、ご自身のサブスクリプションを選択します。	この新しい Azure Managed Redis インスタンスが作成されるサブスクリプション。
リソースグループ	ドロップダウンでリソースグループを選択するか、 [新規作成] を選択し、新しいリソースグループの名前を入力します。	その中にキャッシュやその他のリソースを作成するリソースグループの名前。すべてのアプリリソースを 1 つのリソースグループに配置することで、それらをまとめて簡単に管理または削除できます。
DNS 名	リージョンで一意の名前を入力します。	キャッシュ名は、"キャッシュのリージョン名と組み合わせた" ときに 1 から 63 文字の文字列で、数字、英字、ハイフンのみを使用する必要があります。 (キャッシュ名の長さが 45 文字未満の場合、現在使用できるすべてのリージョンで機能するはずです)。名前の先頭と末尾には数字または文字を使用する必要があり、連続するハイフンを含めることはできません。キャッシュインスタンスの "ホスト名" は `\<DNS name\>.\<Azure region\>.redis.azure.net` です。
場所	ドロップダウンで場所を選択します。	Azure Managed Redis は、選択した Azure リージョンで使用できます。
キャッシュの種類	ドロップダウンメニューから、パフォーマンスレベルとキャッシュサイズを選択します。	Redis インスタンスのパフォーマンスはレベルによって決まり、データの格納に使用できるメモリはキャッシュサイズによって決まります。適切なパフォーマンスレベルの選択に関するガイダンスについては、「最適なサービスレベルを選択する」を参照してください

Azure Managed Redis の [基本] タブを示すスクリーンショット。

[次へ: ネットワーク] を選択し、パブリックまたはプライベートエンドポイントのいずれかを選択します。
[次: 詳細] を選択します。

インスタンスに追加する Redis モジュールを構成します。

既定では、新しいマネージドキャッシュの場合:
- Microsoft Entra ID が有効になっています。
- [アクセスキー認証] は、セキュリティ上の理由から無効になっています。
重要

最適なセキュリティのため、可能であれば、キャッシュに対する要求を認可するのに Microsoft Entra ID とマネージド ID を使うことをお勧めします。 Microsoft Entra ID とマネージド ID を使う認可は、共有アクセスキーの認可より、セキュリティと使いやすさの点で優れています。キャッシュでのマネージド ID の使用について詳しくは、キャッシュ認証への Microsoft Entra ID の使用に関する記事をご覧ください。

クラスター化されていないキャッシュの [Clustering policy] (クラスタリングポリシー) を [Enterprise] に設定するか、クラスター化されたキャッシュの場合は [OSS] に設定します。 [クラスタリングポリシー] の選択方法の詳細については、「クラスタリングポリシー」を参照してください。

アクティブ geo レプリケーションを使用する場合は、作成時に構成する必要があります。詳細については、「Azure Managed Redis インスタンスのアクティブ geo レプリケーションを構成する」を参照してください。

重要

Azure Managed Redis (プレビュー) インスタンスのクラスタリングポリシーは、作成後に変更することはできません。 RediSearch を使用している場合、Enterprise クラスターポリシーは必須であり、サポートされている唯一の削除ポリシーは NoEviction です。

重要

geo レプリケーショングループでこのキャッシュインスタンスを使用している場合、インスタンスの作成後に削除ポリシーを変更することはできません。キャッシュを作成する前に、プライマリノードの削除ポリシーを確認してください。アクティブ geo レプリケーションの詳細については、「アクティブ geo レプリケーションの前提条件」を参照してください。

重要

キャッシュインスタンスを作成した後でモジュールを変更することはできません。モジュールは、Azure Cache for Redis インスタンスを作成するときに有効になっている必要があります。キャッシュの作成後にモジュールの構成を有効にするオプションはありません。
タグを選択してスキップします。
確認と作成 をクリックします。
設定を確認し、 [作成] を選択します。

Redis インスタンスの作成には数分かかります。 Azure Managed Redis の [概要] ページで進行状況を監視できます。 [状態] に "実行中" と表示されている場合は、キャッシュを使用する準備ができています。

Azure Cache for Redis インスタンスを作成する

キャッシュを作成するには、Azure portal にサインインします。ポータルのメニューで、[リソースの作成] を選びます。
[作業の開始] ペインの検索バーに「Azure Cache for Redis」と入力します。検索結果で Azure Cache for Redis を見つけて、[作成] を選びます。

[新しい Redis Cache] ペインの [基本] タブで、以下のキャッシュの設定を構成します。

設定	アクション	説明
サブスクリプション	Azure サブスクリプションを選択します。	Azure Cache for Redis の新しいインスタンスの作成に使うサブスクリプション。
リソースグループ	リソースグループを選択するか、 [新規作成] を選択し、新しいリソースグループの名前を入力します。	キャッシュや他のリソースを作成するリソースグループの名前。すべてのアプリリソースを 1 つのリソースグループに配置することで、それらをまとめて簡単に管理または削除できます。
DNS 名	一意の名前を入力します。	キャッシュ名は、数字、英字、ハイフンのみを含む 1 から 63 文字の文字列とする必要があります。名前の先頭と末尾には数字または文字を使用する必要があり、連続するハイフンを含めることはできません。キャッシュインスタンスの "ホスト名" は `\<DNS name>.redis.cache.windows.net` です。
場所	場所を選択します。	キャッシュを使う他のサービスに近い Azure リージョン。
キャッシュ SKU	SKU を選びます。	SKU によって、キャッシュに利用できるサイズ、パフォーマンス、機能のパラメーターが決まります。詳細については、Azure Cache for Redis の概要に関するページを参照してください。
キャッシュサイズ	キャッシュサイズを選びます。	詳細については、Azure Cache for Redis の概要に関するページを参照してください。

[ネットワーク] タブを選ぶか、[次へ: ネットワーク] を選びます。
[ネットワーク] タブで、キャッシュに使う接続方法を選びます。
[詳細] タブを選ぶか、[次へ: 詳細] を選びます。
[詳細] ペインで、以下の情報に基づいて認証方法を確認または選択します。
- 既定では、新しい Basic、Standard、または Premium キャッシュでは、Microsoft Entra 認証が有効になり、アクセスキー認証が無効になります。
- Basic または Standard キャッシュの場合は、非 TLS ポートを選択できます。
- Standard および Premium キャッシュの場合は、可用性ゾーンを有効にすることを選択できます。キャッシュの作成後に可用性ゾーンを無効にすることはできません。
- Premium キャッシュを利用する場合は、非 TLS ポート、クラスタリング、マネージド ID、データ永続化の設定を構成します。
重要

最適なセキュリティのため、可能であれば、キャッシュに対する要求を認可するのに Microsoft Entra ID とマネージド ID を使うことをお勧めします。 Microsoft Entra ID とマネージド ID を使う認可は、共有アクセスキーの認可より、セキュリティと使いやすさの点で優れています。キャッシュでのマネージド ID の使用について詳しくは、キャッシュ認証への Microsoft Entra ID の使用に関する記事をご覧ください。
(省略可能) [タグ] タブを選ぶか、[次へ: タグ] を選びます。
(省略可能) キャッシュリソースを分類する場合は、[タグ] タブでタグの名前と値を入力します。
[確認および作成] ボタンを選択します。

[確認と作成] タブでは、Azure によって構成が自動的に検証されます。
緑色の検証に成功のメッセージが表示された後、 [作成] を選択します。

新しいキャッシュのデプロイは数分で完了します。デプロイの進行状況は、Azure Cache for Redis の [概要] ペインで監視できます。 [状態] に [実行中] と表示されたら、キャッシュを使用できます。

node-redis クライアントライブラリをインストールする

node-redis ライブラリは、主要な Redis 用 Node.js クライアントです。 npm は以下のコマンドを使用してインストールできます。

npm install redis

キャッシュにアクセスする Node.js アプリを作成する

Microsoft Entra ID またはアクセスキーを使用して Azure Managed Redis (プレビュー) インスタンスに接続する Node.js アプリを作成します。 Microsoft Entra ID の使用をお勧めします。

Microsoft Entra ID 認証 (推奨)
アクセスキー認証

キャッシュで Microsoft Entra ID 認証を使用する

Azure Redis キャッシュでは、Enterprise レベルと Enterprise Flash レベルを除き、既定で Microsoft Entra 認証が有効になっています。アクセスキーは既定で無効になっています。

重要

Microsoft では、パスワードやアクセスキーを使用する代わりに、最も安全な認証エクスペリエンスに Microsoft Entra ID 認証を使用することをお勧めします。記事のこのセクションで説明する認証では、アクセスキーを使用します。このキーは、アプリケーションで非常に高い信頼を必要とし、Microsoft Entra ID を使用する場合には存在しないリスクを伴います。このドキュメントの方法は、Microsoft Entra ID 認証が実行できない場合にのみ使用してください。

Azure portal で、Microsoft Entra トークンベースの認証を使用するキャッシュを選択します。
リソースメニューで [認証] を選択します。
[メンバーの選択] を選び、有効なユーザーの名前を入力します。 [保存] を選択した場合は、既定で入力したユーザーに [データ所有者アクセスポリシー] が自動的に割り当てられます。マネージド ID またはサービスプリンシパルを入力して、キャッシュインスタンスに接続することもできます。

Azure CLI で Microsoft Entra ID を使用する方法については、ID のリファレンスページを参照してください。

JavaScript Azure Identity クライアントライブラリをインストールする

Microsoft Authentication Library (MSAL) を使用すると、Microsoft ID からセキュリティトークンを取得してユーザーを認証できます。 MSAL を使用してトークン認証サポートを提供する JavaScript Azure Identity クライアントライブラリがあります。 npm を使用して、このライブラリをインストールします。

npm install @azure/identity

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

ホスト名 と サービスプリンシパル ID (使用する Microsoft Entra ID サービスプリンシパルまたはユーザーのオブジェクト ID) の環境変数を追加します。 Azure portal で、ユーザー名を探します。
```
set AZURE_MANAGED_REDIS_HOST_NAME=contosoCache
set REDIS_SERVICE_PRINCIPAL_ID=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
```
redistest.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。このコードでは、キャッシュホスト名とキー環境変数を使用して Azure Managed Redis のインスタンスに接続する方法を示しています。コードでは、キャッシュ内の文字列値の格納および取得も行います。 PING および CLIENT LIST コマンドも実行されます。 Redis と node-redis クライアントを使用する他の例については、https://redis.js.org/ を参照してください。

const { createClient } = require("redis");
const { DefaultAzureCredential } = require("@azure/identity");

async function main() {
  // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
  const credential = new DefaultAzureCredential();
  const redisScope = "https://redis.azure.com/.default";

  // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
  let accessToken = await credential.getToken(redisScope);
  console.log("access Token", accessToken);

  // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
  const cacheConnection = createClient({
    username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
    password: accessToken.token,
    url: `redis://${process.env.AZURE_MANAGED_REDIS_HOST_NAME}:10000`,
    pingInterval: 100000,
    socket: { 
      tls: true,
      keepAlive: 0 
    },
  });

  cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
  await cacheConnection.connect();

  // PING command
  console.log("\nCache command: PING");
  console.log("Cache response : " + await cacheConnection.ping());

  // SET
  console.log("\nCache command: SET Message");
  console.log("Cache response : " + await cacheConnection.set("Message",
      "Hello! The cache is working from Node.js!"));

  // GET
  console.log("\nCache command: GET Message");
  console.log("Cache response : " + await cacheConnection.get("Message"));

  // Client list, useful to see if connection list is growing...
  console.log("\nCache command: CLIENT LIST");
  console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));

  cacheConnection.disconnect();

  return "Done"
}

main().then((result) => console.log(result)).catch(ex => console.log(ex));

Node.js でスクリプトを実行します。
```
node redistest.js
```

コードの出力例は以下のようになります。

Cache command: PING
Cache response : PONG

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: SET Message
Cache response : OK

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: CLIENT LIST
Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Done

再認証を使用するサンプル JavaScript アプリを作成する

Microsoft Entra ID アクセストークンの有効期間は有限で、平均 75 分です。キャッシュへの接続を維持するには、トークンを更新する必要があります。この例では、JavaScript でこれを実行する方法を示します。

redistestreauth.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。

 const { createClient } = require("redis");
 const { DefaultAzureCredential } = require("@azure/identity");

 async function returnPassword(credential) {
     const redisScope = "https://redis.azure.com/.default";

     // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
     return credential.getToken(redisScope);
 }

 async function main() {
   // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
   const credential = new DefaultAzureCredential();
   let accessToken = await returnPassword(credential);

   // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
   let cacheConnection = createClient({
     username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
     password: accessToken.token,
     url: `redis://${process.env.AZURE_MANAGED_REDIS_HOST_NAME}:10000`,
     pingInterval: 100000,
     socket: { 
       tls: true,
       keepAlive: 0 
     },
   });

   cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
   await cacheConnection.connect();

   for (let i = 0; i < 3; i++) {
     try {
         // PING command
         console.log("\nCache command: PING");
         console.log("Cache response : " + await cacheConnection.ping());

         // SET
         console.log("\nCache command: SET Message");
         console.log("Cache response : " + await cacheConnection.set("Message",
             "Hello! The cache is working from Node.js!"));

         // GET
         console.log("\nCache command: GET Message");
         console.log("Cache response : " + await cacheConnection.get("Message"));

         // Client list, useful to see if connection list is growing...
         console.log("\nCache command: CLIENT LIST");
         console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
       break;
     } catch (e) {
       console.log("error during redis get", e.toString());
       if ((accessToken.expiresOnTimestamp <= Date.now())|| (redis.status === "end" || "close") ) {
         await redis.disconnect();
         accessToken = await returnPassword(credential);
         cacheConnection = createClient({
           username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
           password: accessToken.token,
           url: `redis://${process.env.AZURE_MANAGED_REDIS_HOST_NAME}:10000`,
           pingInterval: 100000,
           socket: {
             tls: true,
             keepAlive: 0
           },
         });
       }
     }
   }
 }

 main().then((result) => console.log(result)).catch(ex => console.log(ex));

Node.js でスクリプトを実行します。
```
node redistestreauth.js
```

コードの出力例は以下のようになります。

 Cache command: PING
 Cache response : PONG

 Cache command: GET Message
 Cache response : Hello! The cache is working from Node.js!

 Cache command: SET Message
 Cache response : OK

 Cache command: GET Message
 Cache response : Hello! The cache is working from Node.js!

 Cache command: CLIENT LIST
 Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Note

node-redis ライブラリを使用して Microsoft Entra ID で Redis の認証を行うその他の例については、この GitHub リポジトリを参照してください

重要

Azure portal からホスト名、ポート、アクセスキーを取得する

Azure Cache for Redis サーバーに接続するには、キャッシュクライアントにキャッシュのホスト名、ポート、およびキーが必要です。クライアントによっては、これらの項目を参照するための名前が若干異なる場合があります。ホスト名、ポート、およびキーは Azure portal から取得できます。

アクセスキーを取得するには、[リソース] メニューから [認証] を選択します。その後、[アクセスキー] タブを選択します。
キャッシュのホスト名とポートを取得するには、[リソース] メニューから [概要] を選択します。ホスト名は、<DNS 名>.redis.cache.windows.net の形式になります。

[ホスト名] と [プライマリ] アクセスキーの環境変数を追加します。コードに機密情報を直接含める代わりに、これらの変数をコードから使用します。

set AZURE_MANAGED_REDIS_HOST_NAME=contosoCache
set AZURE_MANAGED_REDIS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

キャッシュに接続する

Note

コード内の操作ごとに新しい接続を作成しないでください。可能な限り接続を再利用してください。

新しい Node.js アプリを作成する

redistest.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。

const redis = require("redis");

// Environment variables for cache
const cacheHostName = process.env.AZURE_MANAGED_REDIS_HOST_NAME;
const cachePassword = process.env.AZURE_MANAGED_REDIS_ACCESS_KEY;

if(!cacheHostName) throw Error("AZURE_MANAGED_REDIS_HOST_NAME is empty")
if(!cachePassword) throw Error("AZURE_MANAGED_REDIS_ACCESS_KEY is empty")

async function testCache() {

    // Connection configuration
    const cacheConnection = redis.createClient({
        // redis for TLS
        url: `redis://${cacheHostName}:10000`,
        password: cachePassword
    });

    // Connect to Redis
    await cacheConnection.connect();

    // PING command
    console.log("\nCache command: PING");
    console.log("Cache response : " + await cacheConnection.ping());

    // GET
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // SET
    console.log("\nCache command: SET Message");
    console.log("Cache response : " + await cacheConnection.set("Message",
        "Hello! The cache is working from Node.js!"));

    // GET again
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // Client list, useful to see if connection list is growing...
    console.log("\nCache command: CLIENT LIST");
    console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));

    // Disconnect
    cacheConnection.disconnect()

    return "Done"
}

testCache().then((result) => console.log(result)).catch(ex => console.log(ex));

このコードでは、キャッシュホスト名とキー環境変数を使用して Azure Cache for Redis のインスタンスに接続する方法を示しています。コードでは、キャッシュ内の文字列値の格納および取得も行います。 PING および CLIENT LIST コマンドも実行されます。 Redis と node_redis クライアントの他の使用例については、https://redis.js.org/ を参照してください。

Node.js でスクリプトを実行します。
```
node redistest.js
```

出力の例。

Cache command: PING
Cache response : PONG

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: SET Message
Cache response : OK

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: CLIENT LIST
Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Done

キャッシュにアクセスする Node.js アプリを作成する

Microsoft Entra ID またはアクセスキーを使用して Azure Cache for Redis に接続する Node.js アプリを作成します。 Microsoft Entra ID の使用をお勧めします。

Microsoft Entra ID 認証 (推奨)
アクセスキー認証

キャッシュで Microsoft Entra ID 認証を使用する

重要

Azure portal で、Microsoft Entra トークンベースの認証を使用するキャッシュを選択します。
リソースメニューで [認証] を選択します。
[メンバーの選択] を選び、有効なユーザーの名前を入力します。 [保存] を選択した場合は、既定で入力したユーザーに [データ所有者アクセスポリシー] が自動的に割り当てられます。マネージド ID またはサービスプリンシパルを入力して、キャッシュインスタンスに接続することもできます。

Azure CLI で Microsoft Entra ID を使用する方法については、ID のリファレンスページを参照してください。

JavaScript Azure Identity クライアントライブラリをインストールする

npm install @azure/identity

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

ホスト名 と サービスプリンシパル ID (使用する Microsoft Entra ID サービスプリンシパルまたはユーザーのオブジェクト ID) の環境変数を追加します。 Azure portal で、ユーザー名を探します。
```
set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
set REDIS_SERVICE_PRINCIPAL_ID=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
```
redistest.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。このコードでは、キャッシュホスト名とキー環境変数を使用して Azure Cache for Redis のインスタンスに接続する方法を示しています。コードでは、キャッシュ内の文字列値の格納および取得も行います。 PING および CLIENT LIST コマンドも実行されます。 Redis と node-redis クライアントを使用する他の例については、https://redis.js.org/ を参照してください。

const { createClient } = require("redis");
const { DefaultAzureCredential } = require("@azure/identity");

async function main() {
  // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
  const credential = new DefaultAzureCredential();
  const redisScope = "https://redis.azure.com/.default";

  // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
  let accessToken = await credential.getToken(redisScope);
  console.log("access Token", accessToken);

  // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
  const cacheConnection = createClient({
    username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
    password: accessToken.token,
    url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
    pingInterval: 100000,
    socket: { 
      tls: true,
      keepAlive: 0 
    },
  });

  cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
  await cacheConnection.connect();

  // PING command
  console.log("\nCache command: PING");
  console.log("Cache response : " + await cacheConnection.ping());

  // SET
  console.log("\nCache command: SET Message");
  console.log("Cache response : " + await cacheConnection.set("Message",
      "Hello! The cache is working from Node.js!"));

  // GET
  console.log("\nCache command: GET Message");
  console.log("Cache response : " + await cacheConnection.get("Message"));

  // Client list, useful to see if connection list is growing...
  console.log("\nCache command: CLIENT LIST");
  console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));

  cacheConnection.disconnect();

  return "Done"
}

main().then((result) => console.log(result)).catch(ex => console.log(ex));

Node.js でスクリプトを実行します。
```
node redistest.js
```

コードの出力例は以下のようになります。

Cache command: PING
Cache response : PONG

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: SET Message
Cache response : OK

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: CLIENT LIST
Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Done

再認証を使用するサンプル JavaScript アプリを作成する

redistestreauth.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。

 const { createClient } = require("redis");
 const { DefaultAzureCredential } = require("@azure/identity");

 async function returnPassword(credential) {
     const redisScope = "https://redis.azure.com/.default";

     // Fetch a Microsoft Entra token to be used for authentication. This token will be used as the password.
     return credential.getToken(redisScope);
 }

 async function main() {
   // Construct a Token Credential from Identity library, e.g. ClientSecretCredential / ClientCertificateCredential / ManagedIdentityCredential, etc.
   const credential = new DefaultAzureCredential();
   let accessToken = await returnPassword(credential);

   // Create redis client and connect to the Azure Cache for Redis over the TLS port using the access token as password.
   let cacheConnection = createClient({
     username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
     password: accessToken.token,
     url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
     pingInterval: 100000,
     socket: { 
       tls: true,
       keepAlive: 0 
     },
   });

   cacheConnection.on("error", (err) => console.log("Redis Client Error", err));
   await cacheConnection.connect();

   for (let i = 0; i < 3; i++) {
     try {
         // PING command
         console.log("\nCache command: PING");
         console.log("Cache response : " + await cacheConnection.ping());

         // SET
         console.log("\nCache command: SET Message");
         console.log("Cache response : " + await cacheConnection.set("Message",
             "Hello! The cache is working from Node.js!"));

         // GET
         console.log("\nCache command: GET Message");
         console.log("Cache response : " + await cacheConnection.get("Message"));

         // Client list, useful to see if connection list is growing...
         console.log("\nCache command: CLIENT LIST");
         console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
       break;
     } catch (e) {
       console.log("error during redis get", e.toString());
       if ((accessToken.expiresOnTimestamp <= Date.now())|| (redis.status === "end" || "close") ) {
         await redis.disconnect();
         accessToken = await returnPassword(credential);
         cacheConnection = createClient({
           username: process.env.REDIS_SERVICE_PRINCIPAL_ID,
           password: accessToken.token,
           url: `redis://${process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME}:6380`,
           pingInterval: 100000,
           socket: {
             tls: true,
             keepAlive: 0
           },
         });
       }
     }
   }
 }

 main().then((result) => console.log(result)).catch(ex => console.log(ex));

Node.js でスクリプトを実行します。
```
node redistestreauth.js
```

コードの出力例は以下のようになります。

 Cache command: PING
 Cache response : PONG

 Cache command: GET Message
 Cache response : Hello! The cache is working from Node.js!

 Cache command: SET Message
 Cache response : OK

 Cache command: GET Message
 Cache response : Hello! The cache is working from Node.js!

 Cache command: CLIENT LIST
 Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Note

node-redis ライブラリを使用して Microsoft Entra ID で Redis の認証を行うその他の例については、この GitHub リポジトリを参照してください

Azure portal からホスト名、ポート、アクセスキーを取得する

アクセスキーを取得するには、[リソース] メニューから [認証] を選択します。その後、[アクセスキー] タブを選択します。
キャッシュのホスト名とポートを取得するには、[リソース] メニューから [概要] を選択します。ホスト名は、<DNS 名>.redis.cache.windows.net の形式になります。

set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
set AZURE_CACHE_FOR_REDIS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

キャッシュに接続する

Note

コード内の操作ごとに新しい接続を作成しないでください。可能な限り接続を再利用してください。

新しい Node.js アプリを作成する

redistest.js という名前の新しいスクリプトファイルを作成します。

次の例の JavaScript をファイルに追加します。

const redis = require("redis");

// Environment variables for cache
const cacheHostName = process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME;
const cachePassword = process.env.AZURE_CACHE_FOR_REDIS_ACCESS_KEY;

if(!cacheHostName) throw Error("AZURE_CACHE_FOR_REDIS_HOST_NAME is empty")
if(!cachePassword) throw Error("AZURE_CACHE_FOR_REDIS_ACCESS_KEY is empty")

async function testCache() {

    // Connection configuration
    const cacheConnection = redis.createClient({
        // redis for TLS
        url: `redis://${cacheHostName}:6380`,
        password: cachePassword
    });

    // Connect to Redis
    await cacheConnection.connect();

    // PING command
    console.log("\nCache command: PING");
    console.log("Cache response : " + await cacheConnection.ping());

    // GET
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // SET
    console.log("\nCache command: SET Message");
    console.log("Cache response : " + await cacheConnection.set("Message",
        "Hello! The cache is working from Node.js!"));

    // GET again
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // Client list, useful to see if connection list is growing...
    console.log("\nCache command: CLIENT LIST");
    console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));

    // Disconnect
    cacheConnection.disconnect()

    return "Done"
}

testCache().then((result) => console.log(result)).catch(ex => console.log(ex));

Node.js でスクリプトを実行します。
```
node redistest.js
```

出力の例。

Cache command: PING
Cache response : PONG

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: SET Message
Cache response : OK

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: CLIENT LIST
Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Done

リソースをクリーンアップする

この記事で作成したリソースを引き続き使用する場合は、リソースグループを保持します。

それ以外の場合、リソースを使い終わったら、課金されないように、作成した Azure リソースグループを削除できます。

重要

リソースグループを削除すると、元に戻すことができません。リソースグループを削除すると、そのリソースグループ内のすべてのリソースは完全に削除されます。間違ったリソースグループやリソースをうっかり削除しないようにしてください。リソースを既存のリソースグループ内に作成し、そのリソースグループ内に保持したいリソースが含まれている場合は、リソースグループを削除するのではなく、各リソースを個別に削除できます。

リソースグループを削除するには

Azure portal にサインインし、 [リソースグループ] を選択します。
削除するリソースグループを選択します。

多数のリソースグループがある場合は、[任意のフィールドのフィルター...] ボックスを使用し、この記事用に作成したリソースグループの名前を入力します。結果リストでリソースグループを選びます。
[リソースグループの削除] を選択します。
リソースグループの削除の確認を求めるメッセージが表示されます。確認のためにリソースグループの名前を入力し、[削除] を選択します。

しばらくすると、リソースグループとそのリソースのすべてが削除されます。

サンプルコードを入手する

GitHub で Node.js のクイックスタートを入手してください。

このクイックスタートでは、Node.js アプリケーションから Azure Managed Redis (プレビュー) または Azure Cache for Redis を使用する方法について説明しました。 Azure Redis オファリングの詳細については、以下をご覧ください。

次の方法で共有

クイックスタート: Node.js で Azure Redis を使用する

前提条件

Azure Managed Redis (プレビュー) インスタンスを作成する

Azure Cache for Redis インスタンスを作成する

node-redis クライアントライブラリをインストールする

キャッシュにアクセスする Node.js アプリを作成する

キャッシュで Microsoft Entra ID 認証を使用する

JavaScript Azure Identity クライアントライブラリをインストールする

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

再認証を使用するサンプル JavaScript アプリを作成する

Azure portal からホスト名、ポート、アクセスキーを取得する

キャッシュに接続する

新しい Node.js アプリを作成する

キャッシュにアクセスする Node.js アプリを作成する

キャッシュで Microsoft Entra ID 認証を使用する

JavaScript Azure Identity クライアントライブラリをインストールする

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

再認証を使用するサンプル JavaScript アプリを作成する

Azure portal からホスト名、ポート、アクセスキーを取得する

キャッシュに接続する

新しい Node.js アプリを作成する

リソースをクリーンアップする

リソースグループを削除するには

サンプルコードを入手する

フィードバック

その他のリソース

次の方法で共有

クイックスタート: Node.js で Azure Redis を使用する

前提条件

Azure Managed Redis (プレビュー) インスタンスを作成する

Azure Cache for Redis インスタンスを作成する

node-redis クライアント ライブラリをインストールする

キャッシュにアクセスする Node.js アプリを作成する

キャッシュで Microsoft Entra ID 認証を使用する

JavaScript Azure Identity クライアント ライブラリをインストールする

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

再認証を使用するサンプル JavaScript アプリを作成する

キャッシュにアクセスする Node.js アプリを作成する

キャッシュで Microsoft Entra ID 認証を使用する

JavaScript Azure Identity クライアント ライブラリをインストールする

Microsoft Entra ID を使用して新しい Node.js アプリを作成する

再認証を使用するサンプル JavaScript アプリを作成する

リソースをクリーンアップする

リソース グループを削除するには

サンプル コードを入手する

関連するコンテンツ

フィードバック

その他のリソース

node-redis クライアントライブラリをインストールする

JavaScript Azure Identity クライアントライブラリをインストールする

JavaScript Azure Identity クライアントライブラリをインストールする

リソースグループを削除するには

サンプルコードを入手する