Créer une instance Memorystore pour Redis à l'aide de gcloud CLI

Créer une instance Memorystore pour Redis à l'aide de gcloud CLI

Découvrez comment créer une instance Memorystore pour Redis, vous y connecter, puis la supprimer.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud , cliquez sur Visite guidée :

Visite guidée

---

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Si ce n'est pas déjà fait, installez Google Cloud CLI.

   Lorsque vous y êtes invité, choisissez le projet que vous avez sélectionné ou créé.

2. Si vous avez déjà installé la Google Cloud CLI, mettez-la à jour.

   gcloud components update

Rôles requis

Pour obtenir les autorisations nécessaires pour créer une instance Memorystore pour Redis, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Administrateur Cloud Memorystore pour Redis (roles/redis.admin)
• Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)
• Utilisateur du compte de service (roles/iam.serviceAccountUser)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une instance Memorystore pour Redis

Dans cette section, vous allez créer une instance Memorystore pour Redis de 2 Go située dans la région us-central1 et appartenant au niveau de base. Pour en savoir plus sur les niveaux, consultez la section Fonctionnalités de niveau Redis.

1. Ouvrez une fenêtre de terminal.

2. Pour définir le projet dans lequel vous souhaitez créer votre instance comme projet par défaut, saisissez la commande suivante :

   gcloud config set core/project PROJECT_ID
   

3. Pour créer une instance Redis de base de 2 Gio dans la région us-central1, saisissez la commande suivante :

   gcloud redis instances create myinstance --size=2 --region=us-central1 \
   --redis-version=redis_6_x
   

4. Une fois l'instance créée, saisissez la commande suivante pour obtenir son adresse IP et son numéro de port :

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

   Si vous pouvez accéder à l'instance, la commande renvoie le résultat suivant :

   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_6_X
   reservedIpRange: 10.0.0.24/29
   state: READY
   tier: BASIC

5. Notez les valeurs host et port de votre instance. Vous avez besoin de ces valeurs pour vous connecter à l'instance.

Se connecter à l'instance Memorystore pour Redis depuis une VM Compute Engine

Vous pouvez vous connecter à une instance Memorystore pour Redis depuis n'importe quelle VM Compute Engine utilisant le réseau autorisé de l'instance avec une adresse IP RFC 1918 compatible.

1. Si vous ne disposez pas d'une VM Compute Engine utilisant le même réseau autorisé que votre instance, créez-en une et connectez-vous à la VM à l'aide de SSH. Pour ce faire, suivez les étapes décrites dans Créer une instance de VM Linux dans Compute Engine.

2. Installez telnet à l'aide de apt-get :

   sudo apt-get install telnet
   

3. Depuis le terminal, connectez telnet à l'adresse IP de l'instance. Remplacez VARIABLES par les valeurs appropriées.

   telnet INSTANCE_IP_ADDRESS 6379
   

   Si vous parvenez à vous connecter à l'instance, la commande renvoie le résultat suivant :

   Trying INSTANCE_IP_ADDRESS…
   Connected to INSTANCE_IP_ADDRESS
   

4. Dans la session telnet, renseignez quelques commandes Redis. Exemple :

   Saisissez le code suivant :

   PING
   

   Résultat :

   PONG
   

   Saisissez les informations suivantes :

   SET HELLO WORLD
   

   Résultat :

   +OK
   

   Saisissez le code suivant :

   GET HELLO
   

   Résultat :

   $5
   WORLD
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

1. Pour supprimer l'instance, saisissez la commande suivante :

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

2. Pour confirmer la suppression, saisissez Y :

   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 vous pouvez supprimer l'instance, la commande renvoie le résultat suivant :

   Deleted instance [myinstance].

3. Facultatif. Si vous avez créé une VM Compute Engine pour ce guide de démarrage rapide, supprimez-la.

Étapes suivantes

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