Clonage d'un volume pour un cluster Amazon DocumentDB

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.

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.

En utilisant le clonage Amazon DocumentDB, vous pouvez créer un nouveau cluster qui utilise le même volume de cluster Amazon DocumentDB et possède les mêmes données que l'original. Le processus est conçu pour être rapide et rentable. Le nouveau cluster avec son volume de données associé est appelé clone. La création d'un clone est plus rapide et plus économe en espace que la copie physique des données à l'aide d'autres techniques telles que la restauration d'instantané.

Amazon DocumentDB prend en charge la création d'un clone provisionné Amazon DocumentDB à partir d'un cluster Amazon DocumentDB provisionné. Lorsque vous créez un clone à l'aide d'une configuration de déploiement différente de celle de la source, le clone est créé à l'aide de la dernière version du moteur Amazon DocumentDB de la source.

Lorsque vous créez des clones à partir de vos clusters Amazon DocumentDB, les clones sont créés dans AWS votre compte, le même compte qui possède le cluster Amazon DocumentDB source.

Présentation du clonage d'Amazon DocumentDB

Amazon DocumentDB utilise un copy-on-write protocole pour créer un clone. Ce mécanisme utilise un espace supplémentaire minimal pour créer un clone initial. Lorsque le clone est créé pour la première fois, Amazon DocumentDB conserve une copie unique des données utilisées par le cluster de base de données source et le nouveau cluster Amazon DocumentDB (cloné). Du stockage supplémentaire est alloué uniquement lorsque des modifications sont apportées aux données (sur le volume de stockage Amazon DocumentDB) par le cluster Amazon DocumentDB source ou le clone du cluster Amazon DocumentDB. Pour en savoir plus sur le copy-on-write protocole, voirComment fonctionne le clonage Amazon DocumentDB.

Le clonage Amazon DocumentDB est particulièrement utile pour configurer rapidement des environnements de test à l'aide de vos données de production, sans risquer de les corrompre. Vous pouvez utiliser des clones pour de nombreux types d'applications, telles que les suivantes :

Vous pouvez créer plusieurs clones à partir du même cluster Amazon DocumentDB. Vous pouvez également créer plusieurs clones à partir d'un autre clone.

Après avoir créé un clone Amazon DocumentDB, vous pouvez configurer les instances Amazon DocumentDB différemment du cluster Amazon DocumentDB source. Par exemple, il se peut que vous n'ayez pas besoin d'un clone à des fins de développement pour répondre aux mêmes exigences de haute disponibilité que le cluster Amazon DocumentDB de production source. Dans ce cas, vous pouvez configurer le clone avec une seule instance Amazon DocumentDB plutôt qu'avec les multiples instances de base de données utilisées par le cluster Amazon DocumentDB.

Lorsque vous avez fini d'utiliser le clone à des fins de test, de développement ou autres, vous pouvez le supprimer.

Limites du clonage d'Amazon DocumentDB

Amazon DocumentDB ; le clonage présente actuellement les limites suivantes :

Comment fonctionne le clonage Amazon DocumentDB

Le clonage Amazon DocumentDB fonctionne au niveau de la couche de stockage d'un cluster Amazon DocumentDB. Il utilise un copy-on-writeprotocole à la fois rapide et peu encombrant en termes de support durable sous-jacent supportant le volume de stockage Amazon DocumentDB. Vous pouvez en savoir plus sur les volumes de cluster Amazon DocumentDB dans. Gestion des clusters Amazon DocumentDB

Comprendre le copy-on-write protocole

Un cluster Amazon DocumentDB stocke les données dans des pages du volume de stockage Amazon DocumentDB sous-jacent.

Par exemple, dans le schéma suivant, vous pouvez trouver un cluster Amazon DocumentDB (A) comportant quatre pages de données, 1, 2, 3 et 4. Imaginez qu'un clone, B, soit créé à partir du cluster Amazon DocumentDB. Lors de la création du clone, aucune donnée n'est copiée. Le clone pointe plutôt vers le même ensemble de pages que le cluster Amazon DocumentDB source.

Lors de la création du clone, aucun stockage supplémentaire n'est généralement nécessaire. Le copy-on-write protocole utilise le même segment sur le support de stockage physique que le segment source. Un stockage supplémentaire n'est requis que si la capacité du segment source n'est pas suffisante pour le segment de clone entier. Dans ce cas, le segment source est copié sur un autre périphérique physique.

