O RabbitMQ continua a ser um dos message brokers mais populares no ecossistema moderno, especialmente em arquiteturas distribuídas e sistemas orientados a eventos. A sua leveza, estabilidade e suporte ao protocolo AMQP tornam-no uma escolha sólida tanto para desenvolvimento como para produção. Neste artigo, vamos explorar duas formas de o instalar: primeiro usando Docker, que é a abordagem mais rápida e que recomendo, e depois através de uma instalação local tradicional caso não seja possível configurar o container com docker.
🐳 Instalar RabbitMQ com Docker
A instalação via Docker é a forma mais prática de levantar rapidamente um ambiente funcional. O Docker isola o RabbitMQ do resto do sistema, evita conflitos de versões e permite criar e destruir ambientes com um único comando.
Antes de podermos correr o RabbitMQ num container, precisamos de garantir que o Docker está instalado. No Windows e no macOS, o processo é bastante simples: basta instalar o Docker Desktop, que inclui tudo o que é necessário. Depois da instalação, podes confirmar que o Docker está operacional abrindo um terminal e executando docker --version. Se aparecer a versão instalada, estás pronto para avançar.
No Linux, o processo envolve instalar o Docker Engine diretamente. Depois de atualizares os pacotes do sistema, adicionas o repositório oficial do Docker e instalas o motor principal. Tal como nos outros sistemas, confirmar a instalação é tão simples quanto correr docker --version.
Com o Docker instalado, levantar o RabbitMQ torna-se quase trivial. Basta executar um comando que cria um container com o RabbitMQ e o seu painel de administração incluído:
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management
Este comando arranca um container em background, expõe a porta 5672 — usada pelas aplicações para comunicar via AMQP — e a porta 15672, que dá acesso ao painel web de administração. Assim que o container estiver a correr, podes confirmar o seu estado com docker ps e aceder ao painel através de http://localhost:15672. As credenciais por defeito são simplesmente guest / guest.
Uma das grandes vantagens do Docker é a facilidade com que podes limpar o ambiente. Se quiseres parar o RabbitMQ, basta correres docker stop rabbitmq, e se quiseres removê-lo completamente, docker rm rabbitmq faz o trabalho. Esta abordagem é perfeita para desenvolvimento, testes rápidos ou pipelines de CI/CD.
🖥️ Instalação Local do RabbitMQ (Windows)
A instalação local do RabbitMQ é uma excelente opção quando precisas de um serviço permanente, integrado no sistema operativo e sem depender de containers. É também a abordagem mais comum em servidores de produção. O processo envolve três passos principais: instalar o Erlang, instalar o RabbitMQ e ativar o painel de administração.
1) Instalar o Erlang
O RabbitMQ depende diretamente do Erlang OTP, por isso este é sempre o primeiro componente a instalar. A versão do Erlang deve ser compatível com a versão do RabbitMQ, e a página oficial mantém sempre uma tabela atualizada de compatibilidade.
No Windows, o processo é bastante simples. Começa por descarregar o instalador oficial do Erlang a partir da página da Erlang Solutions:
Depois de descarregar o instalador .exe, basta executá‑lo e seguir os passos normais. Quando a instalação terminar, convém garantir que o Erlang está acessível no terminal. Para isso, adiciona a localização da pasta bin do erlang ao path (algo deste género):
C:\Program Files\Erlang OTP\erl-26.2\bin
2) Instalar o RabbitMQ
Com o Erlang instalado, podemos avançar para o RabbitMQ. Tal como antes, a página oficial disponibiliza instaladores e pacotes para todas as plataformas.
No Windows, descarrega o instalador oficial. O instalador .exe trata de tudo automaticamente. Depois da instalação, podes verificar o estado do serviço com o comando abaixo. Se o comando responder com informações sobre o broker, significa que o RabbitMQ está ativo.
rabbitmqctl status
3) Ativar o Management Plugin
Agora que já temos tudo instalado falta agora um pequeno passo. Activar a plataforma web para que possamos ver e monitorizar os channels e as nossas filas. É so correr este comando:
rabbitmq-plugins enable rabbitmq_management
Depois disso, o painel fica disponível em:
http://localhost:15672
User: guest
Password: guest