次の方法で共有

Azure Managed Redis (プレビュー) で Redis コマンドライン ツールを使用する

  • [アーティクル]

redis-cli コマンド ライン ツールを使用して、クライアントとして Azure Managed Redis (プレビュー) を操作します。 このツールを使用して、Azure Managed Redis インスタンスを直接操作し、デバッグとトラブルシューティングを行います。

redis-cli をインストールする

redis-cli ツールは、複数のオペレーティング システムで使用できる "Redis パッケージ" と共に自動的にインストールされます。 お好みのオペレーティング システムに関する最も詳細なドキュメントについては、オープン ソースの Redis のインストール ガイドを参照してください。

Linux

redis-cli は Linux 上でネイティブに実行されます。ほとんどのディストリビューションには、redis-cli ツールを含む "Redis パッケージ" が含まれています。 たとえば、Ubuntu では、次のコマンドを使用して "Redis パッケージ" をインストールします。

sudo apt-get update
sudo apt-get install redis

Windows

Windows コンピューターで redis-cli を使用する最善の方法は、Linux 用 Windows サブシステム (WSL) をインストールすることです。 Linux サブシステムを使用すると、Windows 上で Linux ツールを直接実行できます。 WSL をインストールするには、WSL のインストール手順に従います。

WSL がインストールされたら、WSL 用に選択した Linux ディストリビューションで使用可能な任意のパッケージ管理を使って redis-cli をインストールできます。

キャッシュ アクセス情報を収集する

次の方法を使用して、キャッシュにアクセスするために必要な情報を収集できます。

このセクションでは､Azure portal からキーを取得します｡

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

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

  • アクセス キーを取得するには、[リソース] メニューから [認証] を選択します。 その後、[アクセス キー] タブを選択します。

    Azure Cache for Redis のアクセス キーを示すスクリーンショット。

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

    Azure Cache for Redis のプロパティを示すスクリーンショット。

redis-cli を使用して接続する

"Redis パッケージ" がインストールされているコンピューターでシェルまたはターミナルを開きます。 WSL を使用する場合は、Windows ターミナルを使って Linux コマンド ラインを開くことができます。 redis-cli を使って接続する前に、次のことを確認します。

  1. TLS アクセスが必要かどうか - 既定では、Azure Managed Redis インスタンスでは接続に TLS 暗号化が使用されます。 サーバー側で TLS が使用されている場合は常に、--tls オプションを使って redis-cli の TLS を有効にする必要があります。
  2. 使用するポート - すべての Azure Managed Redis インスタンスでポート 10000 が使用されます。 これは、Redis コミュニティ エディションの既定値 (6379) とは異なることに注意してください。
  3. キャッシュ インスタンスが OSS クラスター ポリシーを使用するかどうか - OSS クラスター ポリシーを使用している場合は、-c オプションを追加して、すべてのシャードに確実にアクセスできるようにします。

例

  1. Enterprise クラスター ポリシーと TLS を使用して Azure Managed Redis インスタンスに接続します。

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. OSS クラスター ポリシーと TLS を使用して Azure Managed Redis インスタンスに接続します。

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

接続のテスト

接続が確立されたら、Azure Managed Redis インスタンスにコマンドを発行できます。 接続をテストする簡単な方法の 1 つは、PING コマンドを使用することです。 このコマンドでは、コンソールで PONG が返されます。

yourcachename.region.redis.azure.net:10000> PING
PONG

SET や GET などのコマンドを実行することもできます。

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

これで、redis-cli を使用して Azure Managed Redis インスタンスに接続できました。

redis-cli の代替手段

redis-cli は便利なツールですが、トラブルシューティングやテストのために他の方法でキャッシュに接続できます。

  • RedisInsight は、Redis コマンドを発行し、Redis インスタンスの内容を表示するための豊富なオープン ソースのグラフィカル ツールです。 これは Azure Managed Redis と連携し、Linux、Windows、macOS でサポートされています。

関連するコンテンツ

新しい Azure Managed Redis Instance インスタンスの作成から開始します。