# Comment concevoir une architecture RabbitMQ de production en entreprise
Une architecture RabbitMQ de production en entreprise repose sur un petit nombre de décisions à prendre correctement avant la mise en production de la première charge de travail : un nombre impair de nœuds répartis sur plusieurs zones de disponibilité (AZ), les quorum queues comme type de file d'attente par défaut, une isolation par vhost et par domaine, et TLS dès le premier jour. Ce guide sert de référence de base à une équipe plateforme qui construit son premier cluster de production ; ce n'est ni un playbook de montée en charge ni un calculateur de dimensionnement.
Deux articles complémentaires traitent de sujets que celui-ci laisse volontairement de côté. Pour la croissance au-delà de la première année, consultez concevoir pour la montée en charge future. Pour les calculs de débit, les formules de nombre de nœuds et les schémas de reprise après sinistre multisite, consultez haute disponibilité, reprise après sinistre et dimensionnement du cluster. Cet article part du principe que la question du dimensionnement est déjà tranchée et se concentre sur la topologie, la posture de sécurité et les garde-fous opérationnels.
Les décisions coûteuses à modifier par la suite
Certaines décisions RabbitMQ sont faciles à annuler : une valeur de prefetch se modifie par une mise à jour de policy et un redémarrage progressif (rolling restart). D'autres sont structurelles, inscrites dans le code client, les enregistrements DNS et les habitudes des équipes : les défaire plus tard implique un projet de migration et non un simple changement de configuration. Faites les bons choix avant que le premier producteur ne se connecte.
Type de file d'attente. Choisir les quorum queues dès le départ évite une migration à chaud plus tard. Les files classiques en miroir (le schéma de policy ha-mode) ont été rendues obsolètes dans RabbitMQ 3.x et purement supprimées dans la 4.0. Un premier déploiement qui y recourt encore repose sur des fondations qui n'existent plus. Consultez files classiques ou quorum queues pour une comparaison approfondie.
Parité du nombre de nœuds. Un nombre pair de nœuds est une erreur fréquente sur un premier cluster. Les quorum queues et la coordination de RabbitMQ fondée sur Raft ont besoin d'une majorité nette pour rester disponibles pendant une partition. Un nombre pair crée des égalités ; un nombre impair, non.
Organisation des vhosts. Déverser les files d'attente de toutes les équipes dans le vhost / par défaut est rapide à mettre en place et pénible à défaire. Permissions, policies et limites de connexion sont toutes rattachées au vhost : un vhost partagé signifie que chaque équipe subit le rayon d'impact de toutes les autres.
Conventions de nommage. Les noms de files d'attente et d'exchanges finissent codés en dur dans des dizaines de services. Un schéma adopté après coup oblige à modifier chaque consommateur.
TLS. Activer TLS après la mise en production impose une bascule coordonnée de toutes les chaînes de connexion à la fois. L'activer dès le premier jour ne coûte qu'un certificat et un bloc de configuration.
Les trois erreurs que nous retrouvons sur presque chaque premier déploiement que nous examinons : les files classiques en miroir (supprimées en 4.x, et un mauvais choix de haute disponibilité là où elles fonctionnent encore), un nombre pair de nœuds (comportement en cas de partition pire qu'avec un nombre impair) et un seul vhost pour tout (aucune isolation, aucun contrôle d'accès digne de ce nom, aucun moyen de contenir une équipe trop bruyante).
Forme du cluster : nœuds, AZ et gestion des partitions réseau
La réponse par défaut pour un premier cluster de production est trois nœuds, un par zone de disponibilité, nombre impair, quorum queues. C'est la plus petite topologie qui tolère la défaillance d'un nœud ou d'une AZ tout en conservant une majorité de quorum (2 sur 3) disponible pour servir le trafic et élire les leaders. Le calcul complet du nombre de nœuds pour un débit plus élevé ou une reprise après sinistre multisite relève de haute disponibilité, reprise après sinistre et dimensionnement du cluster : cette section donne les valeurs par défaut, pas les calculs.
Un cluster à deux nœuds est pire qu'un nœud unique, et non un compromis plus sûr. La perte de l'un ou l'autre nœud laisse le survivant sans majorité : les quorum queues et les opérations à l'échelle du cluster se bloquent au lieu de se dégrader en douceur. Si vous ne pouvez pas vous engager sur trois nœuds, exploitez-en un seul et planifiez votre chemin de mise à niveau.
Gestion des partitions réseau. Réglez cluster_partition_handling sur pause_minority pour une topologie à trois nœuds, un par AZ :
cluster_partition_handling = pause_minority
Cela s'applique jusqu'à la 4.2 incluse. RabbitMQ 4.3.0 a supprimé les stratégies de gestion des partitions en même temps que Mnesia ; la clé est toujours acceptée mais n'a aucun effet : omettez-la des configurations 4.3 et ultérieures.
Avec pause_minority, tout nœud situé hors de la partition majoritaire se met en pause au lieu de servir un état obsolète ou divergent. Combiné au consensus Raft propre aux quorum queues, ce réglage garantit un comportement prévisible lors d'un incident réseau sur une AZ : les deux nœuds qui se voient encore continuent de servir, le nœud isolé cesse d'accepter du travail jusqu'à ce qu'il rejoigne le cluster. Évitez autoheal pour un premier déploiement : il privilégie la disponibilité au détriment de la cohérence d'une manière plus difficile à appréhender sous charge.
Placez un nœud par AZ, et non deux dans une AZ et un dans une autre. Avec deux nœuds dans la même AZ, la panne d'AZ contre laquelle vous vouliez vous protéger vous fait aussi perdre votre majorité.
Organisation des files d'attente et des exchanges en entreprise
Les quorum queues par défaut. Utilisez les quorum queues pour tout ce qui comporte une exigence de durabilité ou de disponibilité, c'est-à-dire, en entreprise, l'essentiel du trafic de production : événements de commande, notifications de paiement, mises à jour de stock. Les quorum queues se répliquent via Raft entre les nœuds du cluster et survivent à la perte d'une minorité de nœuds sans intervention d'un opérateur.
Quand les files classiques restent acceptables. Les files classiques restent raisonnables pour des charges de travail éphémères qui tolèrent un seul nœud : files de réponse de type RPC, télémétrie de faible valeur, ou tout cas où perdre le contenu de la file lors de la défaillance d'un nœud est un compromis acceptable en échange d'un surcoût moindre. Ne choisissez pas les files classiques par habitude : décidez délibérément, file par file. L'arbre de décision complet figure dans files classiques ou quorum queues.
Les streams pour le rejeu. Les streams RabbitMQ (le type de file d'attente x-queue-type: stream) sont l'outil adapté lorsque les consommateurs doivent relire l'historique : event sourcing, pistes d'audit ou consumer groups ayant chacun leur propre position de lecture. Les streams se comportent davantage comme un journal que comme une file d'attente et ne remplacent pas directement les quorum queues.
Un vhost par domaine. Structurez les vhosts selon les frontières métier ou d'équipe, et non par environnement (utilisez des clusters distincts, et non des vhosts, pour isoler les environnements). Un domaine paiements, un domaine stocks et un domaine notifications disposent chacun de leur vhost, de leurs utilisateurs et de leurs policies : une frontière naturelle de rayon d'impact, où « qui peut publier vers les paiements ? » devient une question unique et à laquelle on peut répondre.
Conventions de nommage. Un schéma exploitable pour un parc d'entreprise :
<domain>.<service>.<event-or-purpose>
Exemples : payments.invoicing.invoice-created, inventory.warehouse.stock-adjusted. La cohérence compte davantage que le schéma retenu : choisissez-en un et imposez-le par la revue de code ou un outil de provisionnement avant que le parc ne dépasse quelques équipes.
Des policies plutôt que des arguments par file. Définissez le comportement des files d'attente (TTL, longueur maximale, dead-lettering, réplication) via des policies rattachées au vhost et appliquées par motif de nom, plutôt qu'en passant des arguments à chaque appel queue.declare depuis le code applicatif :
Les policies se modifient de façon centralisée sans redéployer le code applicatif, ce qui devient précieux le jour où vous devez ajouter le dead-lettering sur vingt services à la fois.
Garde-fous de ressources
Les paramètres de ressources par défaut de RabbitMQ sont prudents mais pas adaptés d'emblée à l'entreprise. Définissez-les explicitement.
Watermark mémoire haut. Détermine à quel moment RabbitMQ commence à bloquer les éditeurs pour se protéger d'un OOM :
vm_memory_high_watermark.relative = 0.6
0,6 (60 % de la RAM disponible) constitue un point de départ raisonnable pour un nœud broker dédié, en laissant une marge de capacité pour le système d'exploitation, le surcoût de la VM Erlang et l'état des connexions.
Limite d'espace disque libre. RabbitMQ cesse d'accepter les publications lorsque l'espace disque libre passe sous ce seuil, afin d'éviter un broker incapable d'écrire sur disque :
disk_free_limit.absolute = 5GB
Fixez cette valeur bien au-dessus du plus gros backlog de messages attendu sur disque, et pas simplement au-dessus de zéro.
Limites de connexions et de canaux. Plafonnez la consommation de ressources par vhost et par utilisateur afin qu'un service défaillant ne puisse pas épuiser la capacité de tout le broker :
channel_max = 128
connection_max = 1000
Définissez-les par vhost via rabbitmqctl set_vhost_limits lorsque vous avez besoin d'un contrôle plus strict que les valeurs globales par défaut.
Prefetch. Définissez un prefetch consommateur raisonnable (basic.qos) plutôt que de le laisser illimité. Un prefetch illimité permet à un consommateur lent d'accumuler une part disproportionnée de messages non acquittés (unacked), au détriment des autres consommateurs de la même file d'attente. Une valeur de départ de 10-50 par consommateur, ajustée selon le temps de traitement, convient à la plupart des charges de travail.
Comportement lazy en 4.x. Depuis RabbitMQ 3.12, la distinction des lazy queues a été intégrée à un magasin de messages unifié, et les files classiques gèrent la mémoire de façon prévisible sans l'ancien mode lazy. Les quorum queues ont toujours utilisé un journal Raft avec des fichiers de segments sur disque et n'en ont jamais eu besoin. Si vous conservez des policies x-queue-mode: lazy issues d'un ancien déploiement, elles sont désormais sans effet : supprimez-les plutôt que de les laisser traîner comme configuration morte.
Socle de sécurité
TLS sur le port 5671. Terminez TLS au niveau du broker pour le trafic AMQP sur le port 5671 (avec TLS, contre 5672 en clair) dès le premier jour, et non a posteriori :
Désactivez complètement le listener 5672 en clair sur tout nœud accessible en dehors d'un segment réseau entièrement de confiance.
Désactivez guest. L'utilisateur guest est limité par défaut à localhost dans les versions actuelles, mais ne comptez pas uniquement là-dessus. Supprimez-le ou verrouillez-le explicitement :
rabbitmqctl delete_user guest
Utilisateurs et tags par vhost. Créez des utilisateurs limités aux vhosts dont ils ont besoin, avec le tag minimal (management, monitoring, policymaker, administrator) qu'exige leur rôle. Évitez un compte de service partagé entre les producteurs et consommateurs de toutes les équipes : il annule l'isolation par vhost mise en place plus haut et complique la rotation des identifiants et l'audit.
Exposition de l'interface de gestion. L'API HTTP et l'interface du plugin de gestion ne doivent pas être accessibles depuis l'internet public. Placez-les derrière un VPN, un bastion ou un load balancer interne, et imposez aussi TLS sur le listener de gestion (port 15671).
OAuth2/LDAP. RabbitMQ prend en charge OAuth 2.0 (via rabbitmq_auth_backend_oauth2, compatible avec Keycloak, Azure AD et d'autres fournisseurs OIDC) et LDAP (via rabbitmq_auth_backend_ldap) comme alternatives à la gestion interne des utilisateurs. Les deux centralisent l'authentification et évitent la prolifération des mots de passe dès que vous gérez les accès de plus de quelques ingénieurs.
Observabilité
Plugin Prometheus. Activez le plugin Prometheus intégré plutôt que de recourir à un exporter tiers :
rabbitmq-plugins enable rabbitmq_prometheus
Il expose nativement les métriques du broker, des files d'attente et des nœuds au format Prometheus sur le port 15692, sans agent séparé à exécuter ni à maintenir.
Six métriques sur lesquelles déclencher des alertes :
Profondeur de file d'attente (rabbitmq_queue_messages_ready) : une croissance sans limite signale un consommateur qui ne suit plus le rythme.
Utilisation des consommateurs (rabbitmq_queue_consumer_utilisation) : une baisse indique des consommateurs inactifs ou un consommateur lent qui bloque les autres.
Mémoire du nœud (rabbitmq_process_resident_memory_bytes) : l'approche du watermark haut annonce un blocage imminent des éditeurs.
Utilisation des descripteurs de fichiers (rabbitmq_fd_used vs rabbitmq_fd_total) : un niveau élevé fait courir un risque d'échecs de connexion sous charge.
Nombre de messages non acquittés : une hausse indique des consommateurs qui acceptent du travail plus vite qu'ils ne le confirment, signe avant-coureur de tempêtes de nouvelles livraisons.
État des partitions du cluster (rabbitmq_partitions) : une valeur supérieure à zéro signifie que le cluster est scindé et requiert une attention immédiate.
Expédition des journaux. Envoyez les journaux de RabbitMQ (au format JSON par défaut depuis la 3.9) vers votre pile de journalisation centrale plutôt que de les laisser sur le disque local. Événements de partition, échecs d'authentification et modifications de policies apparaissent dans ces journaux avant de se traduire par une anomalie de métrique : l'expédition des journaux devient ainsi votre système d'alerte le plus précoce pour plusieurs des modes de défaillance ci-dessus.
Stratégie de mise à niveau et de gestion des correctifs
Planifiez votre version et votre période de support avant qu'un incident ne vous impose la question. La communauté RabbitMQ ne prend en charge que les deux séries de versions les plus récentes (4.4 et 4.3 en octobre 2026) ; dès qu'une nouvelle version mineure sort, les plus anciennes perdent assez vite leur support. Les licences commerciales (via Broadcom/Tanzu) étendent la couverture jusqu'à la série 3.13.x. Le support d'AceMQ remonte encore plus loin, de la 3.8.x à la série 4.x actuelle, ce qui compte pour les entreprises qui exploitent des déploiements de longue durée et ne peuvent pas suivre le rythme de mise à niveau de la communauté.
Compatibilité Erlang. RabbitMQ 4.x exige une version Erlang/OTP tout aussi récente (Erlang 26 ou 27 pour la série 4.x actuelle). Faire tourner un runtime Erlang ancien avec une version récente de RabbitMQ, ou l'inverse, est une source fréquente d'échecs subtils au démarrage et en clustering. Vérifiez la matrice de compatibilité avant chaque mise à niveau majeure.
Feature flags avant les mises à niveau majeures. RabbitMQ encadre les changements incompatibles entre versions majeures au moyen de feature flags. Avant de franchir une version majeure (de 3.x à 4.x, par exemple), vérifiez que tous les nœuds sont sur la dernière version mineure de la série actuelle et que tous les flags requis sont activés :
rabbitmqctl list_feature_flags
rabbitmqctl enable_feature_flag all
Sauter cette étape et franchir des versions majeures sans traiter les feature flags est l'une des causes les plus fréquentes d'une mise à niveau de cluster bloquée ou ratée.
Pour les options de licence, notamment la façon dont AceMQ prend en charge RabbitMQ commercial en deçà des minimums standard de cœurs de Broadcom, consultez licence RabbitMQ.
Services financiers et charges de travail réglementées
Les entreprises des services financiers, de la santé ou d'autres secteurs réglementés ont des exigences qui vont au-delà de ce socle.
Journalisation d'audit. Au-delà des journaux opérationnels déjà évoqués, les charges de travail réglementées exigent généralement un enregistrement immuable des actions d'administration : création d'utilisateurs, modifications de permissions, mises à jour de policies, modifications de vhosts. Capturez-les depuis l'API de gestion et transmettez-les à un stockage à écriture unique ou à un SIEM, plutôt que de les greffer sur l'expédition générale des journaux.
Cryptographie FIPS 140. Lorsqu'une charge de travail exige des modules cryptographiques validés FIPS, les builds RabbitMQ standard ne les fournissent pas d'emblée. AceMQ propose FIPSMQ, une distribution RabbitMQ reposant sur des modules cryptographiques validés FIPS 140, précisément pour cette exigence. Consultez FIPSMQ pour en savoir plus.
Séparation des tâches. Organisez l'administration des vhosts et des utilisateurs de sorte qu'aucun compte ne puisse à la fois approuver et déployer une modification de policy touchant un flux financier. Le modèle d'utilisateurs et de tags par vhost décrit plus haut vous en donne le mécanisme ; l'attribution des tags est une décision que la conformité doit prendre conjointement avec l'ingénierie plateforme.
Preuves de changement. Les environnements réglementés doivent généralement démontrer précisément ce qui a changé sur un broker de production, quand et par qui. Associer la policy-as-code (policies sous contrôle de version, appliquées via la CI) à la journalisation d'audit ci-dessus vous fournit à la fois l'historique des changements et la piste d'approbation que demandent les auditeurs.
Avant que la première charge de travail de production ne se connecte, vérifiez que :
le cluster compte trois nœuds (ou un autre nombre impair), un par AZ
cluster_partition_handling est réglé sur pause_minority
le type de chaque file d'attente (quorum, classique ou stream) résulte d'un choix délibéré
les vhosts sont structurés par domaine métier, et non en un namespace partagé unique
une convention de nommage des files d'attente et des exchanges est documentée et appliquée
TLS est activé sur 5671 ; le port 5672 en clair est désactivé ou filtré par pare-feu
l'utilisateur guest est supprimé ou restreint
chaque service dispose de ses propres identifiants, limités à son vhost et à ses permissions
l'interface de gestion n'est pas accessible depuis l'internet public
vm_memory_high_watermark et disk_free_limit sont définis explicitement
le prefetch consommateur est défini délibérément pour chaque charge de travail
le plugin Prometheus est activé et les six métriques d'alerte sont reliées au monitoring
les journaux sont expédiés vers un stockage central, et non sur le disque local du broker
la compatibilité des versions RabbitMQ et Erlang est confirmée et la période de support documentée
Pour les schémas de montée en charge, la topologie multicluster et le choix entre fédération et Shovel pour les déploiements multirégion, poursuivez avec concevoir pour la montée en charge future. Pour les équipes qui exploitent Kubernetes, nos travaux de stabilisation critique sur Kubernetes couvrent les aspects propres à l'opérateur que cette référence générale n'aborde pas.
Si vous souhaitez un regard extérieur sur cette architecture avant sa mise en production, AceMQ réalise des revues d'architecture RabbitMQ dans le cadre de ses missions de support. Nous sommes le seul partenaire MSP RabbitMQ désigné par Broadcom et lauréat du Tanzu Partner of the Year 2025, avec une ligne directe vers l'équipe principale (core team) de RabbitMQ et plus de 160+ clients grands comptes dans plus de 26+ pays. Consultez la page RabbitMQ pour une vue d'ensemble, ou contactez-nous directement.
Questions fréquentes
Quelle architecture RabbitMQ assure la haute disponibilité ?
Un cluster de trois nœuds, un par zone de disponibilité, avec des quorum queues et cluster_partition_handling réglé sur pause_minority, constitue le socle standard de haute disponibilité. Depuis RabbitMQ 4.3, ce réglage ne s'applique plus : la 4.3.0 a supprimé Mnesia et, avec lui, les stratégies de gestion des partitions ; cluster_partition_handling est toujours accepté mais n'a aucun effet, et seule la règle de majorité Raft détermine quel côté continue de servir. Supprimez la clé lors de la mise à niveau. Les quorum queues répliquent l'état des files entre les nœuds par consensus Raft : la perte d'un nœud (ou d'une zone de disponibilité entière) laisse donc toujours une majorité disponible pour servir le trafic et élire automatiquement de nouveaux leaders de file. Les files classiques en miroir, l'ancien mécanisme de haute disponibilité, ont été supprimées dans RabbitMQ 4.x : les quorum queues sont désormais la voie prise en charge pour la haute disponibilité. Pour les calculs de nombre de nœuds et de débit sous-jacents, consultez notre guide de dimensionnement HA et PRA.
Combien de nœuds RabbitMQ faut-il exploiter ?
Trois nœuds sont le point de départ standard en production, répartis à raison d'un par zone de disponibilité, avec un nombre total impair. Les nombres impairs évitent les égalités de type split-brain lors des partitions réseau, et trois est le minimum qui tolère la panne d'un nœud ou d'une zone de disponibilité tout en conservant une majorité de quorum. Un cluster à deux nœuds est pire qu'un nœud unique, puisque la perte de l'un ou l'autre supprime entièrement la disponibilité de la majorité. Aller au-delà de trois nœuds est une décision liée au débit et à la charge de travail, traitée dans notre guide de dimensionnement des clusters ; ce n'est pas une valeur par défaut pour un premier déploiement.
Faut-il choisir les quorum queues pour la haute disponibilité ?
Oui : pour toute charge de travail ayant une exigence de durabilité ou de disponibilité, les quorum queues sont aujourd'hui le choix par défaut recommandé. Elles s'appuient sur une réplication fondée sur Raft entre les nœuds du cluster, survivent à la perte d'une minorité de nœuds sans intervention manuelle et constituent le type de file haute disponibilité activement développé par RabbitMQ pour l'avenir. Les files classiques en miroir, l'ancien mécanisme de haute disponibilité, ont été entièrement supprimées dans RabbitMQ 4.0 : toute équipe qui les prévoit encore bâtit sur une voie obsolète. Les files classiques (sans miroir) restent pertinentes pour du trafic de faible valeur ou qui tolère un nœud unique. Consultez notre comparatif files classiques ou quorum queues pour l'ensemble des critères de décision.
Quelle configuration de cluster RabbitMQ recommander pour une entreprise ?
Trois nœuds au minimum, un par zone de disponibilité, un nombre impair de nœuds, les quorum queues comme type de file par défaut et la gestion des partitions en pause_minority. (Depuis la 4.3, retirez le paramètre de partition : les stratégies ont été supprimées et la clé n'a aucun effet.) Ajoutez par-dessus une isolation avec un vhost par domaine métier, des conventions de nommage appliquées aux files et aux exchanges, et des policies (plutôt que des arguments applicatifs file par file) pour piloter le comportement des files comme le TTL et la longueur maximale. Ajoutez dès le départ TLS sur le port 5671, des garde-fous explicites sur la mémoire et le disque, et une supervision fondée sur Prometheus couvrant les six métriques essentielles : profondeur des files, utilisation des consommateurs, mémoire des nœuds, utilisation des descripteurs de fichiers, messages non acquittés et état des partitions.
Un partenaire RabbitMQ peut-il examiner notre architecture ?
Oui. AceMQ examine les architectures RabbitMQ dans le cadre de ses missions de support et de conseil : topologie du cluster, conception des files et des vhosts, posture de sécurité et préparation aux mises à niveau, au regard des schémas décrits dans ce guide. En tant que seul partenaire MSP RabbitMQ désigné par Broadcom, avec une ligne directe vers l'équipe principale (core team) de RabbitMQ, AceMQ accompagne des entreprises qui exploitent aussi bien la 3.8.x que les versions 4.x actuelles, avec des objectifs de réponse à partir de 15 minutes, selon le plan, sur les contrats de support. Contactez-nous ou parcourez le hub RabbitMQ pour connaître tout le périmètre d'une revue.
Faut-il un cluster distinct par environnement ?
Oui. Utilisez des clusters RabbitMQ entièrement distincts pour la production, la préproduction et le développement, plutôt que de les séparer par vhost au sein d'un même cluster. Les vhosts sont le bon outil pour isoler des domaines métier au sein d'un environnement ; ils ne remplacent pas une séparation physique ou logique des clusters entre environnements, car une policy mal configurée, un épuisement des ressources ou une mise à niveau ratée dans un cluster partagé peuvent affecter le trafic de production, quelles que soient les frontières des vhosts. Cela garde aussi les tests de mise à niveau honnêtes : la préproduction doit être un cluster réellement distinct que vous pouvez casser sans conséquence, et non un vhost qui partage l'infrastructure de la production.
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.