Jak używać narzędzia wiersza polecenia Redis z usługą Azure Cache for Redis

Artykuł
01/06/2024

Użyj narzędzia wiersza polecenia redis-cli, aby wchodzić w interakcje z usługą Azure Cache for Redis jako klientem. To narzędzie umożliwia bezpośrednią interakcję z wystąpieniem usługi Azure Cache for Redis oraz debugowaniem i rozwiązywaniem problemów.

Instalowanie interfejsu wiersza polecenia redis

Narzędzie redis-cli jest instalowane automatycznie z pakietem Redis, który jest dostępny dla wielu systemów operacyjnych. Aby uzyskać najbardziej szczegółową dokumentację dotyczącą preferowanego systemu operacyjnego, zapoznaj się z przewodnikiem dotyczącym instalacji usługi Redis typu open source.

Linux

Interfejs wiersza polecenia redis działa natywnie w systemie Linux, a większość dystrybucji obejmuje pakiet Redis zawierający narzędzie redis-cli . Na przykład w systemie Ubuntu zainstalujesz pakiet Redis za pomocą następujących poleceń:

sudo apt-get update
sudo apt-get install redis

Windows

Najlepszym sposobem korzystania z interfejsu wiersza polecenia redis na komputerze z systemem Windows jest zainstalowanie Podsystem Windows dla systemu Linux (WSL). Podsystem Linux umożliwia uruchamianie narzędzi systemu Linux bezpośrednio w systemie Windows. Aby zainstalować program WSL, postępuj zgodnie z instrukcjami instalacji programu WSL.

Po zainstalowaniu programu WSL można zainstalować interfejs redis-cli przy użyciu dowolnego zarządzania pakietami dostępnego w dystrybucji systemu Linux wybranej dla usługi WSL.

Zbieranie informacji o dostępie do pamięci podręcznej

Informacje potrzebne do uzyskania dostępu do pamięci podręcznej można zebrać przy użyciu następujących metod:

Interfejs wiersza polecenia platformy Azure przy użyciu polecenia az redis list-keys
Program Azure PowerShell przy użyciu polecenia Get-AzRedisCacheKey
Korzystanie z witryny Azure Portal

W tej sekcji pobierzesz klucze z witryny Azure Portal.

Pobieranie nazwy hosta, portów i kluczy dostępu z witryny Azure Portal

Aby połączyć serwer usługi Azure Cache for Redis, klient pamięci podręcznej potrzebuje nazwy hosta, portów i klucza pamięci podręcznej. Niektórzy klienci mogą odwoływać się do tych elementów przy użyciu nieco innych nazw. Nazwę hosta, porty i klucze można uzyskać w witrynie Azure Portal.

Aby uzyskać klucze dostępu, w obszarze nawigacji po lewej stronie pamięci podręcznej wybierz pozycję Klucze dostępu.
Aby uzyskać nazwę hosta i porty, w obszarze nawigacji po lewej stronie pamięci podręcznej wybierz pozycję Właściwości. Nazwa hosta ma formę <DNS name.redis.cache.windows.net>.

Połączenie przy użyciu interfejsu wiersza polecenia redis

Otwórz powłokę lub terminal na komputerze z zainstalowanym pakietem Redis. Jeśli używasz protokołu WSL, możesz użyć Terminal Windows, aby otworzyć wiersz polecenia systemu Linux. Przed nawiązaniem połączenia z interfejsem redis-cli sprawdź:

Czy wymagany jest dostęp do protokołu TLS — domyślnie wystąpienia usługi Azure Cache for Redis używają szyfrowania TLS dla połączeń. Zawsze, gdy protokół TLS jest używany po stronie serwera, protokół TLS w interfejsie wiersza polecenia redis musi być włączony przy użyciu --tls opcji .
Używany port — wszystkie pamięci podręczne w warstwie Flash przedsiębiorstwa i przedsiębiorstwa używają portu 10000. Pamięci podręczne w warstwie Podstawowa, Standardowa i Premium używają jednak portu 6379 dla połączeń innych niż TLS lub portów 6380 dla połączeń TLS.
Niezależnie od tego, czy wystąpienie pamięci podręcznej korzysta z klastrowania — jeśli używasz pamięci podręcznej w warstwie Premium korzystającej z klastra lub pamięci podręcznej warstwy Flash przedsiębiorstwa/przedsiębiorstwa korzystającej z zasad klastra systemu operacyjnego, dodaj -copcję, aby zapewnić dostęp do wszystkich fragmentów.

Przykłady

Użyj następującego polecenia, aby nawiązać połączenie z wystąpieniem usługi Azure Cache for Redis w warstwie Podstawowa, Standardowa lub Premium przy użyciu protokołu TLS:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
Połączenie do wystąpienia usługi Azure Cache for Redis w warstwie Podstawowa, Standardowa lub Premium, które nie korzysta z protokołu TLS:
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
Połączenie do wystąpienia usługi Azure Cache for Redis w warstwie Podstawowa, Standardowa lub Premium przy użyciu protokołu TLS i klastrowania:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```
Połączenie do wystąpienia pamięci podręcznej warstwy Flash Enterprise lub Enterprise przy użyciu zasad klastra przedsiębiorstwa z protokołem TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
```
Połączenie do wystąpienia pamięci podręcznej w warstwie Enterprise lub Enterprise Flash przy użyciu zasad klastra systemu operacyjnego bez protokołu TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c
```

Testowanie połączenia

Po nawiązaniu połączenia możesz wydać polecenia do wystąpienia usługi Azure Cache for Redis. Jednym z prostych sposobów przetestowania połączenia jest użycie PING polecenia . To polecenie jest zwracane PONG w konsoli programu .

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

Możesz również uruchamiać polecenia, takie jak SET i GET:

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

Teraz masz połączenie z wystąpieniem usługi Azure Cache for Redis przy użyciu interfejsu wiersza polecenia redis.

Alternatywy interfejsu wiersza polecenia redis

Chociaż interfejs wiersza polecenia redis jest przydatnym narzędziem, możesz nawiązać połączenie z pamięcią podręczną na inne sposoby rozwiązywania problemów lub testowania:

Usługa Azure Cache for Redis oferuje konsolę Redis wbudowaną w witrynę Azure Portal, w której można wydać polecenia bez konieczności instalowania narzędzia wiersza polecenia. Funkcja konsoli Redis jest obecnie dostępna tylko w warstwach Podstawowa, Standardowa i Premium.
RedisInsight to zaawansowane narzędzie graficzne typu open source do wydawania poleceń usługi Redis i wyświetlania zawartości wystąpienia usługi Redis. Działa z usługą Azure Cache for Redis i jest obsługiwana w systemach Linux, Windows i macOS.

Rozpocznij od utworzenia nowego wystąpienia pamięci podręcznej warstwy przedsiębiorstwa.