Sur cette page
Pourquoi les mises à niveau de RabbitMQ tournent-elles mal ?
« 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
Quel est le chemin de mise à niveau obligatoire de la 3.x à la 4.x ?
rabbitmqctl enable_feature_flag allEt la compatibilité avec Erlang ?
- 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)
- Arrêter le nœud 1 (le service uniquement, pas le système d'exploitation)
- Mettre à niveau Erlang sur le nœud 1 vers la version requise
- Mettre à niveau RabbitMQ sur le nœud 1 vers la version cible
- Démarrer le service RabbitMQ sur le nœud 1
- Vérifier que le nœud 1 a rejoint le cluster et qu'il est sain
- Répéter l'opération pour les nœuds 2 et 3
Stratégie 2 : déploiement blue-green
- Provisionner un nouveau cluster (green) avec les versions cibles de RabbitMQ et d'Erlang
- Configurer sur le cluster green un upstream de file fédérée pointant vers le cluster blue
- À mesure que les consommateurs sont déplacés vers le cluster green, la fédération tire automatiquement les messages de blue vers green
- Une fois tous les consommateurs sur green, déplacer les producteurs vers green
- Une fois les producteurs déplacés, vider les messages restants de blue à l'aide du plugin Shovel
- Décommissionner le cluster blue
« 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
Check-list avant mise à niveau
- 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
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-modeetha-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_policyvous 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-typedonne toujours une file classique, sauf si le virtual host définitdefault_queue_type. Réglez-le surquorumpar vhost pour les nouvelles charges de travail, et assurez-vous que le code client qui déclare des files transmet unx-queue-typeexplicite, 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 :
- Les files classiques en miroir ont disparu et il ne reste aucune politique HA.
- Tous les feature flags stables sont activés sur tous les nœuds.
- Erlang est en OTP 26 ou version ultérieure, ou vous êtes prêt à le mettre à niveau pendant la mise à niveau progressive.
- 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.
- 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_usedetrabbitmq-diagnostics check_if_cluster_has_classic_queue_mirroring_policysur n'importe quel nœud. Les deux doivent revenir sans erreur avant de poursuivre. - Activez tous les feature flags stables.
rabbitmqctl enable_feature_flag allsur un seul nœud s'applique à tout le cluster. Vérifiez avecrabbitmqctl list_feature_flags: tout flag encoredisabledbloque la mise à niveau. - 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.
- 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é.
- 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. - Mettez à niveau un nœud à la fois. Avant d'arrêter un nœud, exécutez
rabbitmq-upgrade await_online_quorum_plus_onepour qu'aucune quorum queue ne perde sa majorité pendant l'absence de ce nœud. Ensuite,rabbitmq-upgrade drainmet 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. - Attendez que les membres des quorum queues se resynchronisent.
rabbitmq-queues quorum_status <queue>sur les files d'attente les plus chargées, ourabbitmq-diagnostics check_if_node_is_quorum_criticalsur 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é. - 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.
- 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é.
- 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 drainLe 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.