Durchführen eines Patch-Updates für die Engine-Version eines Clusters

In diesem Abschnitt erklären wir, wie Sie ein Patch-Update mit dem AWS Management Console oder dem bereitstellen AWS CLI. Ein Patch-Update ist ein Update innerhalb derselben Engine-Version (z. B. die Aktualisierung einer 3.6-Engine-Version auf eine neuere 3.6-Engine-Version). Sie können es sofort oder während des nächsten Wartungsfensters Ihres Clusters aktualisieren. Informationen darüber, ob Ihre Engine aktualisiert werden muss, finden Sie unterErmittlung ausstehender Wartungsarbeiten. Bitte beachten Sie, dass es bei der Installation des Updates zu einigen Ausfallzeiten auf Ihrem Cluster kommen kann.

Anmerkung

Wenn Sie versuchen, ein Upgrade von einer Hauptversion der Engine auf eine andere durchzuführen, z. B. 3.6 auf 5.0, finden Sie entweder Direktes Upgrade der Hauptversion von Amazon DocumentDB oderAktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service. Ein direktes Upgrade der Hauptversion unterstützt nur docdb 5.0 als Ziel-Engine-Version.

Es gibt zwei Konfigurationsanforderungen, um die neuesten Patch-Updates für die Engine-Version eines Clusters zu erhalten:

• Der Cluster-Status muss available (verfügbar) lauten.

• Der Cluster muss eine ältere Engine-Version ausführen.

Using the AWS Management Console

Das folgende Verfahren wendet mithilfe der Konsole Patch-Updates auf die Engine-Version Ihres Clusters an. Sie haben die Möglichkeit, das Update sofort oder während des nächsten Wartungsfensters Ihres Clusters durchzuführen.

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

2. Klicken Sie im Navigationsbereich auf Cluster. Wählen Sie in der Liste der Cluster die Schaltfläche links neben dem Cluster aus, den Sie upgraden möchten. Der Cluster-Status muss available (verfügbar) lauten.

   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. Wählen Sie im Menü Actions (Aktionen) eine der folgenden Optionen aus. Diese Menüoptionen sind nur auswählbar, wenn der ausgewählte Cluster nicht die neueste Engine-Version ausführt.

   

   • Jetzt aktualisieren — Startet sofort den Upgrade-Vorgang. Ihr Cluster ist eine zeitlang offline, während er auf die neueste Engine-Version aktualisiert wird.

   • Upgrade im nächsten Fenster — Initiiert den Upgrade-Vorgang während des nächsten Wartungsfensters des Clusters. Ihr Cluster ist eine zeitlang offline, während er auf die neueste Engine-Version aktualisiert wird.

4. Wenn sich das Bestätigungsfenster öffnet, wählen Sie eine der folgenden Optionen aus:

   • Upgrade — Um Ihren Cluster gemäß dem im vorherigen Schritt ausgewählten Zeitplan auf die neueste Engine-Version zu aktualisieren.

   • Abbrechen — Um das Engine-Upgrade des Clusters abzubrechen und mit der aktuellen Engine-Version des Clusters fortzufahren.

Using the AWS CLI

Sie können Patch-Updates auf Ihren Cluster anwenden, indem Sie den apply-pending-maintenance-action Vorgang AWS CLI und mit den folgenden Parametern verwenden.

Parameter

• --resource-identifier—Erforderlich. Der ARN des Amazon DocumentDB-Clusters, den Sie aktualisieren möchten.

• --apply-action—Erforderlich. Die folgenden Werte sind zulässig. Verwenden Sie db-upgrade, um Ihre Cluster-Engine-Version upzugraden.

  • db-upgrade

  • system-update

• --opt-in-type—Erforderlich. Die folgenden Werte sind zulässig.

  • immediate— Wenden Sie die Wartungsmaßnahme sofort an.

  • next-maintenance— Wendet die Wartungsaktion im nächsten Wartungsfenster an.

  • undo-opt-in— Stornieren Sie alle bestehenden next-maintenance Opt-In-Anfragen.

Mit dem folgenden Beispiel-Patch wird die Engine-Version von sample-cluster auf Version 4.0.0 aktualisiert.

Für Linux, macOS oder Unix:

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

Für Windows:

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

Die Ausgabe dieser Operation sieht folgendermaßen aus.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}