Gestione di un cluster globale Amazon DocumentDB

La maggior parte delle operazioni di gestione vengono eseguite sui singoli cluster che costituiscono un cluster globale. Quando si sceglie Risorse correlate al gruppo nella pagina Cluster della console, vengono visualizzati il cluster primario e i cluster secondari raggruppati nel cluster globale associato.

La scheda Configurazione per un cluster globale mostra Regioni AWS dove sono in esecuzione i cluster, la versione e l'identificatore globale del cluster.

Modifica di un cluster globale Amazon DocumentDB

La pagina Cluster AWS Management Console elenca tutti i cluster globali, mostrando il cluster primario e i cluster secondari per ciascuno di essi. Il cluster globale ha le proprie impostazioni di configurazione. In particolare, ha regioni associate ai suoi cluster primari e secondari.

Quando apporti modifiche al cluster globale, hai la possibilità di annullare le modifiche.

Quando si sceglie Continue (Continua), si confermano le modifiche.

Modifica dei parametri di un cluster globale Amazon DocumentDB

È possibile configurare i gruppi di parametri del cluster in modo indipendente per ogni cluster all'interno del cluster globale. La maggior parte dei parametri funziona come per altri tipi di cluster Amazon DocumentDB. Si consiglia di mantenere le impostazioni coerenti tra tutti i cluster di un database globale. In questo modo è possibile evitare modifiche impreviste del comportamento se si promuove un cluster secondario come primario.

Ad esempio, utilizzare le stesse impostazioni per fusi orari e set di caratteri per evitare comportamenti incoerenti se un cluster diverso diventa un cluster primario.

Rimuovere un cluster da un cluster globale Amazon DocumentDB

Esistono diverse situazioni in cui potresti voler rimuovere i cluster dal tuo cluster globale. Ad esempio, potresti voler rimuovere un cluster da un cluster globale se il cluster primario diventa degradato o isolato. Diventa quindi un cluster autonomo con provisioning che può essere utilizzato per creare un nuovo cluster globale. Per ulteriori informazioni, consulta Ripristino manuale di un cluster globale da un'interruzione non pianificata.

Potresti anche voler rimuovere i cluster perché desideri eliminare un cluster globale che non ti serve più. Puoi eliminare il cluster globale solo dopo aver scollegato tutti i cluster associati, lasciando il cluster primario per ultimo. Per ulteriori informazioni, consulta Eliminazione di un cluster globale Amazon DocumentDB.

Nota

Quando un cluster viene scollegato dal cluster globale, non è più sincronizzato con il cluster primario. Diventa un cluster autonomo con funzionalità complete di lettura/scrittura. Inoltre, non è più visibile nella console Amazon DocumentDB. È visibile solo quando si seleziona la regione nella console in cui si trovava il cluster.

È possibile rimuovere i cluster dal cluster globale utilizzando l' AWS Management Console API RDS o AWS CLI l'API RDS.

Using the AWS Management Console

1. Accedi AWS Management Console e accedi alla console Amazon DocumentDB.

2. Scegli Clusters nella barra di navigazione a sinistra.

   

3. Espandi il cluster globale in modo da poter vedere tutti i cluster secondari. Seleziona i cluster secondari che desideri rimuovere. Scegli Azioni e, nel menu a discesa, scegli Rimuovi da globale.

   

4. Apparirà un messaggio che ti chiederà di confermare che desideri scollegare il cluster secondario dal cluster globale. Scegli Rimuovi e promuovi per rimuovere il cluster dal cluster globale.

   

Ora quel cluster non funge più da cluster secondario e non è più sincronizzato con il cluster primario. È un cluster autonomo con funzionalità di lettura/scrittura complete.

Dopo aver rimosso o eliminato tutti i cluster secondari, puoi rimuovere il cluster primario nello stesso modo. È possibile scollegare o rimuovere il cluster primario dal cluster globale solo dopo aver rimosso tutti i cluster secondari. Il cluster globale potrebbe rimanere nell'elenco dei cluster, con zero regioni e AZ. È possibile eliminare se non si desidera più utilizzare questo cluster globale.

Using the AWS CLI

Per rimuovere un cluster da un cluster globale, esegui il comando remove-from-global-cluster CLI con i seguenti parametri:

• --global-cluster-identifier— Il nome (identificatore) del cluster globale.

• --db-cluster-identifier— Il nome di ogni cluster da rimuovere dal cluster globale.

Gli esempi seguenti rimuovono prima un cluster secondario e poi il cluster primario da un cluster globale.

Per Linux, macOS o Unix:

aws docdb --region secondary_region \
  remove-from-global-cluster \
    --db-cluster-identifier secondary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region \
  remove-from-global-cluster \
    --db-cluster-identifier primary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

Ripeti il remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN comando per ogni regione secondaria del cluster globale.

Per Windows:

aws docdb --region secondary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier secondary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier primary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

Ripeti il remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN comando per ogni regione secondaria del cluster globale.

Eliminazione di un cluster da un cluster globale Amazon DocumentDB

