Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Reprise après sinistre et clusters mondiaux Amazon DocumentDB

En utilisant un cluster mondial, vous pouvez vous remettre rapidement en cas de catastrophes telles que des défaillances régionales. La reprise après sinistre est généralement mesurée à l'aide de valeurs RTO et RPO.

Exécution d'un basculement géré pour un cluster mondial Amazon DocumentDB

Cette approche vise à assurer la continuité des activités dans le cas d’une véritable catastrophe régionale ou interruption complète du niveau de service.

Lors d'un basculement géré, votre cluster principal est transféré vers la région secondaire de votre choix tandis que la topologie de réplication existante de votre cluster mondial Amazon DocumentDB est maintenue. Le cluster secondaire choisi promeut l’un de ses nœuds en lecture seule au statut d’enregistreur complet. Cette étape permet au cluster d’endosser le rôle de cluster principal. Votre base de données est indisponible pendant une courte période pendant que ce cluster endosse son nouveau rôle. Les données qui n'ont pas été répliquées de l'ancien cluster principal vers le cluster secondaire choisi peuvent être manquantes lorsque ce cluster secondaire devient le nouveau cluster principal. L'ancien volume principal fait de son mieux pour prendre un instantané avant de procéder à la synchronisation avec le nouveau volume principal afin de préserver les données non répliquées sur l'instantané.

Pour minimiser les pertes de données, procédez comme suit avant d'utiliser cette fonctionnalité :

Lors d'un basculement géré, le cluster secondaire choisi est promu à son nouveau rôle de principal. Cependant, il n'hérite pas des différentes options de configuration du cluster principal. Une incompatibilité de configuration peut provoquer des problèmes de performances, des incompatibilités de charge de travail et d’autres comportements anormaux. Pour éviter de tels problèmes, corrigez les différences entre vos clusters globaux Amazon DocumentDB pour les points suivants :

En règle générale, le cluster secondaire choisi assume le rôle principal en une minute. Dès que le nœud d'enregistreur de la nouvelle région principale est disponible, vous pouvez y connecter vos applications et reprendre vos charges de travail. Une fois qu'Amazon DocumentDB a promu le nouveau cluster principal, il reconstruit automatiquement tous les clusters de régions secondaires supplémentaires.

Étant donné que les clusters mondiaux Amazon DocumentDB utilisent la réplication asynchrone, le délai de réplication dans chaque région secondaire peut varier. Amazon DocumentDB reconstruit ces régions secondaires pour qu'elles disposent exactement des mêmes données ponctuelles que celles du nouveau cluster de régions principal. La durée de la tâche de reconstruction complète peut prendre de quelques minutes à plusieurs heures, selon la taille du volume de stockage et la distance entre les régions. Lorsque les clusters des régions secondaires ont fini de se reconstruire à partir de la nouvelle région principale, ils sont disponibles pour un accès en lecture. Dès que le nouveau rédacteur principal est promu et disponible, le cluster de la nouvelle région principale peut gérer les opérations de lecture et d'écriture pour le cluster mondial Amazon DocumentDB.

Pour restaurer la topologie d'origine du cluster global, Amazon DocumentDB surveille la disponibilité de l'ancienne région principale. Dès que cette région est saine et à nouveau disponible, Amazon DocumentDB l'ajoute automatiquement au cluster global en tant que région secondaire. Avant de créer le nouveau volume de stockage dans l'ancienne région principale, Amazon DocumentDB essaie de prendre un instantané de l'ancien volume de stockage au point de défaillance. Il le fait pour que vous puissiez l’utiliser pour récupérer les données manquantes. Si cette opération aboutit, Amazon DocumentDB place cet instantané nommé « rds:docdb-unplanned-global-failover-name-of-old-primary- » dans la section Instantané du. DB-cluster-timestamp Console de gestion AWS Vous pouvez également voir cette capture d'écran répertoriée dans les informations renvoyées par l'opération DescribeDBClusterSnapshots d'API.

Une fois la topologie d'origine restaurée, vous pouvez rétablir la région principale d'origine de votre cluster global en effectuant une opération de basculement au moment le plus approprié pour votre activité et votre charge de travail. Pour ce faire, suivez les étapes de Exécution d'un basculement pour un cluster global Amazon DocumentDB.

Vous pouvez basculer sur votre cluster global Amazon DocumentDB à l'aide de l' Console de gestion AWS API Amazon DocumentDB ou de l'API Amazon DocumentDB. AWS CLI

Using the Console de gestion AWS

Effectuez un basculement géré sur votre cluster mondial Amazon DocumentDB

1. Connectez-vous au et ouvrez Console de gestion AWS la console Amazon DocumentDB à https://console.aws.amazon.com/docdb l'adresse.

