Utiliser la réplication interrégionale

Cette page explique comment utiliser la réplication interrégionale en créant et en gérant des instances secondaires.

Pour obtenir une présentation conceptuelle de la réplication interrégionale, consultez À propos de la réplication interrégionale.

Créer une instance secondaire

Lorsque vous créez une instance secondaire, Memorystore pour Valkey copie et applique certains paramètres de l'instance principale en tant que paramètres de l'instance secondaire. Pour en savoir plus, consultez Paramètres d'instance.

Vous pouvez créer une instance secondaire dans Memorystore pour Valkey à l'aide de la consoleGoogle Cloud ou de la Google Cloud CLI.

Console

  1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

    Memorystore for Valkey

  2. Cliquez sur une instance principale. L'instance principale est le parent de l'instance secondaire que vous créez.

  3. Dans le panneau latéral, cliquez sur l'onglet Instances secondaires.

  4. Cliquez sur Ajouter une instance secondaire.

  5. Dans la fenêtre Ajouter des instances secondaires, apportez les modifications suivantes :

    1. Dans le champ ID d'instance, saisissez l'ID de l'instance secondaire que vous créez. L'ID doit comporter entre 1 et 63 caractères. Seuls les lettres minuscules, les chiffres et les traits d'union sont acceptés. Il doit commencer par une lettre minuscule, se terminer par une lettre minuscule ou un chiffre, et être unique dans sa région.

    2. Dans le menu Région, sélectionnez la région dans laquelle vous souhaitez que l'instance secondaire soit située.

    3. Dans la section Disponibilité zonale, sélectionnez l'une des options suivantes :

      • Si vous souhaitez que tous les segments et répliques de l'instance soient répartis sur trois zones de la région dans laquelle Memorystore pour Valkey crée l'instance, sélectionnez l'option Multizone.

        Par exemple, si vous sélectionnez la région us-central1 et l'option Multizone, Memorystore pour Valkey répartit les partitions et les réplicas de l'instance dans les zones us-central1-a, us-central1-b et
        us-central1-c. En cas de défaillance d'une zone, les nœuds de l'instance basculent vers les répliques.

      • Si vous souhaitez que tous les shards et réplicas de l'instance se trouvent dans une seule zone de la région où Memorystore pour Valkey crée l'instance, sélectionnez l'option Zone unique, puis sélectionnez la zone dans le menu Zone.

        En utilisant une seule zone, vous réduisez les coûts de réseau. Toutefois, en cas de défaillance d'une zone, aucun basculement ne se produit.

    4. Dans le menu Instances répliquées, sélectionnez le nombre d'instances répliquées (par segment) pour l'instance. Vous pouvez avoir zéro, une ou deux répliques.

    5. Dans le menu Réseau, sélectionnez un réseau pour l'instance. Pour en savoir plus sur la mise en réseau pour Memorystore pour Valkey, consultez Mise en réseau.

  6. Cliquez sur Ajouter une instance secondaire.

gcloud

Pour créer une instance secondaire, utilisez la commande gcloud memorystore instances create.

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=NETWORK,projectId=PROJECT_ID \
--primary-instance=PRIMARY_INSTANCE_PATH

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance secondaire que vous créez. L'ID doit comporter entre 1 et 63 caractères, et ne contenir que des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre minuscule, se terminer par une lettre minuscule ou un chiffre, et être unique dans sa région.
  • PROJECT_ID : ID du projet dans lequel vous souhaitez créer l'instance secondaire. Il s'agit du même projet que celui dans lequel se trouve votre instance principale.
  • REGION_ID : ID de la région dans laquelle vous souhaitez placer l'instance secondaire.
  • NETWORK : réseau utilisé pour créer l'instance. Il doit respecter le format suivant : projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. L'ID de réseau doit correspondre à celui utilisé par la règle de connexion de service. Sinon, vous ne pourrez pas créer l'instance secondaire.
  • PRIMARY_INSTANCE_PATH : chemin d'accès de l'instance principale. Par exemple, projects/my-project/locations/us-central1/instances/my-primary-instance. Vous pouvez choisir n'importe quelle instance de votre projet comme instance principale, à condition qu'il ne s'agisse pas d'une instance secondaire.

Exemple :

gcloud memorystore instances create my-secondary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--primary-instance=projects/my-project/locations/us-central1/instances/my-primary-instance

Afficher une instance secondaire

Vous pouvez afficher des informations récapitulatives sur une instance secondaire à l'aide de la consoleGoogle Cloud ou de Google Cloud CLI.

