Erstellen einer Amazon DocumentDB Documente-Gruppe

Wenn Sie einen Amazon DocumentDB-Cluster erstellen, müssen Sie eine Amazon VPC und die entsprechende Subnetzgruppe innerhalb dieser Amazon VPC auswählen, um Ihren Cluster zu starten. Subnetze bestimmen die Availability Zone und den IP-Bereich innerhalb der Availability Zone, die Sie zum Starten einer Instance verwenden möchten.

Eine Subnetzgruppe ist ein benannter Satz von Subnetzen (oder AZs), mit dem Sie die Availability Zones angeben können, die Sie für den Start von Amazon DocumentDB DocumentDB-Instances verwenden möchten. In einem Cluster mit drei Instances wird beispielsweise empfohlen, dass jede dieser Instanzen in separaten AZs bereitgestellt wird. Dadurch wird die Hochverfügbarkeit optimiert. Wenn also eine einzelne AZ ausfällt, wirkt sich dies nur auf eine einzelne Instanz aus.

Derzeit können Amazon DocumentDB DocumentDB-Instances in bis zu drei AZs bereitgestellt werden. Selbst wenn eine Subnetzgruppe mehr als drei Subnetze hat, können Sie nur drei dieser Subnetze verwenden, um einen Amazon DocumentDB-Cluster zu erstellen. Daher empfehlen wir, dass Sie beim Erstellen einer Subnetzgruppe nur die drei Subnetze auswählen, von denen Sie Ihre Instances bereitstellen möchten.

Zum Beispiel: Ein Cluster wird erstellt und Amazon DocumentDB wählt AZs {1A, 1B und 1C}. Wenn Sie versuchen, eine Instance in AZ {1D} zu erstellen, schlägt der API-Aufruf fehl. Wenn Sie sich jedoch dafür entscheiden, eine Instance zu erstellen, ohne die bestimmte AZ anzugeben, wählt Amazon DocumentDB in Ihrem Namen eine AZ aus. Amazon DocumentDB verwendet einen Algorithmus für den Lastenausgleich der Instances zwischen AZs, um Ihnen zu helfen, eine hohe Verfügbarkeit zu erreichen. Wenn drei Instances bereitgestellt werden, werden sie standardmäßig über drei AZs bereitgestellt und nicht alle in einer einzigen AZ bereitgestellt.

Bewährte Methoden

• Wenn Sie keinen speziellen Grund haben, legen Sie immer eine Subnetzgruppe mit drei Subnetzen an. Dadurch wird sichergestellt, dass Cluster mit drei oder mehr Instances eine höhere Verfügbarkeit erreichen können, da die Instances auf drei AZs bereitgestellt werden.

• Verteilen Sie Instances immer über mehrere AZs, um eine hohe Verfügbarkeit zu erreichen. Platzieren Sie niemals alle Instances für einen Cluster in einer einzigen AZ.

• Da Failover-Ereignisse jederzeit auftreten können, sollten Sie nicht davon ausgehen, dass sich eine primäre Instance oder Replikat-Instance immer in einer bestimmten AZ befinden.

So erstellen Sie eine Subnetzgruppe

Sie können dasAWS Management Console oder verwendenAWS CLI, um eine Amazon DocumentDB-Subnetzgruppe zu erstellen:

Using the AWS Management Console

Führen Sie die folgenden Schritte aus, um eine Amazon DocumentDB Documente-Gruppe zu erstellen.

So erstellen Sie eine Amazon DocumentDB Documente-Gruppe

1. Melden Sie sich bei derAWS Management Console an und öffnen Sie die Amazon-DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

2. Wählen Sie im Navigationsbereich Subnet groups (Subnetzgruppen) und anschließend Create (Erstellen) aus.

   Tipp

   Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol () aus.

