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 fornito. Quando crei 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 del codice sorgente.

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

Panoramica della clonazione di Amazon DocumentDB

Amazon DocumentDB utilizza un copy-on-write protocollo 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 storage 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, consulta. copy-on-write 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 di Amazon DocumentDB in modo diverso dal cluster Amazon DocumentDB di origine. Ad esempio, potrebbe non essere necessario 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 di 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.

Limitazioni della 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 funziona come un ripristino. point-in-time

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

• Non è possibile creare un clone da un cluster Amazon DocumentDB senza istanze DB. Puoi clonare solo 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. In tal caso, le sottoreti del sistema VPCs devono essere mappate alle stesse zone di disponibilità.

Come funziona la clonazione di Amazon DocumentDB

La clonazione di Amazon DocumentDB funziona a livello di storage di un cluster Amazon DocumentDB. Utilizza un copy-on-writeprotocollo rapido ed efficiente 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

• Comprendere il protocollo copy-on-write
• Eliminazione di un volume cluster di origine

Comprendere il 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 copy-on-write protocollo 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, è possibile trovare un esempio del copy-on-write protocollo in azione che utilizza lo stesso cluster A e il suo clone, B, come mostrato 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 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 4 originale, 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.

Man mano che nel tempo si verificano più 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, è possibile utilizzare AWS Management Console o AWS CLI le procedure seguenti.

Utilizzando la clonazione di Amazon DocumentDB, puoi creare un clone di cluster Amazon DocumentDB fornito da un cluster Amazon DocumentDB fornito.

Using the AWS Management Console

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

Creazione di un clone utilizzando i AWS Management Console 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 sta creando il clone. Il cluster DB deve appartenere allo 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 account, utilizza il AWSAWS Management Console

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

2. Nel pannello di navigazione scegliere Clusters (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 di 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 sottoreti per il tuo caso d'uso e i gruppi di sicurezza associati. VPC

   4. Per E ncryption-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 il cluster di origine non ha la crittografia abilitata, 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 attivando la protezione dall'eliminazione accidentale del cluster (abilitata per impostazione predefinita).

      

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

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

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

Using the AWS CLI

L'utilizzo di AWS CLI per la clonazione del 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. Cioè, 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. Crea il clone utilizzando il comando -. restore-db-cluster-to point-in-time CLI I parametri utilizzati con questo comando controllano il tipo di capacità e altri dettagli del cluster Amazon DocumentDB vuoto (clone) che viene creato.

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

I comandi seguenti presuppongono che AWS CLI sia impostato con la tua AWS regione come impostazione predefinita. 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. Puoi anche specificare il --region in ciascuno dei CLI comandi che seguono.

Argomenti

Creare il clone

I parametri specifici che passate al restore-db-cluster-to-point-in-time CLI comando variano. Ciò che passi dipende dal tipo di clone che desideri creare.

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

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

• Utilizza il restore-db-cluster-to-point-in-time CLI comando e specifica i valori per i seguenti parametri:

  • --db-cluster-identifier: scegliere un nome significativo per il clone. Assegnate un nome al clone quando utilizzate il point-in-time CLI comando restore-db-cluster-to-.

  • --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'JSONoggetto 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, consultate 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

Usa il create-db-instanceCLIcomando per creare l'istanza DB per il tuo clone.

Il --db-instance-class parametro viene utilizzato solo per i cluster Amazon DocumentDB di 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	--restore-typeSpecificare copy-on-write come 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.