Démarrage rapide avec l'outil de ligne de commande gcloud

Cette page explique comment créer une instance Memorystore pour Redis, s'y connecter, puis la supprimer.

Avant de commencer

Connectez-vous à votre compte Google.
Si vous n'en possédez pas déjà un, vous devez en créer un.

Dans Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Cloud.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

Accéder à la page de sélection du projet

Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

Si vous ne l'avez pas déjà fait, installez le SDK Cloud.
Lorsque vous y êtes invité, choisissez le projet que vous avez sélectionné ou créé ci-dessus.
Si le SDK Cloud est déjà installé, mettez-le à jour.
```
gcloud components update
```

Créer une instance Memorystore pour Redis

Pour créer une instance Memorystore pour Redis :

Ouvrez une fenêtre de terminal.
Définissez le projet dans lequel vous souhaitez créer votre instance comme projet par défaut dans gcloud en saisissant la commande suivante :
```
gcloud config set core/project PROJECT_ID
```
Saisissez la commande suivante pour créer une instance Redis de base de 2 Gio dans la région us-central1 :
```
gcloud redis instances create myinstance --size=2 --region=us-central1 \
    --redis-version=redis_5_0
```

Une fois l'instance créée, saisissez la commande describe pour obtenir l'adresse IP et le port de l'instance :

gcloud redis instances describe myinstance --region=us-central1

Si l'opération réussit, gcloud renvoie les éléments suivants :

authorizedNetwork: projects/my-project/global/networks/default
createTime: '2018-04-09T21:47:56.824081Z'
currentLocationId: us-central1-a
host: 10.0.0.27
locationId: us-central1-a
memorySizeGb: 2
name: projects/my-project/locations/us-central1/instances/myinstance
networkThroughputGbps: 2
port: 6379
redisVersion: REDIS_4_0
reservedIpRange: 10.0.0.24/29
state: READY
tier: BASIC

Vous pouvez utiliser les valeurs host et port pour vous connecter à l'instance.

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.

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
```
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
```
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.

Nettoyer

Pour éviter que des frais ne soient facturés sur votre compte Google Cloud pour les ressources utilisées dans ce guide de démarrage rapide, supprimez l'instance en saisissant la commande suivante :
```
gcloud redis instances delete myinstance --region=us-central1
```

Saisissez Y pour confirmer l'instance à supprimer :

You are about to delete instance [myinstance] in [us-central1].
Any associated data will be lost.
Do you want to continue (Y/n)? Y
Delete request issued for: [myinstance]

Si l'opération réussit, gcloud renvoie les éléments suivants :

Deleted instance [myinstance].

Étape suivante

Découvrez comment créer et gérer des instances.
Découvrez d'autres manières de vous connecter à l'instance Redis.
Découvrez les caractéristiques d'une instance Redis.