Cette page liste les commandes gcloud CLI nécessaires pour configurer les prérequis, provisionner une instance, décrire une instance et supprimer une instance sur un réseau VPC standard. Pour savoir comment effectuer ces tâches sur un réseau VPC partagé, consultez Provisionner des instances sur un réseau VPC partagé. Pour effectuer ces tâches, vous devez suivre 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
Commencez par activer les API de cette section. Ces API sont nécessaires, car Memorystore pour Redis Cluster utilise l'automatisation de la connectivité des services Private Service Connect pour automatiser la connectivité des instances. Pour en savoir plus, consultez Mise en réseau.
Pour activer les API, exécutez les commandes suivantes :
gcloud
gcloud services enable --project=PROJECT_ID networkconnectivity.googleapis.com gcloud services enable --project=PROJECT_ID compute.googleapis.com gcloud services enable --project=PROJECT_ID serviceconsumermanagement.googleapis.com gcloud services enable --project=PROJECT_ID redis.googleapis.com
Remplacez les éléments suivants :
- PROJECT_ID est l'ID de votre projet.
Créer une règle de connexion de service
Vous devez créer une règle de connexion de service pour le projet, le réseau et la région dans lesquels vous souhaitez provisionner l'instance Memorystore pour Redis Cluster. Une règle de connexion de service vous permet d'autoriser la classe de service gcp-memorystore-redis
à créer une connexion Private Service Connect entre les réseaux VPC producteur et client dans la région où la règle est définie, et dans les sous-réseaux qu'elle spécifie.
Pour connaître l'autorisation requise pour créer une règle de connexion de service, consultez la section Rôles requis.
Cette procédure pas à pas utilise le réseau default
et le sous-réseau default
.
Pour créer la règle de connexion de service, exécutez la commande suivante :
gcloud
gcloud network-connectivity service-connection-policies create POLICY_NAME \ --network=default \ --project=PROJECT_ID \ --region=REGION \ --service-class=gcp-memorystore-redis \ --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/default
Remplacez les éléments suivants :
- POLICY_NAME est le nom que vous souhaitez donner à votre règle.
- PROJECT_ID est l'ID de projet.
- REGION est la région dans laquelle vous souhaitez provisionner votre instance Memorystore pour Redis Cluster.
Valider la création d'une règle de connexion de service
Vérifiez que la stratégie a bien été créée en exécutant la commande list
:
gcloud
gcloud network-connectivity service-connection-policies list --region=REGION --project=PROJECT_ID
Remplacez les éléments suivants :
- PROJECT_ID est l'ID de projet.
- 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, exécutez la commande create
:
gcloud
gcloud redis clusters create INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --network=projects/PROJECT_ID/global/networks/default
Remplacez les éléments suivants :
- INSTANCE_ID est l'ID de l'instance.
- PROJECT_ID est l'ID de projet.
REGION est la région dans laquelle vous souhaitez provisionner votre instance.
NODE_TYPE est le type de nœud choisi. Les valeurs acceptées sont les suivantes :
redis-shared-core-nano
redis-standard-small
redis-highmem-medium
redis-highmem-xlarge
SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de partitions détermine la capacité de mémoire totale pour stocker les données du cluster. Pour en savoir plus sur la spécification du cluster, consultez Spécification du cluster et des nœuds.
REPLICA_COUNT correspond au nombre d'instances dupliquées avec accès en lecture souhaité (par segment). Les valeurs acceptées sont
0
,1
et2
.
Décrivez l'instance
Pour afficher les détails d'une instance, exécutez la commande describe
:
gcloud
gcloud redis clusters describe INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION
Remplacez les éléments suivants :
- INSTANCE_ID est l'ID de l'instance.
- PROJECT_ID est l'ID de projet.
- REGION est la région dans laquelle se trouve votre instance.
Supprimer l'instance
Pour supprimer une instance, exécutez la commande delete
:
gcloud
gcloud redis clusters delete INSTANCE_ID \ --project=PROJECT_ID \ --region=REGION
Remplacez les éléments suivants :
- INSTANCE_ID est l'ID de l'instance.
- PROJECT_ID est l'ID de projet.
- REGION est la région dans laquelle se trouve votre instance.