Verwenden des Redis-Befehlszeilentools mit Azure Cache for Redis

  • Artikel

Verwenden Sie das Befehlszeilentool „redis-cli“, um mit einem Azure Cache for Redis als Client zu interagieren. Verwenden Sie dieses Tool, um direkt mit Ihrer Azure Cache for Redis-Instanz zu interagieren, sowie zum Debuggen und zur Problembehandlung.

Installieren von redis-cli

Das redis-cli-Tool wird automatisch mit dem Redis-Paket installiert, das für mehrere Betriebssysteme verfügbar ist. Die detaillierteste Dokumentation für Ihr bevorzugtes Betriebssystem finden Sie im Open Source-Leitfaden zur Installation von Redis.

Linux

Die redis-cli wird nativ unter Linux ausgeführt, und die meisten Distributionen enthalten ein Redis-Paket, das das redis-cli-Tool enthält. Unter Ubuntu installieren Sie beispielsweise das Redis-Paket mit den folgenden Befehlen:

sudo apt-get update
sudo apt-get install redis

Windows

Die beste Möglichkeit, redis-cli auf einem Windows-Computer zu verwenden, besteht darin, das Windows-Subsystem für Linux (WSL) zu installieren. Mit dem Linux-Subsystem können Sie Linux-Tools direkt unter Windows ausführen. Befolgen Sie zum Installieren von WSL die WSL-Installationsanweisungen.

Nachdem WSL installiert wurde, können Sie redis-cli mithilfe der verfügbaren Paketverwaltung in der Linux-Distribution installieren, die Sie für WSL ausgewählt haben.

Sammeln von Cachezugriffsinformationen

Sie können die benötigten Informationen zum Zugriff auf den Cache mithilfe der folgenden Methoden sammeln:

In diesem Abschnitt rufen Sie die Schlüssel aus dem Azure-Portal ab.

Abrufen des Hostnamens, der Ports und des Zugriffsschlüssels

Um Ihren Azure Cache for Redis-Server zu verbinden, benötigt der Cacheclient den Hostnamen, die Ports und einen Zugriffsschlüssel. Einige Clients verweisen möglicherweise auf diese Elemente, indem sie geringfügig andere Namen verwenden. Sie können den Hostnamen, Ports und Schlüssel im Azure-Portal abrufen.

  • So rufen Sie einen Zugriffsschlüssel für Ihren Cache ab:

    1. Wechseln Sie im Azure-Portal zu Ihrem Cache.
    2. Wählen Sie im Dienstmenü unter Einstellungen die Option Authentifizierung aus.
    3. Wählen Sie im Bereich Authentifizierung die Zugriffsschlüssel Registerkarte aus.
    4. Um den Wert für einen Zugriffsschlüssel zu kopieren, wählen Sie im Schlüsselfeld das Symbol Kopieren aus.

    Screenshot, der zeigt, wie Sie einen Zugriffsschlüssel für eine Instanz von Azure Cache for Redis suchen und kopieren.

  • So rufen Sie den Hostnamen und die Ports für Ihren Cache ab:

    1. Wechseln Sie im Azure-Portal zu Ihrem Cache.
    2. Wählen Sie im Menü "Dienst" Übersicht aus.
    3. Wählen Sie unter Essentials für den Hostnamen das Symbol Kopieren aus, um den Hostnamenwert zu kopieren. Der Hostnamenwert weist das Formular <DNS name>.redis.cache.windows.net auf.
    4. Wählen Sie für Ports das Symbol Kopieren aus, um die Portwerte zu kopieren.

    Screenshot, der zeigt, wie Sie den Hostnamen und die Ports für eine Instanz von Azure Cache for Redis suchen und kopieren.

Verbinden mit redis-cli

Öffnen Sie eine Shell oder ein Terminal auf einem Computer, auf dem das Redis-Paket installiert ist. Wenn Sie WSL verwenden, können Sie das Windows-Terminal verwenden, um eine Linux-Befehlszeile zu öffnen. Bevor Sie eine Verbindung mit redis-cli herstellen, überprüfen Sie Folgendes:

  1. Ob TLS-Zugriff erforderlich ist – Standardmäßig verwenden Azure Cache for Redis-Instanzen TLS-Verschlüsselung für Verbindungen. Wenn TLS auf Serverseite verwendet wird, muss TLS in redis-cli mithilfe der Option --tls aktiviert werden.
  2. Der verwendete Port – Alle Caches im Enterprise- und Enterprise Flash-Tarif verwenden Port 10000. Basic-, Standard- und Premium-Caches verwenden jedoch entweder Port 6379 für Nicht-TLS-Verbindungen oder Port 6380 für TLS-Verbindungen.
  3. Ob die Cache-Instanz Clustering verwendet– Wenn Sie einen Premium-Cache verwenden, der Clustering verwendet, oder einen Enterprise/Enterprise Flash-Cache, der die OSS-Clusterrichtlinie verwendet, fügen Sie die Option -c hinzu, um sicherzustellen, dass auf alle Shards zugegriffen werden kann.

Beispiele

  1. Verwenden Sie den folgenden Befehl, um eine Verbindung mit einer Azure Cache for Redis-Instanz im Tarif „Basic“, „Standard“ oder „Premium“ mithilfe von TLS herzustellen:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls

  2. Herstellen einer Verbindung mit einer Azure Cache for Redis-Instanz im Tarif „Basic“, „Standard“ oder „Premium“, die kein TLS verwendet:

    redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey

  3. Herstellen einer Verbindung mit einer Azure Cache for Redis-Instanz im Tarif „Basic“, „Standard“ oder „Premium“ mit TLS und Clustering:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c

  4. Herstellen einer Verbindung mit einer Enterprise- oder Enterprise Flash-Cache-Instanz mithilfe der Enterprise-Clusterrichtlinie mit TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls

  5. Herstellen einer Verbindung mit einer Enterprise- oder Enterprise Flash-Cache-Instanz mithilfe der OSS-Clusterrichtlinie ohne TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c

Testen der Verbindung

Nachdem die Verbindung hergestellt wurde, können Sie Befehle an Ihre Azure Cache for Redis-Instanz ausgeben. Eine einfache Möglichkeit zum Testen der Verbindung ist die Verwendung des Befehls PING. Dieser Befehl gibt PONG in der Konsole zurück.

yourcachename.redis.cache.windows.net:6380> PING
PONG

Sie können auch Befehle wie SET und GET ausführen:

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

Sie haben jetzt mit redis-cli eine Verbindung mit Ihrer Azure Cache for Redis-Instanz hergestellt.

Alternativen zu redis-cli

Auch wenn die redis-cli ein nützliches Tool ist, können Sie auch auf andere Arten eine Verbindung mit Ihrem Cache zur Problembehandlung oder zum Testen herstellen:

  • Azure Cache for Redis bietet eine in das Azure-Portal integrierte Redis-Konsole, mit der Sie Befehle ausgeben können, ohne das Befehlszeilentool installieren zu müssen. Das Redis-Konsolenfeatures ist derzeit nur in den Tarifen „Basic“, „Standard“ und „Premium“ verfügbar.
  • RedisInsight ist ein umfangreiches grafisches Open Source-Tool zum Ausgeben von Redis-Befehlen und zum Anzeigen des Inhalts einer Redis-Instanz. Es funktioniert mit Azure Cache for Redis und wird unter Linux, Windows und macOS unterstützt.

Zugehöriger Inhalt

Beginnen Sie, indem Sie eine neue Cache-Instanz im Enterprise-Tarif erstellen.