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.
Ajouter une instance Amazon DocumentDB à un cluster
- Using the AWS Management Console
-
Utilisez la procédure suivante pour créer une instance pour votre cluster à l'aide de la console Amazon DocumentDB.
-
Dans le panneau de navigation, choisissez Clusters.
Astuce
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (
) dans le coin supérieur gauche de la page. -
Pour choisir le cluster auquel vous voulez ajouter une instance, sélectionnez le bouton à gauche du nom du cluster.
-
Choisissez Actions, puis Add instances (Ajouter des instances).
-
Dans la page Add instance to: (Ajouter une instance à :)<cluster-name>, répétez les étapes suivantes pour chaque instance que vous souhaitez ajouter au cluster. Vous pouvez en avoir jusqu'à 15.
-
Identifiant d'instance : 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.
Contraintes d'affectation de noms :
-
La longueur est de [1 à 63] lettres, chiffres ou traits d'union.
-
Le premier caractère doit être une lettre.
-
Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.
-
Doit être unique pour toutes les instances d'Amazon RDS, Neptune et Amazon Compte AWS DocumentDB par région.
-
-
Classe d'instance : dans la liste déroulante, choisissez le type d'instance que vous souhaitez pour cette instance.
-
Niveau de promotion : dans la liste déroulante, choisissez le niveau de promotion pour votre instance ou choisissez Aucune préférence pour permettre à Amazon DocumentDB de définir le niveau de promotion pour votre instance. Plus le chiffre est bas, plus la priorité est élevée. Pour de plus amples informations, veuillez consulter Contrôle de la cible de basculement.
-
Pour ajouter d'autres instances, choisissez Add additional instances (Ajouter des instances supplémentaires) et répétez les étapes a, b et c.
-
-
Mettez fin à l'opération.
-
Pour ajouter des instances à votre cluster, choisissez Create (Créer).
-
Pour annuler l'opération, choisissez Annuler.
-
La création d'une instance prend quelques minutes. Vous pouvez utiliser la console ou AWS CLI consulter le statut de l'instance. Pour de plus amples informations, veuillez consulter Surveillance de l'état d'une instance.
- Using the AWS CLI
-
Utilisez l'
create-db-instanceAWS CLI opération avec les paramètres suivants pour créer l'instance principale de votre cluster.-
--db-instance-class— Obligatoire. La capacité de calcul et de mémoire de l'instance, par exempledb.m4.large. Les classes d'instance ne sont pas toutes disponibles Régions AWS. -
--db-instance-identifier— Obligatoire. Chaîne en minuscules () qui identifie l'instance.Contraintes d'affectation de noms :
-
La longueur est de [1 à 63] lettres, chiffres ou traits d'union.
-
Le premier caractère doit être une lettre.
-
Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.
-
Doit être unique pour toutes les instances d'Amazon RDS, Neptune et Amazon Compte AWS DocumentDB par région.
-
-
--engine— Obligatoire. Doit indiquerdocdb. -
--availability-zone— Facultatif. La zone de disponibilité dans laquelle vous voulez créer l'instance. Utilisez ce paramètre pour localiser vos instances dans différentes zones de disponibilité, afin d'accroître la tolérance aux pannes. Pour de plus amples informations, veuillez consulter Amazon DocumentDB Haute disponibilité et réplication. -
--promotion-tier— Facultatif. Le niveau de priorité de basculement pour cette instance. Il doit être compris entre 0 et 15, les chiffres les plus bas indiquant une priorité plus élevée. Pour de plus amples informations, veuillez consulter Contrôle de la cible de basculement.
-
Tout d'abord, déterminez dans quelles zones de disponibilité vous pouvez créer votre instance.
Si vous souhaitez spécifier la zone de disponibilité avant de créer votre instance, exécutez la commande suivante pour déterminer quelles zones de disponibilité sont disponibles pour votre cluster Amazon DocumentDB.
Pour Linux, macOS ou Unix :
aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'Pour Windows :
aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'Le résultat de cette opération ressemble à ceci.
[ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] -
Ensuite, identifiez les classes d'instance que vous pouvez créer dans votre région.
Pour déterminer quelles classes d'instances sont disponibles dans votre région, exécutez la commande suivante. Dans la sortie, choisissez une classe d'instance pour l'instance que vous souhaitez ajouter à votre cluster Amazon DocumentDB.
Pour Linux, macOS ou Unix :
aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'Pour Windows :
aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'Le résultat de cette opération ressemble à ceci.
[ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] -
Enfin, ajoutez une instance à votre cluster Amazon DocumentDB.
Pour ajouter une instance à votre cluster Amazon DocumentDB, exécutez la commande suivante.
Pour Linux, macOS ou Unix :
aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdbPour Windows :
aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdbLe résultat de cette opération ressemble à ceci.
{ "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2" } }
La création de l'instance prend quelques minutes. Vous pouvez utiliser la console ou AWS CLI consulter le statut de l'instance. Pour de plus amples informations, veuillez consulter Surveillance de l'état d'une instance Amazon DocumentDB.
-
