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.
# 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)
+ [À l'aide d'un instantané](#global-clusters.snapshot)
## Configuration
Le cluster mondial 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éplication, tandis qu'une région secondaire gère un cluster en lecture seule composé entièrement de 16 instances de réplication au maximum. Un cluster mondial peut comporter jusqu'à 10 régions secondaires. Le tableau répertorie le nombre maximum 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 | 10 (maximum) |
| Instances de scripteur | 1 | 0 |
| Read-only instances (répliques Amazon DocumentDB), par cluster | 15 (max) | 16 (total) |
| Read-only instances (maximum autorisé, compte tenu du nombre réel de régions secondaires) | 15 - s | s = nombre total d'écoles 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'à 10 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 mondial 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 Console de gestion AWS ou AWS CLI en suivant les instructions suivantes.
### Utilisation de Console de gestion AWS
1. Dans le Console de gestion AWS, accédez à ** Amazon DocumentDB. **
1. Lorsque vous accédez à la console Amazon DocumentDB, choisissez ** Clusters**.
1. Choisissez **Créer**.
1. Remplissez la ** section ** Configuration du ** formulaire ** Créer un cluster Amazon DocumentDB en conséquence :
+ **Identifiant du cluster ** : vous pouvez soit entrer un identifiant unique pour cette instance, soit autoriser Amazon DocumentDB à fournir l'identifiant de l'instance en fonction de l'identifiant du cluster.
+ Version du moteur : Choose ** 4.0.0 **
+ Classe d'instance : choisissez ** db.r5.large **
+ Nombre d'instances : Choisissez ** 3**.
1. Dans la ** section ** Authentification, saisissez un nom d'utilisateur principal et un mot de passe principal.
1. Choisissez ** Afficher les paramètres avancés**.
1. Dans la ** section Paramètres ** réseau :
+ Conservez les options par défaut pour le cloud privé ** virtuel (VPC) ** et le groupe de ** sous-réseaux. **
+ Pour les groupes de sécurité ** VPC**, la ** valeur par défaut (VPC) ** doit déjà être ajoutée.
+ Tapez `DocDB` dans le ** champ Groupes de sécurité ** VPC et sélectionnez ** DocDB-Inbound (VFC). **
1. Pour les options de ** cluster ** et ** Encryption-at-rest**, laissez les sélections par défaut.
1. Pour les exportations ** de sauvegarde ** et de ** journalisation**, laissez les sélections par défaut.
1. Pour la ** maintenance**, les ** balises ** et la protection contre la ** suppression**, laissez les sélections par défaut.
1. Choisissez maintenant ** Créer un cluster**.
### Utilisation de AWS CLI
Pour créer un cluster régional Amazon DocumentDB, appelez le cluster [AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) create-global-cluster. La AWS CLI commande suivante crée un cluster Amazon DocumentDB nommé`global-cluster-id`. Pour plus d'informations sur la protection contre la suppression, consultez[Supprimer un cluster Amazon DocumentDB](db-cluster-delete.md).
Il `--engine-version` s'agit également d'un paramètre facultatif dont la valeur par défaut est la dernière version du moteur majeur. 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 telle`8.0.0`). Lorsque de nouvelles versions de moteurs majeurs sont publiées, la version du moteur par défaut pour `--engine-version` est mise à jour pour refléter la dernière version du moteur majeur. 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, spécifiez explicitement la `--engine-version` version majeure prévue.
Si aucun `db-subnet-group-name` ou n'`vpc-security-group-id`est spécifié, Amazon DocumentDB utilisera le groupe de sous-réseaux par défaut et le groupe de sécurité Amazon VPC 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 Console de gestion AWS 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) [ CreateDBCluster ](https://docs.aws.amazon.com/documentdb/latest/APIReference/API_CreateDBCluster.html) dans la référence d'API * Amazon DocumentDB. *
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 vers un cluster mondial Amazon DocumentDB](#global-clusters.add-region). Lorsque vous ajoutez une région, votre cluster régional devient votre cluster principal et vous disposez d'un nouveau cluster secondaire dans la région que vous avez choisie.
## Ajouter un Région AWS vers un cluster mondial Amazon DocumentDB
Un cluster global nécessite au moins un cluster secondaire dans une région différente de celle du cluster principal, et vous pouvez ajouter jusqu'à 10 clusters secondaires. Notez que pour chaque cluster secondaire que vous ajoutez, vous devez réduire d'une unité le nombre de répliques autorisées dans le cluster principal. Par exemple, si votre cluster global possède 10 régions secondaires, votre cluster principal ne peut avoir que 5 répliques (au lieu de 15). Pour de plus amples informations, veuillez consulter [Configuration](#global-clusters.config).
### Utilisation de Console de gestion AWS
1. Connectez-vous à la console Amazon DocumentDB Console de gestion AWS et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Choisissez le cluster auquel vous souhaitez ajouter un cluster secondaire. Assurez-vous que le cluster est`Available`.
1. Sélectionnez la liste déroulante pour ** Actions, ** puis choisissez ** Ajouter une région. **
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 global. 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.
1. Renseignez les champs restants pour le cluster secondaire dans la nouvelle région, puis sélectionnez ** Créer un cluster**. Une fois que vous avez fini d'ajouter la région, vous pouvez la voir dans la liste des ** clusters ** du Console de gestion AWS.
### Utilisation de 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 `--source-region` destiné au chiffrement.
L'exemple suivant crée un nouveau cluster Amazon DocumentDB et l'associe 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 mondial 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 à votre cluster global. Vous pouvez ensuite ajouter une autre région au cluster restauré, le convertissant ainsi en cluster global.