Guide Complet pour Déployer un Conteneur RabbitMQ avec Docker Compose

Apprenez à déployer RabbitMQ avec Docker Compose et à configurer un fichier de configuration personnalisé pour optimiser son utilisation.

Étape 1 : Installation de Docker et Docker Compose

Avant de commencer, assurez-vous que Docker et Docker Compose sont bien installés sur votre machine. Vous pouvez les télécharger depuis le site officiel de Docker.

Étape 2 : Création du Fichier Docker Compose

Créez un fichier nommé docker-compose.yml et ajoutez-y la configuration suivante :

version: '3'

services:

  rabbitmq:
    image: rabbitmq:3.12-management-alpine
    container_name: 'rabbitmq_api_client'
    volumes:
      - ./rabbitmq/rabbitmq.conf:/etc/rabbitmq/rabbitmq.conf
    environment:
      - RABBITMQ_DEFAULT_USER=user
      - RABBITMQ_DEFAULT_PASS=password
      - RABBITMQ_CONFIG_FILE=/etc/rabbitmq/rabbitmq.conf
    ports:
      - 5672:5672
      - 15672:15672

Cette configuration va créer un conteneur Docker nommé rabbitmq_api_client basé sur l’image rabbitmq:3.12-management-alpine. Le conteneur expose le port 5672 pour les connexions AMQP et le port 15672 pour l’interface de gestion RabbitMQ. Le fichier de configuration personnalisé est monté pour permettre une personnalisation complète de RabbitMQ.

Explications des principaux éléments de la configuration :

• Volume : Le fichier ./rabbitmq/rabbitmq.conf sur votre machine est lié à /etc/rabbitmq/rabbitmq.conf dans le conteneur. Ce volume permet de charger un fichier de configuration personnalisé pour RabbitMQ.
• Variables d’environnement :
  • RABBITMQ_DEFAULT_USER : Nom d’utilisateur par défaut pour accéder à l’interface de gestion.
  • RABBITMQ_DEFAULT_PASS : Mot de passe pour l’accès.
  • RABBITMQ_CONFIG_FILE : Chemin du fichier de configuration personnalisé à utiliser dans le conteneur.

Étape 3 : Création du Fichier de Configuration de RabbitMQ

Créez un répertoire nommé rabbitmq au même emplacement que votre fichier docker-compose.yml. Dans ce répertoire, créez un fichier nommé rabbitmq.conf pour personnaliser RabbitMQ.

Étape 4 : Personnalisation du Fichier rabbitmq.conf (Facultatif)

Dans le fichier rabbitmq.conf, ajoutez des paramètres de configuration adaptés à vos besoins. Par exemple :

vm_memory_high_watermark.absolute = 2GB

Ce paramètre fixe la limite de mémoire de RabbitMQ à 2 Go. Pour plus de paramètres, consultez la documentation officielle de RabbitMQ.

Étape 5 : Lancer RabbitMQ avec Docker Compose

Ouvrez un terminal, naviguez jusqu’au répertoire contenant docker-compose.yml et exécutez la commande suivante :

docker-compose up

Cette commande télécharge l’image Docker de RabbitMQ, crée le conteneur et démarre RabbitMQ en arrière-plan. Les logs affichés indiqueront si le fichier de configuration a bien été chargé.

Pour accéder à l’interface de gestion, ouvrez un navigateur et rendez-vous à l’adresse http://localhost:15672. Connectez-vous avec les identifiants définis dans le fichier Docker Compose (user et password).

RabbitMQ est maintenant prêt pour une connexion AMQP via localhost:5672 en utilisant les identifiants spécifiés.

Félicitations !

Vous avez déployé avec succès un conteneur RabbitMQ via Docker Compose ! Vous pouvez désormais personnaliser davantage votre configuration en modifiant les fichiers docker-compose.yml et rabbitmq.conf selon vos besoins.