Dans les diagrammes suivants, vous pouvez trouver un exemple du copy-on-write protocole en action utilisant le même cluster A et son clone, B, comme indiqué ci-dessus. Supposons que vous apportiez une modification à votre cluster Amazon DocumentDB (A) qui entraîne une modification des données contenues sur la page 1. Au lieu d'écrire sur la page 1 d'origine, Amazon DocumentDB crée une nouvelle page 1 [A]. Le volume du cluster Amazon DocumentDB pour le cluster (A) pointe désormais vers les pages 1 [A], 2, 3 et 4, tandis que le clone (B) fait toujours référence aux pages d'origine.

Sur le clone, une modification est apportée à la page 4 sur le volume de stockage. Au lieu d'écrire sur la page 4 d'origine, Amazon DocumentDB crée une nouvelle page, 4 [B]. Le clone pointe maintenant vers les pages 1, 2, 3 et 4[B], tandis que le cluster (A) continue de pointer vers les pages 1[A], 2, 3 et 4.

Au fur et à mesure que de nouvelles modifications se produisent au fil du temps, à la fois dans le volume du cluster Amazon DocumentDB source et dans le clone, davantage de stockage est nécessaire pour capturer et stocker les modifications.

Suppression d'un volume de cluster source

Lorsque vous supprimez un volume de cluster source auquel un ou plusieurs clones sont associés, ceux-ci ne sont pas affectés. Les clones continuent de pointer vers les pages qui étaient précédemment la propriété du volume de cluster source.

Création d'un clone Amazon DocumentDB

Vous pouvez créer un clone dans le même AWS compte que le cluster Amazon DocumentDB source. Pour ce faire, vous pouvez utiliser le AWS Management Console ou les AWS CLI et les procédures suivantes.

En utilisant le clonage Amazon DocumentDB, vous pouvez créer un clone de cluster Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.

Using the AWS Management Console

La procédure suivante décrit comment cloner un cluster Amazon DocumentDB à l'aide du. AWS Management Console

Création d'un clone à l'aide des AWS Management Console résultats dans un cluster Amazon DocumentDB avec une instance Amazon DocumentDB.

Ces instructions s'appliquent aux clusters de base de données appartenant au même AWS compte qui crée le clone. Le cluster de base de données doit appartenir au même AWS compte, car le clonage entre comptes n'est pas pris en charge dans Amazon DocumentDB.

Pour créer un clone d'un cluster de base de données appartenant à votre AWS compte à l'aide du AWS Management Console

1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.

2. Dans le panneau de navigation, choisissez Clusters.

3. Choisissez votre cluster Amazon DocumentDB dans la liste, et pour Actions, choisissez Create clone.

   

   La page Créer un clone s'ouvre, où vous pouvez configurer un identifiant de cluster et une classe d'instance, ainsi que d'autres options pour le clone de cluster Amazon DocumentDB.

4. Dans la section Settings (Paramètres), procédez comme suit :

   1. Dans le champ Identifiant du cluster, entrez le nom que vous souhaitez attribuer à votre cluster Amazon DocumentDB cloné.

   2. Pour la configuration de l'instance, sélectionnez une classe d'instance appropriée pour votre cluster Amazon DocumentDB cloné.

      

   3. Pour les paramètres réseau, choisissez un groupe de sous-réseaux pour votre cas d'utilisation et les groupes de sécurité VPC associés.

   4. Pour E ncryption-at-rest, si le chiffrement est activé sur le cluster source (le cluster cloné), le chiffrement doit également être activé sur le cluster cloné. Si ce scénario est vrai, les options Activer le chiffrement sont grisées (désactivées) mais l'option Activer le chiffrement est sélectionnée. À l'inverse, si le chiffrement n'est pas activé dans le cluster source, les options Activer le chiffrement sont disponibles et vous pouvez choisir d'activer ou de désactiver le chiffrement.

      

   5. Complétez la nouvelle configuration du clone de cluster en sélectionnant le type de journaux à exporter (facultatif), en saisissant un port spécifique utilisé pour se connecter au cluster et en activant la protection contre la suppression accidentelle du cluster (activée par défaut).

      

   6. Terminez de saisir tous les paramètres de votre clone de cluster Amazon DocumentDB. Pour en savoir plus sur les paramètres du cluster et de l'instance Amazon DocumentDB, consultez. Gestion des clusters Amazon DocumentDB

