Dela via


Använd redis-kommandoradsverktyget med Azure Managed Redis (förhandsversion)

Använd kommandoradsverktyget redis-cli för att interagera med en Azure Managed Redis (förhandsversion) som klient. Använd det här verktyget för att interagera direkt med din Azure Managed Redis-instans och för felsökning och felsökning.

Installera redis-cli

Redis-cli-verktyget installeras automatiskt med Redis-paketet, som är tillgängligt för flera operativsystem. Se öppen källkod installera Redis-guiden för den mest detaljerade dokumentationen om ditt operativsystem.

Linux

Redis-cli körs internt i Linux, och de flesta distributioner innehåller ett Redis-paket som innehåller redis-cli-verktyget. I Ubuntu installerar du till exempel Redis-paketet med följande kommandon:

sudo apt-get update
sudo apt-get install redis

Windows

Det bästa sättet att använda redis-cli på en Windows-dator är att installera Windows-undersystem för Linux (WSL). Med Linux-undersystemet kan du köra Linux-verktyg direkt i Windows. Om du vill installera WSL följer du installationsanvisningarna för WSL.

När WSL har installerats kan du installera redis-cli med den pakethantering som är tillgänglig i den Linux-distribution som du valde för WSL.

Samla in information om cacheåtkomst

Du kan samla in den information som behövs för att komma åt cacheminnet med hjälp av följande metoder:

I det här avsnittet hämtar du nycklarna från Azure Portal.

Hämta värdnamn, portar och åtkomstnycklar från Azure Portal

För att ansluta din Azure Cache for Redis-server behöver cacheklienten värdnamnet, portarna och en nyckel för cachen. Vissa klienter kan hänvisa till dessa objekt med namn som skiljer sig något. Du kan hämta värdnamnet, portarna och nycklarna från Azure Portal.

  • Om du vill hämta värdnamnet och portarna för cacheminnet väljer du Översiktresursmenyn . Värdnamnet är av formuläret <DNS name>.redis.cache.windows.net.

    Skärmbild som visar Azure Cache for Redis-egenskaper.

  • Om du vill hämta åtkomstnycklarna väljer du Autentiseringresursmenyn . Välj sedan fliken Åtkomstnycklar .

    Skärmbild som visar Åtkomstnycklar för Azure Cache for Redis.

Ansluta med redis-cli

Öppna ett gränssnitt eller en terminal på en dator med Redis-paketet installerat. Om du använder WSL kan du använda Windows-terminal för att öppna en Linux-kommandorad. Kontrollera innan du ansluter med redis-cli:

  1. Om TLS-åtkomst behövs – Som standard använder Azure Managed Redis-instanser TLS-kryptering för anslutningar. När TLS används på serversidan måste TLS på redis-cli aktiveras med hjälp av --tls alternativet .
  2. Porten som används – alla Azure Managed Redis-instanser använder port 10000. Observera att detta skiljer sig från standardvärdet för Redis Community Edition, som är 6379.
  3. Om cacheinstansen använder OSS-klusterprincipen – Om du använder OSS-klusterprincipen -clägger du till alternativet för att säkerställa att alla shards kan nås.

Exempel

  1. Anslut till en Azure Managed Redis-instans med enterprise-klusterprincip med TLS:

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
    
  2. Anslut till en Azure Managed Redis-instans med OSS-klusterprincip och TLS:

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

Testa anslutningen

När anslutningen har upprättats kan du utfärda kommandon till din Azure Managed Redis-instans. Ett enkelt sätt att testa anslutningen är att använda PING kommandot . Det här kommandot returnerar PONG i -konsolen.

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

Du kan också köra kommandon som SET och GET:

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

Nu är du ansluten till din Azure Managed Redis-instans med hjälp av redis-cli.

redis-cli-alternativ

Även om redis-cli är ett användbart verktyg kan du ansluta till cacheminnet på andra sätt för felsökning eller testning:

  • RedisInsight är ett omfattande öppen källkod grafiskt verktyg för att utfärda Redis-kommandon och visa innehållet i en Redis-instans. Det fungerar med Azure Managed Redis och stöds i Linux, Windows och macOS.

Kom igång genom att skapa en ny Azure Managed Redis Instance-instans.