View a markdown version of this page

Migration vers Amazon DocumentDB sans serveur - Amazon DocumentDB
Migration de clusters DocumentDB existants vers un environnement sans serveurMigration de MongoDB vers DocumentDB sans serveur

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.

Migration vers Amazon DocumentDB sans serveur

Migration de clusters DocumentDB existants vers un environnement sans serveur

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

Si votre cluster provisionné exécute une version de moteur inférieure 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 de la version majeure d'Amazon DocumentDB sur place.

Migration d'un cluster provisionné vers DocumentDB sans serveur

Pour passer d'un cluster provisionné à l'utilisation de 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 pour DocumentDB sans serveur.

    Note

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

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

  3. Configurez toutes les autres propriétés de cluster pour tenir compte des exigences et des limites de DocumentDB sans serveur de. Exigences et limites pour 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. Si tel est le cas, vous pouvez choisir de convertir l'un des lecteurs en 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 sans serveur DocumentDB l'auteur du cluster. Consultez Basculement d'Amazon DocumentDB.

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

Using the Console de gestion AWS

L'exemple de Console de gestion AWS 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 Console de gestion AWS et 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 (Menu button.) 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 Classe d'instance DB 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'à atteindre 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 afficher l'état de l'instance. Pour de plus amples informations, veuillez consulter Surveillance de l'état d'un cluster Amazon DocumentDB.

  9. De retour 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 qu'auteur. 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 etsample-provisioned-instance-2, une instance d'écriture et une instance de lecture.

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 recherche 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, de nouvelles instances sans serveur sont nommées sample-serverless-instance-1 et sample-serverless-instance-2 sont 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 les informations suivantes 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 l'auteur 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 l'auteur du cluster. Vérifiez cela à l'aide de l'entrée suivante :

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 et mise à niveau d'Amazon DocumentDB.