RabbitMQ en Docker: colas, confirmaciones y persistencia

RabbitMQ permite desacoplar productores y consumidores mediante colas y otros patrones de mensajería. Ejecutarlo en Docker facilita una práctica local, pero la entrega confiable depende de configuración y comportamiento de las aplicaciones.

Este laboratorio publica puertos únicamente en loopback y utiliza credenciales propias. No se plantea como clúster disponible ante fallos.

Prepara credenciales de práctica

Define RABBITMQ_DEFAULT_PASS en tu sesión mediante un método privado, sin incluir una contraseña real en un tutorial o repositorio. El usuario del ejemplo es lab.

Las variables de entorno del contenedor pueden ser accesibles a quienes administran Docker. Para otros entornos, utiliza el mecanismo de configuración y secretos apropiado y limita quién controla el daemon.

Inicia el servicio

docker volume create rabbitmq_lab_data
docker run -d --name rabbitmq-lab \
  -p 127.0.0.1:5672:5672 \
  -p 127.0.0.1:15672:15672 \
  -e RABBITMQ_DEFAULT_USER=lab \
  -e RABBITMQ_DEFAULT_PASS="${RABBITMQ_DEFAULT_PASS:?Define la clave de laboratorio}" \
  -v rabbitmq_lab_data:/var/lib/rabbitmq \
  rabbitmq:4-management
docker logs --tail 50 rabbitmq-lab

Revisa soporte y arquitectura de la etiqueta elegida y registra la versión utilizada. Si la variable de contraseña no está definida, corrige la preparación en lugar de arrancar con un valor vacío.

Comprueba el broker y el panel

docker exec rabbitmq-lab rabbitmq-diagnostics -q ping

Accede al panel local y revisa conexiones, canales y colas. La salud del proceso no comprueba toda la ruta de una aplicación.

Para servicios reales, separa usuario administrativo de cuentas con permisos por vhost y recursos. No compartas una cuenta con control total para todos los productores.

Productor y consumidor de prueba

Sigue el tutorial oficial de tu cliente para declarar una cola y enviar mensajes ficticios. Mantén coherentes las propiedades al declarar la misma cola desde varios procesos.

Comprueba que un consumidor recibe y procesa el mensaje antes de confirmarlo. Si confirma demasiado pronto y después falla, el trabajo puede perderse desde la perspectiva de la aplicación.

Persistencia no es una sola casilla

Una cola durable, mensajes persistentes, confirmaciones del publicador y acknowledgements del consumidor resuelven aspectos diferentes. El volumen conserva datos del broker, pero no corrige una aplicación que confirma operaciones antes de terminarlas.

Diseña consumidores capaces de manejar reentregas. Un fallo de conexión puede dejar incertidumbre sobre si un mensaje se publicó o procesó; no prometas “exactamente una vez” sin un diseño que lo sustente.

Prueba fallos deliberados

En laboratorio, detén un consumidor antes de confirmar y observa qué ocurre. Reinicia el broker y verifica qué mensajes y colas se conservan según la configuración.

Revisa políticas de reintento y mensajes fallidos para evitar bucles infinitos. Define un límite y una vía de diagnóstico para trabajo que no puede completarse.

Mantenimiento y retirada

Vigila disco, memoria y acumulación de mensajes. Un broker accesible puede estar bloqueando publicadores por recursos.

Antes de borrar volúmenes, decide qué datos deben conservarse y cómo migrarlos. Cambiar credenciales de inicialización no modifica automáticamente usuarios de una base ya creada.

Preguntas frecuentes

¿Una cola durable hace persistente cualquier mensaje?

No. Debes revisar también propiedades de publicación y confirmaciones. Son decisiones diferentes.

¿Puedo confirmar antes de procesar para ir más rápido?

Eso cambia la garantía de recuperación ante fallos. Confirma según el resultado que realmente puedas sostener.

¿Un mensaje puede llegar más de una vez?

Sí en determinados escenarios. Diseña idempotencia o controles adecuados en el consumidor.

En pocas palabras

RabbitMQ entrega mensajes mediante mecanismos que la aplicación debe configurar y comprobar. Una cola durable y un volumen no garantizan por sí solos que cada trabajo se procese exactamente una vez.

Conclusión

Prueba fallos del consumidor y reinicios del broker con mensajes ficticios. Documenta reintentos, confirmaciones y comportamiento duplicado antes de integrar trabajo importante.

Para continuar, revisa Docker: qué es y cómo usarlo para ejecutar contenedores y Cómo instalar Docker en Ubuntu 24.04: guía práctica paso a paso.

Fuentes y documentación

Documentación de www.rabbitmq.com.

Documentación de www.rabbitmq.com.