View a markdown version of this page

Gestion des clusters élastiques Amazon DocumentDB - Amazon DocumentDB
Modification des configurations d'Elastic ClusterSurveillance d'un cluster élastiqueSupprimer un cluster élastique

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.

Gestion des clusters élastiques Amazon DocumentDB

Pour gérer un cluster élastique Amazon DocumentDB, vous devez disposer d'une politique IAM avec les autorisations de plan de contrôle Amazon DocumentDB appropriées. Ces autorisations vous permettent de créer, de modifier et de supprimer des clusters. La DocumentDBFullAccess politique Amazon fournit toutes les autorisations requises pour administrer un cluster élastique Amazon DocumentDB.

Les rubriques suivantes montrent comment effectuer différentes tâches lorsque vous travaillez avec des clusters élastiques Amazon DocumentDB.

Rubriques

Modification des configurations d'Elastic Cluster

Dans cette section, nous expliquons comment modifier Elastic Cluster à l'aide des instructions suivantes Console de gestion AWS ou AWS CLI à l'aide des instructions suivantes.

L'une des utilisations principales de la modification du cluster est de redimensionner les partitions en augmentant ou en diminuant la capacité de calcul des partitions en fonction du nombre de and/or partitions.

Using the Console de gestion AWS

Pour modifier la configuration d'un cluster élastique à l'aide de Console de gestion AWS :

  1. Connectez-vous à la console Amazon DocumentDB Console de gestion AWS et ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation n'apparaît pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.

  3. Choisissez le nom du cluster que vous souhaitez modifier dans la colonne Identifiant du cluster.

  4. Sélectionnez Modifier.

  5. Modifiez les champs que vous souhaitez modifier, puis sélectionnez Modifier le cluster.

    Formulaire indiquant les options de configuration, de maintenance, d'authentification et de paramètres réseau qui peuvent être modifiées, avec le bouton Modifier le cluster dans le coin inférieur droit.
Note

Vous pouvez également accéder à la boîte de dialogue Modifier le cluster en accédant à la page Clusters, en cochant la case à côté de votre cluster, en choisissant Actions, puis Modifier.

Using the AWS CLI

Pour modifier la configuration d'un cluster élastique à l'aide de AWS CLI, utilisez l'update-clusteropération avec les paramètres suivants :

  • --cluster-arn : obligatoire. L'identifiant ARN du cluster que vous souhaitez modifier.

  • --shard-capacity—Facultatif. Le nombre de vCPU affectés à chaque partition. Le maximum est de 64. Les valeurs autorisées sont 2, 4, 8, 16, 32, 64.

  • --shard-count—Facultatif. Le nombre de partitions attribuées au cluster. Le maximum est de 32.

  • --shard-instance-Compter : facultatif. Le nombre d'instances de réplication s'appliquant à toutes les partitions de ce cluster. Le maximum est de 16.

  • --auth-type—Facultatif. Type d'authentification utilisé pour déterminer où récupérer le mot de passe utilisé pour accéder à l'Elastic Cluster. Les types valides sont PLAIN_TEXT ouSECRET_ARN.

  • --admin-user-password—Facultatif. Le mot de passe associé à l'utilisateur administrateur.

  • --vpc-security-group-ids—Facultatif. Configurez une liste des groupes de sécurité Amazon EC2 et Amazon Virtual Private Cloud (VPC) à associer à ce cluster.

  • --preferred-maintenance-window—Facultatif. Configurez la plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, en temps universel coordonné (UTC)

    Le format est le suivant :ddd:hh24:mi-ddd:hh24:mi. Jours de validité (ddd) : lun, mar, mer, jeu, ven, sam, dim

    Par défaut, il s'agit d'une fenêtre de 30 minutes sélectionnée au hasard parmi un intervalle de 8 heures pour chaque région Amazon Web Services, survenant un jour aléatoire de la semaine.

    Fenêtre minimale de 30 minutes.

  • --subnet-ids—Facultatif. Configurez les identifiants de sous-réseau du réseau.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb-elastic update-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
    --shard-capacity 8 \
    --shard-count 4 \
    --shard-instance-count 3 \
    --admin-user-password testPassword \
    --vpc-security-group-ids ec-65f40350 \
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Pour Windows :

aws docdb-elastic update-cluster ^
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
    --shard-capacity 8 ^
    --shard-count 4 ^
    --shard-instance-count 3 ^
    --admin-user-password testPassword ^
    --vpc-security-group-ids ec-65f40350 ^
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Pour surveiller l'état du cluster élastique après votre modification, consultez la section Surveillance d'un cluster élastique.

Surveillance d'un cluster élastique

Dans cette section, nous expliquons comment surveiller votre cluster élastique à l'aide des instructions suivantes Console de gestion AWS ou à l' AWS CLI aide des instructions suivantes.

Using the Console de gestion AWS

Pour surveiller la configuration d'un cluster élastique à l'aide de Console de gestion AWS :

  1. Connectez-vous à la console Amazon DocumentDB Console de gestion AWS et ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation n'apparaît pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.

  3. Choisissez le nom du cluster que vous souhaitez surveiller dans la colonne Identifiant du cluster.

  4. Sélectionnez l'onglet Monitoring (Surveillance).

    Informations récapitulatives sur le cluster Elastic affichées dans l'onglet Surveillance.

