View a markdown version of this page

Gestione di un cluster globale Amazon DocumentDB - Amazon DocumentDB
Modifica dei cluster globaliModifica dei parametriRimozione dei 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 viene eseguita sui singoli cluster che compongono un cluster globale. Quando scegli Risorse relative 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 il Regioni AWS luogo in cui i cluster sono in esecuzione, la versione e l'identificatore globale del cluster.

Modifica di un cluster globale Amazon DocumentDB

La pagina Cluster Console di gestione AWS 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 delle 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. Mantieni le impostazioni coerenti tra tutti i cluster di un database globale per evitare cambiamenti di comportamento imprevisti se promuovi 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 con provisioning autonomo che può essere utilizzato per creare un nuovo cluster globale. Per ulteriori informazioni, consulta Esecuzione di un failover manuale per un cluster globale Amazon DocumentDB.

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

Nota

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

Puoi rimuovere i cluster dal tuo cluster globale utilizzando l' Console di gestione AWS API AWS CLI, the o RDS.

Using the Console di gestione AWS

  1. Accedi Console di gestione AWS 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 ai cluster esistenti e i collegamenti alle istanze 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 Clusters che mostra la selezione di un cluster secondario esistente ed evidenzia l'azione «Rimuovi dal globale».

  4. Apparirà un prompt 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: la richiesta Rimuovi e promuovi.

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

Dopo aver rimosso o eliminato tutti i cluster secondari, è possibile 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. Puoi eliminare se non desideri 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,Rimuovere un cluster da un cluster globale Amazon DocumentDB.

  • 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 primaria. L'eliminazione dell'istanza primaria dal nuovo cluster autonomo in genere rimuove anche sia il cluster che il cluster globale.

Using the Console di gestione AWS

  1. Accedi Console di gestione AWS 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 ai cluster esistenti e i collegamenti alle istanze corrispondenti.

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

    Immagine: la casella di navigazione Clusters 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 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 nel passaggio precedente, Rimuovere un cluster da un cluster globale Amazon DocumentDB.

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 mostrato 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 Regione AWS diverso da quello primario, puoi utilizzare una configurazione headless per il cluster secondario. Un cluster Amazon DocumentDB secondario headless è un cluster Amazon DocumentDB privo di 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 verrà addebitato alcun costo per l'elaborazione, ma solo per lo storage. Se è impostato correttamente, il volume di archiviazione di un headless secondario 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 ha iniziato la replica su quello secondario, si elimina l'istanza di sola lettura dal cluster secondario. Questo cluster secondario è ora considerato «headless» perché non ha più un'istanza. Tuttavia, il volume di storage viene mantenuto sincronizzato con il cluster Amazon DocumentDB primario.

Importante

Usa i cluster headless solo se riesci a tollerare Region-wide guasti per 15 minuti o più. Il ripristino da un Region-wide errore con un cluster secondario headless richiede la creazione di una nuova istanza dopo il failover. Una nuova istanza può richiedere 10-15 minuti per diventare disponibile.

Come aggiungere un cluster secondario headless al cluster globale

  1. Accedi Console di gestione AWS 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 lo siaAvailable.

  4. Per Azioni, scegli Aggiungi regione.

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

    Nota

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

  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, questa viene visualizzata Clusters nell'elenco di Console di gestione AWS.

  8. Controlla lo stato del cluster secondario e della relativa istanza del lettore prima di continuare, utilizzando Console di gestione AWS o il AWS CLI. Ecco un comando di esempio se utilizzi 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 passi 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 Amazon DocumentDB secondario headless per ripristinare manualmente il tuo cluster globale Amazon DocumentDB da un'interruzione non pianificata nella regione primaria, se si verifica tale interruzione.