Auf dieser Seite
Warum gehen RabbitMQ-Upgrades schief?
„Woran Unternehmen oft scheitern oder was sie vergessen: Sie upgraden nicht regelmäßig. Manchmal dauert es ein paar Jahre bis zum nächsten Upgrade. Und wenn sie dann von ihrem Stand direkt auf die neueste Version gehen wollen, bekommen sie jede Menge unvorhergesehener Probleme – denn eigentlich hätten sie Schritt für Schritt upgraden müssen.“
— Jeff Sogolov, AceMQ Engineer, Projektsitzung bei Lucidya, Mai 2025
Welcher Upgrade-Pfad ist von 3.x auf 4.x vorgeschrieben?
rabbitmqctl enable_feature_flag allWas ist mit der Erlang-Kompatibilität?
- 3.12 unterstützt mindestens Erlang 25.x
- 3.13 setzt mindestens Erlang 26 voraus (26.2 empfohlen)
- 4.x setzt ebenfalls mindestens Erlang 26.2 voraus
„Sie können Erlang direkt von 25 auf 26.2 upgraden. Sobald Sie auf 26.2 sind, upgraden Sie RabbitMQ auf 3.13 – Sie haben dann bereits das richtige Erlang. Und von 3.13 auf 4.1 gilt weiterhin dieselbe Erlang-Version.“
— Jeff Sogolov, AceMQ Engineer, Sitzung bei Lucidya, Mai 2025
Strategie 1: Rolling Upgrade (In-Place)
- Node 1 stoppen (nur den Dienst – nicht das Betriebssystem)
- Erlang auf Node 1 auf die erforderliche Version upgraden
- RabbitMQ auf Node 1 auf die Zielversion upgraden
- Den RabbitMQ-Dienst auf Node 1 starten
- Prüfen, dass Node 1 dem Cluster wieder beigetreten und fehlerfrei ist
- Für Node 2 und 3 wiederholen
Strategie 2: Blue-Green-Deployment
- Einen neuen Cluster (Green) mit der RabbitMQ- und Erlang-Zielversion bereitstellen
- Auf dem Green-Cluster einen Upstream für Federated Queues konfigurieren, der auf den Blue-Cluster zeigt
- Während Consumer auf den Green-Cluster umziehen, holt die Federation Nachrichten automatisch von Blue nach Green
- Sobald alle Consumer auf Green sind, die Producer auf Green umstellen
- Sind die Producer umgezogen, verbleibende Nachrichten mit dem Shovel-Plugin aus Blue abziehen
- Den Blue-Cluster außer Betrieb nehmen
„Blue-Green bedeutet null Downtime. Sie können es jederzeit machen – es gibt keinen Wartungsmodus. Der Preis ist, dass gleichzeitig zwei Cluster laufen, und das können sich manche Unternehmen nicht leisten, gerade On-Premises. Aber bei Deployments auf AWS, wo Sie neue Cluster problemlos hochfahren können, ist es sehr sinnvoll.“
— Jeff Sogolov, AceMQ Engineer, Sitzung bei Lucidya, Mai 2025
Checkliste vor dem Upgrade
- Aktuelle RabbitMQ-Version bestätigen und den erforderlichen Upgrade-Pfad ermitteln
- Die Erlang-Kompatibilitätsmatrix für Ziel- und Zwischenversionen prüfen
- Alle Feature Flags auf der aktuellen Version aktivieren (rabbitmqctl enable_feature_flag all)
- Cluster-Definitions (Topologie, Benutzer, Berechtigungen) über die Management API sichern
- Das Upgrade in der Staging-Umgebung durchgängig validieren, bevor Sie die Produktion anfassen
- Das Health-Check-Verhalten des Load Balancers bei offline genommenen Nodes prüfen
- Das Reconnect-Verhalten der Clients im Staging bei simulierten Node-Neustarts testen
- Beim Rolling Upgrade das Zeitfenster mit dem geringsten Traffic einplanen
- Einen Rollback-Plan dokumentieren, bevor Sie beginnen
Den umfassenderen Blick auf die Einsatzbereitschaft, bevor Sie sich auf ein Zeitfenster festlegen, bietet die Checkliste zur Migrationsbereitschaft für RabbitMQ.
Was sich in RabbitMQ 4.x ändert und eine 3.x-Umgebung brechen kann
Die meisten Upgrades von 3.x auf 4.x, die schiefgehen, scheitern an einer kurzen Liste von Änderungen. Keine davon ist eine Überraschung, wenn Sie die Release Notes von 4.0 lesen, aber jede ist leicht zu übersehen in einer großen Umgebung, die mit den Konventionen von 3.8 und 3.9 gewachsen ist.
- Classic Queue Mirroring gibt es nicht mehr. Gespiegelte Classic Queues (die Policy-Keys
ha-modeundha-params) wurden in 3.9 als veraltet markiert und in 4.0 entfernt. Ein 4.x-Node spiegelt keine Classic Queues; jede Queue, die sich für die Replikation auf eine HA-Policy verlassen hat, wird in dem Moment zur Single-Node-Queue, in dem die Policy nicht mehr greift. Das ist die eine Änderung, die vor dem Upgrade und nicht danach behandelt werden muss: Migrieren Sie jede gespiegelte Queue auf eine Quorum Queue und löschen Sie dann die HA-Policies.rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policyzeigt Ihnen, ob noch welche vorhanden sind. Die Abwägungen behandeln wir in unserem Beitrag Classic Queues vs. Quorum Queues. - Transiente, nicht exklusive Queues sind veraltet. Nicht persistente Queues, die nicht exklusiv an eine Verbindung gebunden sind, werden als veraltetes Feature gekennzeichnet und lassen sich per Konfiguration verbieten. In 4.x funktionieren sie noch, aber planen Sie, überall persistente Queues zu deklarieren und exklusive Queues nur für echten verbindungsbezogenen Zustand zu nutzen.
- Der Standard-Queue-Typ. Eine Queue, die ohne
x-queue-typedeklariert wird, ist weiterhin eine Classic Queue, sofern der Virtual Host nichtdefault_queue_typesetzt. Setzen Sie ihn für neue Workloads pro vhost aufquorum, und sorgen Sie dafür, dass Client-Code, der Queues deklariert, explizitx-queue-typeübergibt, damit niemand von einem Standardwert auf vhost-Ebene überrascht wird. - AMQP 1.0 ist ein Kernprotokoll. Ab 4.0 wird das separate AMQP-1.0-Plugin nicht mehr benötigt; 1.0 ist nativ neben 0-9-1 auf demselben Listener implementiert. Bestehende 0-9-1-Clients sind nicht betroffen. Teams, die das alte Plugin genutzt haben, sollten es aus der Liste der aktivierten Plugins entfernen, und Teams, die 1.0 nutzen wollen, sollten auf die gepflegten 1.0-Client-Bibliotheken statt auf Legacy-Bibliotheken setzen.
- Khepri als Metadatenspeicher. Khepri, der Raft-basierte Nachfolger von Mnesia, kam in 3.13 als experimentelles Feature und wird in 4.x unterstützt, ist aber optional. Nach dem Upgrade verwenden die Nodes weiterhin Mnesia, bis Sie bewusst das Feature Flag
khepri_dbaktivieren. Behandeln Sie das als eigenständige Änderung mit eigenem Testfenster, nicht als Nebeneffekt des Versionssprungs. - Alle Feature Flags müssen zuerst aktiviert sein. Ein 3.13-Cluster, in dem noch irgendein stabiles Feature Flag deaktiviert ist, kann keinen 4.x-Node aufnehmen, und der 4.x-Node verweigert den Start. Aktivieren Sie alles, bevor der erste Node umzieht.
- Plugins und die Management-UI. Für 3.x kompilierte Plugins brauchen 4.x-Builds. Das Management-Plugin selbst wird übernommen, verliert aber die Mirroring-Ansichten, und das AMQP-1.0-Plugin wird wirkungslos. Prüfen Sie jedes Community-Plugin, bevor Sie davon ausgehen, dass es funktioniert.
- MQTT 5. Die Unterstützung für MQTT 5 kam mit 3.13 und bleibt in 4.x erhalten. Wenn Sie von 3.12 oder älter kommen, erhalten Ihre MQTT-Clients sie auf dem Weg mit dazu.
- Erlang. 4.x setzt Erlang/OTP 26 oder neuer voraus. Laufen Ihre Nodes noch auf OTP 25, erfolgt das Erlang-Upgrade als Teil des Rolling Upgrades, Node für Node. Lesen Sie unseren Hinweis zu End of Life von Erlang 26 und RabbitMQ, bevor Sie eine Zielversion wählen.
Sollten wir auf 3.13 bleiben oder auf 4.x upgraden?
3.13 ist die letzte 3.x-Reihe. Ihr Community-Supportfenster ist kurz, und sobald es sich schließt, gibt es für keine 3.x-Version mehr Upstream-Sicherheitspatches. Das ist die ehrliche Randbedingung, die die Entscheidung bestimmt.
Auf 3.13 zu bleiben ist in genau einem Fall vertretbar: Sie haben eine kommerzielle oder erweiterte Support-Vereinbarung, die Sicherheitsfixes auf die Version zurückportiert, die Sie betreiben. Ohne das ist ein 3.13-Cluster eine tickende CVE-Uhr. Unser Extended LTS Support deckt 3.8.x bis 3.13.x mit zurückportierten Patches ab. So können Kunden ältere Reihen nach einem Zeitplan betreiben, den sie selbst bestimmen, statt nach dem Upstream-Kalender. Das verschafft Zeit; die Notwendigkeit, den Wechsel zu planen, nimmt es Ihnen nicht ab.
Upgraden Sie, wenn alle vier Punkte erfüllt sind:
- Gespiegelte Classic Queues sind entfernt und es gibt keine HA-Policies mehr.
- Jedes stabile Feature Flag ist auf jedem Node aktiviert.
- Erlang läuft auf OTP 26 oder neuer, oder Sie sind bereit, es während des Rolling Upgrades umzustellen.
- Die Client-Anwendungen nutzen gepflegte Bibliotheksversionen, die sich gegenüber Quorum Queues korrekt verhalten (korrekter Umgang mit
x-delivery-limit, Dead Lettering und Reconnect).
Upgraden Sie früher, als Ihr Wartungskalender es vorsieht, wenn Sie AMQP 1.0 ohne Plugin, MQTT 5 auf einer älteren 3.x oder die Verbesserungen an Quorum Queues in 4.x brauchen. Dazu gehören Nachrichtenprioritäten und ein standardmäßiges Delivery Limit, das verhindert, dass Poison Messages endlos kreisen.
Wenn Sie auf 3.8 bis 3.12 sind, ist die Antwort dieselbe, nur der Weg ist länger: zuerst auf 3.13, stabilisieren, dann auf 4.x. Wir übernehmen beide Hälften für Kunden, und unser Service für RabbitMQ-Upgrades und -Patches ist genau so zugeschnitten.
Ob Bleiben sicher ist, ist eine andere Frage als die, ob es möglich ist: Ist RabbitMQ 3.x noch sicher zu betreiben? geht die End-of-Life-Termine und die CVE-Exposition Reihe für Reihe durch. Wenn Sie bleiben, hält Extended LTS Support für RabbitMQ 3.x die Version gepatcht, während das Upgrade auf ein Zeitfenster wartet.
Unser Runbook für das Rolling Upgrade
Diese Abfolge wenden wir bei Kunden-Clustern an. Sie setzt einen Cluster mit drei oder fünf Knoten voraus, Quorum Queues für alles Wichtige und Clients, die sich nach einem Verbindungsabbruch neu verbinden.
- Bestandsaufnahme. Erfassen Sie Versionen, Erlang-Versionen, aktivierte Plugins und jede Policy. Führen Sie
rabbitmq-diagnostics check_if_any_deprecated_features_are_usedundrabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policyauf einem beliebigen Knoten aus. Beide müssen ohne Befund zurückkommen, bevor Sie weitermachen. - Alle stabilen Feature Flags aktivieren.
rabbitmqctl enable_feature_flag allauf einem Knoten gilt clusterweit. Prüfen Sie mitrabbitmqctl list_feature_flags; alles, was nochdisabledist, blockiert das Upgrade. - Gespiegelte Classic Queues Flow für Flow in Quorum Queues umwandeln. Quorum Queues lassen sich nicht in-place umwandeln. Deklarieren Sie für jeden Flow die Quorum Queue, stellen Sie Consumer und danach Producer um, leeren Sie die alte Queue und löschen Sie sie. Gehen Sie pro Anwendung vor, damit ein Fehler nur einen Flow betrifft und nicht die gesamte IT-Landschaft.
- Erlang-Zielversion prüfen. Stellen Sie sicher, dass das Paket für OTP 26 oder neuer auf jedem Knoten verfügbar ist und dass es die Version ist, gegen die Ihr 4.x-Build getestet wurde.
- Definitionen exportieren und ein Backup erstellen.
rabbitmqctl export_definitionsplus ein Dateisystem-Backup des Datenverzeichnisses auf jedem Knoten. Aus dem Definitionsexport bauen Sie neu auf, falls die Rollback-Grenze überschritten ist. - Einen Knoten nach dem anderen upgraden. Führen Sie vor dem Stoppen eines Knotens
rabbitmq-upgrade await_online_quorum_plus_oneaus, damit keine Quorum Queue ihre Mehrheit verliert, solange dieser Knoten fehlt. Anschließend versetztrabbitmq-upgrade drainden Knoten in den Wartungsmodus, schließt Client-Verbindungen sauber und überträgt die Leadership der Quorum Queues auf andere Knoten. Stoppen Sie den Dienst, upgraden Sie bei Bedarf Erlang, upgraden Sie RabbitMQ, starten Sie ihn und prüfen Sie, dass er dem Cluster wieder beigetreten ist. - Warten, bis die Mitglieder der Quorum Queues aufgeholt haben.
rabbitmq-queues quorum_status <queue>auf den am stärksten genutzten Queues oderrabbitmq-diagnostics check_if_node_is_quorum_criticalauf dem nächsten Knoten, den Sie stoppen wollen. Fahren Sie erst mit dem nächsten Knoten fort, wenn diese Prüfung erfolgreich ist. - Prüfen, ob sich die Clients neu verbunden haben. Die Verbindungszahlen in der Management-UI sollten auf dem aktualisierten Knoten wieder das Ausgangsniveau erreichen. Verbindet sich eine Client-Library nicht neu, beheben Sie das jetzt – vor dem nächsten Knoten.
- Für jeden weiteren Knoten wiederholen. In diesem Zeitraum läuft der Cluster gemischt mit 3.13 und 4.x. Ändern Sie keine Policies, legen Sie keine Queues an und aktivieren Sie nichts Neues, bis der letzte Knoten fertig ist.
- Die neuen 4.x-Feature-Flags aktivieren. Wenn der letzte Knoten aktualisiert ist, führen Sie erneut
rabbitmqctl enable_feature_flag allaus. Das ist die Rollback-Grenze: Sobald ein reines 4.x-Feature-Flag aktiviert ist, gibt es keinen Downgrade-Pfad mehr. Alles vor diesem Schritt lässt sich rückgängig machen, indem Sie einen Knoten auf 3.13 zurücksetzen.
rabbitmqctl enable_feature_flag all
rabbitmq-upgrade await_online_quorum_plus_one
rabbitmq-upgrade drainEin Blue-Green-Deployment ist die Alternative, wenn der Cluster klein genug für einen Neuaufbau ist, der Definitionsexport verlässlich ist und Sie Clients per DNS oder Load Balancer umziehen können. Sie erhalten einen sauberen 4.x-Cluster und behalten einen intakten 3.13-Cluster als Rückfallebene. Wir bevorzugen diesen Weg für Cluster, die über Jahre undokumentierte Policies angesammelt haben.
In beiden Fällen deckt unser Support das Upgrade-Fenster ab, mit Reaktionszeitzielen ab 15 Minuten, je nach Plan – entscheidend vor allem zwischen Schritt 6 und Schritt 10. Wenn Sie während des Upgrades gar keine Rufbereitschaft halten möchten, führen die RabbitMQ Managed Services von AceMQ es in Ihrem Change-Fenster durch.
FAQ
Kann ich RabbitMQ direkt von 3.13 auf 4.x upgraden?
Ja. Ein Rolling Upgrade von 3.13.x auf 4.0.x wird unterstützt, sofern alle stabilen Feature Flags aktiviert sind, keine Policies für Classic Queue Mirroring mehr existieren und Erlang auf OTP 26 oder neuer läuft. Wenn Sie auf 3.12 oder älter sind, können Sie nicht direkt auf 4.x springen: Upgraden Sie zuerst auf 3.13, aktivieren Sie dessen Feature Flags und machen Sie dann weiter. Der Grund: 4.x-Nodes treten nur Clustern bei, in denen der Feature-Flag-Satz von 3.13 vollständig aktiviert ist, und ältere Reihen können das nicht erfüllen.
Kann ich auf RabbitMQ 3.x bleiben?
Ja, sicher aber nur mit einer Support-Vereinbarung, die Sicherheitsfixes zurückportiert, denn die Upstream-Patches für 3.x enden mit dem Community-Supportfenster von 3.13. Unser Extended LTS Support deckt 3.8.x bis 3.13.x mit zurückportierten CVE-Patches genau für diese Situation ab. Bleiben ist sinnvoll, wenn eine Client-Migration, ein Compliance-Freeze oder eine Queue-Umstellung mehr Zeit braucht, als der Upstream-Kalender zulässt. Als Dauerzustand ist es nicht sinnvoll; planen Sie den Wechsel auf 4.x nach Ihrem eigenen Zeitplan.
Wie upgradet man RabbitMQ ohne Downtime?
Per Rolling Upgrade, ein Node nach dem anderen. Aktivieren Sie alle Feature Flags, entfernen Sie gespiegelte Classic Queues, exportieren Sie die Definitions und führen Sie dann für jeden Node rabbitmq-upgrade await_online_quorum_plus_one aus, setzen Sie ihn per Drain in den Wartungsmodus, upgraden Sie Erlang und RabbitMQ, starten Sie ihn neu und warten Sie, bis die Mitglieder der Quorum Queues aufgeholt haben, bevor Sie den nächsten Node anfassen. Clients, die sich nach einem Verbindungsabbruch neu verbinden, sehen einen kurzen Reconnect, keinen Ausfall. Blue-Green mit einem neuen 4.x-Cluster und einer Umstellung der Clients ist die Option, wenn der bestehende Cluster zu verworren für ein In-Place-Upgrade ist.
Setzt RabbitMQ 4 Erlang 26 voraus?
Ja. RabbitMQ 4.x setzt Erlang/OTP 26 oder neuer voraus. Laufen Ihre 3.13-Nodes bereits auf OTP 26, entfällt der Erlang-Schritt; laufen sie auf OTP 25, upgraden Sie Erlang auf jedem Node im selben Rolling-Fenster wie das RabbitMQ-Paket. Prüfen Sie die Kompatibilitätstabelle für genau das 4.x-Patch-Release, das Sie installieren, denn spätere 4.x-Releases heben die Mindestversion an. Unser Beitrag zum End of Life von Erlang 26 erklärt, was das für die Support-Zeitpläne bedeutet.