Migration vers Amazon DocumentDB sans serveur

Migration de clusters DocumentDB existants vers des clusters sans serveur

Mise à niveau de la version du moteur d'un cluster

Si votre cluster provisionné exécute une version inférieure du moteur qui ne prend pas en charge DocumentDB sans serveur, vous devez d'abord mettre à niveau le cluster vers une version de moteur prise en charge. Pour de plus amples informations, veuillez consulter Mise à niveau sur place de la version majeure d'Amazon DocumentDB.

Migration d'un cluster provisionné vers DocumentDB sans serveur

Pour changer un cluster provisionné afin d'utiliser DocumentDB sans serveur, procédez comme suit :

1. Vérifiez si la version du moteur du cluster provisionné doit être mise à niveau pour être utilisée avec DocumentDB sans serveur. Consultez Exigences et limites de DocumentDB sans serveur.

   Note

   Si le cluster provisionné exécute une version du moteur qui n'est pas disponible pour DocumentDB sans serveur, mettez à niveau la version du moteur du cluster. Consultez Mise à niveau sur place de la version majeure d'Amazon DocumentDB.

2. Définissez la configuration de mise à l'échelle du cluster. Pour plus de détails sur le choix de la configuration de dimensionnement, consultezChoix de la plage de capacité de dimensionnement pour un cluster sans serveur DocumentDB. Pour modifier la configuration de dimensionnement d'un cluster, consultezAffichage et modification de la configuration de la plage de capacités d'évolutivité d'un cluster.

3. Configurez toutes les autres propriétés du cluster pour tenir compte des exigences et des limites de DocumentDB sans serveur issues de. Exigences et limites de DocumentDB sans serveur

4. Ajoutez une ou plusieurs instances sans serveur DocumentDB au cluster. Suivez la procédure décrite dans Ajouter une instance sans serveur Amazon DocumentDB.

   Note

   Dans certains cas, il se peut que vous disposiez déjà d'une ou de plusieurs instances de lecteur provisionnées dans le cluster. Dans ce cas, vous pouvez choisir de convertir l'un des lecteurs en une instance sans serveur DocumentDB au lieu de créer une nouvelle instance. Pour ce faire, suivez la procédure décrite dans Modification de la classe d'une instance.

5. (Facultatif) Effectuez une opération de basculement pour faire d'une instance de DocumentDB sans serveur le rédacteur du cluster. Consultez Basculement d'Amazon DocumentDB.

6. (Facultatif) Convertissez toutes les instances Amazon DocumentDB provisionnées restantes en instances sans serveur DocumentDB (Modification de la classe d'une instancevoir) ou supprimez-les du cluster (voir). Suppression d'une instance Amazon DocumentDB

Using the AWS Management Console

L'exemple de AWS Management Console configuration suivant montre le processus de migration à l'aide d'un cluster provisionné Amazon DocumentDB qui exécute Amazon DocumentDB 5.0.0, qui ne nécessite pas de mise à niveau de la version du moteur pour commencer à utiliser DocumentDB sans serveur. Le cluster est nommé sample et commence par trois instances provisionnées nommées samplesample2, etsample3. Dans cet exemple, ces trois instances seront remplacées par trois instances sans serveur.

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

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

   Le tableau Clusters apparaît.

3. Dans le tableau Clusters, cochez la case du cluster auquel vous souhaitez ajouter une instance sans serveur.

4. Choisissez Actions, puis Add instances (Ajouter des instances).

5. Dans la boîte de dialogue Ajouter des instances, sélectionnez Serverless dans la section de classe d'instance de base de données pour chaque nouvelle instance sans serveur que vous souhaitez créer.

6. Pour les paramètres de capacité sans serveur, définissez la configuration de dimensionnement en fonction de la description de la capacité dans la boîte de dialogue.

7. (Facultatif) Pour ajouter une autre instance, choisissez Ajouter une instance. Continuez à ajouter des instances jusqu'à ce que vous ayez atteint le nombre de nouvelles instances souhaité.

   Dans cet exemple, trois nouvelles instances sans serveur sont créées.

8. Choisissez Créer.

   La création d'une instance prend quelques minutes. Vous pouvez utiliser la console ou le AWS CLI pour consulter le statut de l'instance. Pour plus d'informations, consultez Surveillance de l'état d'un cluster Amazon DocumentDB.

9. Pour revenir au tableau Clusters, cochez les cases des trois instances provisionnées d'origine.

10. Choisissez Actions, puis Supprimer.

Lors de la suppression, un basculement est automatiquement effectué pour promouvoir l'une des instances restantes en tant que rédactrice. Après quelques minutes, le processus de suppression est terminé. Le cluster existant contient désormais trois instances sans serveur DocumentDB (telles que définies dans la colonne Taille).

Using the AWS CLI

L'exemple de AWS CLI configuration suivant montre le processus de migration à l'aide d'un cluster provisionné Amazon DocumentDB qui exécute Amazon DocumentDB 5.0.0, qui ne nécessite pas de mise à niveau de la version du moteur pour commencer à utiliser DocumentDB sans serveur. Le cluster est nommé sample et commence par trois instances provisionnées nommées samplesample2, etsample3. Dans cet exemple, ces trois instances seront remplacées par trois instances sans serveur. Le cluster est nommé sample-cluster et commence par deux instances provisionnées nommées sample-provisioned-instance-1 et une instance sample-provisioned-instance-2 d'écriture et une instance de lecteur.

Dans l'exemple suivant, remplacez chacun user input placeholder par vos propres informations ou paramètres de configuration.

Utilisez cette aws docdb describe-db-clusters opération pour déterminer l'état d'un cluster. Le code suivant trouve l'état du cluster sample-cluster et affiche les résultats dans un tableau :

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table

--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

Ajoutez la configuration de dimensionnement pour le cluster :

aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16

Ajoutez les instances sans serveur. Dans cet exemple, les nouvelles instances sans serveur sample-serverless-instance-2 sont nommées sample-serverless-instance-1 et ajoutées :

aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-1 \
    --db-instance-class db.serverless \
    --engine docdb

aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-2 \
    --db-instance-class db.serverless \
    --engine docdb

Entrez ce qui suit pour attendre que les instances sans serveur soient disponibles avant de continuer :

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-1

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-2

Effectuez un basculement pour faire de la nouvelle sample-serverless-instance-1 instance le rédacteur du cluster :

aws docdb failover-db-cluster \
    --db-cluster-identifier sample-cluster \
    --target-db-instance-identifier sample-serverless-instance-1

Le basculement prend quelques secondes, après quoi sample-serverless-instance -1 devient le rédacteur du cluster. Vérifiez cela à l'aide des données suivantes :

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table

--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

Enfin, supprimez les instances provisionnées d'origine :

aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-1

aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-2

Migration de MongoDB vers DocumentDB sans serveur

Vous pouvez migrer vos bases de données MongoDB vers DocumentDB sans serveur, comme avec Amazon DocumentDB provisionné. Pour de plus amples informations, veuillez consulter Migration vers Amazon DocumentDB.