Cette page liste 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 conseils plus détaillés sur ces tâches, consultez les pages suivantes:
Activer les API
Activez les API suivantes, qui sont nécessaires pour configurer une stratégie de connexion de service, configurer un VPC partagé et créer une instance Memorystore pour Valkey.
gcloud
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 memorystore.googleapis.com
Remplacez SERVICE_PROJECT_ID par l'ID de votre projet de service.
Activez les API suivantes dans le projet hôte:
gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com
Remplacez HOST_PROJECT_ID par l'ID de votre projet hôte.
Créer une règle de connexion de service
Ensuite, une règle de connexion de service doit être créée pour le projet hôte du VPC partagé où la règle est définie, le réseau, la région et le ou les sous-réseaux sur lesquels vous souhaitez provisionner l'instance Memorystore pour Valkey. En général, c'est votre administrateur réseau qui s'en charge. Vous pouvez également disposer de l'autorisation nécessaire pour exécuter la commande si vous disposez du rôle requis.
Ce guide de démarrage rapide utilise le réseau default
et le sous-réseau default
. Les adresses IP de votre instance sont attribuées sur ce sous-réseau par défaut dans la région.
gcloud
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 \ --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default
Remplacez les éléments suivants :
- POLICY_NAME est le nom de la règle souhaité.
- HOST_PROJECT_ID correspond à l'ID du projet hôte.
- REGION est la même région que celle dans laquelle vous souhaitez provisionner votre instance Memorystore pour Valkey.
Pour vérifier si la stratégie a bien é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 VPC partagé, exécutez la commande suivante:
gcloud
gcloud beta memorystore instances create INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --replica-count=REPLICA_COUNT \ --psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=SERVICE_PROJECT_ID
Remplacez les éléments suivants :
- INSTANCE est l'ID de l'instance.
- SERVICE_PROJECT_ID correspond à l'ID du projet de service.
REGION est la région dans laquelle vous souhaitez provisionner votre instance.
NODE_TYPE correspond au type de nœud choisi. Voici les valeurs acceptées:
shared-core-nano
standard-small
highmem-medium
highmem-xlarge
Pour en savoir plus sur les types de nœuds et les configurations d'instances, consultez la section Spécification des instances et des nœuds.
SHARD_COUNT détermine le nombre de segments dans votre instance. Le nombre de fragments détermine la capacité de mémoire totale pour stocker les données d'instance. Pour en savoir plus sur la spécification des instances, consultez la section Spécification des instances et des nœuds.
REPLICA_COUNT correspond au nombre d'instances dupliquées avec accès en lecture souhaitées (par segment). Les valeurs acceptées sont
0
,1
et2
.HOST_PROJECT_ID correspond à l'ID du projet hôte.
Décrivez l'instance
Pour afficher les détails de l'instance, exécutez la commande suivante:
gcloud
gcloud beta memorystore instances describe INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
- INSTANCE est l'ID de l'instance.
- SERVICE_PROJECT_ID correspond à l'ID du projet de service.
- REGION est la région dans laquelle se trouve votre instance.
Supprimer l'instance
Pour supprimer une instance, utilisez la commande suivante :
gcloud
gcloud beta memorystore instances delete INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
Remplacez les éléments suivants :
- INSTANCE est l'ID de l'instance.
- SERVICE_PROJECT_ID correspond à l'ID du projet de service.
- REGION est la région dans laquelle se trouve votre instance.