RabbitMQ

Mettre à niveau RabbitMQ de la 3.x à la 4.x sans interruption de service : rolling ou blue-green

Scott Sternloff

Par Scott Sternloff, Architecte d’entreprise senior

LinkedIn · Mis à jour le

3.13EOL4.xCURRENTNo DowntimeRolling & Blue-Green Upgrade
Sur cette page
La mise à niveau de RabbitMQ fait partie de ces opérations qui devraient être simples mais qui prennent régulièrement les équipes au dépourvu. Les contraintes de chemin de versions ne sont pas évidentes, la dépendance à Erlang ajoute une pièce mobile supplémentaire, et le coût d'une erreur en production est élevé.
Cet article présente les deux stratégies qui fonctionnent, la mise à niveau progressive (rolling upgrade) et le déploiement blue-green, ainsi que les étapes préalables que la plupart des équipes négligent, notamment l'activation des feature flags et la vérification de la compatibilité des versions d'Erlang. Si vous préférez déléguer ce travail, nos services de mise à niveau RabbitMQ cadrent et exécutent toute la séquence de sauts de version dans votre fenêtre de changement.

Pourquoi les mises à niveau de RabbitMQ tournent-elles mal ?

Le scénario d'échec le plus courant : une équipe qui n'a pas mis à niveau depuis un an ou plus décide de passer directement à la dernière version et saute les étapes intermédiaires qu'exige le chemin de mise à niveau.

« Souvent, ce qui pose problème aux entreprises, ou ce qu'elles oublient, c'est qu'elles ne font pas de mises à niveau fréquentes. Parfois, il leur faut deux ou trois ans pour faire une mise à niveau. Et si elles essaient de passer directement de leur version actuelle à la dernière, elles rencontrent une série de problèmes imprévus, parce qu'elles auraient dû mettre à niveau étape par étape. »

— Jeff Sogolov, ingénieur AceMQ, session de travail avec Lucidya, mai 2025

RabbitMQ a un chemin de mise à niveau défini. Vous ne pouvez pas sauter de version majeure. Si vous êtes en 3.12, vous devez passer en 3.13 avant de pouvoir passer en 4.x. Tenter de sauter directement provoque une instabilité du cluster et des problèmes de compatibilité difficiles à diagnostiquer.

Quel est le chemin de mise à niveau obligatoire de la 3.x à la 4.x ?

Le chemin de mise à niveau est documenté par Broadcom et doit être suivi à la lettre. La règle essentielle : vous ne pouvez monter que d'une version majeure à la fois.
Depuis la 3.12 → passage obligatoire en 3.13 → puis en 4.x. Vous ne pouvez pas passer directement de la 3.12 à la 4.1. Si vous avez davantage de retard (en 3.10 ou 3.11), vous devez franchir chaque version majeure dans l'ordre.
Avant chaque étape, il faut également activer tous les feature flags de la version actuelle :
rabbitmqctl enable_feature_flag all
Ne pas activer les feature flags avant un changement de version est une cause fréquente d'échec des mises à niveau. Vérifiez toujours que tous les flags apparaissent comme activés avant de passer à la version suivante.

Et la compatibilité avec Erlang ?

Chaque version de RabbitMQ définit une version minimale et une version maximale d'Erlang prises en charge. Mettre à niveau RabbitMQ sans avoir d'abord mis Erlang à la version requise fera échouer la nouvelle version de RabbitMQ.
Points de contrôle Erlang essentiels pour le chemin 3.12 → 3.13 → 4.x :
  • 3.12 prend en charge Erlang 25.x au minimum
  • 3.13 exige Erlang 26 au minimum (26.2 recommandé)
  • 4.x exige également Erlang 26.2 au minimum

« Vous pouvez mettre à niveau Erlang directement de la 25 à la 26.2. Une fois en 26.2, vous passez RabbitMQ en 3.13 : vous avez déjà le bon Erlang. Puis de la 3.13 à la 4.1, la même version d'Erlang s'applique toujours. »

— Jeff Sogolov, ingénieur AceMQ, session avec Lucidya, mai 2025

Stratégie 1 : mise à niveau progressive (sur place)

