Clonazione di un volume per un cluster Amazon DocumentDB

Utilizzando la clonazione di Amazon DocumentDB, puoi creare un nuovo cluster che utilizza lo stesso volume del cluster Amazon DocumentDB e contiene gli stessi dati dell'originale. Il processo è progettato per essere veloce e conveniente. Il nuovo cluster con il relativo volume di dati associato è noto come clone. La creazione di un clone è più veloce ed efficiente in termini di spazio rispetto alla copia fisica dei dati utilizzando una tecnica diversa, ad esempio con il ripristino di uno snapshot.

Amazon DocumentDB supporta la creazione di un clone con provisioning di Amazon DocumentDB da un cluster Amazon DocumentDB con provisioning. Quando si crea un clone utilizzando una configurazione di distribuzione diversa da quella di origine, il clone viene creato utilizzando la versione più recente del motore Amazon DocumentDB della fonte.

Quando crei cloni dai tuoi cluster Amazon DocumentDB, i cloni vengono creati nel tuo AWS account, lo stesso account proprietario del cluster Amazon DocumentDB di origine.

Panoramica sulla clonazione di Amazon DocumentDB

Amazon DocumentDB utilizza un protocollo copy-on-write per creare un clone. Questo meccanismo utilizza uno spazio aggiuntivo minimo per creare un clone iniziale. Quando il clone viene creato per la prima volta, Amazon DocumentDB conserva una singola copia dei dati utilizzati dal cluster DB di origine e dal nuovo cluster Amazon DocumentDB (clonato). Lo spazio di archiviazione aggiuntivo viene allocato solo quando vengono apportate modifiche ai dati (sul volume di storage Amazon DocumentDB) dal cluster Amazon DocumentDB di origine o dal clone del cluster Amazon DocumentDB. Per ulteriori informazioni sul protocollo copy-on-write, consulta Come funziona la clonazione di Amazon DocumentDB.

La clonazione di Amazon DocumentDB è particolarmente utile per configurare rapidamente ambienti di test utilizzando i dati di produzione, senza rischiare il danneggiamento dei dati. È possibile utilizzare i cloni per molti tipi di applicazioni di breve durata, ad esempio:

• Sperimenta potenziali cambiamenti (modifiche allo schema e modifiche ai gruppi di parametri, ad esempio) per valutare tutti gli impatti.

• Esegui operazioni che utilizzano in modo intensivo i carichi di lavoro, come l'esportazione di dati o l'esecuzione di query analitiche sul clone.

• Creare una copia del cluster database di produzione per lo sviluppo, il test o altri scopi.

Puoi creare più di un clone dallo stesso cluster Amazon DocumentDB. È anche possibile creare più cloni da un altro clone.

Dopo aver creato un clone di Amazon DocumentDB, puoi configurare le istanze Amazon DocumentDB in modo diverso dal cluster Amazon DocumentDB di origine. Ad esempio, potresti non aver bisogno di un clone per scopi di sviluppo per soddisfare gli stessi requisiti di alta disponibilità del cluster Amazon DocumentDB di produzione di origine. In questo caso, puoi configurare il clone con una singola istanza Amazon DocumentDB anziché con più istanze DB utilizzate dal cluster Amazon DocumentDB.

Una volta terminato di utilizzare il clone per test, sviluppo o altri scopi, è possibile eliminarlo.

Note sull'utilizzo per la clonazione di Amazon DocumentDB

Amazon DocumentDB; la clonazione presenta attualmente le seguenti limitazioni:

• Puoi creare tutti i cloni che desideri, fino al numero massimo di cluster database consentito nella Regione AWS. Tuttavia, dopo aver creato 15 cloni, il clone successivo è una copia completa. L'operazione di clonazione agisce come un ripristino point-in-time.

• Non puoi creare un clone in una AWS regione diversa dal cluster Amazon DocumentDB di origine.

• Non puoi creare un clone da un cluster Amazon DocumentDB privo di istanze DB. Puoi clonare solo i cluster Amazon DocumentDB che hanno almeno un'istanza DB.

• Puoi creare un clone in un cloud privato virtuale (VPC) diverso da quello del cluster Amazon DocumentDB. Tuttavia, le sottoreti in quei VPC devono essere associate alle stesse zone di disponibilità.

Come funziona la clonazione di Amazon DocumentDB

La clonazione di Amazon DocumentDB funziona sul livello di storage di un cluster Amazon DocumentDB. Utilizza un protocollo copy-on-write veloce ed efficiente in termini di spazio in termini di supporti durevoli sottostanti che supportano il volume di storage Amazon DocumentDB. Puoi saperne di più sui volumi del cluster Amazon DocumentDB in. Gestione dei cluster Amazon DocumentDB

Argomenti

• Informazioni sul protocollo copy-on-write

• Eliminazione di un volume cluster di origine

Informazioni sul protocollo copy-on-write

Un cluster Amazon DocumentDB archivia i dati in pagine nel volume di storage Amazon DocumentDB sottostante.

