Se connecter à une instance Redis

Cette page explique comment se connecter à une instance Redis à l'aide de Compute Engine et Google Kubernetes Engine. Il fournit également des instructions pour tester les commandes Redis de base avec Telnet.

Pour obtenir la liste des environnements Google Cloud compatibles avec Memorystore pour Redis, consultez la section Environnements compatibles. Certains environnements sans serveur compatibles avec Memorystore nécessitent un connecteur d'accès au VPC sans serveur. Pour en savoir plus, consultez la section Exigences relatives au connecteur d'accès au VPC sans serveur.

Se connecter à une instance Redis depuis une VM Compute Engine

Vous pouvez vous connecter à une instance Redis depuis n'importe quelle instance de VM Compute Engine située dans le même projet, la même région et le même réseau que celle-ci.

  1. Suivez les instructions de la section Démarrage rapide à l'aide d'une VM Linux pour créer une instance de VM Compute Engine et vous connecter à cette dernière. Assurez-vous de créer l'instance de VM Compute Engine dans la même région que celle de l'instance Redis. Si vous avez utilisé une image Debian 8 pour créer votre instance de VM comme décrit dans le guide de démarrage rapide, installez telnet à l'aide de apt-get :

    sudo apt-get install telnet
    
  2. Depuis le terminal, connectez telnet à l'adresse IP de l'instance Redis, en remplaçant les variables par les valeurs appropriées.

          telnet instance-ip-address 6379
    

    Si l'opération réussit, la commande renvoie ce résultat :

          Trying instance-ip-address…
          Connected to instance-ip-address
    
  3. Dans la session telnet, renseignez quelques commandes Redis. Exemple :

    Saisissez les informations suivantes :

    PING
    

    Résultat :

    PONG
    

    OK

    SET HELLO WORLD
    

    Résultat :

    +OK
    

    Saisissez les informations suivantes :

    GET HELLO
    

    Résultat :

    $5
    WORLD
    

Vous pouvez également utiliser le client Redis pour émettre des commandes vers l'instance Redis. Pour en savoir plus sur l'utilisation du client Redis, reportez-vous au Guide de démarrage rapide de Redis.

Se connecter à une instance Redis à partir d'un cluster Google Kubernetes Engine

Vous pouvez vous connecter aux instances Redis à partir de clusters Google Kubernetes Engine situés dans la même région et utilisant le même réseau que votre instance.

Se connecter à partir d'un pod exécutant une interface système bash

  1. Accédez à la page GKE dans Cloud Console.
    GKE
  2. Cliquez sur le cluster GKE à partir duquel vous souhaitez effectuer la connexion. Si vous ne possédez pas encore de cluster, vous devez en créer un dans la même zone et la même région que votre instance Redis avec les alias d'adresses IP activés. Pour découvrir comment créer un cluster avec les alias d'adresses IP activés, consultez la documentation relative aux alias d'adresses IP.
  3. Cliquez sur le bouton Se connecter situé à droite du nom de votre cluster, puis sur le bouton Exécuter dans Cloud Shell dans la fenêtre qui s'affiche.
  4. Configurez l'accès à la ligne de commande kubectlkubectl en exécutant la commande suivante :
    gcloud container clusters get-credentials CLUSTER_NAME --zone=CLUSTER_ZONE --project=PROJECT_ID
    • CLUSTER_NAME est le nom du cluster.
    • CLUSTER_ZONE est la zone dans laquelle se trouve le cluster. Elle doit également correspondre à la zone de votre instance Redis.
    • PROJECT_ID est le projet dans lequel le cluster et les instances Redis se trouvent.
    Un message confirmant le succès de l'opération doit s'afficher : kubeconfig generated for CLUSTER_NAME
  5. Si le cluster est de version 1.8 ou supérieure et que les alias d'adresses IP sont activés, ignorez cette étape. Si votre cluster est de version 1.7 ou inférieure, ou si les alias d'adresses IP ne sont pas activés sur votre cluster de version 1.8 ou supérieure, procédez comme suit avant d'essayer de vous connecter à l'instance : Pour en savoir plus sur les alias d'adresses IP et sur la création de clusters avec ce paramètre activé, consultez la documentation relative aux alias d'adresses IP.
  6. Utilisez la commande suivante pour vous connecter à une interface système bash :
    kubectl run -i --tty busybox --image=busybox -- sh
  7. Connectez telnet sur votre instance Redis à l'aide de l'adresse de l'hôte et du numéro de port :
    telnet HOST-IP PORT
  8. Renseignez une commande Redis de base pour vérifier la connexion. Exemple :
    PING
    +PONG
  9. Pour quitter la connexion telnet, appuyez sur Ctrl + C (ou sur Commande + C sur Mac). Pour quitter l'interface système bash de votre pod, renseignez la commande "return". Si vous avez terminé et n'avez plus besoin de vous connecter à Redis, exécutez la commande suivante à partir du répertoire /k8s-custom-iptables/ :
    ./uninstall.sh