Un certain nombre de graphiques d'Amazon CloudWatch sont affichés pour les catégories de surveillance suivantes :

  • Utilisation des ressources

  • Débit

  • Opérations

  • Système

Vous pouvez également accéder à Amazon CloudWatch via le Console de gestion AWS pour configurer votre propre environnement de surveillance pour vos clusters élastiques.

Using the AWS CLI

Pour surveiller une configuration de cluster élastique spécifique à l'aide de AWS CLI, utilisez l'get-clusteropération avec les paramètres suivants :

  • --cluster-arn : obligatoire. L'identifiant ARN du cluster pour lequel vous souhaitez obtenir des informations.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb-elastic get-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

Pour Windows :

aws docdb-elastic get-cluster ^
    --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

Le résultat de cette opération ressemble à ce qui suit :

"cluster": {
        ...
        "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
        "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
        "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
        "clusterName": "stretch-11",     
        "shardCapacity": 2,
        "shardCount": 3,
        "shardInstanceCount: 5,
        "status": "ACTIVE",
        ...
 }

Pour plus d'informations, consultez la référence DescribeClusterSnapshot de l'API de gestion des ressources Amazon DocumentDB.

Pour afficher les détails de tous les clusters élastiques à l'aide de AWS CLI, utilisez l'list-clustersopération avec les paramètres suivants :

  • --next-token—Facultatif. Si le nombre d’éléments en sortie (--max-results) est inférieur au nombre total d’éléments renvoyés par les appels d’API sous-jacents, la sortie inclut un code NextToken que vous pouvez transmettre dans une commande suivante pour récupérer le prochain ensemble d’éléments.

  • --max-results—Facultatif. Le nombre total d'éléments à renvoyer dans la sortie de la commande. S'il existe plus de résultats que la max-results valeur spécifiée, un jeton de pagination (next-token) est inclus dans la réponse afin que les résultats restants puissent être récupérés.

    • Par défaut : 100

    • Minimum 20, maximum 100

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb-elastic list-clusters \
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
    --max-results 2

Pour Windows :

aws docdb-elastic list-clusters ^
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
    --max-results 2

Le résultat de cette opération ressemble à ce qui suit :

{
   "Clusters": [
      {
         "ClusterIdentifier":"mycluster-1",
         "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
       {
         "ClusterIdentifier":"mycluster-2",
         "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
   ] 
}

Supprimer un cluster élastique

Dans cette section, nous expliquons comment supprimer un cluster élastique, en suivant les instructions suivantes Console de gestion AWS ou AWS CLI en suivant les instructions suivantes.

Using the Console de gestion AWS

Pour supprimer une configuration de cluster élastique à l'aide de Console de gestion AWS :

  1. Connectez-vous à la console Amazon DocumentDB Console de gestion AWS et ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation n'apparaît pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.

  3. Dans le tableau de la liste des clusters, cochez la case à gauche du nom du cluster que vous souhaitez supprimer, puis choisissez Actions. Dans le menu déroulant, choisissez Delete (Supprimer).

  4. Dans le cluster élastique Delete « cluster-name » ? boîte de dialogue, choisissez Supprimer.

    Boîte de dialogue Supprimer, avec le bouton Supprimer dans le coin inférieur droit.

La suppression du cluster prend plusieurs minutes. Pour surveiller le statut du cluster, consultez Surveillance de l'état d'un cluster Amazon DocumentDB.

Using the AWS CLI

Pour supprimer un cluster élastique à l'aide de AWS CLI, utilisez l'delete-clusteropération avec les paramètres suivants :

  • --cluster-arn : obligatoire. L'identifiant ARN du cluster que vous souhaitez supprimer.

  • --no-skip-final-backup—Facultatif. Si vous souhaitez effectuer une sauvegarde finale, vous devez inclure ce paramètre avec un nom pour la sauvegarde finale. Vous devez inclure soit --final-backup-identifier ou --skip-final-backup.

  • --skip-final-backup—Facultatif. Utilisez ce paramètre uniquement si vous ne souhaitez pas effectuer de sauvegarde finale avant de supprimer votre cluster. Le paramètre par défaut consiste à prendre un instantané final.

Les exemples de AWS CLI code suivants suppriment un cluster avec un ARN arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster avec une sauvegarde finale.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --no-skip-final-backup \
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Pour Windows :

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --no-skip-final-backup ^
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Les exemples de AWS CLI code suivants suppriment un cluster dont l'ARN est arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster sans effectuer de sauvegarde finale.

Dans l'exemple suivant, remplacez chacune user input placeholder par vos propres informations.

Pour Linux, macOS ou Unix :

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --skip-final-backup \

Pour Windows :

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --skip-final-backup ^

Le résultat de l'delete-clusteropération est un affichage du cluster que vous supprimez.

La suppression du cluster prend plusieurs minutes. Pour surveiller le statut du cluster, consultez Surveillance de l'état d'un cluster Amazon DocumentDB.