5. Choisissez Create clone pour lancer le clone Amazon DocumentDB du cluster Amazon DocumentDB de votre choix.

Lorsque le clone est créé, il est répertorié avec vos autres clusters Amazon DocumentDB dans la section Bases de données de la console et affiche son état actuel. Votre clone est prêt à être utilisé quand son état est Disponible.

Using the AWS CLI

L'utilisation du AWS CLI pour cloner votre cluster Amazon DocumentDB implique quelques étapes.

La restore-db-cluster-to-point-in-time AWS CLI commande que vous utilisez génère un cluster Amazon DocumentDB vide avec 0 instance Amazon DocumentDB. En d'autres termes, la commande restaure uniquement le cluster Amazon DocumentDB, et non les instances de base de données de ce cluster. Vous faites cela séparément une fois le clone disponible. Les deux étapes du processus sont les suivantes :

1. Créez le clone à l'aide de la commande restore-db-cluster-to- point-in-time CLI. Les paramètres que vous utilisez avec cette commande contrôlent le type de capacité et d'autres détails du cluster Amazon DocumentDB vide (clone) en cours de création.

2. Créez l'instance Amazon DocumentDB pour le clone en utilisant la commande create-db-instanceCLI pour recréer l'instance Amazon DocumentDB dans le cluster Amazon DocumentDB restauré.

Les commandes suivantes supposent que votre AWS région AWS CLI est configurée par défaut. Cette approche vous évite de passer le nom de --region dans chaque commande. Pour plus d'informations, consultez Configuration de l' AWS CLI. Vous pouvez également spécifier la --region dans chacune des commandes de la CLI qui suivent.

Rubriques

Création du clone

Les paramètres spécifiques que vous passez à la commande de la CLI restore-db-cluster-to-point-in-time varient. Ce que vous transmettez dépend du type de clone que vous souhaitez créer.

Utilisez la procédure suivante pour créer un clone Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.

Pour créer un clone du même mode de moteur que le cluster Amazon DocumentDB source

• Utilisez la commande de la CLI restore-db-cluster-to-point-in-time et spécifiez les valeurs des paramètres suivants :

  • --db-cluster-identifier – Choisissez un nom explicite pour votre clone. Vous nommez le clone lorsque vous utilisez la commande restore-db-cluster-to- point-in-time CLI.

  • --restore-type – Utilisez la commande copy-on-write pour créer un clone du cluster de base de données source. Sans ce paramètre, le cluster Amazon DocumentDB restore-db-cluster-to-point-in-time restaure plutôt que de créer un clone. La valeur par défaut restore-type estfull-copy.

  • --source-db-cluster-identifier— Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner.

  • --use-latest-restorable-time – Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone. Ce paramètre est obligatoire carrestore-type copy-on-write, cependant, vous ne pouvez pas utiliser le restore-to-time parameter avec.

L'exemple suivant crée un clone nommé my-clone à partir d'un cluster nommé my-source-cluster.

Pour Linux, macOS ou Unix :

aws docdb restore-db-cluster-to-point-in-time \
    --source-db-cluster-identifier my-source-cluster \
    --db-cluster-identifier my-clone \
    --restore-type copy-on-write \
    --use-latest-restorable-time

Pour Windows :

aws docdb restore-db-cluster-to-point-in-time ^
    --source-db-cluster-identifier my-source-cluster ^
    --db-cluster-identifier my-clone ^
    --restore-type copy-on-write ^
    --use-latest-restorable-time

La commande renvoie l'objet JSON contenant les détails du clone. Vérifiez que votre cluster de base de données cloné est disponible avant d'essayer de créer l'instance de base de données pour votre clone. Pour plus d'informations, consultez la section Vérification de l'état et obtention des informations relatives au clone ci-dessous :

Vérifier le statut et obtenir les détails du clone

Vous pouvez utiliser la commande suivante pour vérifier l'état de votre cluster de base de données vide nouvellement créé.

$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text

Vous pouvez également obtenir le statut et les autres valeurs dont vous avez besoin pour créer l'instance de base de données pour votre clone en utilisant la AWS CLI requête suivante :

Pour Linux, macOS ou Unix :

aws docdb describe-db-clusters --db-cluster-identifier my-clone \
  --query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'

Pour Windows :

aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
  --query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"

Cette requête retourne une sortie similaire à la suivante.

