Gestione di un cluster globale Amazon DocumentDB - Amazon DocumentDB
Modifica dei cluster globaliModifica dei parametriRimozione di cluster globaliEliminazione di cluster globaliCluster headless

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 scegli Risorse correlate al gruppo nella pagina Cluster della console, vedi il cluster primario e i cluster secondari raggruppati nel cluster globale associato.

La scheda Configurazione per un cluster globale mostra Regioni AWS dove vengono eseguiti 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.

Rimozione di 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 il AWS Management Console, il AWS CLI, o il RDSAPI.

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.

    Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.

  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.

    Immagine: la casella di navigazione Cluster che mostra la selezione di un cluster secondario esistente ed evidenzia l'azione «Rimuovi dal 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.

    Immagine: il prompt Rimuovi e promuovi.

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. AZs È 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 remove-from-global-cluster CLI comando 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.

    Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.

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

    Immagine: la casella di navigazione dei cluster che mostra la selezione di un cluster globale ed evidenzia l'azione «Elimina».

Conferma che tutti i cluster siano stati rimossi dal cluster globale. Il cluster globale dovrebbe mostrare zero regioni AZs 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 delete-global-cluster CLI comando 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 necessita di 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 usi 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.