Wartung von Amazon DocumentDB

Amazon DocumentDB führt regelmäßig zwei Arten von Wartungsarbeiten durch:

Engine-Patches und Betriebssystemupdates verwenden dieselben drei Lebenszykluskategorien — optional, erforderlich und erzwungen — mit demselben Benachrichtigungs- und Anwendungsverhalten für jede Kategorie. Engine-Versionen haben auch eine vierte Kategorie: Nebenversionen, auf die Sie manuell aktualisieren. Es gibt folgende Kategorien:

Engine-Patches werden in einer einzigen Kategorie (optional, erforderlich oder erzwungen) veröffentlicht und bleiben dort. Aktualisierung der Betriebssysteme: Die meisten Updates sind zunächst optional und werden, falls sie nicht angewendet werden, zu „erforderlich“ und schließlich erzwungen. Der genaue Zeitpunkt hängt vom jeweiligen Patch ab und wird in der AHD-Benachrichtigung und in den Datumsfeldern veröffentlicht, die von zurückgegeben werden describe-pending-maintenance-actions (sieheTermine anwenden). In den Versionshinweisen von Amazon DocumentDB werden diese Kategorienamen verwendet, wenn Engine-Änderungen angekündigt werden.

Durch das Anwenden eines Engine-Patches wird der Cluster kurzzeitig offline geschaltet. Im Rest dieses Themas wird beschrieben, wie Wartungsfenster funktionieren, wie ausstehende Aufgaben gefunden werden, wie Engine-Patches und Nebenversionen installiert werden, wie Betriebssystemupdates funktionieren und wie spezielle Verfahren für globale Cluster behandelt werden.

Nummerierung der Engine-Versionen

Amazon DocumentDB verwendet zwei separate Versions-IDs:

Sie können die Engine-Version anhand des Präfixes der Engine-Patch-Version ermitteln, wie in der folgenden Tabelle dargestellt.

Um zu überprüfen, welche Patch-Version Ihr Cluster gerade läuft, stellen Sie eine Verbindung her und starten db.runCommand({getEngineVersion: 1}) Sie ihn.

Eine Liste der veröffentlichten Engine-Patch-Versionen und deren Inhalt finden Sie unterVersionshinweise.

Verwaltung Ihrer Amazon DocumentDB DocumentDB-Wartungsfenster

Jeder Cluster und jede Instanz hat ihr eigenes wöchentliches Wartungsfenster von 30 Minuten — den Zeitraum, in dem geplante Änderungen und Software-Patches ausgeführt werden. Die meisten Ereignisse werden innerhalb von 30 Minuten abgeschlossen, größere können länger dauern.

Wenn Sie bei der Erstellung der Ressource kein Fenster auswählen, weist Amazon DocumentDB innerhalb eines für die Region definierten 8-Stunden-Tagesblocks an einem zufällig ausgewählten Tag eines nach dem Zufallsprinzip ausgewählten Tages zu. Wählen Sie Fenster, die die Auswirkungen auf Ihre Anwendung so gering wie möglich halten — zum Beispiel abends oder am Wochenende.

Für Datenbank-Engine-Upgrades verwendet Amazon DocumentDB das Fenster des Clusters, nicht die Fenster einzelner Instances.

Die folgende Tabelle zeigt die Standard-Zeitblöcke pro Region.

Ihre Amazon DocumentDB DocumentDB-Wartungsfenster ändern

Wählen Sie das Fenster mit dem geringsten Verkehrsaufkommen, und passen Sie es im Laufe der Zeit an, wenn sich Ihre Verkehrsmuster ändern. Der Cluster oder die Instance ist während des Zeitfensters nur dann nicht verfügbar, wenn eine Systemänderung — zum Beispiel ein Skalierungsspeichervorgang oder eine Änderung der Instance-Klasse — einen Ausfall erfordert, und nur so lange, wie diese Änderung tatsächlich erforderlich ist.

Benachrichtigungen für Amazon DocumentDB DocumentDB-Engine-Patches

Wenn ein erforderlicher Engine-Patch in einer AWS Region verfügbar wird, erhält jedes AWS Konto mit einem betroffenen Amazon DocumentDB-Cluster in dieser Region eine Benachrichtigung per Health Dashboard (AHD) und per E-Mail (gesendet an die Root-Benutzeradresse des AWS Kontos). Pro betroffener Version der Amazon DocumentDB DocumentDB-Engine wird eine Benachrichtigung zugestellt. Sie finden sie im AHD unter Geplante Änderungen. In jeder Benachrichtigung werden der Zeitpunkt der Patch-Verfügbarkeit, der Zeitplan für die automatische Anwendung, die betroffenen Cluster und die Versionshinweise aufgeführt.

