Provisionnement d'instances sur un réseau VPC

Cette page répertorie les commandes de gcloud CLI nécessaires pour configurer les prérequis, provisionner une instance, la décrire et la supprimer sur un réseau VPC standard. Pour savoir comment effectuer ces tâches sur un réseau VPC partagé, consultez la section Provisionner une instance sur un réseau VPC partagé. 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

Commencez par activer les API de cette section. Ces API sont nécessaires, car Memorystore pour Valkey utilise l'automatisation de la connectivité des services Private Service Connect pour automatiser la connectivité des instances. Pour en savoir plus, consultez la section 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 memorystore.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 Valkey. Une règle de connexion de service vous permet d'autoriser la classe de service gcp-memorystore à 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 le sous-réseau spécifié par la règle.

Pour connaître l'autorisation nécessaire pour créer une règle de connexion de service, consultez la section Rôles 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 allouées sur ce sous-réseau par défaut dans la région.

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 \
  --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/default

Remplacez les éléments suivants :

  • POLICY_NAME est le nom de la règle souhaité.
  • PROJECT_ID est l'ID de projet.
  • REGION est la même région dans laquelle vous souhaitez provisionner votre instance Memorystore pour Valkey.

Valider la création de la règle de connexion de service

Vérifiez si la règle a é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 est 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 memorystore instances create INSTANCE \
--project=PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]'

Remplacez les éléments suivants :

  • INSTANCE est l'ID de l'instance.

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

  • NODE_TYPE est le type de nœud que vous souhaitez utiliser pour l' instance.

  • 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 de l'instance. Pour en savoir plus sur les spécifications des instances, consultez la section Spécifications des instances 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.

  • PROJECT_ID est l'ID du projet dans lequel vous souhaitez créer votre instance.

  • NETWORK_ID est l'ID du réseau que vous souhaitez utiliser pour créer votre instance.

Décrire l'instance

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

gcloud

gcloud memorystore instances describe INSTANCE \
--project=PROJECT_ID \
--location=REGION

Remplacez les éléments suivants :

  • INSTANCE 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 memorystore instances delete INSTANCE \
--project=PROJECT_ID \
--location=REGION

Remplacez les éléments suivants :

  • INSTANCE est l'ID de l'instance.
  • PROJECT_ID est l'ID de projet.
  • REGION est la région dans laquelle se trouve votre instance.