Aktualisieren einer Amazon MQ-Broker-Engine-Version - Amazon MQ
Manuelles Upgraden der Engine-VersionAutomatisches Upgraden der Engine-Unterversion

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktualisieren einer Amazon MQ-Broker-Engine-Version

Amazon MQ stellt regelmäßig neue Broker-Engine-Versionen für alle unterstützten Broker-Engine-Typen bereit. Neue Engine-Versionen beinhalten Sicherheitspatches, Bugfixes und andere Verbesserungen der Broker-Engine.

Amazon MQ organisiert Versionsnummern gemäß der semantischen Versionsspezifikation als. X.Y.Z XBezeichnet in Amazon MQ MQ-Implementierungen die Hauptversion, Y steht für die Nebenversion und Z gibt die Patch-Versionsnummer an. Es gibt zwei Typen von Aktualisierungen:

  • Hauptversions-Upgrade: Tritt auf, wenn sich die Versionsnummern der Haupt-Engine ändern. Beispielsweise wird ein Upgrade von Version 1.0 auf Version 2.0 als Hauptversions-Upgrade betrachtet.

  • Unterversion-Upgrade: Tritt auf, wenn sich nur die Versionsnummer der Neben-Engine ändert. Zum Beispiel ein Upgrade von Version 1. 5 auf Version 1. 6 wird als geringfügiges Versionsupgrade betrachtet.

Sie können Ihren Broker jederzeit manuell auf die nächste unterstützte Haupt- oder Nebenversion aktualisieren. Wenn Sie automatische Upgrades für Nebenversionen aktivieren, aktualisiert Amazon MQ Ihren Broker auf die neueste unterstützte Patch-Version. Für alle Broker, die Engine-Version 3.13 und höher verwenden, verwaltet Amazon MQ während des Wartungsfensters Upgrades auf die neueste unterstützte Patch-Version. Amazon MQ aktualisiert Ihren Broker auf die nächste Nebenversion, wenn der Support für die aktuelle Nebenversion ausläuft. Sowohl manuelle als auch automatische Versions-Upgrades erfolgen während des geplanten Wartungsfensters oder nachdem SieSo starten Sie Ihren Broker neu.

In den folgenden Themen wird beschrieben, wie Sie die Broker-Engine-Version manuell aktualisieren und automatische Nebenversions-Upgrades aktivieren können.

Manuelles Upgraden der Engine-Version

Um die Engine-Version eines Brokers manuell auf eine neue Haupt- oder Nebenversion zu aktualisieren, können Sie den AWS Management Console AWS CLI, oder den Amazon MQ API verwenden.

Um die Engine-Version eines Brokers zu aktualisieren, verwenden Sie AWS Management Console

  1. Melden Sie sich bei der Amazon MQ-Konsole an.

  2. Wählen Sie im linken Navigationsbereich die Option Broker, un dann in der Liste den Broker aus, den Sie upgraden möchten.

  3. Klicken Sie auf der Seite Broker-Details auf Edit.

  4. UNDERTechnische Daten, für-Broker-Engine-VersionWählen Sie in der Dropdown-Liste die neue Versionsnummer .

  5. Scrollen Sie ans Seitenende und wählen SieÄnderungen im Zeitplan.

  6. Klicken Sie auf derÄnderungen für Broker-Seite, fürWann Änderungen angewendet werdenWählen Sie eine der folgenden Optionen .

    • Wählen Sie Nach dem nächsten Neustart, wenn Sie möchten, dass Amazon MQ das Versions-Upgrade während des nächsten geplanten Wartungsfensters abschliesst.

    • Wählen Sie Sofort, wenn Sie den Broker neu starten und die Engine-Version sofort aktualisieren möchten.

      Wichtig

      Ihr Broker ist offline, während er neu gestartet wird.

  7. Wählen Sie Anwenden, um die Anwendung der Änderungen abzuschließen.

Um die Engine-Version eines Brokers zu aktualisieren, verwenden Sie AWS CLI

  1. Verwenden Sie den CLI Befehl update-broker und geben Sie die folgenden Parameter an, wie im Beispiel gezeigt.

    • --broker-id - Die eindeutige ID, die Amazon MQ für die Broker-Instance generiert. Sie können die ID Ihres Brokers analysieren. ARN In Anbetracht der folgenden ARN Bedingungen wäre b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9 die Broker-ID beispielsweise. arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9

    • --engine-version— Die Engine-Versionsnummer für die Broker-Engine, auf die das Upgrade durchgeführt wird. 

    aws mq update-broker --broker-id broker-id --engine-version version-number

  2. (Optional) Verwenden Sie den CLI Befehl reboot-broker, um Ihren Broker neu zu starten, wenn Sie die Engine-Version sofort aktualisieren möchten. 

    aws mq reboot-broker --broker-id broker-id

    Wenn Sie Ihren Broker nicht neu starten und die Änderungen sofort anwenden möchten, aktualisiert Amazon MQ den Broker während des nächsten geplanten Wartungsfensters.

    Wichtig

    Ihr Broker ist offline, während er neu gestartet wird.