Benachrichtigungen werden ungefähr zwei Tage vor dem Öffnen des Fensters für die automatische Bewerbung versendet. Beispielsweise kann ein erforderlicher Patch, der am Montag um 00:00 Uhr UTC veröffentlicht wurde, am Mittwoch um 00:00 Uhr UTC automatisch angewendet werden. Wenn das Wartungsfenster Ihres Clusters Mittwoch um 12:00 Uhr UTC ist, wird der Patch an diesem Mittwoch automatisch angewendet — etwa 12 Stunden, nachdem das Fenster für die automatische Anwendung geöffnet wurde. Wenn Ihr Wartungsfenster Dienstag um 12:00 Uhr UTC ist, wartet der Patch eine ganze Woche, bevor er automatisch angewendet wird.

Nachdem Sie die Benachrichtigung erhalten haben, haben Sie zwei Möglichkeiten: Sie können den Patch vor dem Datum der automatischen Installation selbst anwenden oder warten, bis er während eines bevorstehenden Wartungsfensters automatisch angewendet wird (Standardeinstellung). Um die Anwendung selbst durchzuführen, öffnen Sie die Registerkarte Wartung und Backups des Clusters und suchen Sie nach dem Eintrag vom Typ. system-update

Optionale Patches und neue Nebenversionen generieren keine AHD- oder E-Mail-Benachrichtigungen. Um sie zu verfolgen, sehen Sie sich die Amazon DocumentDB DocumentDB-Versionshinweise an.

Erzwungene Patches (die seltenste Kategorie, die den kritischsten Sicherheitsupdates vorbehalten ist) werden ebenfalls per AHD und E-Mail angekündigt. Im Gegensatz zu erforderlichen Patches werden sie außerhalb Ihres Wartungsfensters angewendet, sodass das obige Beispiel für den Zeitpunkt der automatischen Anwendung nicht gilt.

Programmgesteuertes Reagieren auf Patch-Benachrichtigungen

AWS Health ist in Amazon integriert EventBridge, sodass Sie ereignisgesteuerte Anwendungen für mehr als 20 Ziele erstellen können, darunter AWS Lambda Amazon Simple Queue Service (SQS). Um programmgesteuert auf die Verfügbarkeit von Engine-Patches zu reagieren, konfigurieren Sie die Konfiguration entsprechend dem Ereignis. EventBridge AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED Von dort aus können Sie Ereignisdaten erfassen, zusätzliche Ereignisse auslösen, Push-Benachrichtigungen über das senden oder jede andere Aktion ergreifen AWS Console Mobile Application, die Sie benötigen.

Wenn Amazon DocumentDB einen Patch storniert (selten), erhalten Sie eine AHD-Benachrichtigung und eine E-Mail über die Kündigung. Verwenden Sie den AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED Eventcode bei Amazon EventBridge , um diesen Fall zu behandeln. Weitere Informationen zum Schreiben von Regeln finden Sie im EventBridge Amazon-Benutzerhandbuch.

Ausstehende Amazon DocumentDB DocumentDB-Wartungsaktionen anzeigen

Verwenden Sie das AWS-Managementkonsole oder AWS CLI , um zu überprüfen, welche Wartungsarbeiten für einen Cluster oder eine Instanz ausstehen.

Ausstehende Updates werden mit dem Aktionstyp angezeigtsystem-update, der sowohl Engine-Patches als auch Betriebssystemupdates umfasst.

Wenn ein Update aussteht, können Sie:

Das Wartungsfenster steuert, wann ausstehende Vorgänge gestartet werden, und nicht, wie lange es dauert, bis sie abgeschlossen sind.

Termine anwenden

Für jede ausstehende Wartungsmaßnahme gelten bis zu drei Gültigkeitsdaten. Sie erscheinen in der AWS CLI Ausgabe für describe-pending-maintenance-actions und geben an, wann die Aktion ausgeführt wird. Felder sind null für die optionale Wartung vorgesehen.

Um eine ausstehende Aktion zu verschieben, verschieben Sie Ihr Wartungsfenster auf einen späteren Tag zuvorAutoAppliedAfterDate. Sobald AutoAppliedAfterDate die Aktion erfolgreich abgeschlossen ist, wird sie automatisch im nächsten Wartungsfenster angewendet. Sobald der ForcedApplyDate Vorgang abgeschlossen ist, ist kein weiterer Aufschub möglich. Das genaue Zeitfenster für die Verzögerung ist je nach Patch unterschiedlich. Die Daten werden in der AHD-Benachrichtigung und der Ausgabe veröffentlicht. AWS CLI