2. Dans le panneau de navigation, choisissez Clusters.

3. Recherchez et choisissez le cluster global Amazon DocumentDB que vous souhaitez basculer.

   

4. Choisissez Switchover ou Failover dans le menu Actions.

5. Dans la boîte de dialogue qui apparaît, choisissez Failover, puis choisissez le cluster secondaire dans la liste déroulante du champ Nouveau cluster principal.

   

6. Tapez « confirmer » dans le dernier champ. Ensuite, choisissez Valider.

   L'état du cluster principal passe à «  Failing-over  ». Cette condition devrait prendre environ une minute. Pendant ce temps, l'état du nouveau cluster principal indique «  Modification... ». Une fois que le nouveau principal sera promu, il affichera «  Disponible  » et pourra servir des transactions de lecture et d'écriture. Les régions secondaires, y compris l'ancienne région principale, afficheront «  Resynchronisation... "pendant qu'il se resynchronise avec le nouveau primaire. Comme le nouveau serveur principal, il ne pourra traiter les transactions que lorsque le statut sera passé à «  Disponible  ».

7. Une fois terminé, le cluster principal d'origine devient le cluster secondaire. Le cluster secondaire sélectionné devient le cluster principal.

   

Using the AWS CLI

Effectuez un basculement géré sur votre cluster mondial Amazon DocumentDB

Exécutez la commande failover-global-cluster CLI pour basculer sur votre cluster global Amazon DocumentDB. À l'aide de la commande, transmettez des valeurs pour les options suivantes :

• --region

• --global-cluster-identifier

• --target-db-cluster-identifier

• --allow-data-loss

Dans les exemples suivants, remplacez chacun par user input placeholder les informations relatives à votre cluster.

Pour Linux, macOS ou Unix :

aws docdb failover-global-cluster \
   --region region_of_selected_secondary \
   --global-cluster-identifier global_cluster_id \
   --target-db-cluster-identifier arn_of_secondary_to_promote \
   --allow-data-loss

Pour Windows :

aws docdb failover-global-cluster ^
   --region region_of_selected_secondary ^
   --global-cluster-identifier global_cluster_id ^
   --target-db-cluster-identifier arn_of_secondary_to_promote ^
   --allow-data-loss

Exécution d'un basculement manuel pour un cluster global Amazon DocumentDB

Si un cluster entier d'un cluster Région AWS devient indisponible, vous pouvez promouvoir un autre cluster dans le cluster global pour qu'il soit doté read/write de fonctionnalités.

Vous pouvez activer manuellement le mécanisme de basculement global des clusters si un cluster d'un autre cluster Région AWS constitue un meilleur choix pour être le cluster principal. Par exemple, vous pouvez accroître la capacité de l'un des clusters secondaires, puis le promouvoir comme cluster principal. Ou l'équilibre des activités entre les deux Régions AWS peut changer, de sorte que le passage du cluster principal à un autre Région AWS peut réduire la latence pour les opérations d'écriture.

La procédure suivante décrit la procédure à suivre pour promouvoir l'un des clusters secondaires d'un cluster global Amazon DocumentDB.

Les clusters mondiaux Amazon DocumentDB peuvent être gérés à l'aide de kits de AWS développement logiciel (SDK), ce qui vous permet de créer des solutions pour automatiser le processus global de basculement des clusters pour les cas d'utilisation liés à la reprise après sinistre et à la planification de la continuité des activités. L'une de ces solutions est mise à la disposition de nos clients sous licence Apache 2.0 et est accessible depuis notre référentiel d'outils ici. Cette solution exploite Amazon Route 53 pour la gestion des terminaux et fournit des AWS Lambda fonctions qui peuvent être déclenchées en fonction d'événements appropriés.

Exécution d'un basculement pour un cluster global Amazon DocumentDB

En utilisant les bascules, vous pouvez modifier de façon routinière la région de votre cluster principal. Cette approche est destinée aux scénarios contrôlés tels que la maintenance opérationnelle et d’autres procédures opérationnelles planifiées.

Il existe trois cas d'utilisation courants de l'utilisation des commutateurs :

