Verwenden des Redis-Befehlszeilentools mit Azure Cache for Redis

Artikel
01/06/2024

Verwenden Sie das Befehlszeilentool redis-cli, um mit einem Azure-Cache für Redis als Client zu interagieren. Verwenden Sie dieses Tool, um direkt mit Ihrem Azure Cache für Redis-Instanz und zum Debuggen und Zur Problembehandlung zu interagieren.

Installieren von redis-cli

Das Redis-cli-Tool wird automatisch mit dem Redis-Paket installiert, das für mehrere Betriebssysteme verfügbar ist. Im Redis-Handbuch für die Open Source-Installation finden Sie die detaillierteste Dokumentation zu Ihrem bevorzugten Betriebssystem.

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. Auf 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. Um WSL zu installieren, befolgen Sie 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

Mithilfe dieser Methoden können Sie die erforderlichen Informationen sammeln, um auf den Cache zuzugreifen:

Über Azure CLI mit az redis list-keys
Azure PowerShell mithilfe von Get-AzRedisCacheKey
Verwenden des Azure-Portals

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

Abrufen von Hostname, Ports und Zugriffsschlüsseln vom Azure-Portal

Um ihren Azure Cache for Redis-Server zu verbinden, benötigt der Cacheclient den Hostnamen, die Ports und einen Schlüssel für den Cache. Von einigen Clients wird unter Umständen mit etwas anderen Namen auf diese Elemente verwiesen. Sie können den Hostnamen, Ports und Zugriffsschlüssel vom Azure-Portal abrufen.

Wählen Sie Zugriffsschlüssel aus, um die Zugriffsschlüssel aus dem linken Navigationsbereich des Cache abzurufen.
Wählen Sie Eigenschaften aus, um den Hostnamen und die Ports aus dem linken Navigationsbereich des Cache abzurufen. Der Hostname hat das Format <DNS-Name>.redis.cache.windows.net.

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 die Windows-Terminal verwenden, um eine Linux-Befehlszeile zu öffnen. Bevor Sie eine Verbindung mit redis-cli herstellen, überprüfen Sie Folgendes:

Ob TLS-Zugriff erforderlich ist – Standardmäßig verwenden Azure Cache für Redis-Instanzen TLS-Verschlüsselung für Verbindungen. Wenn TLS auf serverseitiger Seite verwendet wird, muss TLS auf Redis-Cli mithilfe der --tls Option aktiviert werden.
Der verwendete Port – Alle Caches der Enterprise- und Enterprise Flash-Ebene verwenden portiert 10000. Standard-, Standard- und Premium-Caches verwenden jedoch entweder Port für Nicht-TLS-Verbindungen oder Port 63796380 für TLS-Verbindungen.
Gibt an, ob die Cacheinstanz Clustering verwendet– Wenn Sie einen Premium-Cache verwenden, der Clustering oder einen Enterprise/Enterprise Flash-Cache verwendet, der die OSS-Clusterrichtlinie verwendet, fügen Sie die -cOption hinzu, um sicherzustellen, dass auf alle Shards zugegriffen werden kann.

Beispiele

Verwenden Sie den folgenden Befehl, um eine Verbindung mit einem Azure-Cache der Stufe "Basic", "Standard" oder "Premium" für Redis-Instanzen mithilfe von TLS herzustellen:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
Verbinden zu einer Azure-Instanz der Stufe "Basic", "Standard" oder "Premium", die TLS nicht verwendet:
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
Verbinden mithilfe von TLS und Clustering zu einem Azure-Cache der Stufe "Basic", "Standard" oder "Premium":
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```
Verbinden einer Enterprise- oder Enterprise Flash-Cacheinstanz mithilfe der Enterprise-Clusterrichtlinie mit TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
```
Verbinden einer Enterprise- oder Enterprise Flash-Cacheinstanz mithilfe der OSS-Clusterrichtlinie ohne TLS:
```
redis-cli.exe -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 Ihren Azure-Cache für Redis-Instanz ausgeben. Eine einfache Möglichkeit zum Testen der Verbindung ist die Verwendung des PING Befehls. Dieser Befehl gibt in der Konsole zurück PONG .

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

Sie können auch Befehle wie SET und GET:

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

Sie sind jetzt mithilfe der Redis-Cli mit Ihrem Azure-Cache für Redis-Instanz verbunden.

Redis-Cli-Alternativen

Während die Redis-Cli ein nützliches Tool ist, können Sie eine Verbindung mit Ihrem Cache auf andere Arten zur Problembehandlung oder zum Testen herstellen:

Azure Cache for Redis bietet eine Redis-Konsole, die in die Azure-Portal integriert ist, in der Sie Befehle ausgeben können, ohne das Befehlszeilentool installieren zu müssen. Das Redis Console-Feature ist derzeit nur in den Stufen "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 für Redis und wird unter Linux, Windows und macOS unterstützt.

Erste Schritte durch Erstellen einer neuen Cacheinstanz auf Unternehmensebene.