Delen via

Het redis-opdrachtregelprogramma gebruiken met Azure Managed Redis (preview)

  • Artikel

Gebruik het opdrachtregelprogramma redis-cli om te communiceren met een Azure Managed Redis (preview) als client. Gebruik dit hulpprogramma om rechtstreeks te communiceren met uw Azure Managed Redis-exemplaar en voor foutopsporing en probleemoplossing.

Redis-cli installeren

Het redis-cli-hulpprogramma wordt automatisch geïnstalleerd met het Redis-pakket, dat beschikbaar is voor meerdere besturingssystemen. Raadpleeg de opensource-installatie redis-handleiding voor de meest gedetailleerde documentatie over uw voorkeursbesturingssysteem.

Linux

De redis-cli wordt systeemeigen uitgevoerd op Linux en de meeste distributies bevatten een Redis-pakket dat het redis-cli-hulpprogramma bevat. Op Ubuntu installeert u bijvoorbeeld het Redis-pakket met de volgende opdrachten:

sudo apt-get update
sudo apt-get install redis

Windows

De beste manier om redis-cli op een Windows-computer te gebruiken, is door de Windows-subsysteem voor Linux (WSL) te installeren. Met het Linux-subsysteem kunt u Linux-hulpprogramma's rechtstreeks in Windows uitvoeren. Volg de installatie-instructies voor WSL om WSL te installeren.

Zodra WSL is geïnstalleerd, kunt u redis-cli installeren met behulp van welk pakketbeheer ook beschikbaar is in de Linux-distributie die u voor WSL hebt gekozen.

Cachetoegangsgegevens verzamelen

U kunt de informatie verzamelen die nodig is voor toegang tot de cache met behulp van deze methoden:

In deze sectie haalt u de sleutels op uit Azure Portal.

Hostnaam, poorten en toegangssleutels ophalen uit Azure Portal

Om verbinding te maken met uw Azure Cache voor Redis-server, heeft de cacheclient de hostnaam, poorten en een sleutel voor de cache nodig. Sommige clients kunnen enigszins andere namen gebruiken om naar deze items te verwijzen. U kunt de hostnaam, poorten en toegangssleutels ophalen uit Azure Portal.

  • Als u de toegangssleutels wilt ophalen, selecteert u Verificatie in het menu Resource. Selecteer vervolgens het tabblad Toegangstoetsen .

    Schermopname van Azure Cache voor Redis toegangssleutels.

  • Als u de hostnaam en poorten voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource. De hostnaam is van de dns-naam> van het formulier.redis.cache.windows.net<.

    Schermopname van Azure Cache voor Redis eigenschappen.

Verbinding maken met redis-cli

Open een shell of terminal op een computer waarop het Redis-pakket is geïnstalleerd. Als u WSL gebruikt, kunt u de Windows-terminal gebruiken om een Linux-opdrachtregel te openen. Voordat u verbinding maakt met redis-cli, controleert u:

  1. Of TLS-toegang nodig is: azure Managed Redis-exemplaren maken standaard gebruik van TLS-versleuteling voor verbindingen. Wanneer TLS aan de serverzijde wordt gebruikt, moet TLS op redis-cli worden ingeschakeld met behulp van de --tls optie.
  2. De gebruikte poort: alle Beheerde Redis-exemplaren van Azure gebruiken poort 10000. Houd er rekening mee dat dit anders is dan de standaardversie van de Redis-community.6379
  3. Of het cache-exemplaar het OSS-clusterbeleid gebruikt: als u het OSS-clusterbeleid gebruikt, voegt u de -coptie toe om ervoor te zorgen dat alle shards toegankelijk zijn.

Voorbeelden

  1. Verbinding maken met een Azure Managed Redis-exemplaar met behulp van Enterprise-clusterbeleid met TLS:

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

  2. Verbinding maken met een Azure Managed Redis-exemplaar met behulp van OSS-clusterbeleid en TLS:

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

De verbinding testen

Zodra de verbinding tot stand is gebracht, kunt u opdrachten uitgeven aan uw Azure Managed Redis-exemplaar. Een eenvoudige manier om de verbinding te testen, is door de PING opdracht te gebruiken. Deze opdracht wordt geretourneerd PONG in de console.

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

U kunt ook opdrachten uitvoeren zoals SET en GET:

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

U bent nu verbonden met uw azure Managed Redis-exemplaar met behulp van de redis-cli.

alternatieven voor redis-cli

Hoewel de redis-cli een nuttig hulpprogramma is, kunt u op andere manieren verbinding maken met uw cache om problemen op te lossen of te testen:

  • RedisInsight is een uitgebreid opensource-grafische hulpprogramma voor het uitgeven van Redis-opdrachten en het weergeven van de inhoud van een Redis-exemplaar. Het werkt met Azure Managed Redis en wordt ondersteund in Linux, Windows en macOS.

Gerelateerde inhoud

Ga aan de slag door een nieuw exemplaar van Azure Managed Redis Instance te maken.