Se connecter à une instance Redis à partir d'un pod Google Kubernetes Engine

Avant de commencer, vous avez besoin d'un cluster GKE. Si vous n'en possédez pas encore, créez-en un dans la même zone et la même région que votre instance Redis, en activant les alias d'adresses IP. Pour savoir comment procéder, consultez la documentation relative aux alias d'adresses IP.

  1. Dans l'angle supérieur droit de la console, cliquez sur le bouton Activer Cloud Shell Activer Cloud Shell.
  2. Configurez l'accès à la ligne de commande kubectlkubectl en exécutant la commande suivante :
    gcloud container clusters get-credentials CLUSTER_NAME --zone CLUSTER_ZONE --project PROJECT_ID
    • CLUSTER_NAME est le nom du cluster.
    • CLUSTER_ZONE est la zone dans laquelle se trouve le cluster. Elle doit également correspondre à la zone de votre instance Redis.
    • PROJECT_ID est le projet dans lequel le cluster et les instances Redis se trouvent.
    Un message confirmant le succès de l'opération doit s'afficher : kubeconfig generated for CLUSTER_NAME
  3. Si le cluster est de version 1.8 ou supérieure et que les alias d'adresses IP sont activés, ignorez cette étape. Si votre cluster est de version 1.7 ou inférieure, ou si les alias d'adresses IP ne sont pas activés sur votre cluster de version 1.8 ou supérieure, procédez comme suit avant d'essayer de vous connecter à l'instance : Pour en savoir plus sur les alias d'adresses IP et sur la création de clusters avec ce paramètre activé, consultez la documentation relative aux alias d'adresses IP.
  4. Exécutez la commande suivante pour démarrer un pod Redis exécutant la commande redis-cli :
    kubectl run -i --tty redisbox --image=gcr.io/google_containers/redis:v1 -- sh
  5. Exécutez une commande redis-cli en remplaçant HOST-IP par l'adresse IP de l'hôte de votre instance Redis :
    redis-cli -h HOST-IP info
  6. Vous pouvez éventuellement exécuter une commande Benchmark Redis en remplaçant à nouveau HOST-IP par l'adresse IP de l'hôte de votre instance Redis :
    redis-benchmark -c 100 -n 100000 -d 1024 -r 100000 -t PING,SET,GET,INCR,LPUSH,RPUSH,LPOP,RPOP,SADD,SPOP,MSET -h HOST-IP -q
  7. Pour quitter le pod Redis, saisissez return. Si vous avez terminé et n'avez plus besoin de vous connecter à Redis, exécutez la commande suivante à partir du répertoire /k8s-custom-iptables/ :
    ./uninstall.sh

Étape suivante

Connectez-vous à l'instance Redis à l'aide d'un exemple d'application s'exécutant sur les environnements suivants :