Partager via

Utilisez l'outil de ligne de commande Redis avec Azure Managed Redis (version préliminaire)

  • Article

Utilisez le redis-cli command-line tool pour interagir avec un Azure Managed Redis (préversion) en tant que client. Utilisez cet outil pour interagir directement avec votre instance Azure Managed Redis et pour le débogage et le dépannage.

Installer redis-cli

L’outil redis-cli est installé automatiquement avec le package Redis, qui est disponible pour de multiples systèmes d’exploitation. Consultez le guide open source installer redis pour obtenir la documentation la plus détaillée sur votre système d’exploitation préféré.

Linux

redis-cli s’exécute en mode natif sur Linux, et la plupart des distributions incluent un package Redis qui contient l’outil redis-cli. Sur Ubuntu, par exemple, vous installez le package Redis avec les commandes suivantes :

sudo apt-get update
sudo apt-get install redis

Windows

La meilleure façon d’utiliser redis-cli sur un ordinateur Windows consiste à installer le sous-système Windows pour Linux (Windows Subsystem for Linux/WSL). Le sous-système Linux vous permet d’exécuter des outils Linux directement sur Windows. Pour installer WSL, suivez les instructions d’installation de WSL.

Une fois WSL installé, vous pouvez installer redis-cli à l’aide de la gestion des packages disponible dans la distribution Linux que vous avez choisie pour WSL.

Collecter les informations d’accès au cache

Vous pouvez collecter les informations nécessaires pour accéder au cache à l’aide de ces méthodes :

Dans cette section, vous allez extraire les clés du Portail Azure.

Récupération du nom d’hôte, des ports et des clés d’accès à partir du portail Azure

Pour connecter votre serveur Azure Cache pour Redis, le client de cache a besoin du nom d’hôte, des ports et d’une clé pour le cache. Certains clients peuvent référencer ces éléments par des noms légèrement différents. Vous pouvez récupérer le nom d’hôte, les ports et les clés d’accès à partir du portail Azure.

  • Pour obtenir les clés d’accès, sélectionnez Authentification dans le menu Ressource. Sélectionnez ensuite l’onglet Clés d’accès.

    Capture d’écran montrant des clés d’accès à Azure Cache pour Redis.

  • Pour obtenir le nom d’hôte et les ports de votre cache, sélectionnez Vue d’ensemble dans le menu Ressource. Le nom d’hôte prend la forme <nom DNS>.redis.cache.windows.net.

    Capture d’écran montrant les propriétés d’Azure Cache pour Redis.

Se connecter en utilisant redis-cli

Ouvrez un interpréteur de commandes ou un terminal sur un ordinateur avec le package Redis installé. Si vous utilisez WSL, vous pouvez utiliser le terminal Windows pour ouvrir une ligne de commande Linux. Avant de vous connecter avec redis-cli, vérifiez :

  1. Si l’accès TLS est nécessaire – Par défaut, les instances Azure Managed Redis utilisent le chiffrement TLS pour les connexions. Chaque fois que TLS est utilisé côté serveur, TLS sur redis-cli doit être activé en utilisant l’option --tls.
  2. Le port utilisé - toutes les instances Azure Managed Redis utilisent le port 10000. Notez que ceci est différent de la valeur par défaut de l'édition communautaire Redis, qui est 6379.
  3. Si l'instance de cache utilise la stratégie de cluster OSS - Si vous utilisez la stratégie de cluster OSS, ajoutez l'-coption permettant de garantir que tous les fragments sont accessibles.

Exemples

  1. Connectez-vous à une instance Azure Managed Redis à l’aide de la stratégie de cluster d’entreprise avec TLS :

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

  2. Connectez-vous à une instance Azure Managed Redis à l'aide de la stratégie de cluster OSS et de TLS :

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

Tester la connexion

Une fois la connexion établie, vous pouvez émettre des commandes vers votre instance Azure Managed Redis. Un moyen simple de tester la connexion consiste à utiliser la commande PING. Cette commande retourne PONG dans la console.

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

Vous pouvez également exécuter des commandes comme SET et GET :

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

Vous êtes maintenant connecté à votre instance Azure Managed Redis à l'aide de redis-cli.

Alternatives à redis-cli

Bien que redis-cli soit un outil utile, vous pouvez vous connecter à votre cache de différentes manières pour résoudre les problèmes ou effectuer des tests :

  • RedisInsight est un outil graphique open source riche permettant d’émettre des commandes Redis et d’afficher les contenus d’une instance Redis. Il fonctionne avec Azure Managed Redis et est pris en charge sur Linux, Windows et macOS.

Contenu connexe

Commencez par créer une nouvelle instance Azure Managed Redis Instance.