Gestion des clusters élastiques Amazon DocumentDB - Amazon DocumentDB
Modification des configurations de clusters élastiquesSurveillance 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 appropriées du plan de contrôle Amazon DocumentDB. Ces autorisations vous permettent de créer, de modifier et de supprimer des clusters. La politique DBFull d'accès aux documents 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 de clusters élastiques

Dans cette section, nous expliquons comment modifier Elastic Cluster, en utilisant AWS Management Console ou AWS CLI en suivant les instructions suivantes.

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

Using the AWS Management Console

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

  1. Connectez-vous à la console Amazon DocumentDB AWS Management Consoleet ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation ne s'affiche 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 présentant 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 une configuration de cluster élastique à l'aide de AWS CLI, utilisez l'update-clusteropération avec les paramètres suivants :

  • --cluster-arn : obligatoire. Identifiant ARN du cluster que vous souhaitez modifier.

  • --shard-capacity—Facultatif. Le nombre de v CPUs attribué à 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-Nombre : facultatif. Le nombre d'instances de répliques 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 au cluster élastique. 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. Configurer la plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, en temps universel coordonné (UTC)

    Le format est :ddd:hh24:mi-ddd:hh24:mi. Jours valides (ddd) : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche

    La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard sur une période 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.

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 en utilisant AWS Management Console ou en suivant AWS CLI les instructions suivantes.

Using the AWS Management Console

Pour surveiller une configuration de cluster élastique à l'aide de AWS Management Console :

  1. Connectez-vous à la console Amazon DocumentDB AWS Management Consoleet ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation ne s'affiche 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 Monitoring.

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 AWS Management Console 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. 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 le document DescribeClusterSnapshot de référence 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 extraire 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 utilisant AWS Management Console ou AWS CLI en suivant les instructions suivantes.

Using the AWS Management Console

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

  1. Connectez-vous à la console Amazon DocumentDB AWS Management Consoleet ouvrez-la.

  2. Dans le panneau de navigation, choisissez Clusters.

    Astuce

    Si le volet de navigation ne s'affiche 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 liste des clusters, cochez la case située à 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 » ? dans une 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 l'état du cluster, consultez la section 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. 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 dans le nom de 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 dont l'ARN est 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 l'état du cluster, consultez la section Surveillance de l'état d'un cluster Amazon DocumentDB.