Um die Engine-Version eines Brokers mithilfe von Amazon MQ zu aktualisieren API

  1. Verwenden Sie die UpdateBrokerAPIOperation. Geben Sie broker-id an als Pfadparameter. In den folgenden Beispielen wird von einem Broker in der us-west-2Region ausgegangen. Weitere Informationen zu den verfügbaren Amazon-MQ-Endpunkten finden Sie unter Amazon-MQ-Endpunkte und -Kontingente in der Allgemeine AWS-Referenz 

    PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    Verwenden Sie engineVersion in der Anforderungs-Nutzlast, um die Versionsnummer für den Broker anzugeben, auf den ein Upgrade durchgeführt werden soll.

    {
    "engineVersion": "engine-version-number"
}

  2. (Optional) Verwenden Sie den RebootBrokerAPIVorgang, um Ihren Broker neu zu starten, wenn Sie die Engine-Version sofort aktualisieren möchten. broker-idist als Pfadparameter angegeben. 

    POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

    Wenn Sie Ihren Broker nicht neu starten und die Änderungen sofort anwenden möchten, aktualisiert Amazon MQ den Broker während des nächsten geplanten Wartungsfensters.

    Wichtig

    Ihr Broker ist offline, während er neu gestartet wird.

Automatisches Upgraden der Engine-Unterversion

Sie können steuern, ob das automatische Nebenversions-Upgrade für einen Broker aktiviert wird, wenn Sie den Broker zum ersten Mal erstellen, oder indem Sie die Brokereinstellungen ändern. Um auto Nebenversions-Upgrades für einen vorhandenen Broker zu aktivieren, können Sie Amazon MQ AWS Management Console AWS CLI, den oder Amazon MQ API verwenden.

Um automatische Upgrades für Nebenversionen zu aktivieren, verwenden Sie AWS Management Console

  1. Melden Sie sich bei der Amazon MQ-Konsole an.

  2. Wählen Sie im linken Navigationsbereich die Option Broker, un dann in der Liste den Broker aus, den Sie upgraden möchten.

  3. Klicken Sie auf der Seite Broker-Details auf Edit.

  4. UNDERWartung, wählen SieAktivieren von automatischen Upgrades von Unterversionen.

    Anmerkung

    Wenn die Option bereits ausgewählt ist, müssen Sie keine Änderungen vornehmen.

  5. Wählen Sie unten auf der Seite die Option Save aus.

Um automatische Upgrades für Nebenversionen über den zu aktivieren AWS CLI, verwenden Sie den CLI Befehl update-broker und geben Sie die folgenden Parameter an.

  • --broker-id - Die eindeutige ID, die Amazon MQ für die Broker-Instance generiert. Sie können die ID Ihres Brokers analysieren. ARN In Anbetracht der folgenden ARN Bedingungen wäre b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9 die Broker-ID beispielsweise. arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9

  • --auto-minor-version-upgrade— Aktiviert die Option für automatische Unterversions-Upgrades. 

aws mq update-broker --broker-id broker-id --auto-minor-version-upgrade

Wenn Sie automatische Nebenversions-Upgrades für Ihren Broker deaktivieren möchten, verwenden Sie den --no-auto-minor-version-upgrade-Parameter.

Verwenden Sie den UpdateBrokerAPIVorgang, um automatische Upgrades für kleinere Versionen über Amazon MQ API zu aktivieren. Geben Sie broker-id als Pfadparameter an. Im folgenden Beispiel wird von einem Broker in der us-west-2Region ausgegangen. Weitere Informationen zu den verfügbaren Amazon-MQ-Endpunkten finden Sie unter Amazon-MQ-Endpunkte und -Kontingente in der Allgemeine AWS-Referenz 

PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string

Verwenden Sie die autoMinorVersionUpgrade-Eigenschaft in der Anforderungs-Nutzlast, um das automatische Nebenversions-Upgrade zu aktivieren.

{
    "autoMinorVersionUpgrade": "true"
}

Wenn Sie automatische Nebenversions-Upgrades für Ihren Broker deaktivieren möchten, legen Sie "autoMinorVersionUpgrade": "false"in der Anforderungsnutzlast fest.