Schnellstart: Globale Cluster

Konfiguration

Der globale Amazon DocumentDB-Cluster umfasst mindestens zwei AWS-Regionen. Die primäre Region unterstützt einen Cluster mit einer primären (Writer-)Instance und bis zu fünfzehn Replikat-Instances, während eine sekundäre Region einen schreibgeschützten Cluster ausführt, der vollständig aus bis zu sechszehn Replikat-Instances besteht. Ein globaler Cluster kann bis zu fünf sekundäre Regionen haben. Die Tabelle listet die maximal zulässigen Cluster, Instances und Replikate in einem globalen Cluster auf.

Beschreibung	Primär AWS-Region	Sekundär AWS-Region
Cluster	1	5 (maximal)
Writer-Inst	1	0
Schreibgeschützte Instances (Amazon DocumentDB-Replikate) pro Cluster	15 (Max.)	16 (Total)
Schreibgeschützte Instances (maximal zulässig, bei tatsächlicher Anzahl von sekundären Regionen)	15 - s	s = Gesamtzahl der sekundären AWS-Regionen

Die Cluster haben die folgenden spezifischen Anforderungen:

• Anforderungen an Datenbank-Instance-Klassen – Sie können nur die db.r6 Instance-Klassen db.r5 und verwenden.

• -AWS-RegionAnforderungen – Der primäre Cluster muss sich in einer Region befinden und mindestens ein sekundärer Cluster muss sich in einer anderen Region desselben Kontos befinden. Sie können bis zu fünf sekundäre (schreibgeschützte) Cluster erstellen, die sich jeweils in einer anderen Region befinden müssen. Mit anderen Worten, es können sich keine zwei Cluster in derselben Region befinden.

• Benennungsanforderungen – Die Namen, die Sie für jeden Ihrer Cluster auswählen, müssen in allen Regionen eindeutig sein. Sie können nicht denselben Namen für verschiedene Cluster verwenden, obwohl sie sich in verschiedenen Regionen befinden.

Erstellen eines globalen Amazon DocumentDB-Clusters

Sind Sie bereit, Ihren ersten globalen Cluster zu erstellen? In diesem Abschnitt wird erläutert, wie Sie einen völlig neuen globalen Cluster mit neuen Datenbank-Clustern und Instances erstellen, indem Sie entweder die AWS Management Console oder die AWS CLI mit den folgenden Anweisungen verwenden.

Verwenden des AWS Management Console

1. Navigieren AWS Management ConsoleSie in der zu Amazon DocumentDB .

2. Wenn Sie zur Amazon DocumentDB-Konsole gelangen, wählen Sie Cluster aus.

   

3. Wählen Sie Erstellen.

   

4. Füllen Sie den Abschnitt Konfiguration des Formulars Amazon DocumentDB-Cluster erstellen entsprechend aus:

   • Cluster-ID: Sie können entweder eine eindeutige ID für diese Instance eingeben oder Amazon DocumentDB erlauben, die Instance-ID basierend auf der Cluster-ID bereitzustellen.

   • Engine-Version: Wählen Sie 4.0.0

   • Instance-Klasse: Wählen Sie db.r5.large

   • Anzahl der Instances: Wählen Sie 3 aus.

   

5. Geben Sie im Abschnitt Authentifizierung einen Hauptbenutzernamen und ein Hauptpasswort ein.

   

6. Wählen Sie Show Advanced Settings aus.

   

7. Im Abschnitt Netzwerkeinstellungen:

   • Behalten Sie die Standardoptionen für Virtual Private Cloud und Subnetzgruppe bei.

     

   • Für VPC-Sicherheitsgruppen sollte die Standard-VPC bereits hinzugefügt werden.

     

   • Geben Sie DocDB in das Feld VPC-Sicherheitsgruppen ein und wählen Sie DocDB -Inbound (VPC) aus.

     

8. Behalten Sie für Cluster-Optionen und Encryption-at-rest die Standardauswahl bei.

   

9. Behalten Sie für Backup -und Protokollexporte die Standardauswahl bei.

   

10. Behalten Sie für Wartung , Tags und Löschschutz die Standardauswahl bei.

    

11. Klicken Sie jetzt auf die Schaltfläche mit der Bezeichnung Erstellen.

    

Verwenden des AWS CLI

Um einen regionalen Amazon DocumentDB-Cluster zu erstellen, rufen Sie die create-db-cluster aufAWS CLI. Der folgende AWS CLI Befehl erstellt einen Amazon DocumentDB-Cluster mit dem Namen global-cluster-id. Weitere Informationen zum Löschschutz finden Sie unter Löschen eines Amazon DocumentDB-Clusters.

Außerdem --engine-version ist ein optionaler Parameter, der standardmäßig die neueste Engine-Hauptversion verwendet. Die aktuelle Engine-Hauptversion ist 4.0.0. Wenn neue Engine-Hauptversionen veröffentlicht werden, --engine-version wird die Standard-Engine-Version für aktualisiert, sodass sie der letzten Engine-Hauptversion entspricht. Daher empfehlen wir, für Produktions-Workloads und insbesondere für Workloads, die von Skripten, Automatisierungen oder AWS CloudFormation Vorlagen abhängig sind, die explizit --engine-version für die gewünschte Hauptversion anzugeben.