3. Auf der Seite Create subnet group (Subnetzgruppe erstellen):

   1. Im Abschnitt Subnet group details (Subnetzgruppen-Details:

      1. Name — Geben Sie einen aussagekräftigen Namen für die Subnetzgruppe für die Subnetzgruppe für die Subnetzgruppe

      2. Beschreibung – Geben Sie eine Beschreibung für die Subnetzgruppe ein.

   2. Im Abschnitt Add subnets (Subnetze hinzufügen):

      1. VPC —Wählen Sie in der Liste eine VPC für diese Subnetzgruppe aus.

      2. Führen Sie eine der folgenden Aktionen aus:

         • Um alle Subnetze in der ausgewählten VPC miteinzuschließen, wählen Sie Add all the subnets related to this VPC (Alle zu dieser VPC gehörenden Subnetze hinzufügen).

         • Um Subnetze für diese Subnetzgruppe festzulegen, führen Sie folgende Aufgaben für jede Availability Zone aus, für die Sie Subnetze miteinschließen möchten. Sie müssen mindestens zwei Availability Zones einschließen.

           1. Availability Zone —Wählen Sie in der Liste eine Availability Zone aus.

           2. Subnetz —Wählen Sie in der Liste ein Subnetz aus der ausgewählten Availability Zone für diese Subnetzgruppe aus.

           3. Wählen Sie Add subnet (Subnetz hinzufügen) aus.

4. Wählen Sie Create (Erstellen) aus. Wenn die Subnetzgruppe erstellt wurde, wird sie mit Ihren anderen Subnetzgruppen aufgeführt.

   

Using the AWS CLI

Bevor Sie mit der AWS CLI eine Subnetzgruppe erstellen können, müssen Sie zunächst ermitteln, welche Subnetze verfügbar sind Führen Sie die folgenden AWS CLI-Operation aus, um eine Liste der Availability Zones und ihrer Subnetze anzuzeigen.

Parameter:

• --db-subnet-group—Fakultativ. Bei Angabe einer bestimmten Subnetzgruppe werden die Availability Zones und Subnetze für diese Gruppe aufgelistet. Durch Auslassen dieses Parameters werden Availability Zones und Subnetze für alle Ihre Subnetzgruppen aufgelistet. Bei Angabe der default-Subnetzgruppe werden alle Subnetze der VPC aufgelistet.

Für Linux, macOS oder Unix:

aws docdb describe-db-subnet-groups \
    --db-subnet-group-name default \
    --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'

Für Windows:

aws docdb describe-db-subnet-groups ^
    --db-subnet-group-name default ^
    --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]'

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

[
    [
        "default",
        [
            [
                "us-east-1a",
                "subnet-4e26d263"
            ],
            [
                "us-east-1c",
                "subnet-afc329f4"
            ],
            [
                "us-east-1e",
                "subnet-b3806e8f"
            ],
            [
                "us-east-1d",
                "subnet-53ab3636"
            ],
            [
                "us-east-1b",
                "subnet-991cb8d0"
            ],
            [
                "us-east-1f",
                "subnet-29ab1025"
            ]
        ]
    ]
]

Sie können eine neue Subnetzgruppe erstellen, indem Sie die Ausgabe des vorherigen Vorgangs verwenden. Die neue Subnetzgruppe muss über Subnetze aus mindestens zwei Availability Zones verfügen.

Parameter:

• --db-subnet-group-name—Erforderlich. Der Name für diese Subnetzgruppe.

• --db-subnet-group-description—Erforderlich. Beschreibung dieser Subnetzgruppe.

• --subnet-ids—Erforderlich. Eine Liste der Subnetze in dieser Subnetzgruppe. Beispiel: subnet-53ab3636.

• --Tags —Optional. Eine Liste der Tags (Schlüssel-Wert-Paare) zum Anfügen an diese Subnetzgruppe.

Der folgende Code erstellt die Subnetzgruppe sample-subnet-group mit drei Subnetzen, subnet-4e26d263, subnet-afc329f4 und subnet-b3806e8f.

Für Linux, macOS oder Unix:

aws docdb create-db-subnet-group \
    --db-subnet-group-name sample-subnet-group \
    --db-subnet-group-description "A sample subnet group" \
    --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \
    --tags Key=tag1,Value=One Key=tag2,Value=2

Für Windows:

aws docdb create-db-subnet-group ^
    --db-subnet-group-name sample-subnet-group ^
    --db-subnet-group-description "A sample subnet group" ^
    --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^
    --tags Key=tag1,Value=One Key=tag2,Value=2

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

{
    "DBSubnetGroup": {
        "DBSubnetGroupDescription": "A sample subnet group",
        "DBSubnetGroupName": "sample-subnet-group",
        "Subnets": [
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetIdentifier": "subnet-4e26d263",
                "SubnetStatus": "Active"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetIdentifier": "subnet-afc329f4",
                "SubnetStatus": "Active"
            },
            {
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1e"
                },
                "SubnetIdentifier": "subnet-b3806e8f",
                "SubnetStatus": "Active"
            }
        ],
        "VpcId": "vpc-91280df6",
        "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group",
        "SubnetGroupStatus": "Complete"
    }
}