Aktualisierungen der Amazon DocumentDB DocumentDB-Engine

Wenn Sie einen ausstehenden Engine-Patch identifiziert haben, wenden Sie eines der folgenden Verfahren an, um ihn anzuwenden oder zu planen. Sie können diese Verfahren entweder vom AWS-Managementkonsole oder vom aus ausführen AWS CLI.

Lesen Sie die Verfügbarkeit während des Patchens

Die Amazon DocumentDB DocumentDB-Engine 5.0 und 8.0 behalten die Leseverfügbarkeit beim Patchen bei, wenn der Cluster mehrere Instances umfasst. Amazon DocumentDB patcht Leser-Instances fortlaufend in drei Gruppen, sodass die verbleibenden Reader weiterhin Traffic bereitstellen. Der Writer ist während des Patches kurzzeitig nicht verfügbar. Um keine Ausfallzeiten beim Lesen zu erreichen, stellen Sie Ihre Lesepräferenz so ein, dass Lesevorgänge auf den Writer zurückfallen können: secondaryPreferred oder sie primaryPreferred funktionieren primary oder secondary alleine zu Leseausfällen führen können.

Während Lesegeräte Patches durchführen, sinkt der gesamte Cluster-Lesedurchsatz vorübergehend. Um den Durchsatz konstant zu halten, sollten Sie vor dem Upgrade zusätzliche Lesegeräte bereitstellen und diese nach Abschluss des Upgrades entfernen.

Auf Engine 3.6 und 4.0 gelten diese Funktionen für Leseverfügbarkeit nicht: Ein Engine-Patch verursacht längere Ausfallzeiten, die sich sowohl auf Lese- als auch auf Schreibvorgänge auswirken. Informationen zum Upgrade auf eine Hauptversion, bei der dies der Fall ist, finden Sie unter. Direktes Upgrade der Hauptversion von Amazon DocumentDB

Dauer der Patch-Ausfallzeit

Engine-patch Die Ausfallzeiten variieren. Die wichtigsten Faktoren sind die CPU-Auslastung und der Speicherdruck auf der Instance zum Zeitpunkt des Patches. Daher ist es wichtig, die richtige Größe Ihrer Instances zu wählen. Um Ausfallzeiten zu minimieren, führen Sie die neueste Version der Amazon DocumentDB DocumentDB-Hauptengine aus und verteilen Sie die Instances auf mehrere Availability Zones.

Patch-Updates und Ersatzprodukte

Amazon DocumentDB überwacht Patches nach der Veröffentlichung. In dem seltenen Fall, dass ein Problem festgestellt wird, unterbricht Amazon DocumentDB den Rollout, während eine aktualisierte Version vorbereitet wird. In diesem Fall wird der Patch von Clustern, die den Patch noch nicht erhalten haben, nicht mehr als verfügbare Wartungsaktion angesehen und die entsprechende Benachrichtigung über geplante Änderungen in der wird zurückgezogen. Health Dashboard Cluster, auf denen die betroffene Version bereits ausgeführt wird, funktionieren weiterhin normal und erfordern keine Aktion von Ihnen.

Ein aktualisierter Patch folgt in Kürze. Sobald er in Ihrer Region verfügbar ist, erhalten Sie per E-Mail eine neue Benachrichtigung, genau wie unter beschriebenBenachrichtigungen für Amazon DocumentDB DocumentDB-Engine-Patches. Health Dashboard

Unterversion-Upgrades

Amazon DocumentDB veröffentlicht Nebenversionen zusätzlich zur Hauptversion 5.0 und höher (z. B.5.0.1). Nebenversionen für Hauptversionen vor 5.0 werden nicht veröffentlicht. Nebenversionen verhalten sich anders als erforderliche und optionale Engine-Patches:

Lesen Sie mehr:Upgrade der Nebenversion von Amazon DocumentDB.

Betriebssystem-Updates für Amazon DocumentDB

Instanzen benötigen gelegentlich Betriebssystem-Updates. Amazon DocumentDB aktualisiert das Betriebssystem, um die Leistung zu verbessern und die Sicherheit zu erhöhen. Bei Betriebssystem-Updates bleiben die Cluster-Engine-Version und die Instance-Klasse unverändert. Wie Engine-Patches verwenden Betriebssystem-Updates den optionalen Lebenszyklus /required /forced, der oben in diesem Thema beschrieben wird. Im Gegensatz zu Engine-Patches kann ein Betriebssystemupdate im Laufe der Zeit diese Kategorien durchlaufen, wenn Sie es verschieben. Installieren Sie Betriebssystem-Updates, sobald sie verfügbar sind, und legen Sie das Wartungsfenster Ihrer Instanz auf einen Zeitpunkt fest, der zu Ihrem Unternehmen passt.

