Migrazione ad Amazon DocumentDB serverless

Migrazione dei cluster DocumentDB esistenti a quelli serverless

Aggiornamento della versione del motore di un cluster

Se il cluster di cui hai eseguito il provisioning esegue una versione inferiore del motore che non supporta DocumentDB serverless, devi prima aggiornare il cluster a una versione del motore supportata. Per ulteriori informazioni, consulta Aggiornamento della versione principale in-place di Amazon DocumentDB.

Migrazione di un cluster con provisioning su DocumentDB serverless

Per passare da un cluster con provisioning a utilizzare DocumentDB serverless, segui questi passaggi:

1. Verifica se la versione del motore del cluster fornito deve essere aggiornata per essere utilizzata con DocumentDB serverless. Per informazioni, consulta Requisiti e limitazioni per DocumentDB serverless.

   Nota

   Se il cluster fornito esegue una versione del motore che non è disponibile per DocumentDB serverless, aggiorna la versione del motore del cluster. Per informazioni, consulta Aggiornamento della versione principale in-place di Amazon DocumentDB.

2. Definire la configurazione di dimensionamento per il cluster. Per i dettagli sulla scelta della configurazione di scalabilità, vedere. Scelta dell'intervallo di capacità di scalabilità per un cluster serverless DocumentDB Per modificare la configurazione di scalabilità per un cluster, vedere. Visualizzazione e modifica della configurazione dell'intervallo di capacità di scalabilità di un cluster

3. Configura qualsiasi altra proprietà del cluster per tenere conto dei requisiti e delle limitazioni serverless di DocumentDB da. Requisiti e limitazioni per DocumentDB serverless

4. Aggiungi una o più istanze serverless di DocumentDB al cluster. Segui la procedura riportata in Aggiungere un'istanza serverless di Amazon DocumentDB.

   Nota

   In alcuni casi, è possibile che nel cluster siano già presenti una o più istanze di lettura predisposte. In tal caso, puoi scegliere di convertire uno dei lettori in un'istanza serverless di DocumentDB invece di creare una nuova istanza. A tale scopo, segui la procedura in Modifica della classe di un'istanza.

5. (Facoltativo) Esegui un'operazione di failover per rendere un'istanza serverless di DocumentDB il cluster writer. Per informazioni, consulta Failover di Amazon DocumentDB.

6. (Facoltativo) Converti tutte le istanze Amazon DocumentDB con provisioning rimanenti in istanze serverless DocumentDB (vediModifica della classe di un'istanza) o rimuovile dal cluster (vedi). Eliminazione di un'istanza Amazon DocumentDB

Using the Console di gestione AWS

L'esempio di Console di gestione AWS configurazione seguente mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB su cui è in esecuzione Amazon DocumentDB 5.0.0, che non richiede un aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze predisposte denominatesample, e. sample sample2 sample3 In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless.

1. Accedi Console di gestione AWS e apri la console Amazon DocumentDB.

2. Nel pannello di navigazione scegliere Cluster.

   Suggerimento

   Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu () nell'angolo in alto a sinistra della pagina.

   Viene visualizzata la tabella Clusters.

3. Nella tabella Clusters, seleziona la casella di controllo del cluster a cui desideri aggiungere un'istanza serverless.

4. Scegli Actions (Operazioni), quindi Add instance (Aggiungi istanza).

5. Nella finestra di dialogo Aggiungi istanze, seleziona Serverless nella sezione della classe di istanza DB per ogni nuova istanza serverless che desideri creare.

6. Per le impostazioni della capacità serverless, imposta la configurazione di scalabilità in base alla descrizione della capacità nella finestra di dialogo.

7. (Facoltativo) Per aggiungere un'altra istanza, scegli Aggiungi istanza. Continua ad aggiungere istanze fino a raggiungere il numero desiderato di nuove istanze.

   In questo esempio, vengono create tre nuove istanze serverless.

8. Scegli Create (Crea).

   La creazione dell'istanza richiede diversi minuti. È possibile utilizzare la console o la AWS CLI per visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta Monitoraggio dello stato di un cluster Amazon DocumentDB.

9. Tornando alla tabella Clusters, seleziona le caselle di controllo di tutte e tre le istanze originariamente assegnate.

10. Scegli Azioni, quindi Elimina.

Durante l'eliminazione, viene eseguito automaticamente un failover per promuovere una delle istanze rimanenti come writer. Dopo alcuni minuti, il processo di eliminazione è completato. Il cluster esistente ora contiene tre istanze serverless di DocumentDB (come definito nella colonna Dimensioni).

Using the AWS CLI

L'esempio di AWS CLI configurazione seguente mostra il processo di migrazione utilizzando un cluster fornito da Amazon DocumentDB su cui è in esecuzione Amazon DocumentDB 5.0.0, che non richiede un aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze predisposte denominatesample, e. sample sample2 sample3 In questo esempio, queste tre istanze verranno sostituite da tre istanze serverless. Il cluster è denominato sample-cluster e inizia con due istanze assegnate denominate sample-provisioned-instance-1 andsample-provisioned-instance-2, un'istanza writer e un'istanza reader.

Nell'esempio seguente, sostituisci ciascuna user input placeholder con le tue informazioni o i tuoi parametri di configurazione.

Utilizzate l'aws docdb describe-db-clustersoperazione per determinare lo stato di un cluster. Il codice seguente trova lo stato del cluster sample-cluster e restituisce i risultati in una tabella:

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             |
+--------------------------------+---------------------------------+------------------+----------------+

Aggiungi la configurazione di scalabilità per il cluster:

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

Aggiungi le istanze serverless. In questo esempio, vengono aggiunte nuove istanze serverless sample-serverless-instance-1 denominate e: sample-serverless-instance-2

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

Inserisci quanto segue per attendere che le istanze serverless siano disponibili prima di procedere:

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

Eseguite un failover per rendere la nuova sample-serverless-instance-1 istanza il cluster writer:

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

Il completamento del failover richiede alcuni secondi, dopodiché sample-serverless-instance-1 diventa il cluster writer. Verificalo con il seguente input:

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             |
+--------------------------------+---------------------------------+------------------+----------------+

Infine, elimina le istanze originali assegnate:

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

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

Migrazione da MongoDB a DocumentDB serverless

Puoi migrare i tuoi database MongoDB su DocumentDB serverless, proprio come con Amazon DocumentDB con provisioning. Per ulteriori informazioni, consulta Migrazione e aggiornamento di Amazon DocumentDB.