Ad esempio, nel diagramma seguente puoi trovare un cluster Amazon DocumentDB (A) con quattro pagine di dati, 1, 2, 3 e 4. Immagina che un clone, B, venga creato dal cluster Amazon DocumentDB. Quando viene creato il clone, non viene copiato alcun dato. Piuttosto, il clone punta allo stesso set di pagine del cluster Amazon DocumentDB di origine.

Quando viene creato il clone, in genere non è necessario alcuno spazio di archiviazione aggiuntivo. Il protocollo copy-on-write utilizza lo stesso segmento sul supporto di archiviazione fisico del segmento di origine. Lo spazio di archiviazione aggiuntivo è necessario solo se la capacità del segmento di origine non è sufficiente per l'intero segmento di clone. In questo caso, il segmento di origine viene copiato su un altro dispositivo fisico.

Nei diagrammi seguenti, puoi un esempio del protocollo copy-on-write in azione utilizzando lo stesso cluster A e il relativo clone, B, come illustrato in precedenza. Supponiamo che tu apporti una modifica al tuo cluster Amazon DocumentDB (A) che comporti una modifica ai dati contenuti nella pagina 1. Invece di scrivere sulla pagina 1 originale, Amazon DocumentDB crea una nuova pagina 1 [A]. Il volume del cluster Amazon DocumentDB per il cluster (A) ora punta alle pagine 1 [A], 2, 3 e 4, mentre il clone (B) fa ancora riferimento alle pagine originali.

Sul clone, viene apportata una modifica a pagina 4 sul volume di archiviazione. Invece di scrivere sulla pagina originale 4, Amazon DocumentDB crea una nuova pagina, 4 [B]. Il clone punta ora alle pagine 1, 2, 3 e alla pagina 4[B], mentre il cluster (A) continua a puntare a 1[A], 2, 3 e 4.

Poiché nel tempo si verificano ulteriori modifiche sia nel volume del cluster Amazon DocumentDB di origine che nel clone, è necessario più spazio di archiviazione per acquisire e archiviare le modifiche.

Eliminazione di un volume cluster di origine

Quando si elimina un volume cluster di origine a cui sono associati uno o più cloni, i cloni non sono interessati. I database clone continuano a rimandare alle pagine precedentemente di proprietà del volume del cluster di origine.

Creazione di un clone di Amazon DocumentDB

Puoi creare un clone nello stesso AWS account del cluster Amazon DocumentDB di origine. A tale scopo, puoi utilizzare le procedure Console di gestione AWS o the AWS CLI e le seguenti.

Utilizzando la clonazione di Amazon DocumentDB, puoi creare un clone del cluster Amazon DocumentDB con provisioning da un cluster Amazon DocumentDB con provisioning.

Using the Console di gestione AWS

La procedura seguente descrive come clonare un cluster Amazon DocumentDB utilizzando. Console di gestione AWS

Creazione di un clone utilizzando i Console di gestione AWS risultati in un cluster Amazon DocumentDB con un'istanza Amazon DocumentDB.

Queste istruzioni si applicano ai cluster DB di proprietà dello stesso AWS account che crea il clone. Il cluster DB deve essere di proprietà dello stesso AWS account poiché la clonazione tra account non è supportata in Amazon DocumentDB.

Per creare un clone di un cluster DB di proprietà del tuo AWS account utilizzando il Console di gestione AWS

1. Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com/docdb.

2. Nel pannello di navigazione scegliere Cluster.

3. Scegli il tuo cluster Amazon DocumentDB dall'elenco e, per Azioni, scegli Crea clone.

   

   Viene visualizzata la pagina Crea clone, in cui è possibile configurare un identificatore del cluster e una classe di istanza e altre opzioni per il clone del cluster Amazon DocumentDB.

4. Nella sezione Rule settings (Impostazioni regole), procedi nel seguente modo:

   1. Per l'identificatore del cluster, inserisci il nome che desideri assegnare al cluster Amazon DocumentDB clonato.

   2. Per la configurazione dell'istanza, seleziona una classe di istanza appropriata per il cluster Amazon DocumentDB clonato.

      

   3. Per le impostazioni di rete, scegli un gruppo di sottorete per il tuo caso d'uso e i gruppi di sicurezza VPC associati.

   4. Perché Encryption-at-rest, se il cluster di origine (il cluster che viene clonato) ha la crittografia abilitata, anche il cluster clonato deve avere la crittografia abilitata. Se questo scenario è vero, le opzioni Abilita crittografia sono disattivate (disattivate) ma con l'opzione Abilita crittografia selezionata. Al contrario, se nel cluster di origine non è abilitata la crittografia, sono disponibili le opzioni Abilita crittografia ed è possibile scegliere di abilitare o disabilitare la crittografia.

      

   5. Completa la nuova configurazione del clone del cluster selezionando il tipo di log da esportare (opzionale), inserendo una porta specifica utilizzata per la connessione al cluster e abilitando la protezione dall'eliminazione accidentale del cluster (abilitata per impostazione predefinita).

      

   6. Completa l'immissione di tutte le impostazioni per il clone del tuo cluster Amazon DocumentDB. Per ulteriori informazioni sulle impostazioni del cluster e delle istanze Amazon DocumentDB, consulta. Gestione dei cluster Amazon DocumentDB

