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

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

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

Ce guide de démarrage rapide utilise le fournisseur Google Cloud Platform pour Terraform.

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 le SDK Google Cloud.

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

2. Si Google Cloud SDK est déjà installé, mettez-le à jour.

   gcloud components update

3. Activez l'API Memorystore pour Redis.
   Memorystore pour Redis
4. Préparez un fichier Terraform auquel vous pouvez ajouter la ressource Memorystore. Pour obtenir des instructions sur la configuration de Terraform avec Google Cloud, consultez la page Premiers pas avec le fournisseur Google Cloud.

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. Ajoutez la ressource suivante à votre fichier de configuration Terraform :

   resource "google_redis_instance" "my_memorystore_redis_instance" {
     name           = "myinstance"
     tier           = "BASIC"
     memory_size_gb = 2
     region         = "us-central1"
     redis_version  = "REDIS_6_X"
   }
   

2. Ajoutez la valeur de sortie suivante à votre fichier de configuration Terraform pour imprimer l'adresse IP de l'instance. Vous en aurez besoin pour vous connecter à votre instance.

   output "host" {
    description = "The IP address of the instance."
    value = "${google_redis_instance.my_memorystore_redis_instance.host}"
   }
   

3. Exécutez la commande terraform init.

4. Exécutez la commande terraform plan, puis examinez l'instance à créer.

5. Pour créer l'instance, exécutez la commande terraform apply.

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 sur cette page ne soient facturées sur votre compte Google Cloud , procédez comme suit :

1. Supprimez la ressource google_redis_instance de votre fichier de configuration Terraform.
2. Pour supprimer la ressource, exécutez les commandes terraform init, terraform plan et terraform apply.
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.