Per eliminare un cluster globale, procedi come segue:

• Rimuovi tutti i cluster secondari dal cluster globale. Ogni cluster diventa un cluster autonomo. Vedi la sezione precedente, Rimozione dei cluster globali.

• Da ogni cluster autonomo, elimina tutte le repliche.

• Rimuovi il cluster primario dal cluster globale. Questo diventa un cluster autonomo.

• Dal cluster primario, elimina prima tutte le repliche, quindi elimina l'istanza principale. L'eliminazione dell'istanza primaria dal nuovo cluster autonomo in genere rimuove anche sia il cluster che il cluster globale.

Using the AWS Management Console

1. Accedi AWS Management Console e accedi alla console Amazon DocumentDB.

2. Scegli Clusters e trova il cluster globale che desideri eliminare.

   

3. Con il cluster globale selezionato, scegli Elimina dal menu Azioni.

   

Conferma che tutti i cluster siano stati rimossi dal cluster globale. Il cluster globale dovrebbe mostrare zero regioni e AZ e una dimensione pari a zero cluster. Se il cluster globale contiene dei cluster, non puoi ancora eliminarlo. Dovrai prima seguire le istruzioni del passaggio precedente, Rimozione dei cluster globali.

Using the AWS CLI

Per eliminare un cluster globale, esegui il comando delete-global-cluster CLI con il nome Regione AWS e l'identificatore globale del cluster, come illustrato nell'esempio seguente.

Per Linux, macOS o Unix:

aws docdb --region primary_region delete-global-cluster \
   --global-cluster-identifier global_cluster_id

Per Windows:

aws docdb --region primary_region delete-global-cluster ^
   --global-cluster-identifier global_cluster_id

Creazione di un cluster Amazon DocumentDB headless in una regione secondaria

Sebbene un cluster globale Amazon DocumentDB richieda almeno un cluster secondario in un cluster Regione AWS diverso da quello primario, è possibile utilizzare una configurazione headless per il cluster secondario. Un cluster secondario headless di Amazon DocumentDB è un cluster senza istanza. Questo tipo di configurazione può ridurre le spese per un cluster globale. In un cluster Amazon DocumentDB, elaborazione e storage sono disaccoppiati. Senza l'istanza, non ti viene addebitato alcun costo per l'elaborazione, ma solo per lo storage. Se è configurato correttamente, il volume di archiviazione di un secondario headless viene mantenuto sincronizzato con il cluster primario.

Aggiungi il cluster secondario come fai normalmente quando crei un cluster globale Amazon DocumentDB. Tuttavia, dopo che il cluster primario inizia la replica sul cluster secondario, elimini l'istanza di sola lettura dal cluster secondario. Questo cluster secondario è ora considerato «headless» perché non dispone più di un'istanza. Tuttavia, il volume di storage viene mantenuto sincronizzato con il cluster Amazon DocumentDB principale.

Importante

Consigliamo i cluster headless solo per i clienti che possono tollerare guasti a livello regionale per più di 15 minuti. Questo perché il ripristino da un errore a livello regionale con un cluster secondario headless richiederà all'utente di creare una nuova istanza dopo il failover. Una nuova istanza può impiegare circa 10-15 minuti per diventare disponibile.

Come aggiungere un cluster secondario headless al cluster globale

1. Accedi AWS Management Console e apri la console Amazon DocumentDB.

2. Scegli Clusters nella barra di navigazione a sinistra.

3. Scegli il cluster globale che richiede un cluster secondario. Assicurati che il cluster primario siaAvailable.

4. Per Actions (Operazioni), scegliere Add region (Aggiungi regione).

5. Nella pagina Aggiungi una regione, scegli la regione secondaria.

   Nota

   Non puoi scegliere una regione che abbia già un cluster secondario per lo stesso cluster globale. Inoltre, non può essere la stessa regione del cluster primario.

6. Completa i campi rimanenti per il cluster secondario nella nuova regione. Queste sono le stesse opzioni di configurazione di qualsiasi istanza del cluster.

7. Aggiungi una regione. Dopo aver aggiunto la regione al cluster globale, la vedrai nell'elenco di Clusters AWS Management Console.

8. Controlla lo stato del cluster secondario e della relativa istanza di lettura prima di continuare, utilizzando AWS Management Console o il AWS CLI. Ecco un esempio di comando se si utilizza AWS CLI:

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

   Possono essere necessari diversi minuti prima che lo stato di un cluster secondario appena aggiunto cambi da creazione a disponibile. Quando il cluster è disponibile, puoi eliminare l'istanza del lettore.

9. Seleziona l'istanza del lettore nel cluster secondario, quindi scegli Elimina.

10. Dopo aver eliminato l'istanza del lettore, il cluster secondario rimane parte del cluster globale. Non dovrebbe avere alcuna istanza associata.

Nota

Puoi utilizzare questo cluster secondario headless di Amazon DocumentDB per ripristinare manualmente il cluster globale Amazon DocumentDB da un'interruzione non pianificata nella regione principale, se si verifica un'interruzione di questo tipo.