5. Scegli Crea clone per avviare il clone Amazon DocumentDB del cluster Amazon DocumentDB scelto.

Quando viene creato, il clone viene elencato con gli altri cluster Amazon DocumentDB nella sezione Database della console e ne viene visualizzato lo stato corrente. Il clone è pronto per l'utilizzo quando lo stato diventa Disponibile.

Using the AWS CLI

L'utilizzo di AWS CLI per clonare il cluster Amazon DocumentDB richiede un paio di passaggi.

Il restore-db-cluster-to-point-in-time AWS CLI comando utilizzato genera un cluster Amazon DocumentDB vuoto con 0 istanze Amazon DocumentDB. In altre parole, il comando ripristina solo il cluster Amazon DocumentDB, non le istanze DB per quel cluster. Sarà possibile farlo separatamente una volta che il clone è disponibile. Le due fasi del processo sono descritte di seguito:

1. Creare il clone utilizzando il comando restore-db-cluster-to-point-in-time della CLI. I parametri utilizzati con questo comando controllano il tipo di capacità e altri dettagli del cluster Amazon DocumentDB vuoto (clone) in fase di creazione.

2. Crea l'istanza Amazon DocumentDB per il clone utilizzando il comando CLI create-db-instance per ricreare l'istanza Amazon DocumentDB nel cluster Amazon DocumentDB ripristinato.

I comandi seguenti presuppongono che sia impostato con la AWS CLI tua regione come predefinita. AWS Questo approccio ti evita di dover inviare il nome --region in ciascuno dei comandi. Per ulteriori informazioni, consultare la pagina relativa alla configurazione di AWS CLI. È anche possibile specificare la --region in ciascuno dei comandi della CLI che seguono.

Argomenti

Creazione del clone

I parametri specifici che vengono inviati al comando della CLI restore-db-cluster-to-point-in-time variano. Ciò che si passa dipende dal tipo di clone che si desidera creare.

Utilizza la seguente procedura per creare un clone Amazon DocumentDB con provisioning da un cluster Amazon DocumentDB con provisioning.

Per creare un clone della stessa modalità di motore del cluster Amazon DocumentDB di origine

• Utilizzare il comando restore-db-cluster-to-point-in-time della CLI e specificare i valori per i seguenti parametri:

  • --db-cluster-identifier: scegliere un nome significativo per il clone. Il nome del clone viene assegnato utilizzando il comando restore-db-cluster-to-point-in-time della CLI.

  • --restore-type: utilizza copy-on-write per creare un clone del cluster database di origine. Senza questo parametro, restore-db-cluster-to-point-in-time ripristina il cluster Amazon DocumentDB anziché creare un clone. L'impostazione predefinita per è. restore-type full-copy

  • --source-db-cluster-identifier— Usa il nome del cluster Amazon DocumentDB di origine che desideri clonare.

  • --use-latest-restorable-time: questo valore punta ai dati del volume ripristinabile più recenti per il clone. Questo parametro è obbligatoriorestore-type copy-on-write, tuttavia, non è possibile utilizzarlo restore-to-time parameter con esso.

Nell'esempio seguente viene creato un clone denominato my-clone da un cluster denominato my-source-cluster.

Per Linux, macOS o 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

Per 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

Il comando restituisce l'oggetto JSON contenente i dettagli del clone. Prima di provare a creare l'istanza database per il clone, verificare che il cluster database clonato sia disponibile. Per ulteriori informazioni, consulta Verifica dello stato e acquisizione dei dettagli del clone di seguito:

Verifica dello stato e ottenimento dei dettagli del clone

È possibile utilizzare il seguente comando per controllare lo stato del cluster database vuoto appena creato.

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

Oppure puoi ottenere lo stato e gli altri valori necessari per creare l'istanza DB per il tuo clone utilizzando la seguente query: AWS CLI

Per Linux, macOS o Unix:

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

Per Windows:

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

Questa query restituisce un output simile al seguente:

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

Creazione dell'istanza Amazon DocumentDB per il tuo clone

Emettere il comando create-db-instance della CLI per creare l'istanza database per il clone.

Il --db-instance-class parametro viene utilizzato solo per i cluster Amazon DocumentDB su cui è stato effettuato il provisioning.

Per Linux, macOS o 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

Per 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

Parametri da utilizzare per la clonazione

La tabella seguente riassume i vari parametri utilizzati per restore-db-cluster-to-point-in-time clonare i cluster Amazon DocumentDB.

Parametro	Descrizione
--source-db-cluster-identifier	Usa il nome del cluster Amazon DocumentDB di origine che desideri clonare.
--db-cluster-identifier	Scegliere un nome significativo per il clone. È possibile assegnare un nome al clone con il comando restore-db-cluster-to-point-in-time. Quindi questo nome viene inviato al comando create-db-instance.
--restore-type	Specifica copy-on-write come --restore-type per creare un clone del cluster DB di origine anziché ripristinare il cluster Amazon DocumentDB di origine.
--use-latest-restorable-time	Questo valore punta ai dati del volume ripristinabile più recenti per il clone.