Lors d'un basculement, Amazon DocumentDB bascule votre cluster principal vers la région secondaire que vous avez choisie tout en conservant la topologie de réplication existante de votre cluster global. Avant de démarrer le processus de basculement, Amazon DocumentDB attend que tous les clusters régionaux secondaires soient entièrement synchronisés avec le cluster régional principal. Ensuite, le cluster de bases de données de la région principale passe en lecture seule et le cluster secondaire choisi promeut l'un de ses nœuds en lecture seule au statut d'enregistreur à part entière. La promotion de ce nœud au rang d'enregistreur permet à ce cluster secondaire d'endosser le rôle de cluster principal. Étant donné que tous les clusters secondaires étaient synchronisés avec le cluster principal au début du processus, le nouveau cluster principal continue à fonctionner pour le cluster mondial Amazon DocumentDB sans perdre de données. Votre base de données est indisponible pendant une courte période durant laquelle les clusters principaux et secondaires sélectionnés endossent leurs nouveaux rôles.

Pour optimiser la disponibilité des applications, procédez comme suit avant d'utiliser cette fonctionnalité :

Au cours d'une commutation, le cluster de bases de données secondaire choisi est promu dans son nouveau rôle de cluster principal. Toutefois, il n’hérite pas des différentes options de configuration du cluster de bases de données principal. Une incompatibilité de configuration peut provoquer des problèmes de performances, des incompatibilités de charge de travail et d’autres comportements anormaux. Pour éviter de tels problèmes, corrigez les différences entre vos clusters globaux Amazon DocumentDB pour les points suivants :

Une fois le processus de basculement terminé, le cluster Amazon DocumentDB promu peut gérer les opérations d'écriture pour le cluster global.

Vous pouvez basculer entre votre cluster global Amazon DocumentDB à l'aide du Console de gestion AWS ou des AWS CLI :

Using the Console de gestion AWS

Effectuez une commutation sur votre cluster mondial Amazon DocumentDB

1. Connectez-vous au et ouvrez Console de gestion AWS la console Amazon DocumentDB à https://console.aws.amazon.com/docdb l'adresse.

2. Dans le panneau de navigation, choisissez Clusters.

3. Recherchez et sélectionnez le cluster global Amazon DocumentDB que vous souhaitez basculer.

   

4. Choisissez Switchover ou Failover dans le menu Actions.

5. Dans la boîte de dialogue qui apparaît, choisissez Switchover, puis choisissez le cluster secondaire dans la liste déroulante du champ Nouveau cluster principal.

   

6. Choisissez Confirmer.

   L'état du cluster principal passe à «  Switching-over  ». Cette condition devrait prendre environ trois minutes. Pendant cette période, le statut de tous les clusters régionaux indique «  Modification... ». Une fois que les régions seront synchronisées et que le nouveau principal aura été promu, il affichera «  Disponible  » pour tous les champs de statut et pourra traiter les transactions.

7. Une fois terminé, le cluster principal d'origine devient le cluster secondaire. Le cluster secondaire sélectionné devient le cluster principal.

   

Using the AWS CLI

Effectuez une commutation sur votre cluster mondial Amazon DocumentDB

Exécutez la commande switchover-global-cluster CLI pour basculer entre votre cluster global Amazon DocumentDB. À l'aide de la commande, transmettez des valeurs pour les options suivantes :

• --region

• --global-cluster-identifier

• --target-db-cluster-identifier

Dans les exemples suivants, remplacez chacun par user input placeholder les informations relatives à votre cluster.

Pour Linux, macOS ou Unix :

aws docdb switchover-global-cluster \
   --region region_of_primary \
   --global-cluster-identifier global_cluster_id \
   --target-db-cluster-identifier arn_of_secondary_to_promote

Pour Windows :

aws docdb switchover-global-cluster ^
   --region region_of_primary ^
   --global-cluster-identifier global_cluster_id ^
   --target-db-cluster-identifier arn_of_secondary_to_promote

Déblocage d'un basculement ou d'un basculement de cluster global

Les commutations et les basculements de clusters globaux sont bloqués lorsque les clusters régionaux du cluster global n'utilisent pas tous la même version de moteur. Si les versions ne correspondent pas, cette erreur peut s'afficher lors de l'appel d'un basculement ou d'un basculement : le cluster de base de données cible spécifié exécute une version de moteur avec un niveau de correctif différent de celui du cluster de bases de données source. Appliquez régulièrement les dernières versions du moteur pour maintenir vos clusters globaux en bon état.

Pour résoudre cette erreur, mettez d'abord à jour toutes les régions secondaires, puis la région principale avec la même version du moteur en appliquant toutes les actions de maintenance en attente. Pour afficher les actions de maintenance en attente et appliquer les modifications nécessaires pour corriger le problème, suivez les instructions figurant dans l'un des onglets suivants :

Using the Console de gestion AWS

Pour débloquer un basculement ou un basculement de cluster global, vous devez déterminer s'il existe des actions de maintenance en attente pour vos clusters et les appliquer. Procédez comme suit pour afficher et appliquer les actions de maintenance :