Console

  1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

    Memorystore for Valkey

  2. Cliquez sur la flèche de développement à côté d'une instance principale. Cette instance est l'instance parente de l'instance secondaire pour laquelle vous souhaitez afficher des informations.

  3. Cliquez sur l'instance secondaire. Des informations récapitulatives sur l'instance s'affichent.

gcloud

Pour afficher des informations sur une instance secondaire, y compris un champ d'appartenance qui liste les instances principales et secondaires du groupe de réplication, utilisez la commande gcloud memorystore instances describe.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance secondaire
  • PROJECT_ID : ID du projet contenant l'instance secondaire
  • REGION_ID : ID de la région où se trouve l'instance secondaire

Effectuer une commutation

Un basculement vous permet d'inverser les rôles des instances principale et secondaire en promouvant une instance secondaire en instance principale à des fins de reprise après sinistre. Pour en savoir plus, consultez À propos de la réplication interrégionale.

Vous pouvez effectuer un basculement à l'aide de la console Google Cloud ou de Google Cloud CLI.

Console

  1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

    Memorystore for Valkey

  2. Cliquez sur la flèche de développement à côté d'une instance principale. Cette instance est l'instance parente de l'instance secondaire vers laquelle vous souhaitez basculer.

  3. Cliquez sur l'instance secondaire.

  4. Cliquez sur Promouvoir en tant que primaire.

  5. Dans la boîte de dialogue Promouvoir l'instance secondaire en instance principale ?, saisissez l'ID de l'instance secondaire, puis cliquez sur Promouvoir.

Une fois la commutation terminée, vous devez reconnecter vos applications à la nouvelle instance principale.

gcloud

Pour effectuer une permutation, utilisez la commande gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCE_PATH]

Effectuez les remplacements suivants :

  • INSTANCE_ID : ID de l'instance secondaire que vous souhaitez promouvoir en instance principale en effectuant la commutation.
  • PROJECT_ID : ID du projet contenant l'instance secondaire.
  • REGION_ID : ID de la région dans laquelle se trouve l'instance secondaire.

  • SECONDARY_INSTANCE_PATH : chemin d'accès à l'instance secondaire. Exemple : projects/my-project/locations/us-central1/instances/my-secondary-instance.

    Si vous avez plusieurs instances secondaires, séparez-les par des virgules. Exemple : [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance].

Supposons que vous disposiez des instances suivantes dans le projet my-project :

  • instance-1 : cette instance principale se trouve dans la région us-east1.
  • instance-2 : cette instance secondaire réside dans la région asia-east1.
  • instance-3 : cette instance secondaire réside dans la région southamerica-east1.

Vous souhaitez inverser les rôles de instance-1 et instance-2 afin que instance-2 devienne la nouvelle instance principale et que instance-1 devienne une instance secondaire.

Pour ce faire, utilisez le code suivant :

gcloud memorystore instances update instance-2 \
--project=my-project \
--location=asia-east1 \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-east1/instances/instance-1,instance=projects/my-project/locations/southamerica-east1/instances/instance-3]

Une fois la commutation terminée, vous devez reconnecter vos applications à la nouvelle instance principale.

Dissocier les instances secondaires

Si vous dissociez une ou plusieurs instances secondaires de leur instance principale, vous en faites des instances indépendantes entièrement fonctionnelles, qui permettent les lectures et les écritures. Pour en savoir plus, consultez Gérer la réplication interrégionale.

Vous pouvez dissocier des instances secondaires à l'aide de la console Google Cloud ou de Google Cloud CLI.

Dissocier une instance secondaire

Cette section explique comment dissocier une instance secondaire de son instance principale.

Console

  1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

    Memorystore for Valkey

  2. Cliquez sur une instance principale. Il s'agit du parent de l'instance secondaire que vous dissociez de l'instance principale.

  3. Dans le panneau latéral, cliquez sur l'onglet Instances secondaires.

  4. Cochez la case à côté de l'ID de l'instance secondaire que vous souhaitez dissocier de l'instance principale.

  5. Cliquez sur Dissocier du compte principal.

  6. Dans la boîte de dialogue Détacher l'instance secondaire ?, saisissez l'ID de l'instance secondaire, puis cliquez sur Détacher.

gcloud

Pour dissocier une instance secondaire, utilisez la commande gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=none \
--clear-primary-instance

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance secondaire que vous souhaitez dissocier
  • PROJECT_ID : ID du projet contenant l'instance secondaire
  • REGION_ID : région où se trouve l'instance secondaire

