Utiliser les outils clients pour gérer les données dans Azure Redis managé

Vous pouvez utiliser les outils suivants pour accéder aux données et les gérer dans Azure Redis managé en tant que client. Utilisez ces outils pour interagir directement avec votre instance Azure Redis managée et pour le débogage et la résolution des problèmes.

• Redis Insight
• Outil en ligne de commande Redis CLI

Redis Insight

Redis Insight est un outil graphique et CLI open source riche permettant d’émettre des commandes Redis et d’afficher le contenu d’une instance Redis. Il fonctionne avec Azure Redis managé et est pris en charge sur Linux, Windows et macOS.

Installer Redis Insight

Pour installer Redis Insight, suivez les instructions de la documentation Redis Insight.

Configurer l’accès à Azure Redis managé avec Redis Insight

Redis Insight peut s’authentifier auprès d’Azure instance Redis managée à l’aide de Microsoft Entra ID ou de l’authentification par clé d’accès. Nous vous recommandons d’utiliser Microsoft Entra ID pour une meilleure sécurité.

À compter de la version 3.2.0, Redis Insight peut s'authentifier à Azure Redis géré avec Microsoft Entra ID à l’aide du flux PKCE OAuth 2.0, ce qui permet la découverte automatique des bases de données sur les abonnements et une authentification sans mot de passe.

Pour obtenir des instructions sur la configuration de l’accès à Azure Redis managé avec Redis Insight, consultez le Redis Insight GitHub référentiel. Il s’agit d’une configuration unique par locataire Azure.

Se connecter à Azure Redis managé avec Redis Insight

Une fois l’accès Microsoft Entra ID configuré, connectez-vous à une instance redis managée Azure dans Redis Insight en procédant comme suit :

1. Dans Redis Insight, sous l’onglet Bases de données Redis , sélectionnez + Connecter une base de données existante.
2. Dans la fenêtre Add database, sélectionnez Azure Managed Redis.
3. Suivez les invites pour vous connecter à l’aide de l’authentification Microsoft Entra ID.
4. Dans la page Subscription, sélectionnez l’abonnement qui contient votre instance Azure Managed Redis, puis sélectionnez Ajouter une base de données.
5. Sélectionnez l’instance Azure Redis managée (base de données) à laquelle vous souhaitez vous connecter, puis sélectionnez Add database. Vous pouvez sélectionner plusieurs bases de données pour vous connecter en même temps.
6. Répétez les étapes précédentes pour ajouter Azure instances Redis gérées selon les besoins dans le même abonnement ou un autre abonnement Azure.

• Après avoir ajouté une Azure instance Redis managée, vous pouvez la sélectionner dans la liste des bases de données Redis dans Redis Insight et commencer à émettre des commandes et à afficher des données.

• Pour accéder à l’interface CLI intégrée, sélectionnez (>_ CLI) en bas de l’écran pour la base de données sélectionnée.

Outil en ligne de commande Redis CLI

Utilisez l’outil en ligne de commande redis-cli pour interagir avec une instance Redis managée Azure en tant que client. Utilisez redis_cli comme moyen léger d’émettre des commandes et pour effectuer des tests reproductibles dans les scripts.

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 la 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 :

• Utilisation de Azure CLI avec az redisenterprise database list-keys
• Azure PowerShell à l’aide de Get-AzRedisEnterpriseCacheKey
• Utilisation du portail Azure

Dans cette section, vous récupérez les informations à partir du portail Azure.

Pour connecter votre Azure serveur Redis managé, le client de cache a besoin du point de terminaison de cache, du port 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 obtenir ces informations à partir du portail Azure.

• Pour obtenir le point de terminaison et le port de votre cache, sélectionnez Vue d’ensemble dans le menu Ressource . Le point de terminaison est de la forme {yourcachename}.{region}.redis.azure.net. Le port est 10000 pour toutes les instances Redis gérées Azure.

• Pour obtenir les clés d’accès, sélectionnez Authentification dans le menu Paramètres . Sélectionnez ensuite l’onglet Touches d’accès . Ici, vous trouverez les clés primaires et secondaires du cache. Vous pouvez utiliser l’une ou l’autre clé pour vous connecter à votre outil client.

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 Windows Terminal pour ouvrir une ligne de commande Linux. Avant de vous connecter avec redis-cli, vérifiez :

1. Indique si l’accès TLS est nécessaire : par défaut, Azure instances Redis managées utilisent TLS chiffrement 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 Redis gérées Azure 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 redis managée Azure à l’aide de la stratégie de cluster Entreprise avec TLS :

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

2. Connectez-vous à une instance redis managée Azure à l’aide de la stratégie de cluster OSS et du protocole 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 à votre instance Redis managée Azure. 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 Redis managée Azure à l'aide de l'interface de ligne de commande redis-cli.

Contenu connexe

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