Wenn Sie über ein neues optionales Update informiert werden möchten, abonnieren Sie es RDS-EVENT-0230 in der Kategorie Sicherheitspatching-Ereignisse. Einzelheiten finden Sie unter Abonnieren von Amazon DocumentDB DocumentDB-Veranstaltungsabonnements. Nachdem Sie eine Benachrichtigung erhalten haben, können Sie den Betriebssystem-Patch selbst auf jede Instance anwenden.

Wenn Sie einen Cluster patchen, aktualisieren Sie zuerst die Reader-Instanzen und zuletzt den Writer-Instances. Vermeiden Sie es, Reader und Writer gleichzeitig zu patchen — ein Failover während des Patches kann die Ausfallzeit verlängern. Die Wartung der primären Instanz löst einen Failover aus. Führen Sie also mehr als eine Instanz pro Cluster aus, um verfügbar zu bleiben. Details hierzu finden Sie unter Amazon DocumentDB-Failover.

Betriebssystem-Updates sind an bestimmte Engine-Versionen und Instanzklassen gebunden, sodass verschiedene Instanzen zu unterschiedlichen Zeiten in Frage kommen. Wenn eine Instanz berechtigt ist, wird das Update in der Konsole angezeigt. Sie können es auch über den AWS CLI describe-pending-maintenance-actions Befehl oder die DescribePendingMaintenanceActions API einsehen.

Verwenden Sie das AWS-Managementkonsole oder AWS CLI , um zu überprüfen, ob ein Update verfügbar ist.

User-initiated Aktualisierungen

Einige Änderungen können Sie selbst vornehmen, z. B. das Austauschen einer Instance-Klasse gegen eine mit mehr oder weniger Arbeitsspeicher oder das Ändern der Parametergruppe des Clusters. Amazon DocumentDB behandelt diese anders als Updates, die es initiiert. Details hierzu finden Sie unter:

Um vom Benutzer initiierte Änderungen aufzulisten, die noch ausstehen:

aws docdb describe-db-instances \
    --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

aws docdb describe-db-instances ^
    --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

[
    [
        "sample-cluster",
        "sample-cluster-instance",
        {
            "DBInstanceClass": "db.r5.xlarge"
        }
    ],
    [
        "sample-cluster",
        "sample-cluster-instance-2",
        {}
    ]
]

Patchen globaler Cluster

In einem globalen Cluster wird jeder Mitgliedscluster — primärer und sekundärer — während seines eigenen Wartungsfensters aktualisiert. Wenn ein erforderlicher Engine-Patch in jeder Region verfügbar ist, erhalten Sie eine AHD- und E-Mail-Benachrichtigung. Optionale Patches und neue Nebenversionen generieren keine Benachrichtigungen. Weitere Informationen finden Sie in den Amazon DocumentDB DocumentDB-Versionshinweisen.

Wenn Sie die Patches selbst anwenden, patchen Sie immer zuerst die sekundären Patches und die primären Patches zuletzt. Diese Reihenfolge sorgt dafür, dass Failover und Switchover während des gesamten Rollouts verfügbar sind.

Wenn Sie keine Maßnahmen ergreifen, wird der Patch automatisch während des nächsten Wartungsfensters jedes Clusters angewendet: zuerst die sekundären, dann der primäre Patch in seinem Fenster, sobald die sekundären Wartungsfenster abgeschlossen sind.

Behalten Sie die gleiche Version für den primären und den sekundären DB-Cluster bei. Das verwaltete regionsübergreifende Failover funktioniert nur in einer globalen Datenbank, wenn jeder Cluster dieselbe Engine-Version und dasselbe Patch-Level verwendet. Das Gleiche gilt, wenn Sie eine neue sekundäre Engine-Version hinzufügen, die eine neuere Engine-Version als die primäre verwendet. Erstellen Sie neue sekundäre Engine-Versionen auf der primären Version, bevor Sie sie mit der globalen Datenbank verbinden.

Führen Sie nach einer Patch-Benachrichtigung zum frühestmöglichen Zeitpunkt ein Upgrade der primären und sekundären Version auf die neueste Version durch, damit Failover und Switchover weiterhin funktionieren. Wenn eine Failover- oder Switchover-Anfrage abgelehnt wird, vergleichen Sie die Engine-Patch-Versionen der einzelnen Cluster. Wenn sie nicht übereinstimmen, wenden Sie den verfügbaren Patch auf den verzögerten Clustern an.