[
  {
        "Status": "available",
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
    }
]

Création de l'instance Amazon DocumentDB pour votre clone

Utilisez la commande create-db-instanceCLI pour créer l'instance de base de données pour votre clone.

Le --db-instance-class paramètre est utilisé uniquement pour les clusters Amazon DocumentDB provisionnés.

Pour Linux, macOS ou Unix :

aws docdb create-db-instance \
    --db-instance-identifier my-new-db \
    --db-cluster-identifier my-clone \
    --db-instance-class  db.r5.4xlarge \
    --engine docdb

Pour Windows :

aws docdb create-db-instance ^
    --db-instance-identifier my-new-db ^
    --db-cluster-identifier my-clone ^
    --db-instance-class  db.r5.4xlarge ^
    --engine docdb

Paramètres à utiliser pour le clonage

Le tableau suivant récapitule les différents paramètres utilisés pour cloner des restore-db-cluster-to-point-in-time clusters Amazon DocumentDB.

Paramètre	Description
--source-db-cluster-identifier	Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner.
--db-cluster-identifier	Choisissez un nom explicite pour votre clone. Vous nommez votre clone à l'aide de la commande restore-db-cluster-to-point-in-time. Ensuite, vous passez ce nom à la commande create-db-instance.
—type de restauration	Spécifiez copy-on-write comme --restore-type pour créer un clone du cluster de base de données source plutôt que de restaurer le cluster Amazon DocumentDB source.
--use-latest-restorable-time	Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone.

anchoranchor

• Using the AWS Management Console
• Using the AWS CLI

La procédure suivante décrit comment cloner un cluster Amazon DocumentDB à l'aide du. AWS Management Console

Création d'un clone à l'aide des AWS Management Console résultats dans un cluster Amazon DocumentDB avec une instance Amazon DocumentDB.

Ces instructions s'appliquent aux clusters de base de données appartenant au même AWS compte qui crée le clone. Le cluster de base de données doit appartenir au même AWS compte, car le clonage entre comptes n'est pas pris en charge dans Amazon DocumentDB.

Pour créer un clone d'un cluster de base de données appartenant à votre AWS compte à l'aide du AWS Management Console

1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.

2. Dans le panneau de navigation, choisissez Clusters.

3. Choisissez votre cluster Amazon DocumentDB dans la liste, et pour Actions, choisissez Create clone.

   

   La page Créer un clone s'ouvre, où vous pouvez configurer un identifiant de cluster et une classe d'instance, ainsi que d'autres options pour le clone de cluster Amazon DocumentDB.

4. Dans la section Settings (Paramètres), procédez comme suit :

   1. Dans le champ Identifiant du cluster, entrez le nom que vous souhaitez attribuer à votre cluster Amazon DocumentDB cloné.

   2. Pour la configuration de l'instance, sélectionnez une classe d'instance appropriée pour votre cluster Amazon DocumentDB cloné.

      

   3. Pour les paramètres réseau, choisissez un groupe de sous-réseaux pour votre cas d'utilisation et les groupes de sécurité VPC associés.

   4. Pour E ncryption-at-rest, si le chiffrement est activé sur le cluster source (le cluster cloné), le chiffrement doit également être activé sur le cluster cloné. Si ce scénario est vrai, les options Activer le chiffrement sont grisées (désactivées) mais l'option Activer le chiffrement est sélectionnée. À l'inverse, si le chiffrement n'est pas activé dans le cluster source, les options Activer le chiffrement sont disponibles et vous pouvez choisir d'activer ou de désactiver le chiffrement.

      

   5. Complétez la nouvelle configuration du clone de cluster en sélectionnant le type de journaux à exporter (facultatif), en saisissant un port spécifique utilisé pour se connecter au cluster et en activant la protection contre la suppression accidentelle du cluster (activée par défaut).

      

   6. Terminez de saisir tous les paramètres de votre clone de cluster Amazon DocumentDB. Pour en savoir plus sur les paramètres du cluster et de l'instance Amazon DocumentDB, consultez. Gestion des clusters Amazon DocumentDB

5. Choisissez Create clone pour lancer le clone Amazon DocumentDB du cluster Amazon DocumentDB de votre choix.

Lorsque le clone est créé, il est répertorié avec vos autres clusters Amazon DocumentDB dans la section Bases de données de la console et affiche son état actuel. Votre clone est prêt à être utilisé quand son état est Disponible.