Wenn db-subnet-group-name oder nicht angegeben vpc-security-group-id ist, verwendet Amazon DocumentDB die Standardsubnetzgruppe und die Amazon-VPC-Sicherheitsgruppe für die angegebene Region.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder 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
         

Für 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
         

Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).

{
    "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"
    }
}
      

Die Erstellung des Clusters dauert mehrere Minuten. Sie können die AWS Management Console oder AWS CLI verwenden, um den Status Ihres Clusters zu überwachen. Weitere Informationen finden Sie unter Überwachung des Status eines Amazon DocumentDB-Clusters.

Wichtig

Wenn Sie die verwendenAWS CLI, um einen regionalen Amazon DocumentDB-Cluster zu erstellen, werden keine Instances erstellt. Daher müssen Sie explizit eine primäre Instance und alle benötigten Replikat-Instances anlegen. Sie können entweder die Konsole oder die AWS CLI verwenden, um die Instances zu erstellen. Weitere Informationen finden Sie unter Hinzufügen einer Amazon DocumentDB-Instance zu einem Cluster und CreateDBCluster in der Amazon DocumentDB-API-Referenz.

Sobald Ihr regionaler Cluster verfügbar ist, können Sie einen sekundären Cluster in einer anderen Region mit den folgenden Anweisungen hinzufügen: Hinzufügen eines AWS-Region zu einem globalen Amazon DocumentDB-Cluster. Wenn Sie eine Region hinzufügen, wird Ihr regionaler Cluster Ihr primärer Cluster und Sie haben einen neuen sekundären Cluster in der ausgewählten Region.

Hinzufügen eines AWS-Region zu einem globalen Amazon DocumentDB-Cluster

Ein globaler Cluster benötigt mindestens einen sekundären Cluster in einer anderen Region als der primäre Cluster, und Sie können bis zu fünf sekundäre Cluster hinzufügen. Beachten Sie, dass Sie für jeden sekundären Cluster, den Sie hinzufügen, die Anzahl der im primären Cluster zulässigen Replikate um eins reduzieren müssen. Wenn Ihr globaler Cluster beispielsweise fünf sekundäre Regionen hat, kann Ihr primärer Cluster nur zehn (statt fünfzehn) Replikate haben. Weitere Informationen finden Sie unter Konfigurationsanforderungen eines globalen Amazon DocumentDB-Clusters.

Verwenden des AWS Management Console

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

2. Klicken Sie im Navigationsbereich auf Cluster.

   

3. Wählen Sie den Cluster aus, dem Sie einen sekundären Cluster hinzufügen möchten. Stellen Sie sicher, dass der Cluster istAvailable.

   

4. Wählen Sie das Dropdown-Menü für Aktionen und dann Region hinzufügen aus.

   

5. Wählen Sie auf der Seite Region hinzufügen die sekundäre Region aus. Beachten Sie, dass Sie keine Region auswählen können, die bereits über einen sekundären Cluster für denselben globalen Cluster verfügt. Außerdem kann es sich nicht um dieselbe Region wie der primäre Cluster handeln. Wenn Sie die erste Region hinzufügen, müssen Sie auch eine globale Cluster-ID Ihrer Wahl angeben.

   

6. Füllen Sie die verbleibenden Felder für den sekundären Cluster in der neuen Region aus und wählen Sie dann Cluster erstellen aus. Nachdem Sie die Region hinzugefügt haben, können Sie sie in der Liste der Cluster in der sehenAWS Management Console.

   

Verwenden des AWS CLI

• Verwenden Sie den create-db-cluster CLI-Befehl mit dem Namen Ihres globalen (--global-cluster-identifier) Clusters. Für andere Parameter, führen Sie die folgenden Schritte aus:

  • --regionWählen Sie für eine andere AWS-Region als die Ihrer primären Region aus.

  • Wählen Sie bestimmte Werte für die Parameter --engine-version und --engine aus.

  • Geben Sie für einen verschlüsselten Cluster Ihre primäre AWS-Region als --source-region für die Verschlüsselung an.

Im folgenden Beispiel wird ein neuer Amazon DocumentDB-Cluster erstellt und als schreibgeschützter sekundärer Cluster an den globalen Cluster angehängt. Im letzten Schritt wird die Instance dem neuen Cluster hinzugefügt.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder 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
      

Für 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
      

Verwenden eines Snapshots für Ihren globalen Amazon DocumentDB-Cluster

Sie können einen Snapshot eines Amazon DocumentDB-Clusters wiederherstellen, um ihn als Ausgangspunkt für Ihren globalen Cluster zu verwenden. Dazu müssen Sie den Snapshot wiederherstellen und einen neuen Cluster erstellen. Dies dient als primärer Cluster Ihres globalen Clusters. Anschließend können Sie dem wiederhergestellten Cluster eine weitere Region hinzufügen und so in einen globalen Cluster umwandeln.