Migrazione a Amazon DocumentDB serverless

Migrazione dei cluster DocumentDB esistenti verso i cluster serverless

Aggiornamento della versione del motore di un cluster

Se il cluster a cui è stato assegnato il provisioning utilizza una versione precedente del motore che non supporta DocumentDB serverless, è necessario prima aggiornare il cluster a una versione del motore supportata. Per ulteriori informazioni, consulta Aggiornamento immediato della versione principale di Amazon DocumentDB.

Migrazione di un cluster fornito a DocumentDB serverless

Per passare da un cluster a cui è stato assegnato il provisioning all'utilizzo di DocumentDB serverless, segui questi passaggi:

1. Controlla se la versione del motore del cluster fornito deve essere aggiornata per essere utilizzata con DocumentDB serverless. Consultare 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. Consultare Aggiornamento immediato della versione principale 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. 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 Reader 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) Eseguite un'operazione di failover per rendere un'istanza DocumentDB serverless il cluster writer. Consultare Failover di Amazon DocumentDB.

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

Using the AWS Management Console

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

1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

2. Nel pannello di navigazione scegliere Clusters (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 Cluster, 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 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. Continuate 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 il AWS CLI per visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta Monitoraggio dello stato di un cluster Amazon DocumentDB.

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

10. Scegli Azioni, quindi Elimina.

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

Using the AWS CLI

Il seguente esempio di AWS CLI configurazione mostra il processo di migrazione utilizzando un cluster con provisioning di Amazon DocumentDB che esegue Amazon DocumentDB 5.0.0, che non richiede l'aggiornamento della versione del motore per iniziare a utilizzare DocumentDB serverless. Il cluster è denominato e inizia con tre istanze assegnate 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, sostituite ognuna user input placeholder con informazioni o parametri di configurazione personalizzati.

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 aggiunte: 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

Esegui un failover per rendere la nuova sample-serverless-instance-1 istanza lo scrittore del cluster:

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 lo scrittore del cluster. Verificatelo 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 fornite originariamente:

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 senza server, proprio come con Amazon DocumentDB fornito. Per ulteriori informazioni, consulta Migrazione ad Amazon DocumentDB.