Gestion d'un cluster global Amazon DocumentDB - Amazon DocumentDB
Modification de clusters globauxModification des paramètresSuppression de clusters globauxSupprimer des clusters globauxClusters sans tête

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 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.

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'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, consultez la section Restauration manuelle d'un cluster global suite à une panne imprévue.

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 plus d'informations, consultez Supprimer un cluster global Amazon DocumentDB.

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 de lecture/écriture. 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 en utilisant le AWS Management Console, le AWS CLI, ou le RDSAPI.

Using the AWS Management Console

  1. Connectez-vous à la console Amazon DocumentDB AWS Management Console et accédez à celle-ci.

  2. 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.

  3. 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 ».

  4. 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.

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é d'une capacité de lecture/écriture complète.

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 etAZs. 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 remove-from-global-cluster CLI commande 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. Reportez-vous à la section précédente, Suppression de clusters globaux.

  • 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.

  2. 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.

  3. 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 ».

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, Suppression des clusters globaux.

Using the AWS CLI

Pour supprimer un cluster global, exécutez la delete-global-cluster CLI commande 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 et ouvrez-la.

  2. Choisissez Clusters dans la barre de navigation de gauche.

  3. Choisissez le cluster global qui a besoin d'un cluster secondaire. Assurez-vous que le cluster principal estAvailable.

  4. Pour Actions, choisissez Add region (Ajouter une région).

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. Sélectionnez l'instance de lecteur dans le cluster secondaire, puis choisissez Supprimer.

  10. 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.