Provisionnement d'instances sur un réseau VPC partagé

Cette page répertorie les commandes gcloud CLI nécessaires pour configurer les prérequis, provisionner une instance dans un projet de service, décrire une instance et supprimer une instance. Pour effectuer ces tâches, suivez les instructions de chaque section de cette page.

Pour obtenir des instructions plus détaillées sur ces tâches, consultez les pages suivantes :

Activer les API

Activez les API suivantes, nécessaires pour configurer une règle de connexion de service , configurer un VPC partagé, et créer une instance Memorystore for Redis Cluster.

gcloud

  1. Activez les API suivantes dans le projet de service :

    gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID redis.googleapis.com

    Remplacez SERVICE_PROJECT_ID par l'ID de votre projet de service.

  2. Activez les API suivantes dans le projet hôte :

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    Remplacez le HOST_PROJECT_ID par l'ID de votre projet hôte.

Créer une règle de connexion de service

Ensuite, créez une règle de connexion de service pour le projet hôte du réseau VPC partagé, la région et les sous-réseaux dans lesquels vous souhaitez provisionner l'instance Memorystore for Redis Cluster. Cette opération est généralement effectuée par votre administrateur réseau. Toutefois, vous pouvez également le faire si vous disposez des rôles requis pour exécuter la commande.

Ce guide de démarrage rapide utilise le réseau default et le sous-réseau default.

gcloud

  1. Pour créer la règle de connexion de service, exécutez la commande create :

    gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=HOST_PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore-redis \
  --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default

    Remplacez les éléments suivants :

    • POLICY_NAME correspond au nom de règle souhaité.
    • HOST_PROJECT_ID correspond à l'ID du projet hôte.
    • REGION correspond à la région dans laquelle vous souhaitez provisionner votre instance Memorystore for Redis Cluster.

  2. Pour vérifier si la règle a été créée, exécutez la commande list :

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    Remplacez les éléments suivants :

    • HOST_PROJECT_ID correspond à l'ID du projet hôte.
    • REGION correspond à la région dans laquelle la règle de connexion de service est définie.

Créer une instance

Pour créer une instance dans le projet de service associé au réseau VPC partagé, exécutez la commande suivante :

gcloud

gcloud redis clusters create INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--network=projects/HOST_PROJECT_ID/global/networks/default

Remplacez les éléments suivants :

  • INSTANCE_ID correspond à l'ID de l'instance.
  • SERVICE_PROJECT_ID correspond à l'ID du projet de service.

  • REGION correspond à la région dans laquelle vous souhaitez provisionner votre instance.

  • NODE_TYPE correspond au type de nœud que vous souhaitez utiliser pour le cluster.

  • SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de segments détermine la capacité mémoire totale pour stocker les données du cluster. Pour en savoir plus sur les spécifications du cluster, consultez la page Spécifications du cluster et des nœuds.

  • REPLICA_COUNT correspond au nombre d'instances dupliquées avec accès en lecture (par segment). Les valeurs acceptées sont comprises entre 0 et 5.

  • HOST_PROJECT_ID correspond à l'ID du projet hôte.

Décrire l'instance

Pour afficher les détails de l'instance, exécutez la commande suivante :

gcloud

gcloud redis clusters describe INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

Remplacez les éléments suivants :

  • INSTANCE_ID correspond à l'ID de l'instance.
  • SERVICE_PROJECT_ID correspond à l'ID du projet de service.
  • REGION correspond à la région dans laquelle se trouve l'instance.

Supprimer l'instance

Pour supprimer une instance, utilisez la commande suivante :

gcloud

gcloud redis clusters delete INSTANCE_ID \
--project=SERVICE_PROJECT_ID \
--region=REGION

Remplacez les éléments suivants :

  • INSTANCE_ID correspond à l'ID de l'instance.
  • SERVICE_PROJECT_ID correspond à l'ID du projet de service.
  • REGION correspond à la région dans laquelle se trouve l'instance.