View a markdown version of this page

Gestion d'un cluster mondial Amazon DocumentDB - Amazon DocumentDB
Modifier les clusters globauxModifier les 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 mondial Amazon DocumentDB

Vous effectuez la plupart des opérations de gestion sur les différents clusters qui constituent un cluster global. Lorsque vous choisissez 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 s'exécutent, la version et l'identifiant global du cluster.

Modification d'un cluster global Amazon DocumentDB

La page Clusters de la Console de gestion AWS liste répertorie tous vos clusters globaux, en indiquant le cluster principal et les clusters secondaires pour chacun d'entre eux. Le cluster global possède ses propres paramètres de configuration. Plus précisément, des régions sont associées à ses clusters primaires 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 du cluster global. La plupart des paramètres fonctionnent de la même manière que pour les autres types de clusters Amazon DocumentDB. Conservez la cohérence des paramètres entre tous les clusters d'une base de données globale afin d'éviter des changements de comportement inattendus si vous promouvez un cluster secondaire comme 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, veuillez consulter la section Exécution d'un basculement manuel pour un cluster global Amazon DocumentDB.

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 pour la fin. Pour de plus amples informations, veuillez consulter Supprimer un cluster d'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 read/write fonctionnalités complètes. En outre, il n'est plus visible dans la console Amazon DocumentDB. Il n'est visible que lorsque vous sélectionnez la région dans la console dans laquelle se trouvait le cluster.

Vous pouvez supprimer des clusters de votre cluster global à l'aide de l' Console de gestion AWS API RDS ou de l'API RDS. AWS CLI

Using the Console de gestion AWS

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

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

    Image : la zone de navigation Clusters affichant une liste des liens de cluster existants et des 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 liste globale.

    Image : la zone 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'affiche, vous demandant de confirmer que vous souhaitez détacher le cluster secondaire du cluster global. Choisissez Supprimer et promouvoir pour supprimer le cluster du cluster global.

    Image : l'invite Supprimer et promouvoir.

Désormais, ce cluster ne fait plus office de cluster secondaire et n'est plus synchronisé avec le cluster principal. Il s'agit d'un cluster autonome doté de toutes les read/write fonctionnalités.

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 avant d'avoir supprimé tous les clusters secondaires. Le cluster global peut rester dans la liste des clusters, sans aucune région ni zone de zone de classement. 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 commande remove-from-global-cluster CLI avec les paramètres suivants :

  • --global-cluster-identifier— Le nom (identifiant) de votre cluster global.

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

  • 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 cluster nouvellement autonome supprime également généralement à la fois le cluster et le cluster global.

Using the Console de gestion AWS

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

  2. Choisissez Clusters et recherchez le cluster global que vous souhaitez supprimer.

    Image : la zone de navigation Clusters affichant une liste des liens de cluster existants et des liens d'instance correspondants.

  3. Votre cluster global étant sélectionné, choisissez Supprimer dans le menu Actions.

    Image : la zone 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 global ne doit afficher aucune région et aucune zone de zone géographique 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 Supprimer un cluster d'un cluster global Amazon DocumentDB.

Using the AWS CLI

Pour supprimer un cluster global, exécutez la commande delete-global-cluster CLI avec le nom Région AWS et l'identifiant du cluster global, comme illustré 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 en-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 en-tête est un cluster sans instance. Ce type de configuration permet de réduire les dépenses d'un cluster mondial. Dans un cluster Amazon DocumentDB, le calcul et le stockage sont découplés. Sans l'instance, vous n'êtes pas facturé pour le calcul, mais uniquement pour le stockage. S'il est configuré correctement, le volume de stockage d'un secondaire sans tête est synchronisé avec le cluster principal.

Vous ajoutez le cluster secondaire comme vous le faites normalement lors de la création d'un cluster global Amazon DocumentDB. Cependant, 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 « headless » car il ne possède plus d'instance. Cependant, le volume de stockage est synchronisé avec le cluster Amazon DocumentDB principal.

Important

N'utilisez des clusters headless que si vous pouvez tolérer Region-wide des pannes pendant 15 minutes ou plus. Pour effectuer une restauration après une Region-wide panne avec un cluster secondaire sans tête, vous devez créer une nouvelle instance après le basculement. La mise à disposition d'une nouvelle instance peut prendre de 10 à 15 minutes.

Comment ajouter un cluster secondaire headless à votre cluster global

  1. Connectez-vous à la console https://console.aws.amazon.com/rds/ Amazon DocumentDB Console de gestion AWS 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 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 global. De plus, il ne peut pas s'agir de la même région que le cluster principal.

  6. Remplissez 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 fini d'ajouter la région à votre cluster global, elle apparaît Clusters dans la liste des Console de gestion AWS.

  8. Vérifiez l'état du cluster secondaire et de son instance de lecture avant de continuer, en utilisant le Console de gestion AWS 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

    Le passage de l'état de création à l'état disponible d'un cluster secondaire récemment ajouté peut prendre plusieurs minutes. 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. Une fois l'instance de lecteur supprimée, 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 interface pour récupérer manuellement votre cluster mondial Amazon DocumentDB suite à une panne imprévue dans la région principale si une telle panne se produit.