Dissocier plusieurs instances secondaires

Cette section explique comment dissocier plusieurs instances secondaires de leur instance principale. Vous pouvez également utiliser la procédure décrite dans cette section pour dissocier une instance secondaire indisponible de son instance principale.

Console

  1. Dans la console Google Cloud , accédez à la page Memorystore pour Valkey.

    Memorystore for Valkey

  2. Cliquez sur une instance principale. Il s'agit du parent des instances secondaires que vous dissociez de l'instance principale.

  3. Dans le panneau latéral, cliquez sur l'onglet Instances secondaires.

  4. Cochez les cases à côté des ID des instances secondaires que vous souhaitez dissocier de l'instance principale.

  5. Cliquez sur Dissocier du compte principal.

  6. Dans la boîte de dialogue Dissocier l'instance secondaire ?, procédez comme suit :

    1. Saisissez les ID des instances secondaires. Séparez les ID par des virgules.

    2. Cliquez sur Dissocier.

gcloud

Pour dissocier plusieurs instances secondaires, utilisez la commande gcloud memorystore instances update.

gcloud memorystore instances update PRIMARY_INSTANCE_ID \
--project=PROJECT_ID \
--location=PRIMARY_INSTANCE_REGION_ID \
--remove-cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCES] \
--cross-instance-replication-config-role=none

Effectuez les remplacements suivants :

  • PRIMARY_INSTANCE_ID : ID de l'instance principale.
  • PROJECT_ID : ID du projet contenant les instances secondaires.
  • PRIMARY_INSTANCE_REGION_ID : ID de la région dans laquelle se trouve l'instance principale.
  • SECONDARY_INSTANCES : instances secondaires que vous souhaitez dissocier. Séparez les ID d'instance par des virgules. Chaque instance secondaire doit respecter le format suivant : projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID.

Exemple :

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--remove-cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-west4/instances/my-secondary-instance-1,instance=projects/my-project/locations/asia-southeast2/instances/my-secondary-instance-2] \
--cross-instance-replication-config-role=none

Vous pouvez également dissocier des instances secondaires de l'instance principale en spécifiant une liste d'instances que vous ne souhaitez pas dissocier. Memorystore pour Valkey détache toutes les instances que vous n'incluez pas dans cette liste.

Supposons que vous disposiez des instances secondaires suivantes :

  • instance-1 : cette instance se trouve dans la région us-east1.
  • instance-2 : cette instance se trouve dans la région asia-east1.

Vous souhaitez dissocier les deux instances secondaires de my-primary-instance. Cette instance principale se trouve dans la région us-central1 et est contenue dans le projet my-project.

Pour dissocier les instances secondaires, utilisez le code suivant :

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-secondary-instances=[]
--cross-instance-replication-config-role=none

Dans cet exemple, comme la valeur nulle [] est attribuée au paramètre --cross-instance-replication-config-secondary-instances, Memorystore pour Valkey détache toutes les instances secondaires de l'instance principale.

Modifier les paramètres de l'instance

Cette section fournit des liens pour modifier les paramètres de l'instance. La procédure de mise à jour des paramètres d'instance diffère selon que vous modifiez les paramètres de l'instance principale ou secondaire. Pour savoir comment modifier les paramètres, consultez Paramètres d'instance.

Mettre à jour les paramètres de l'instance principale

Vous devez modifier les paramètres suivants sur l'instance principale. Une fois que vous avez effectué cette opération, Memorystore pour Valkey synchronise les modifications apportées à l'instance secondaire.

Mettre à jour les paramètres de l'instance secondaire

Vous devez modifier les paramètres suivants sur l'instance secondaire :

Supprimer des instances qui utilisent la réplication multirégionale

Cette section explique comment supprimer les instances principales et secondaires qui utilisent la réplication interrégionale.

Supprimer une instance principale

Pour supprimer une instance principale, procédez comme suit :

  1. Dissociez ou supprimez toutes les instances secondaires.
  2. Pour supprimer l'instance principale, suivez les instructions de la section Supprimer des instances.

Pour éviter toute suppression accidentelle, vous ne pouvez pas supprimer simultanément les instances principales et secondaires.

Supprimer une instance secondaire

Pour supprimer une instance secondaire, suivez les instructions de la section Supprimer des instances. Pour l'ID d'instance, utilisez l'ID de l'instance secondaire.