Une mise à niveau progressive (rolling upgrade) met à niveau les nœuds de votre cluster existant un par un, sans créer de nouveau cluster. Vous arrêtez un nœud, mettez à niveau RabbitMQ (et Erlang si nécessaire), le redémarrez, puis passez au nœud suivant.
Déroulement :
  1. Arrêter le nœud 1 (le service uniquement, pas le système d'exploitation)
  2. Mettre à niveau Erlang sur le nœud 1 vers la version requise
  3. Mettre à niveau RabbitMQ sur le nœud 1 vers la version cible
  4. Démarrer le service RabbitMQ sur le nœud 1
  5. Vérifier que le nœud 1 a rejoint le cluster et qu'il est sain
  6. Répéter l'opération pour les nœuds 2 et 3
Pendant la mise à niveau progressive, votre cluster fonctionne temporairement avec des versions mixtes. C'est pris en charge au sein d'une même version majeure, mais pas d'une version majeure à l'autre. Effectuez les mises à niveau progressives pendant les périodes de faible trafic : mettre à niveau sous forte charge augmente le risque, car la réplication des quorum queues et la synchronisation des messages ajoutent une charge supplémentaire.
Avantages : aucune nouvelle infrastructure nécessaire, orchestration plus simple, réutilisation de l'appartenance existante au cluster. Inconvénients : les brefs redémarrages de chaque nœud perturbent les connexions ; l'opération doit être menée en période de faible trafic.

Stratégie 2 : déploiement blue-green

Un déploiement blue-green crée un tout nouveau cluster (green) à côté de votre cluster existant (blue), migre le trafic vers le nouveau cluster grâce à la fédération, puis décommissionne l'ancien une fois la transition terminée.
Déroulement :
  1. Provisionner un nouveau cluster (green) avec les versions cibles de RabbitMQ et d'Erlang
  2. Configurer sur le cluster green un upstream de file fédérée pointant vers le cluster blue
  3. À mesure que les consommateurs sont déplacés vers le cluster green, la fédération tire automatiquement les messages de blue vers green
  4. Une fois tous les consommateurs sur green, déplacer les producteurs vers green
  5. Une fois les producteurs déplacés, vider les messages restants de blue à l'aide du plugin Shovel
  6. Décommissionner le cluster blue
Distinction essentielle : utilisez des files fédérées, pas des exchanges fédérés. Avec les files fédérées, lorsqu'un consommateur est présent sur le cluster aval (green), les messages sont tirés du cluster amont (blue) et consommés sur place : ils ne persistent pas des deux côtés.

« Le blue-green, c'est zéro interruption. Vous pouvez le faire à tout moment : il n'y a pas de mode maintenance. Le prix à payer, c'est d'avoir deux clusters qui tournent en même temps, ce que certaines entreprises ne peuvent pas se permettre, surtout sur site. Mais pour des déploiements sur AWS, où l'on peut créer facilement de nouveaux clusters, c'est tout à fait pertinent. »

— Jeff Sogolov, ingénieur AceMQ, session avec Lucidya, mai 2025

Avantages : migration sans interruption de service, réalisable à tout moment. Inconvénients : nécessite temporairement une infrastructure en double, et davantage d'étapes de configuration.

Objectifs de réponse à partir de 15 minutes, selon le plan. Ingénieurs seniors attitrés.

Nous contacter

Check-list avant mise à niveau

Avant de lancer toute mise à niveau de RabbitMQ :
  • Confirmer la version actuelle de RabbitMQ et identifier le chemin de mise à niveau requis
  • Consulter la matrice de compatibilité Erlang pour la version cible et les versions intermédiaires
  • Activer tous les feature flags de la version actuelle (rabbitmqctl enable_feature_flag all)
  • Sauvegarder les définitions du cluster (topologie, utilisateurs, permissions) via la Management API
  • Valider la mise à niveau de bout en bout en préproduction avant de toucher à la production
  • Vérifier le comportement des health checks du load balancer lorsque des nœuds sont mis hors ligne
  • Tester en préproduction le comportement de reconnexion des clients lors de redémarrages de nœuds simulés
  • Planifier l'opération sur la fenêtre de plus faible trafic en cas de mise à niveau progressive
  • Documenter un plan de retour arrière avant de commencer
Les mises à niveau de RabbitMQ sur plusieurs versions, en particulier le passage de la 3.x à la 4.x, font partie des missions que nous menons le plus souvent. Si vous souhaitez de l'aide pour cadrer la mise à niveau, concevoir l'approche de migration ou confier son exécution à un ingénieur AceMQ pendant votre fenêtre de maintenance, contactez notre équipe de support RabbitMQ.

Pour une vue d'ensemble de votre état de préparation avant de vous engager sur une fenêtre, consultez la check-list de préparation à la migration RabbitMQ.

Ce qui change dans RabbitMQ 4.x et peut casser un parc 3.x

La plupart des mises à niveau de la 3.x vers la 4.x qui tournent mal échouent sur l'un des quelques changements suivants. Aucun n'est une surprise si vous lisez les notes de version de la 4.0, mais chacun passe facilement inaperçu dans un grand parc qui a grandi avec les conventions des 3.8 et 3.9.

  • La mise en miroir des files classiques a disparu. Les files classiques en miroir (les clés de politique ha-mode et ha-params) ont été dépréciées dans la 3.9 et supprimées dans la 4.0. Un nœud 4.x ne met pas en miroir les files classiques : toute file qui s'appuyait sur une politique HA pour sa réplication devient une file sur un seul nœud dès que la politique cesse de s'appliquer. C'est le seul changement qu'il faut traiter avant la mise à niveau plutôt qu'après : migrez chaque file en miroir vers une quorum queue, puis supprimez les politiques HA. rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policy vous indique s'il en reste. Nous détaillons les compromis dans notre article files classiques ou quorum queues.
  • Les files transitoires non exclusives sont dépréciées. Les files non durables qui ne sont pas exclusives à une connexion sont signalées comme fonctionnalité dépréciée et peuvent être interdites par configuration. Elles fonctionnent encore en 4.x, mais prévoyez de déclarer des files durables partout et d'utiliser des files exclusives pour l'état réellement propre à une connexion.
  • Le type de file par défaut. Déclarer une file sans x-queue-type donne toujours une file classique, sauf si le virtual host définit default_queue_type. Réglez-le sur quorum par vhost pour les nouvelles charges de travail, et assurez-vous que le code client qui déclare des files transmet un x-queue-type explicite, pour que personne ne soit surpris par une valeur par défaut au niveau du vhost.
  • AMQP 1.0 devient un protocole natif. Dans la 4.0, le plugin AMQP 1.0 distinct n'est plus nécessaire : la version 1.0 est implémentée nativement aux côtés de 0-9-1, sur le même listener. Les clients 0-9-1 existants ne sont pas affectés. Les équipes qui utilisaient l'ancien plugin doivent le retirer de leur liste de plugins activés, et celles qui veulent la 1.0 doivent passer aux bibliothèques clientes 1.0 maintenues plutôt qu'aux anciennes.
  • Khepri comme magasin de métadonnées. Khepri, le remplaçant de Mnesia fondé sur Raft, a été livré à titre expérimental dans la 3.13 et est pris en charge en 4.x, mais son activation est facultative. Les nœuds continuent d'utiliser Mnesia après la mise à niveau tant que vous n'activez pas délibérément le feature flag khepri_db. Traitez-le comme un changement distinct, avec sa propre fenêtre de test, et non comme un effet de bord du changement de version.
  • Tous les feature flags doivent d'abord être activés. Un cluster 3.13 dont un feature flag stable est encore désactivé ne peut pas accueillir de nœud 4.x, et le nœud 4.x refuse de démarrer face à lui. Activez tout avant de déplacer le premier nœud.
  • Les plugins et l'interface de gestion. Les plugins compilés pour la 3.x nécessitent des builds 4.x. Le plugin de gestion lui-même est reconduit, mais il abandonne les vues de mise en miroir et le plugin AMQP 1.0 n'a plus aucun effet. Auditez tout plugin communautaire avant de supposer qu'il fonctionne.
  • MQTT 5. La prise en charge de MQTT 5 est arrivée avec la 3.13 et se poursuit en 4.x. Si vous venez de la 3.12 ou d'une version plus ancienne, vos clients MQTT en bénéficient en cours de route.
  • Erlang. La 4.x exige Erlang/OTP 26 ou version ultérieure. Si vos nœuds sont encore en OTP 25, la mise à niveau d'Erlang se fait dans le cadre de la mise à niveau progressive, un nœud à la fois. Consultez notre note sur la fin de vie d'Erlang 26 et RabbitMQ avant de choisir une cible.

Faut-il rester en 3.13 ou passer en 4.x ?

La 3.13 est la dernière série 3.x. Sa fenêtre de support communautaire est courte et, une fois close, plus aucune version 3.x ne reçoit de correctifs de sécurité amont. C'est la contrainte réelle qui guide la décision.

Rester en 3.13 est raisonnable dans un seul cas : vous disposez d'un contrat de support commercial ou étendu qui rétroporte les correctifs de sécurité sur la version que vous exploitez. Sans cela, un cluster 3.13 est un compte à rebours de CVE. Notre support LTS étendu couvre les versions 3.8.x à 3.13.x avec des correctifs rétroportés, ce qui permet à nos clients d'exploiter des séries plus anciennes selon un calendrier qu'ils maîtrisent, plutôt que dicté par le calendrier amont. Cela fait gagner du temps, sans dispenser de planifier la migration.

Mettez à niveau lorsque ces quatre conditions sont réunies :

  1. Les files classiques en miroir ont disparu et il ne reste aucune politique HA.
  2. Tous les feature flags stables sont activés sur tous les nœuds.
  3. Erlang est en OTP 26 ou version ultérieure, ou vous êtes prêt à le mettre à niveau pendant la mise à niveau progressive.
  4. Les applications clientes utilisent des versions de bibliothèques maintenues qui se comportent correctement avec les quorum queues (gestion correcte de x-delivery-limit, du dead-lettering et de la reconnexion).

Mettez à niveau plus tôt que ne le suggère votre calendrier de maintenance si vous avez besoin d'AMQP 1.0 sans plugin, de MQTT 5 sur une 3.x plus ancienne, ou des améliorations des quorum queues de la 4.x, qui incluent les priorités de messages et une limite de livraison par défaut empêchant les messages empoisonnés de tourner en boucle indéfiniment.

Si vous êtes entre la 3.8 et la 3.12, la réponse est la même mais le chemin est plus long : passez d'abord en 3.13, stabilisez, puis passez en 4.x. Nous menons les deux étapes pour nos clients, et notre service de mises à niveau et de correctifs RabbitMQ est cadré en conséquence.

Savoir s'il est sûr de rester est une question distincte de savoir si c'est possible : RabbitMQ 3.x est-il encore sûr à exploiter ? passe en revue, série par série, les dates de fin de vie et l'exposition aux CVE. Si vous restez, le support LTS étendu pour RabbitMQ 3.x maintient la version corrigée en attendant une fenêtre pour la mise à niveau.

Notre procédure de mise à niveau progressive

Voici la séquence que nous suivons sur les clusters de nos clients. Elle suppose un cluster de trois ou cinq nœuds, des quorum queues pour tout ce qui est important, et des clients qui se reconnectent en cas de perte de connexion.

  1. Inventaire. Relevez les versions, les versions d'Erlang, les plugins activés et chaque policy. Exécutez rabbitmq-diagnostics check_if_any_deprecated_features_are_used et rabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policy sur n'importe quel nœud. Les deux doivent revenir sans erreur avant de poursuivre.
  2. Activez tous les feature flags stables. rabbitmqctl enable_feature_flag all sur un seul nœud s'applique à tout le cluster. Vérifiez avec rabbitmqctl list_feature_flags : tout flag encore disabled bloque la mise à niveau.
  3. Convertissez les files classiques en miroir en quorum queues, flux par flux. Les quorum queues ne peuvent pas être converties sur place. Pour chaque flux, déclarez la quorum queue, redirigez les consommateurs, puis les producteurs, videz l'ancienne file d'attente et supprimez-la. Procédez application par application pour qu'une erreur n'affecte qu'un flux, et non tout le parc.
  4. Vérifiez la version cible d'Erlang. Assurez-vous que le paquet OTP 26 ou ultérieur est disponible sur chaque nœud et qu'il s'agit de la version avec laquelle votre build 4.x a été testé.
  5. Exportez les définitions et faites une sauvegarde. rabbitmqctl export_definitions, plus une sauvegarde du système de fichiers du répertoire de données sur chaque nœud. C'est à partir de l'export des définitions que vous reconstruisez si la limite de retour arrière est franchie.
  6. Mettez à niveau un nœud à la fois. Avant d'arrêter un nœud, exécutez rabbitmq-upgrade await_online_quorum_plus_one pour qu'aucune quorum queue ne perde sa majorité pendant l'absence de ce nœud. Ensuite, rabbitmq-upgrade drain met le nœud en mode maintenance, ferme proprement les connexions clientes et transfère ailleurs le leadership des quorum queues. Arrêtez le service, mettez à niveau Erlang si nécessaire, puis RabbitMQ, démarrez-le et vérifiez qu'il a rejoint le cluster.
  7. Attendez que les membres des quorum queues se resynchronisent. rabbitmq-queues quorum_status <queue> sur les files d'attente les plus chargées, ou rabbitmq-diagnostics check_if_node_is_quorum_critical sur le prochain nœud que vous comptez arrêter. Ne passez pas au nœud suivant tant que ce contrôle n'est pas validé.
  8. Vérifiez que les clients se sont reconnectés. Dans l'interface de gestion, le nombre de connexions doit revenir à son niveau habituel sur le nœud mis à niveau. Si une bibliothèque cliente ne se reconnecte pas, corrigez-la maintenant, avant le nœud suivant.
  9. Répétez l'opération pour chaque nœud restant. Le cluster fonctionne en versions mixtes 3.13 et 4.x pendant cette fenêtre. Ne modifiez pas de policies, n'ajoutez pas de files d'attente et n'activez rien de nouveau avant que le dernier nœud soit terminé.
  10. Activez les nouveaux feature flags de la 4.x. Une fois le dernier nœud mis à niveau, relancez rabbitmqctl enable_feature_flag all. C'est la limite de retour arrière : dès qu'un feature flag propre à la 4.x est activé, aucun retour à la version précédente n'est possible. Tout ce qui précède cette étape peut être annulé en restaurant un nœud en 3.13.
rabbitmqctl enable_feature_flag all
rabbitmq-upgrade await_online_quorum_plus_one
rabbitmq-upgrade drain

Le blue-green est l'alternative lorsque le cluster est assez petit pour être reconstruit, que l'export des définitions est fiable et que vous pouvez basculer les clients via le DNS ou un load balancer. Vous obtenez un cluster 4.x propre et un cluster 3.13 intact sur lequel revenir. Nous le privilégions pour les clusters qui ont accumulé des années de policies non documentées.

Dans les deux cas, notre support couvre la fenêtre de mise à niveau avec des objectifs de réponse à partir de 15 minutes, selon le plan, ce qui compte surtout entre les étapes 6 et 10. Si vous préférez ne pas assurer l'astreinte pendant la mise à niveau, les services managés RabbitMQ d'AceMQ la réalisent dans votre fenêtre de changement.

FAQ

Peut-on passer directement de RabbitMQ 3.13 à la 4.x ?

Oui. Une mise à niveau progressive (rolling) de la 3.13.x vers la 4.0.x est prise en charge, à condition que tous les feature flags stables soient activés, qu'il ne reste aucune politique de mise en miroir des files classiques et qu'Erlang soit en OTP 26 ou version ultérieure. Si vous êtes en 3.12 ou sur une version plus ancienne, vous ne pouvez pas sauter directement à la 4.x : passez d'abord en 3.13, activez ses feature flags, puis poursuivez. La raison : les nœuds 4.x ne rejoignent que des clusters où l'ensemble des feature flags de la 3.13 est entièrement activé, ce que les séries plus anciennes ne peuvent pas satisfaire.

Peut-on rester sur RabbitMQ 3.x ?

C'est possible, mais sans risque uniquement avec un contrat de support qui rétroporte les correctifs de sécurité, car les correctifs amont pour la 3.x s'arrêtent avec la fin de la fenêtre communautaire de la 3.13. Notre support LTS étendu couvre les versions 3.8.x à 3.13.x avec des correctifs de CVE rétroportés, précisément pour cette situation. Rester se justifie lorsqu'une migration des clients, un gel lié à la conformité ou une conversion de files demande plus de temps que le calendrier amont ne le permet. Cela ne se justifie pas comme état permanent : planifiez le passage en 4.x selon votre propre calendrier.

Comment mettre à niveau RabbitMQ sans interruption de service ?

Par une mise à niveau progressive, un nœud à la fois. Activez tous les feature flags, supprimez les files classiques en miroir, exportez les définitions, puis pour chaque nœud exécutez rabbitmq-upgrade await_online_quorum_plus_one, drainez-le, mettez à niveau Erlang et RabbitMQ, redémarrez, et attendez que les membres des quorum queues se resynchronisent avant de toucher au nœud suivant. Les clients qui se reconnectent en cas de perte de connexion ne voient qu'une brève reconnexion, pas une panne. Le blue-green, avec un nouveau cluster 4.x et une bascule des clients, est l'option à retenir lorsque le cluster existant est trop enchevêtré pour être mis à niveau sur place.

RabbitMQ 4 exige-t-il Erlang 26 ?

Oui. RabbitMQ 4.x exige Erlang/OTP 26 ou version ultérieure. Si vos nœuds 3.13 sont déjà en OTP 26, l'étape Erlang n'a rien à faire ; s'ils sont en OTP 25, mettez à niveau Erlang sur chaque nœud dans la même fenêtre progressive que le paquet RabbitMQ. Consultez le tableau de compatibilité pour la version corrective 4.x exacte que vous installez, car les versions 4.x ultérieures relèvent le minimum. Notre article sur la fin de vie d'Erlang 26 explique ce que cela implique pour les calendriers de support.

Consultation gratuite

Un regard expert sur votre cluster RabbitMQ

Que vous deviez résoudre un incident de production, planifier une migration ou obtenir un second avis sur votre architecture, notre équipe est prête. Pas d’argumentaire commercial, seulement des réponses.

Nous écrire