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

In diesem Abschnitt erklären wir, wie Sie ein Patch-Update mithilfe von AWS-Managementkonsole oder bereitstellen AWS CLI. Ein Patch-Update ist ein Update innerhalb derselben Engine-Version (z. B. das Aktualisieren 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 dazu, ob Ihre Engine aktualisiert werden muss, finden Sie unterFeststellung ausstehender Wartungsarbeiten. Beachten Sie, dass Ihr Cluster einige Ausfallzeiten haben wird, wenn Sie das Update installieren.

Anmerkung

Wenn Sie versuchen, von einer Hauptversion der Engine auf eine andere zu aktualisieren, z. B. 3.6 auf 5.0 oder 5.0 auf 8.0, lesen Sie entweder Direktes Upgrade der Hauptversion von Amazon DocumentDB oderAktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service.

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-Managementkonsole

Das folgende Verfahren wendet Patch-Updates mithilfe der Konsole 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-Managementkonsole an und öffnen Sie die Amazon 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 — Initiiert sofort den Upgrade-Prozess. 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 im nächsten Wartungsfenster 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 die folgenden Parameter verwenden.

Parameters

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

• --apply-action—Erforderlich. Wird verwendetsystem-update, um ein Engine-Patch-Update auf den Cluster anzuwenden.

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

  • immediate— Wenden Sie die Wartungsaktion sofort an.

  • next-maintenance— Wenden Sie die Wartungsmaßnahme im nächsten Wartungsfenster an.

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

Beispiel

Im folgenden Beispiel wird das Engine-Patch-Update auf angewendet. sample-cluster

Für Linux, macOS oder Unix:

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster \
   --apply-action system-update \
   --opt-in-type immediate

Für Windows:

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster ^
   --apply-action system-update ^
   --opt-in-type immediate

Die Ausgabe dieser Operation sieht folgendermaßen aus.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "system-update",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}