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

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, 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

Activez les API suivantes nécessaires à la configuration d'une règle de connexion de service, à la configuration du VPC partagé et à la création d'une instance Memorystore pour Valkey.

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 memorystore.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 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 où vous souhaitez provisionner l'instance Memorystore pour Valkey. Cette opération est généralement effectuée par votre administrateur réseau. Toutefois, vous pouvez 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

  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 \
  --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 que vous souhaitez donner à votre règle.
    • HOST_PROJECT_ID est l'ID du projet hôte.
    • REGION est la région dans laquelle vous souhaitez provisionner votre instance Memorystore pour Valkey.

  2. Pour vérifier que 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 est 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 memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"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 est 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. Les valeurs acceptées sont les suivantes :

    • shared-core-nano
    • standard-small
    • highmem-medium
    • 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 d'instance. Pour en savoir plus sur les spécifications des instances, consultez Spécifications des instances 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 et 2.

  • HOST_PROJECT_ID est l'ID du projet hôte.

Décrivez l'instance

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

gcloud

gcloud 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 est 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 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 est l'ID du projet de service.
  • REGION est la région dans laquelle se trouve votre instance.