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.
# Présentation des clusters globaux Amazon DocumentDB
## Qu'est-ce qu'un cluster mondial ?
Un cluster mondial comprend une région principale et jusqu'à 10 régions secondaires en lecture seule. Vous effectuez des opérations d'écriture directement sur le cluster principal de la région principale et Amazon DocumentDB réplique automatiquement les données vers les régions secondaires à l'aide d'une infrastructure dédiée. La latence est généralement inférieure à une seconde.
## En quoi les clusters mondiaux sont-ils utiles ?
+ **Restauration après des pannes à l'échelle de la région** : en cas de panne régionale, vous pouvez transformer l'un des clusters secondaires en cluster principal en quelques minutes, avec un objectif de temps de restauration (RTO) typique inférieur à une minute. L'objectif du point de restauration (RPO) est généralement mesuré en secondes, mais cela dépend du décalage sur le réseau au moment de la panne.
+ **Lectures globales avec latence locale** — Si vous avez des bureaux dans le monde entier, vous pouvez utiliser un cluster mondial pour tenir à jour vos principales sources d'informations dans la région principale. Les bureaux de vos autres régions peuvent accéder aux informations de leur propre région, avec une latence locale.
+ **Clusters secondaires évolutifs** : vous pouvez redimensionner vos clusters secondaires en ajoutant davantage d'instances en lecture seule dans une région secondaire. Le cluster secondaire est en lecture seule, il peut donc prendre en charge jusqu'à 16 instances de réplication en lecture seule au lieu de la limite habituelle de 15 pour un seul cluster.
+ **Réplication rapide des clusters principaux vers les clusters secondaires** : la réplication effectuée par un cluster global a peu d'impact sur les performances du cluster de base de données principal. Les ressources des instances de base de données sont entièrement dévouées aux charges de travail d’application en lecture et en écriture.
## Quelles sont les limites actuelles des clusters mondiaux ?
+ Les clusters globaux ne sont pas pris en charge sur Amazon DocumentDB v3.6.
+ Les clusters globaux sont pris en charge sur tous les types d'instances à l'exception de db.t3, db.t4g et db.r4.
+ Les clusters mondiaux ne sont pas disponibles dans les régions suivantes : Amérique du Sud (São Paulo), Europe (Milan), Chine (Pékin) et Chine (Ningxia).
+ Le basculement et le basculement global ne sont pas pris en charge lorsque les régions utilisent des versions de moteur différentes. Le basculement manuel est pris en charge en cas d'incompatibilité entre les versions du moteur.
+ Seul le cluster principal exécute les opérations d’écriture. Les clients qui effectuent des opérations d'écriture se connectent au point de terminaison du cluster principal.
+ Vous pouvez avoir un maximum de 10 régions secondaires et une région principale pour votre cluster.
+ Un cluster secondaire ne peut pas être arrêté. Un cluster principal ne peut pas être arrêté s'il est associé à des clusters secondaires. Seul un cluster régional qui ne possède aucun cluster secondaire peut être arrêté.
+ Les répliques associées au cluster secondaire peuvent redémarrer dans certaines circonstances. Si l'instance de la région principale redémarre ou bascule, les répliques de la région secondaire redémarrent également. Le cluster est alors indisponible jusqu'à ce que toutes les répliques soient à nouveau synchronisées avec l'instance d'écriture du cluster de base de données principal. Ce comportement est normal. Assurez-vous de bien comprendre l'impact sur votre cluster global avant d'apporter des modifications à votre cluster principal.
+ Vous ne pouvez pas utiliser de flux de modifications sur des clusters secondaires.
**Topics**
+ [Qu'est-ce qu'un cluster mondial ?](#w2aac33b9b3)
+ [En quoi les clusters mondiaux sont-ils utiles ?](#w2aac33b9b5)
+ [Quelles sont les limites actuelles des clusters mondiaux ?](#w2aac33b9b7)
+ [Guide de démarrage rapide](global-clusters.get-started.md)
+ [Gestion des clusters mondiaux](global-clusters.manage.md)
+ [Connecter les clusters mondiaux](global-clusters-connect.md)
+ [Surveillance des clusters mondiaux](global-clusters-monitor.md)
+ [Reprise après sinistre](global-clusters-disaster-recovery.md)
# Guide de démarrage rapide : clusters mondiaux
**Topics**
+ [Configuration](#global-clusters.config)
+ [Création d'un cluster mondial](#global-clusters-create)
+ [Ajouter une région à un cluster mondial](#global-clusters.add-region)
+ [Utilisation d'un instantané](#global-clusters.snapshot)
## Configuration
Le cluster global Amazon DocumentDB s'étend sur au moins deux. Régions AWS La région principale prend en charge un cluster qui possède une instance principale (d'écriture) et jusqu'à 15 instances de réplique, tandis qu'une région secondaire exécute un cluster en lecture seule composé entièrement de 16 instances de réplique au maximum. Un cluster mondial peut comporter jusqu'à cinq régions secondaires. Le tableau répertorie le nombre maximal de clusters, d'instances et de répliques autorisés dans un cluster global.
| Description | Primaire Région AWS | secondaire Région AWS |
| --- | --- | --- |
| Clusters | 1 | 5 (maximum) |
| Instances de scripteur | 1 | 0 |
| Instances en lecture seule (répliques Amazon DocumentDB), par cluster | 15 (max) | 16 (total) |
| Instances en lecture seule (maximum autorisé, compte tenu du nombre réel de régions secondaires) | 15 - s | s = nombre total d'établissements secondaires Régions AWS |
Les clusters ont les exigences spécifiques suivantes :
+ **Exigences relatives aux classes d'instance de base** de données : vous ne pouvez utiliser que les classes d'`db.r6g`instance `db.r5` et.
+ **Région AWS exigences** — Le cluster principal doit se trouver dans une région, et au moins un cluster secondaire doit se trouver dans une région différente du même compte. Vous pouvez créer jusqu'à cinq clusters secondaires (en lecture seule), chacun devant se trouver dans une région différente. En d'autres termes, deux clusters ne peuvent pas se trouver dans la même région.
+ **Exigences en matière de dénomination** — Les noms que vous choisissez pour chacun de vos clusters doivent être uniques, dans toutes les régions. Vous ne pouvez pas utiliser le même nom pour différents clusters, même s'ils se trouvent dans des régions différentes.
## Création d'un cluster global Amazon DocumentDB
Êtes-vous prêt à créer votre premier cluster mondial ? Dans cette section, nous expliquerons comment créer un tout nouveau cluster global avec de nouveaux clusters et instances de base de données, en utilisant les instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
### À l'aide du AWS Management Console
1. Dans le AWS Management Console, accédez à **Amazon DocumentDB**.
1. **Lorsque vous accédez à la console Amazon DocumentDB, choisissez Clusters.**
![\[La page Clusters de la console Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Choisissez **Créer**.
![\[Le bouton Créer apparaît dans le coin supérieur droit du tableau des clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Remplissez la section **Configuration** du formulaire de **création d'un cluster Amazon DocumentDB** en conséquence :
+ **Identifiant de cluster** : vous pouvez saisir un identifiant unique pour cette instance ou autoriser Amazon DocumentDB à fournir l'identifiant d'instance en fonction de l'identifiant de cluster.
+ Version du moteur : Choose **4.0.0**
+ Classe d'instance : Choisissez **db.r5.large**
+ Nombre d'instances : Choisissez **3**.
![\[Formulaire d'options de configuration pour créer un cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. Dans la section **Authentification**, saisissez un nom d'utilisateur principal et un mot de passe principal.
![\[Formulaire d'authentification permettant de spécifier un nom d'utilisateur et un mot de passe principaux pour un nouveau cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Choisissez **Afficher les paramètres avancés**.
![\[Afficher le bouton de basculement des paramètres avancés à côté des boutons Annuler et Créer un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. Dans la section **Paramètres réseau** :
+ **Conservez les options par défaut pour **Virtual Private Cloud (VPC) et le groupe** de sous-réseaux.**
![\[Formulaire de paramètres réseau indiquant les options du VPC, du groupe de sous-réseaux et des groupes de sécurité VPC. Les champs VPC et Subnet Group ont des options par défaut sélectionnées.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Pour les **groupes de sécurité VPC**, la **valeur par défaut (VPC)** doit déjà être ajoutée.
![\[Formulaire de paramètres réseau indiquant que le VPC par défaut a déjà été ajouté.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Tapez `DocDB` dans le champ **Groupes de sécurité VPC** et sélectionnez **DocDB-Inbound** (VFC).
![\[DocDB-Inbound VFC sélectionné dans le menu déroulant des groupes de sécurité VPC.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Pour les **options de cluster** et **E ncryption-at-rest**, conservez les sélections par défaut.
![\[Options de cluster et Encryption-at-rest formulaires avec les options par défaut sélectionnées.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Pour les **exportations **Backup** et Log**, conservez les sélections par défaut.
![\[Backup and Log exporte les formulaires avec les options par défaut sélectionnées.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Pour la **maintenance**, les **balises** et **la protection contre la suppression**, conservez les sélections par défaut.
![\[Formulaires de protection relatifs à la maintenance, aux balises et à la suppression avec les options par défaut sélectionnées.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Cliquez maintenant sur le bouton **Créer un cluster**.
![\[Le bouton Créer un cluster apparaît à la fin du processus de création du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### À l'aide du AWS CLI
Pour créer un cluster régional Amazon DocumentDB, appelez le. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) La AWS CLI commande suivante crée un cluster Amazon DocumentDB nommé. `global-cluster-id` Pour plus d'informations sur la protection contre les suppressions, consultez[Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
Il s'`--engine-version`agit également d'un paramètre facultatif qui utilise par défaut la dernière version majeure du moteur. La version actuelle du moteur par défaut est `5.0.0` (remarque : Amazon DocumentDB 8.0 est disponible mais doit être explicitement spécifiée comme`8.0.0`). Lorsque de nouvelles versions majeures du moteur sont publiées, la version par défaut du moteur est mise à jour pour `--engine-version` refléter la dernière version majeure du moteur. Par conséquent, pour les charges de travail de production, et en particulier celles qui dépendent de scripts, d'automatisation ou de CloudFormation modèles, nous vous recommandons de spécifier explicitement la `--engine-version` version majeure prévue.
Si un `db-subnet-group-name` ou n'`vpc-security-group-id`est pas spécifié, Amazon DocumentDB utilisera le groupe de sous-réseaux et le groupe de sécurité Amazon VPC par défaut pour la région donnée.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Pour Windows :
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La création du cluster prend quelques minutes. Vous pouvez utiliser le AWS Management Console ou AWS CLI pour surveiller l'état de votre cluster. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Important**
Lorsque vous utilisez le AWS CLI pour créer un cluster régional Amazon DocumentDB, aucune instance n'est créée. Par conséquent, vous devez créer explicitement une instance principale et tous les réplicas des instances dont vous avez besoin. Vous pouvez utiliser la console ou AWS CLI créer les instances. Pour plus d'informations, consultez [Ajouter une instance Amazon DocumentDB à un cluster](db-instance-add.md) et consultez le [CreateDBCluster](API_CreateDBCluster.md) manuel Amazon DocumentDB API Reference.
Une fois que votre cluster régional est disponible, vous pouvez ajouter un cluster secondaire dans une autre région en suivant les instructions suivantes :[Ajouter un Région AWS à un cluster global Amazon DocumentDB](#global-clusters.add-region). Lorsque vous ajoutez une région, votre cluster régional devient votre cluster principal, et vous avez un nouveau cluster secondaire dans la région que vous avez choisie.
## Ajouter un Région AWS à un cluster global Amazon DocumentDB
Un cluster global a besoin d'au moins un cluster secondaire dans une région différente de celle du cluster principal, et vous pouvez ajouter jusqu'à cinq clusters secondaires. Notez que pour chaque cluster secondaire que vous ajoutez, vous devez réduire d'un le nombre de répliques autorisées dans le cluster principal. Par exemple, si votre cluster global comporte cinq régions secondaires, votre cluster principal ne peut avoir que 10 répliques (au lieu de 15). Pour plus d'informations, consultez [la section Exigences de configuration d'un cluster global Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### À l'aide du AWS Management Console
1. Connectez-vous à la console Amazon DocumentDB AWS Management Console et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
![\[La page Clusters de la console Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Choisissez le cluster auquel vous souhaitez ajouter un cluster secondaire. Assurez-vous que le cluster l'est`Available`.
![\[Liste des clusters régionaux et mondiaux indiquant le statut disponible, avec mydocdbglobalcluster surligné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. Sélectionnez la liste déroulante des **actions**, puis choisissez **Ajouter une région.**
![\[Le menu déroulant Actions de l'interface Clusters affiche l'option Ajouter une région.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. Sur la Région AWS page **Ajouter une** région, choisissez la région secondaire. Notez que vous ne pouvez pas choisir une région qui possède déjà un cluster secondaire pour le même cluster mondial. De plus, il ne peut pas s'agir de la même région que le cluster principal. S'il s'agit de la première région que vous ajoutez, vous devrez également spécifier un identifiant de cluster global de votre choix.
![\[Choisissez une région secondaire à l'aide du menu déroulant du formulaire Ajouter un Région AWS formulaire.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Complétez les champs restants pour le cluster secondaire dans la nouvelle région, puis sélectionnez **Créer un cluster**. Une fois que vous avez terminé d'ajouter la région, vous pouvez la voir dans la liste des **clusters** du AWS Management Console.
![\[Étapes finales de l'ajout d'une région à un cluster, avec affichage du formulaire de configuration, de l'estimation du coût horaire et du bouton Créer un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### À l'aide du AWS CLI
+ Utilisez la commande `create-db-cluster` CLI avec le nom `(--global-cluster-identifier)` de votre cluster global. Pour les autres paramètres, procédez comme suit :
+ Pour`--region`, choisissez une région différente de Région AWS celle de votre région principale.
+ Choisissez des valeurs spécifiques pour les paramètres `--engine` et `--engine-version`.
+ Pour un cluster chiffré, spécifiez votre cluster principal Région AWS comme étant le cluster `--source-region` de chiffrement.
L'exemple suivant crée un nouveau cluster Amazon DocumentDB et l'attache au cluster global en tant que cluster secondaire en lecture seule. Dans la dernière étape, l'instance est ajoutée au nouveau cluster.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Pour Windows :
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Utilisation d'un instantané pour votre cluster global Amazon DocumentDB
Vous pouvez restaurer un instantané d'un cluster Amazon DocumentDB afin de l'utiliser comme point de départ pour votre cluster global. Pour ce faire, vous devez restaurer le snapshot et créer un nouveau cluster. Il servira de cluster principal de votre cluster mondial. Vous pouvez ensuite ajouter une autre région au cluster restauré, le convertissant ainsi en cluster global.
# Gestion d'un cluster global Amazon DocumentDB
Vous effectuez la plupart des opérations de gestion sur les clusters individuels qui constituent un cluster global. Lorsque vous sélectionnez **Grouper les ressources associées** sur la page **Clusters** de la console, le cluster principal et les clusters secondaires sont regroupés sous le cluster global associé.
L'onglet **Configuration** d'un cluster global indique l' Régions AWS endroit où les clusters sont exécutés, la version et l'identifiant du cluster global.
**Topics**
+ [Modification de clusters globaux](#global-clusters.modify)
+ [Modification des paramètres](#global-clusters.modify-parameters)
+ [Supprimer des clusters globaux](#global-clusters.remove)
+ [Supprimer des clusters globaux](#global-clusters.delete)
+ [Clusters sans tête](#global-clusters.headless)
## Modification d'un cluster global Amazon DocumentDB
La page **Clusters** AWS Management Console répertorie tous vos clusters globaux, en indiquant le cluster principal et les clusters secondaires pour chacun d'entre eux. Le cluster global possède ses propres paramètres de configuration. Plus précisément, des régions sont associées à ses clusters principaux et secondaires.
Lorsque vous apportez des modifications au cluster global, vous avez la possibilité d'annuler les modifications.
Lorsque vous choisissez Continuer, vous confirmez les modifications.
## Modification des paramètres d'un cluster global Amazon DocumentDB
Vous pouvez configurer les groupes de paramètres de cluster indépendamment pour chaque cluster au sein du cluster global. La plupart des paramètres fonctionnent de la même manière que pour les autres types de clusters Amazon DocumentDB. Nous vous recommandons de maintenir la cohérence des paramètres entre tous les clusters d'une base de données globale. Vous pourrez ainsi éviter les changements de comportement inattendus si vous choisissez un cluster secondaire en tant que cluster principal.
Par exemple, utilisez les mêmes paramètres pour les fuseaux horaires et les jeux de caractères afin d'éviter tout écart de comportement si un autre cluster devient le cluster principal.
## Supprimer un cluster d'un cluster global Amazon DocumentDB
Il existe plusieurs situations dans lesquelles vous souhaiterez peut-être supprimer des clusters de votre cluster global. Par exemple, vous souhaiterez peut-être supprimer un cluster d'un cluster global si le cluster principal est dégradé ou isolé. Il devient alors un cluster provisionné autonome qui peut être utilisé pour créer un nouveau cluster global. Pour en savoir plus, veuillez consulter la section [Réalisation d'un basculement manuel pour un cluster global Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover).
Vous souhaiterez peut-être également supprimer des clusters car vous souhaitez supprimer un cluster global dont vous n'avez plus besoin. Vous ne pouvez pas supprimer le cluster global tant que vous n'avez pas détaché tous les clusters associés, en laissant le cluster principal en dernier. Pour de plus amples informations, veuillez consulter [Supprimer un cluster d'un cluster global Amazon DocumentDB](#global-clusters.delete).
**Note**
Lorsqu'un cluster est détaché du cluster global, il n'est plus synchronisé avec le cluster principal. Il devient un cluster provisionné autonome doté de fonctionnalités complètes read/write . En outre, il n'est plus visible dans la console Amazon DocumentDB. Il n'est visible que lorsque vous sélectionnez la région de la console dans laquelle se trouvait le cluster.
Vous pouvez supprimer des clusters de votre cluster global à l'aide de l'API AWS Management Console, de AWS CLI, ou de l'API RDS.
------
#### [ Using the AWS Management Console ]
1. Connectez-vous à la console Amazon DocumentDB AWS Management Console et accédez à celle-ci.
1. Choisissez **Clusters** dans la barre de navigation de gauche.
![\[Image : la boîte de navigation Clusters affichant une liste des liens de clusters existants et leurs liens d'instance correspondants.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Développez le cluster global afin de voir tous les clusters secondaires. Sélectionnez les clusters secondaires que vous souhaitez supprimer. Choisissez **Actions**, puis dans le menu déroulant, choisissez **Supprimer de la version globale**.
![\[Image : la boîte de navigation Clusters montrant la sélection d'un cluster secondaire existant et mettant en évidence l'action « Supprimer du cluster global ».\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. Une invite s'affichera, vous demandant de confirmer que vous souhaitez détacher le secondaire du cluster global. Choisissez **Supprimer et promouvoir** pour supprimer le cluster du cluster global.
![\[Image : l'invite de suppression et de promotion.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
Désormais, ce cluster ne sert plus de cluster secondaire et n'est plus synchronisé avec le cluster principal. Il s'agit d'un cluster autonome doté de read/write fonctionnalités complètes.
Après avoir dissocié ou supprimé les clusters secondaires, vous pouvez procéder de la même façon pour dissocier le cluster principal. Vous ne pouvez pas détacher ou supprimer le cluster principal du cluster global tant que vous n'avez pas supprimé tous les clusters secondaires. Le cluster global peut rester dans la liste des clusters, avec zéro région et AZs. Vous pouvez le supprimer si vous ne souhaitez plus utiliser ce cluster global.
------
#### [ Using the AWS CLI ]
Pour supprimer un cluster d'un cluster global, exécutez la commande `remove-from-global-cluster` CLI avec les paramètres suivants :
+ `--global-cluster-identifier`— Le nom (identifiant) de votre cluster mondial.
+ `--db-cluster-identifier`— Le nom de chaque cluster à supprimer du cluster global.
Les exemples suivants suppriment d'abord un cluster secondaire, puis le cluster principal d'un cluster global.
Pour Linux, macOS ou Unix :
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
Répétez la `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` commande pour chaque région secondaire de votre cluster global.
Pour Windows :
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
Répétez la `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` commande pour chaque région secondaire de votre cluster global.
------
## Supprimer un cluster d'un cluster global Amazon DocumentDB
Pour supprimer un cluster global, procédez comme suit :
+ Supprimez tous les clusters secondaires du cluster global. Chaque cluster devient un cluster autonome. Voir la section précédente,[Supprimer un cluster d'un cluster global Amazon DocumentDB](#global-clusters.remove).
+ Dans chaque cluster autonome, supprimez toutes les répliques.
+ Supprimez le cluster principal du cluster global. Cela devient un cluster autonome.
+ Dans le cluster principal, supprimez d'abord toutes les répliques, puis supprimez l'instance principale. La suppression de l'instance principale du nouveau cluster autonome entraîne généralement la suppression à la fois du cluster et du cluster global.
------
#### [ Using the AWS Management Console ]
1. Connectez-vous à la console Amazon DocumentDB AWS Management Console et accédez à celle-ci.
1. Choisissez **Clusters** et recherchez le cluster global que vous souhaitez supprimer.
![\[Image : la boîte de navigation Clusters affichant une liste des liens de clusters existants et leurs liens d'instance correspondants.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Une fois votre cluster global sélectionné, choisissez **Supprimer** dans le menu **Actions**.
![\[Image : la boîte de navigation Clusters montrant la sélection d'un cluster global et mettant en évidence l'action « Supprimer ».\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
Vérifiez que tous les clusters sont supprimés du cluster global. Le cluster mondial ne doit afficher aucune région AZs et une taille de zéro cluster. Si le cluster global contient des clusters, vous ne pouvez pas encore le supprimer. Vous devez d'abord suivre les instructions de l'étape précédente, **[Supprimer un cluster d'un cluster global Amazon DocumentDB](#global-clusters.remove)**.
------
#### [ Using the AWS CLI ]
Pour supprimer un cluster global, exécutez la commande `delete-global-cluster` CLI avec le nom Région AWS et l'identifiant du cluster global, comme indiqué dans l'exemple suivant.
Pour Linux, macOS ou Unix :
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Pour Windows :
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## Création d'un cluster Amazon DocumentDB sans tête dans une région secondaire
Bien qu'un cluster global Amazon DocumentDB nécessite au moins un cluster secondaire différent Région AWS du cluster principal, vous pouvez utiliser une configuration headless pour le cluster secondaire. Un cluster Amazon DocumentDB secondaire sans tête est un cluster sans instance. Ce type de configuration permet de réduire les dépenses d'un cluster global. Dans un cluster Amazon DocumentDB, le calcul et le stockage sont découplés. Sans l'instance, le calcul ne vous est pas facturé, uniquement le stockage. S'il est correctement configuré, le volume de stockage d'un périphérique secondaire sans tête est maintenu synchronisé avec le cluster principal.
Vous ajoutez le cluster secondaire comme vous le faites habituellement lors de la création d'un cluster global Amazon DocumentDB. Toutefois, une fois que le cluster principal a commencé la réplication vers le cluster secondaire, vous supprimez l'instance en lecture seule du cluster secondaire. Ce cluster secondaire est désormais considéré comme « sans tête » car il ne possède plus d'instance. Cependant, le volume de stockage reste synchronisé avec le cluster Amazon DocumentDB principal.
**Important**
Nous recommandons uniquement les clusters headless aux clients qui peuvent tolérer des pannes régionales pendant plus de 15 minutes. En effet, la restauration après une défaillance régionale avec un cluster secondaire sans tête obligera l'utilisateur à créer une nouvelle instance après le basculement. La disponibilité d'une nouvelle instance peut prendre environ 10 à 15 minutes.
### Comment ajouter un cluster secondaire sans tête à votre cluster mondial
1. Connectez-vous à la console [Amazon DocumentDB AWS Management Console](https://console.aws.amazon.com/rds/) et ouvrez-la.
1. Choisissez **Clusters** dans la barre de navigation de gauche.
1. Choisissez le cluster global qui a besoin d'un cluster secondaire. Assurez-vous que le cluster principal est`Available`.
1. Pour **Actions**, choisissez **Add region (Ajouter une région)**.
1. Sur la page **Ajouter une région**, choisissez la région secondaire.
**Note**
Vous ne pouvez pas choisir une région qui possède déjà un cluster secondaire pour le même cluster mondial. De plus, il ne peut pas s'agir de la même région que le cluster principal.
1. Complétez les champs restants pour le cluster secondaire dans la nouvelle région. Il s'agit des mêmes options de configuration que pour n'importe quelle instance de cluster.
1. Ajoutez une région. Une fois que vous avez terminé d'ajouter la région à votre cluster mondial, vous la verrez `Clusters` dans la liste du AWS Management Console.
1. Vérifiez l'état du cluster secondaire et de son instance de lecteur avant de continuer, en utilisant le AWS Management Console ou le AWS CLI. Voici un exemple de commande si vous utilisez AWS CLI :
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
Plusieurs minutes peuvent être nécessaires pour que le statut d'un cluster secondaire récemment ajouté passe de « création » à « disponible ». Lorsque le cluster est disponible, vous pouvez supprimer l'instance de lecteur.
1. Sélectionnez l'instance de lecteur dans le cluster secondaire, puis choisissez **Supprimer**.
1. Après avoir supprimé l'instance de lecteur, le cluster secondaire fait toujours partie du cluster global. Aucune instance ne doit lui être associée.
**Note**
Vous pouvez utiliser ce cluster Amazon DocumentDB secondaire sans tête pour récupérer manuellement votre cluster global Amazon DocumentDB suite à une panne imprévue dans la région principale si une telle panne se produit.
# Connectez-vous à un cluster global Amazon DocumentDB
La façon dont vous vous connectez à un cluster global varie selon que vous devez écrire dans le cluster ou lire depuis le cluster :
+ Pour les demandes ou requêtes en lecture seule, vous vous connectez au point de terminaison du lecteur pour le cluster de votre. Région AWS
+ Pour exécuter des instructions DML ou DDL, vous vous connectez au point de terminaison de cluster du cluster principal. Ce point de terminaison se trouve peut-être dans une autre application Région AWS que celle de votre application.
Lorsque vous visualisez un cluster global dans la console, vous pouvez voir tous les points de terminaison à usage général associés à tous ses clusters.
La façon dont vous vous connectez à un cluster global dépend de la nécessité d'écrire dans la base de données ou de lire des informations dans la base de données. Pour les opérations DDL, DML et de lecture que vous souhaitez effectuer depuis la région principale, vous devez vous connecter à votre cluster principal. Nous vous recommandons de vous connecter à votre cluster principal en utilisant le point de terminaison du cluster en mode Replica Set, avec une préférence de lecture de`secondaryPreferred=true`. Cela acheminera le trafic d'écriture vers l'instance d'écriture de votre cluster principal et le trafic de lecture vers l'instance de réplique de votre cluster principal.
Pour le trafic interrégional en lecture seule, vous devez vous connecter à l'un de vos clusters secondaires. Nous vous recommandons de vous connecter à votre cluster secondaire en utilisant le point de terminaison du cluster en mode Replica Set. Comme toutes les instances sont des instances de réplication en lecture seule, il n'est pas nécessaire de spécifier de préférence de lecture. Pour minimiser la latence, choisissez le point de terminaison du lecteur situé dans votre région ou dans la région la plus proche de chez vous.
# Surveillance des clusters globaux Amazon DocumentDB
Amazon DocumentDB (compatible avec MongoDB) s'intègre CloudWatch afin que vous puissiez collecter et analyser les métriques opérationnelles de vos clusters. Vous pouvez surveiller ces métriques à l'aide de la CloudWatch console, de la console Amazon DocumentDB, du AWS Command Line Interface (AWS CLI) ou de l' CloudWatch API.
Pour surveiller un cluster global, utilisez les CloudWatch mesures suivantes.
| Métrique | Description |
| --- | --- |
| GlobalClusterReplicatedWriteIO | Nombre moyen d' I/O opérations d'écriture facturées répliquées depuis le volume de cluster du volume principal Région AWS vers le volume de cluster du volume secondaire Région AWS, indiqué à intervalles de 5 minutes. Le nombre de réplications dans ReplicatedWriteIOs chaque région secondaire est le même que le nombre de réplications VolumeWriteIOPs effectuées dans la région par la région principale. |
| GlobalClusterDataTransferBytes | La quantité de données transférée du cluster principal Région AWS vers le cluster secondaire est Région AWS mesurée en octets. |
| GlobalClusterReplicationLag | Le délai, en millisecondes, lors de la réplication des événements de changement du cluster principal Région AWS vers celui d'un cluster secondaire Région AWS |
Pour plus d'informations sur la façon de consulter ces statistiques, consultez la section [Affichage CloudWatch des données](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data).
# Reprise après sinistre et clusters globaux Amazon DocumentDB
**Topics**
+ [Réalisation d'un basculement géré pour un cluster global Amazon DocumentDB](#managed-failover)
+ [Réalisation d'un basculement manuel pour un cluster global Amazon DocumentDB](#manual-failover)
+ [Exécution d'une commutation pour un cluster global Amazon DocumentDB](#global-cluster-switchover)
+ [Déblocage d'un basculement ou d'un basculement d'un cluster global](#unblocking-gc-so-fo)
En utilisant un cluster mondial, vous pouvez vous remettre rapidement après des 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.
+ **Objectif de délai de reprise (RTO)** : temps nécessaire à un système pour revenir à un état de fonctionnement normal après un sinistre. En d’autres termes, le RTO mesure les temps d’arrêt. Pour un cluster mondial, RTO en quelques minutes.
+ **Objectif de point de reprise (RPO)** : quantité de données pouvant être perdues (mesurée dans le temps). Pour un cluster mondial, le RPO est généralement mesuré en secondes.
+ Pour récupérer après une panne imprévue, vous pouvez effectuer un basculement entre régions vers l'un des secondaires de votre cluster mondial. Lorsque votre cluster mondial comporte plusieurs régions secondaires, assurez-vous de dissocier toutes les régions secondaires que vous souhaitez promouvoir en tant que régions principales. Ensuite, vous promouvez l'une de ces régions secondaires comme nouvelle région principale Région AWS. Enfin, vous créez de nouveaux clusters dans chacune des autres régions secondaires et vous attachez ces clusters à votre cluster global.
## Réalisation d'un basculement géré pour un cluster global 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 global Amazon DocumentDB est conservée. 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 se synchroniser avec le nouveau volume principal afin que les données non répliquées soient préservées sur le cliché.
**Note**
Vous ne pouvez effectuer un basculement de cluster interrégional géré sur un cluster global Amazon DocumentDB que si le cluster principal et tous les clusters secondaires possèdent les mêmes versions de moteur. Si les versions de votre moteur sont incompatibles, vous pouvez effectuer le basculement manuellement en suivant les étapes décrites dans [Réalisation d'un basculement manuel pour un cluster global Amazon DocumentDB](#manual-failover).
Si les versions des moteurs de la région ne correspondent pas, le basculement sera bloqué. Vérifiez les mises à niveau en attente et appliquez-les pour vous assurer que les versions du moteur de toutes les régions correspondent et que le basculement du cluster mondial est débloqué. Pour de plus amples informations, veuillez consulter [Déblocage d'un basculement ou d'un basculement d'un cluster global](#unblocking-gc-so-fo).
Pour minimiser les pertes de données, nous vous recommandons de prendre les mesures suivantes avant d'utiliser cette fonctionnalité :
+ Mettez les applications hors ligne pour empêcher l'envoi d'écritures vers le cluster principal du cluster global Amazon DocumentDB.
+ Vérifiez les temps de latence pour tous les clusters secondaires Amazon DocumentDB. Le choix de la région secondaire présentant le retard de réplication minimum peut minimiser les pertes de données avec la région principale actuellement défaillante. Vérifiez les temps de latence de tous les clusters secondaires Amazon DocumentDB du cluster global en consultant la `GlobalClusterReplicationLag` métrique sur Amazon. CloudWatch Ces mesures indiquent le retard (en millisecondes) entre la réplication vers un cluster secondaire et le cluster principal.
Pour plus d'informations sur CloudWatch les métriques pour Amazon DocumentDB, consultez. [Métriques Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Lors d'un basculement géré, le cluster secondaire choisi est promu à son nouveau rôle 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, nous vous recommandons de résoudre les différences entre vos clusters globaux Amazon DocumentDB pour ce qui suit :
+ **Configurez un groupe de paramètres de cluster Amazon DocumentDB pour le nouveau cluster principal, si nécessaire**. Vous pouvez configurer vos groupes de paramètres de cluster Amazon DocumentDB indépendamment pour chaque cluster de votre cluster global Amazon DocumentDB. Par conséquent, lorsque vous promouvez un cluster secondaire pour qu'il prenne le rôle principal, le groupe de paramètres du cluster secondaire peut être configuré différemment de celui du cluster principal. Si tel est le cas, modifiez le groupe de paramètres du cluster secondaire promu pour qu'il soit conforme aux paramètres de votre cluster principal. Pour savoir comment procéder, consultez [Modification des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ **Configurer les outils et les options de surveillance, tels que les CloudWatch événements et les alarmes Amazon** : configurez le cluster promu avec la même capacité de journalisation, les mêmes alarmes, etc. que celles nécessaires pour le cluster global. Comme pour les groupes de paramètres, la configuration de ces fonctionnalités n’est pas héritée du cluster principal durant le processus de basculement. Certaines CloudWatch mesures, telles que le délai de réplication, ne sont disponibles que pour les régions secondaires. Ainsi, un basculement modifie la façon d’afficher ces métriques et de définir des alarmes sur celles-ci, et peut nécessiter d’apporter des modifications à des tableaux de bord prédéfinis. Pour plus d'informations sur les clusters et la surveillance Amazon DocumentDB, consultez. [Surveillance d'Amazon DocumentDB](monitoring_docdb.md)
Généralement, 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 fait la promotion du nouveau cluster principal, il reconstruit automatiquement tous les clusters de régions secondaires supplémentaires.
Étant donné que les clusters globaux 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 point-in-time données que le 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 global 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 -DB-Cluster-Timestamp » dans la section des instantanés du. AWS Management Console Vous pouvez également voir cet instantané répertorié dans les informations renvoyées par l'opération `DescribeDBClusterSnapshots` d'API.
**Note**
L’instantané de l’ancien volume de stockage est un instantané du système soumis à la période de conservation des sauvegardes configurée sur l’ancien cluster principal. Pour conserver cet instantané en dehors de la période de conservation, vous pouvez le copier pour l’enregistrer en tant qu’instantané manuel. Pour en savoir plus sur la copie des instantanés, y compris la tarification, consultez [Copier un instantané de cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Une fois la topologie d'origine restaurée, vous pouvez rétablir votre cluster global dans la région principale d'origine en effectuant une opération de commutation au moment le plus approprié pour votre activité et votre charge de travail. Pour ce faire, suivez les étapes de [Exécution d'une commutation pour un cluster global Amazon DocumentDB](#global-cluster-switchover).
Vous pouvez basculer sur votre cluster global Amazon DocumentDB à l'aide de l' AWS Management Console API Amazon DocumentDB ou de l' AWS CLI API Amazon DocumentDB.
------
#### [ Using the AWS Management Console ]
**Effectuez un basculement géré sur votre cluster global Amazon DocumentDB**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Recherchez et choisissez le cluster global Amazon DocumentDB sur lequel vous souhaitez basculer.
![\[Image : table de clusters avec cluster global sélectionné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. **Choisissez **Switchover ou Failover** dans le menu Actions.**
1. 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**.
![\[Image : boîte de dialogue de basculement ou de basculement global du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Tapez « confirmer » dans le dernier champ. Ensuite, choisissez **Valider**.
L'état du cluster principal passe à « **Basculement ».** Cette condition devrait prendre environ une minute. Pendant ce temps, l'état du nouveau cluster principal indique « **Modification...** «. Une fois que le nouveau serveur principal sera promu, il affichera « **Disponible** » et pourra servir les transactions en lecture et en é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 sera en mesure de traiter les transactions que lorsque le statut deviendra « **Disponible** ».
1. Une fois terminé, le cluster principal d'origine devient le cluster secondaire. Le cluster secondaire sélectionné devient le cluster principal.
![\[Image : Tableau des clusters montrant le nouveau cluster principal.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Effectuez un basculement géré sur votre cluster global Amazon DocumentDB**
Exécutez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI pour basculer sur votre cluster global Amazon DocumentDB. À l'aide de la commande, transmettez les valeurs des options suivantes :
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
Dans les exemples suivants, remplacez chacun *user input placeholder* par les informations de 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
```
------
## Réalisation d'un basculement manuel pour un cluster global Amazon DocumentDB
Si un cluster entier dans un cluster Région AWS devient indisponible, vous pouvez promouvoir une read/write fonctionnalité dans un autre cluster du cluster global.
Vous pouvez activer manuellement le mécanisme de basculement global du cluster s'il Région AWS est préférable de choisir un cluster situé dans un autre cluster comme cluster principal. Par exemple, vous pouvez accroître la capacité de l'un des clusters secondaires, puis le promouvoir comme cluster principal. L'équilibre des activités entre eux Régions AWS peut également changer, de sorte que le fait de passer du cluster principal à un autre Région AWS peut réduire le temps de 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.
Pour promouvoir un cluster secondaire :
1. Arrêtez d'émettre des instructions DML et d'autres opérations d'écriture sur le cluster principal en cas Région AWS de panne.
1. Identifiez un cluster à partir d'un cluster secondaire Région AWS à utiliser comme nouveau cluster principal. Si vous en avez deux (ou plus) Régions AWS dans votre cluster global, choisissez le cluster secondaire qui présente le moins de temps de latence.
1. Détachez le cluster secondaire que vous avez choisi du cluster global.
La suppression d'un cluster secondaire d'un cluster global arrête immédiatement la réplication du cluster principal vers ce cluster secondaire et en fait un cluster provisionné autonome doté de fonctionnalités complètes read/write . Tout autre cluster secondaire associé au cluster principal dans la région touchée par la panne est toujours disponible et peut accepter les appels de votre application. Ils consomment également des ressources. Puisque vous recréez le cluster global, pour éviter les problèmes liés au split brain et à d'autres problèmes, supprimez les autres clusters secondaires avant de créer le nouveau cluster global en suivant les étapes ci-dessous.
Afin d’obtenir les étapes détaillées du détachement, consultez [Supprimer un cluster d'un cluster global Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
1. Ce cluster devient le cluster principal d'un nouveau cluster mondial lorsque vous commencez à y ajouter des régions, à l'étape suivante.
1. Ajoutez un Région AWS au cluster. Lorsque vous effectuez cette opération, le processus de réplication du cluster primaire vers le cluster secondaire commence.
1. Ajoutez-en Régions AWS d'autres si nécessaire pour recréer la topologie requise pour prendre en charge votre application. Assurez-vous que les écritures de l'application sont envoyées au cluster approprié avant, pendant et après de telles modifications, afin d'éviter les incohérences de données entre les clusters du cluster global (problèmes liés au split brain).
1. Lorsque la panne est résolue et que vous êtes prêt à réattribuer votre cluster d'origine Région AWS comme cluster principal, effectuez les mêmes étapes dans le sens inverse.
1. Supprimez l'un des clusters secondaires du cluster global. Cela lui permettra de desservir read/write le trafic.
1. Redirigez tout le trafic d'écriture vers le cluster principal dans l'original Région AWS.
1. Ajoutez un Région AWS pour configurer un ou plusieurs clusters secondaires de la même manière Région AWS que précédemment.
Les clusters globaux Amazon DocumentDB peuvent être gérés à l'aide AWS SDKs de ce qui vous permet de créer des solutions pour automatiser le processus de basculement des clusters mondiaux 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](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation). Cette solution utilise 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'une commutation 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 pour l'utilisation des commutateurs :
+ Pour les exigences de « rotation régionale » imposées à des secteurs spécifiques. Par exemple, la réglementation des services financiers peut exiger que les systèmes de niveau 0 passent à une autre région pendant plusieurs mois afin de garantir que les procédures de reprise après sinistre sont régulièrement mises à l’épreuve.
+ Pour les applications « follow-the-sun » multirégionales. Par exemple, une entreprise peut souhaiter fournir une latence d’écriture plus faible dans différentes régions en fonction des heures d’ouverture dans différents fuseaux horaires.
+ Comme zero-data-loss méthode pour revenir à la région principale d'origine après un basculement.
**Note**
Les switchovers sont conçus pour être utilisés sur un cluster global Amazon DocumentDB sain. Pour récupérer après une panne imprévue, suivez la procédure appropriée dans [Réalisation d'un basculement manuel pour un cluster global Amazon DocumentDB](#manual-failover).
Pour effectuer une commutation, toutes les régions secondaires doivent exécuter exactement la même version de moteur que la région principale. Si les versions des moteurs de la région ne correspondent pas, le passage au numérique sera bloqué. Vérifiez les mises à niveau en attente et appliquez-les pour vous assurer que les versions du moteur de toutes les régions correspondent et que le passage au cluster mondial est débloqué. Pour de plus amples informations, veuillez consulter [Déblocage d'un basculement ou d'un basculement d'un cluster global](#unblocking-gc-so-fo).
Lors d'un changement, Amazon DocumentDB fait passer votre cluster principal à la région secondaire de votre choix tout en conservant la topologie de réplication existante de votre cluster global. Avant de démarrer le processus de transition, Amazon DocumentDB attend que tous les clusters de régions secondaires soient entièrement synchronisés avec le cluster de régions 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. Comme tous les clusters secondaires étaient synchronisés avec le cluster principal au début du processus, le nouveau cluster principal poursuit les opérations du cluster global 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, nous vous recommandons d’effectuer les opérations suivantes avant d’utiliser cette fonctionnalité :
+ Effectuez cette opération en dehors des heures de pointe ou à un autre moment lorsque les écritures sur le cluster principal sont minimes.
+ Mettez les applications hors ligne pour empêcher l'envoi d'écritures vers le cluster principal du cluster global Amazon DocumentDB.
+ Vérifiez les temps de latence de tous les clusters secondaires Amazon DocumentDB du cluster global en consultant la `GlobalClusterReplicationLag` métrique sur Amazon. CloudWatch Cette métrique indique le retard (en millisecondes) entre la réplication vers un cluster secondaire et le cluster principal. Cette valeur est directement proportionnelle au temps nécessaire à Amazon DocumentDB pour effectuer le basculement. Par conséquent, plus la valeur de retard est élevée, plus la bascule prendra de temps.
Pour plus d'informations sur CloudWatch les métriques pour Amazon DocumentDB, consultez. [Métriques Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
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, nous vous recommandons de résoudre les différences entre vos clusters globaux Amazon DocumentDB pour ce qui suit :
+ **Configurez le groupe de paramètres de cluster Amazon DocumentDB pour le nouveau cluster principal, si nécessaire** — Vous pouvez configurer les groupes de paramètres de cluster Amazon DocumentDB indépendamment pour chaque cluster de votre cluster global Amazon DocumentDB. Cela signifie que lorsque vous promouvez un cluster de base de données secondaire pour endosser le rôle de cluster principal, le groupe de paramètres du cluster secondaire peut être configuré différemment de celui du principal. Si c'est le cas, modifiez le groupe de paramètres du cluster de base de données secondaire promu afin qu'il soit conforme aux paramètres de votre cluster principal. Pour savoir comment procéder, consultez [Gestion des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ **Configurez les outils et options de surveillance, tels que les CloudWatch événements et les alarmes Amazon** : configurez le cluster promu avec la même capacité de journalisation, les mêmes alarmes, etc. que celles nécessaires pour le cluster global. Comme pour les groupes de paramètres, la configuration de ces fonctionnalités n’est pas héritée du cluster principal durant le processus de bascule. Certaines CloudWatch mesures, telles que le délai de réplication, ne sont disponibles que pour les régions principales. Ainsi, une bascule modifie la façon d’afficher ces métriques et de définir des alarmes associées, et peut nécessiter d’apporter des modifications à des tableaux de bord prédéfinis. Pour de plus amples informations, veuillez consulter [Surveillance d'Amazon DocumentDB](monitoring_docdb.md).
**Note**
En général, la commutation de rôle peut prendre plusieurs minutes.
Une fois le processus de transition terminé, le cluster Amazon DocumentDB promu peut gérer les opérations d'écriture pour le cluster global.
Vous pouvez changer de cluster global Amazon DocumentDB en utilisant le AWS Management Console ou le : AWS CLI
------
#### [ Using the AWS Management Console ]
**Effectuez une commutation sur votre cluster global Amazon DocumentDB**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Recherchez et sélectionnez le cluster global Amazon DocumentDB que vous souhaitez transférer.
![\[Image : table de clusters avec cluster global sélectionné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. **Choisissez **Switchover ou Failover** dans le menu Actions.**
1. 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**.
![\[Image : boîte de dialogue de commutation de cluster avec cluster secondaire sélectionné.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Choisissez **Confirmer**.
L'état du cluster principal passe à « **Switching-over** ». Cette condition devrait prendre environ trois minutes. Pendant ce temps, l'état de tous les clusters régionaux indique « **Modification...** «. Une fois les régions synchronisées et le nouveau serveur principal promu, tous les champs de statut indiqueront « **Disponible** » et pourront traiter les transactions.
1. Une fois terminé, le cluster principal d'origine devient le cluster secondaire. Le cluster secondaire sélectionné devient le cluster principal.
![\[Image : Tableau des clusters montrant le nouveau cluster principal.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Effectuez une commutation sur votre cluster global Amazon DocumentDB**
Exécutez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI pour basculer entre votre cluster global Amazon DocumentDB. À l'aide de la commande, transmettez les valeurs des options suivantes :
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
Dans les exemples suivants, remplacez chacun *user input placeholder* par les informations de 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 d'un cluster global
Les basculements et les basculements de clusters globaux sont bloqués lorsque tous les clusters régionaux du cluster mondial ne sont pas équipés de la même version de moteur. Si les versions ne correspondent pas, cette erreur peut s'afficher en réponse lors de l'appel à un basculement ou à un basculement : le cluster de base de données cible spécifié exécute une version du moteur avec un niveau de correctif différent de celui du cluster de base de données source. Nous vous recommandons d'appliquer régulièrement les dernières versions du moteur afin de garantir que vous exécutez les dernières mises à jour afin de maintenir vos clusters globaux en bon état.
Pour résoudre cette erreur, veuillez d'abord mettre à jour toutes les régions secondaires, puis la région principale avec la même version du moteur en appliquant toutes les mesures de maintenance en attente. Pour consulter 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 AWS Management Console ]
Pour débloquer un basculement ou un basculement global de clusters, vous devez déterminer si des actions de maintenance sont en attente pour vos clusters et les appliquer. Pour afficher et appliquer les actions de maintenance, procédez comme suit :
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. 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 pour le cluster global donné, puis effectuez les étapes suivantes pour chacun d'eux.
1. 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**.
1. Pour effectuer une action, choisissez le cluster pour en afficher les détails, puis choisissez **Maintenance et sauvegardes**. Les éléments de **maintenance en attente** apparaissent.
1. Sous **Description**, s'il est indiqué qu'une « nouvelle mise à jour de maintenance est disponible », sélectionnez-la, puis choisissez **Appliquer maintenant**.
1. 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**.
1. Pour effectuer une action, choisissez le cluster pour en afficher les détails, puis choisissez **Maintenance et sauvegardes**. Les éléments de **maintenance en attente** apparaissent.
1. 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 un basculement ou un basculement global d'un cluster, vous devez déterminer si des actions de maintenance sont en attente pour le cluster et les appliquer. Procédez comme suit pour afficher et appliquer des actions de maintenance d'abord sur les clusters secondaires, puis sur le cluster principal de votre cluster global :
1. Exécutez d'abord ce qui suit sur le cluster régional de chaque région secondaire, puis pour le cluster régional des régions principales.
1. Exécutez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI avec l'`--resource-identifier`option permettant de déterminer si des actions de maintenance sont disponibles pour votre cluster régional Amazon DocumentDB.
Dans les exemples suivants, remplacez chacun *user input placeholder* par les informations de 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"
}
]
}
]
}
```
1. Si une action de maintenance est nécessaire, exécutez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI avec les options suivantes :
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
Dans les exemples suivants, remplacez chacun *user input placeholder* par les informations de 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
```
1. Une fois l'action de maintenance terminée, réexécutez la [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)commande pour vous assurer qu'aucune autre action n'est en attente pour votre cluster.
Le résultat que vous souhaitez obtenir est le suivant :
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Pour débloquer un basculement ou un basculement global d'un cluster, vous devez déterminer si des actions de maintenance sont en attente pour le cluster et les appliquer. Utilisez ce qui suit APIs pour afficher et appliquer les actions de maintenance :
1. Exécutez d'abord ce qui suit sur le cluster régional de chaque région secondaire, puis pour le cluster régional des régions principales.
1. Appelez l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API pour déterminer si des actions de maintenance sont disponibles pour votre cluster global Amazon DocumentDB.
1. Appliquez les modifications en appelant l'[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API.
------