Guida introduttiva rapida: Cluster globali

Configurazione

Il cluster globale di Amazon DocumentDB si estende su almeno due. Regioni AWS La regione primaria supporta un cluster con un'istanza primaria (writer) e fino a quindici istanze di replica, mentre una regione secondaria gestisce un cluster di sola lettura composto interamente da un massimo di sedici istanze di replica. Un cluster globale può avere fino a cinque aree secondarie. La tabella elenca il numero massimo di cluster, istanze e repliche consentiti in un cluster globale.

Descrizione	Regione AWS principale	Regione AWS secondarie
Cluster	1	5 massimo
Istanze di scrittura	1	0
Istanze di sola lettura (repliche Amazon DocumentDB), per cluster	15 (massimo)	16 (totali)
Istanze di sola lettura (massimo consentito, dato il numero effettivo di regioni secondarie)	15 - s	s = numero totale di Regioni AWS secondarie

I cluster hanno i seguenti requisiti specifici:

• Requisiti delle classi di istanze di database: è possibile utilizzare solo le classi di db.r6 istanze db.r5 e.

• Regione AWSrequisiti: il cluster primario deve trovarsi in una regione e almeno un cluster secondario deve trovarsi in un'area diversa dello stesso account. È possibile creare fino a cinque cluster secondari (di sola lettura) e ognuno deve trovarsi in una regione diversa. In altre parole, non è possibile che due cluster si trovino nella stessa regione.

• Requisiti di denominazione: i nomi scelti per ogni cluster devono essere unici, in tutte le regioni. Non puoi utilizzare lo stesso nome per cluster diversi anche se si trovano in aree geografiche diverse.

Creazione di un cluster globale Amazon DocumentDB

Sei pronto a creare il tuo primo cluster globale? In questa sezione spiegheremo come creare un cluster globale nuovo di zecca con nuovi cluster e istanze di database, utilizzando AWS Management Console o AWS CLI con le seguenti istruzioni.

Utilizzo di AWS Management Console

1. NelAWS Management Console, accedi ad Amazon DocumentDB.

2. Quando accedi alla console Amazon DocumentDB, scegli Clusters.

   

3. Scegli Crea.

   

4. Compila di conseguenza la sezione Configurazione del modulo Crea cluster Amazon DocumentDB:

   • Identificatore del cluster: puoi inserire un identificatore univoco per questa istanza o consentire ad Amazon DocumentDB di fornire l'identificatore dell'istanza basato sull'identificatore del cluster.

   • Versione del motore: scegli 4.0.0

   • Classe di istanza: scegli db.r5.large

   • Numero di istanze: scegli 3.

   

5. Nella sezione Autenticazione, inserisci un nome utente e una password principali.

   

6. Scegli Mostra impostazioni avanzate.

   

7. Nella sezione Impostazioni di rete:

   • Mantieni le opzioni predefinite per Virtual Private Cloud e Subnet Group.

     

   • Per i gruppi di sicurezza VPC, il VPC predefinito dovrebbe già essere aggiunto.

     

   • Digita DocDB nel campo Gruppi di sicurezza VPC e seleziona DOCDB-Inbound (VPC).

     

8. Per Cluster Options ed E, lascia le selezioni predefinite ncryption-at-rest.

   

9. Per Backup ed Esportazioni di log, lascia le selezioni predefinite.

   

10. Per la manutenzione, i tag e la protezione dall'eliminazione, lascia le selezioni predefinite.

    

11. Ora fai clic sul pulsante che dice Crea.

    

Utilizzo di AWS CLI

Per creare un cluster regionale Amazon DocumentDB, chiama il. create-db-cluster AWS CLI Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato. global-cluster-id Per ulteriori informazioni sulla protezione da eliminazione, consultaEliminazione di un cluster Amazon DocumentDB.

Inoltre, --engine-version è un parametro opzionale che utilizza per impostazione predefinita l'ultima versione principale del motore. L'attuale versione principale del motore è. 4.0.0 Quando vengono rilasciate nuove versioni principali del motore, la versione predefinita del motore viene aggiornata in modo da riflettere l'ultima versione principale del motore. --engine-version Di conseguenza, per i carichi di lavoro di produzione, in particolare quelli che dipendono da script, automazione o AWS CloudFormation modelli, si consiglia di specificare esplicitamente la versione principale --engine-version desiderata.

Se non vpc-security-group-id viene specificato un db-subnet-group-name or, Amazon DocumentDB utilizzerà il gruppo di sottoreti e il gruppo di sicurezza Amazon VPC predefiniti per la regione specificata.

Nell'esempio seguente, sostituisci ogni segnaposto dell'input utente con le tue informazioni.

Per Linux, macOS o Unix:

aws docdb create-db-cluster \
      --global-cluster-identifier global-cluster-id \
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

Per Windows:

aws docdb create-db-cluster ^
      --global-cluster-identifier global-cluster-id ^
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
         

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

{
    "DBCluster": {
        "StorageEncrypted": false,
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DeletionProtection" : "enabled",
        "ClusterCreateTime": "2018-11-26T17:15:19.885Z",
        "DBSubnetGroup": "default",
        "EngineVersion": "4.0.0",
        "MasterUsername": "masteruser",
        "BackupRetentionPeriod": 1,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
        "DBClusterIdentifier": "cluster-id",
        "MultiAZ": false,
        "DBClusterParameterGroup": "default.docdb4.0",
        "PreferredBackupWindow": "09:12-09:42",
        "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
        "PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
        "Port": 27017,
        "Status": "creating",
        "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
        "AssociatedRoles": [],
        "HostedZoneId": "ZNKXTT8WH85VW",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1c",
            "us-east-1e"
        ],
        "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
    }
}
      

La creazione del cluster richiede diversi minuti. Puoi utilizzare la AWS Management Console o l'AWS CLI per monitorare lo stato del cluster. Per ulteriori informazioni, consulta Monitoraggio dello stato di un cluster Amazon DocumentDB.

Importante

Quando si utilizza AWS CLI per creare un cluster regionale Amazon DocumentDB, non viene creata alcuna istanza. Di conseguenza, devi creare esplicitamente un'istanza primaria e le eventuali istanze di replica di cui hai bisogno. Per creare le istanze puoi utilizzare la console o l'AWS CLI. Per ulteriori informazioni, consulta Aggiungere un'istanza Amazon DocumentDB a un cluster e CreateDBCluster consulta Amazon DocumentDB API Reference.

Una volta che il cluster regionale è disponibile, puoi aggiungere un cluster secondario in un'altra regione con le seguenti istruzioni:Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB. Quando aggiungi una regione, il tuo cluster regionale diventa il cluster principale, e hai un nuovo cluster secondario nella regione che hai scelto.

Aggiungere un file Regione AWS a un cluster globale Amazon DocumentDB

Un cluster globale necessita di almeno un cluster secondario in una regione diversa da quella del cluster primario ed è possibile aggiungere fino a cinque cluster secondari. Tieni presente che per ogni cluster secondario che aggiungi, devi ridurre di una il numero di repliche consentite nel cluster primario. Ad esempio, se il cluster globale ha cinque regioni secondarie, il cluster primario può avere solo dieci (anziché quindici) repliche. Per ulteriori informazioni, consulta Requisiti di configurazione di un cluster globale Amazon DocumentDB.

Utilizzo di AWS Management Console

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

2. Nel pannello di navigazione scegliere Clusters (Cluster).

   

3. Scegli il cluster a cui desideri aggiungere un cluster secondario. Assicurati che il cluster siaAvailable.

   

4. Seleziona il menu a discesa per Azioni, quindi scegli Aggiungi regione.

   

5. Nella pagina Aggiungi una regione, scegli la regione secondaria. Tieni presente che 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. Se questa è la prima regione che aggiungi, dovrai anche specificare un identificatore globale del cluster a tua scelta.

   

6. Completa i campi rimanenti per il cluster secondario nella nuova regione, quindi seleziona Crea cluster. Dopo aver aggiunto la regione, puoi visualizzarla nell'elenco dei cluster in. AWS Management Console

   

Utilizzo di AWS CLI

• Usa il comando create-db-cluster CLI con il nome (--global-cluster-identifier) del tuo cluster globale. Per gli altri parametri, effettuare le seguenti operazioni:

  • Perché--region, scegli una regione Regione AWS diversa da quella della tua regione principale.

  • Scegli i valori specifici per i parametri --engine e --engine-version.

  • Per un cluster crittografato, specificare la Regione AWS principale come --source-region per la crittografia.

L'esempio seguente crea un nuovo cluster Amazon DocumentDB e lo collega al cluster globale come cluster secondario di sola lettura. Nell'ultimo passaggio, l'istanza viene aggiunta al nuovo cluster.

Nell'esempio seguente, sostituisci ogni segnaposto dell'input utente con le tue informazioni.

Per Linux, macOS o Unix:

aws docdb --region secondary-region-id \
  create-db-cluster \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb

aws docdb --region secondary-region-id \
  create-db-instance \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb
      

Per Windows:

aws docdb --region secondary-region-id ^
  create-db-cluster ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb

aws docdb --region secondary-region-id ^
  create-db-instance ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb
      

Utilizzo di uno snapshot per il cluster globale Amazon DocumentDB

Puoi ripristinare uno snapshot di un cluster Amazon DocumentDB da utilizzare come punto di partenza per il tuo cluster globale. A tale scopo, è necessario ripristinare lo snapshot e creare un nuovo cluster. Questo fungerà da cluster principale del cluster globale. È quindi possibile aggiungere un'altra regione al cluster ripristinato, convertendola così in un cluster globale.