1. Connectez-vous au et ouvrez Console de gestion AWS la console Amazon DocumentDB à https://console.aws.amazon.com/docdb l'adresse.

2. Dans le panneau de navigation, choisissez Clusters.

3. Dans le tableau Clusters, localisez votre cluster global dans la colonne Identifiant du cluster. Dans votre cluster global, prenez note de chaque cluster secondaire et du cluster principal du cluster global donné, et effectuez les étapes suivantes pour chacun d'eux.

4. Pour chaque cluster secondaire :

   1. Si une mise à jour est disponible pour votre cluster, elle est indiquée comme Disponible, Obligatoire ou Fenêtre suivante dans la colonne Maintenance.

   2. Pour effectuer une action, choisissez le cluster dont vous souhaitez afficher les détails, puis choisissez Maintenance et sauvegardes. Les éléments de maintenance en attente apparaissent.

   3. Sous Description, s'il est indiqué qu'une « nouvelle mise à jour de maintenance est disponible », sélectionnez-la, puis choisissez Appliquer maintenant.

5. Pour votre cluster principal :

   1. Si une mise à jour est disponible pour votre cluster, elle est indiquée comme Disponible, Obligatoire ou Fenêtre suivante dans la colonne Maintenance.

   2. Pour effectuer une action, choisissez le cluster dont vous souhaitez afficher les détails, puis choisissez Maintenance et sauvegardes. Les éléments de maintenance en attente apparaissent.

   3. Sous Description, s'il est indiqué qu'une « nouvelle mise à jour de maintenance est disponible », sélectionnez-la, puis choisissez Appliquer maintenant.

Using the AWS CLI

Pour débloquer le basculement ou le basculement d'un cluster global, vous devez déterminer s'il existe des actions de maintenance en attente pour le cluster et les appliquer. Suivez ces étapes pour afficher et appliquer les actions de maintenance d'abord sur les clusters secondaires, puis sur le cluster principal de votre cluster global :

1. Exécutez d'abord les opérations suivantes sur le cluster régional de chaque région secondaire, puis sur le cluster régional des régions principales.

2. Exécutez la commande describe-pending-maintenance-actions CLI avec l'--resource-identifieroption permettant de déterminer si des actions de maintenance sont disponibles pour votre cluster régional Amazon DocumentDB.

   Dans les exemples suivants, remplacez chacun par user input placeholder les informations relatives à votre cluster.

   Pour Linux, macOS ou Unix :

   aws docdb describe-pending-maintenance-action \
      --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15

   Pour Windows :

   aws docdb describe-pending-maintenance-action ^
      --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15

   Le résultat ressemble à ceci :

   {
       "PendingMaintenanceActions": [
           {
               "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
               "PendingMaintenanceActionDetails": [
                   {
                       "Action": "system-update",
                       "CurrentApplyDate": "2025-04-11T03:01:00Z",
                       "Description": "db-version-upgrade",
                       "ForcedApplyDate": "2025-06-18T03:01:00Z",
                       "AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
                       "OptInStatus": "pending"
                   }
               ]
           }
       ]
   }

3. Si une action de maintenance est nécessaire, exécutez la commande apply-pending-maintenance-action CLI avec les options suivantes :

   • --resource-identifier

   • --apply-action

   • --opt-in-type

   • --region

   Dans les exemples suivants, remplacez chacun par user input placeholder les informations relatives à votre cluster.

   Pour Linux, macOS ou Unix :

   aws docdb apply-pending-maintenance-action \
      --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
      --apply-action system-update \
      --opt-in-type immediate \
      --region us-east-1

   Pour Windows :

   aws docdb apply-pending-maintenance-action ^
      --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
      --apply-action system-update ^
      --opt-in-type immediate ^
      --region us-east-1

4. Une fois l'action de maintenance terminée, exécutez à nouveau la describe-pending-maintenance-actions commande pour vous assurer qu'aucune autre action n'est en attente pour votre cluster.

   Le résultat que vous souhaitez est le suivant :

   {
       "PendingMaintenanceActions": []
   }

Using the Amazon DocumentDB API

Pour débloquer le basculement ou le basculement d'un cluster global, vous devez déterminer s'il existe des actions de maintenance en attente pour le cluster et les appliquer. Utilisez les API suivantes pour afficher et appliquer les actions de maintenance :

1. Exécutez d'abord les opérations suivantes sur le cluster régional de chaque région secondaire, puis sur le cluster régional des régions principales.

2. Appelez l'PendingMaintenanceActionAPI pour déterminer si des actions de maintenance sont disponibles pour votre cluster mondial Amazon DocumentDB.

3. Appliquez les modifications en appelant l'ApplyPendingMaintenanceActionAPI.