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.

Weitere Informationen zur Haupt- und Nebenversions-Verwaltung für jeden bestimmten Broker-Engine-Typ finden Sie in den folgenden Themen.

• Verwalten von Amazon MQ für ActiveMQ Engine-Versionen

• Verwalten von Amazon-MQ-für-RabbitMQ-Engine-Versionen

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.

AWS Management Console

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.

AWS CLI

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.

Amazon MQ API

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.

AWS Management Console

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.

AWS CLI

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.

Amazon MQ API

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.

Kalender für das Ende des Supports für die Engine-Version

Der Kalender für das Ende des Supports der Amazon MQ MQ-Version informiert Sie darüber, wann eine Broker-Engine-Version das Ende des Supports erreicht. Wenn der Support für eine Engine-Version endet, aktualisiert Amazon MQ alle Broker dieser Version automatisch auf die nächste verfügbare Version. Amazon MQ informiert Sie mindestens 90 Tage im Voraus, bevor der Support für eine Engine-Version endet.

Den Kalender für die Versionsunterstützung finden Sie unter Amazon MQ Verwalten von Amazon MQ für ActiveMQ Engine-Versionen für ActiveMQ und für Amazon MQ Verwalten von Amazon-MQ-für-RabbitMQ-Engine-Versionen für RabbitMQ.