Instalando Docker Compose no Linux: Guia Completo

Instalando Docker Compose no seu sistema Linux é uma etapa essencial para orquestrar múltiplos contêineres de forma mais simples e automatizada. Docker Compose é uma ferramenta que permite definir e executar aplicativos multicontêiner a partir de um único arquivo YAML, tornando o gerenciamento de ambientes complexos muito mais fácil e eficiente.

Consulte a documentação oficial do Docker para mais detalhes: https://docs.docker.com/compose/install/linux.

❓ O que é Docker Compose e por que usar?

O Docker Compose é um utilitário oficial do Docker usado para definir e executar aplicativos de vários contêineres. Ele permite declarar todos os serviços necessários (como bancos de dados, aplicações web, filas de mensagens etc.) em um único arquivo docker-compose.yml. Isso facilita a orquestração de ambientes de desenvolvimento ou testes, substituindo a necessidade de executar múltiplos comandos docker run manualmente. Com o Docker Compose, você pode iniciar todo o ambiente de uma só vez, melhorando a eficiência do seu fluxo de trabalho.

🛠 Como instalar o Docker Compose no Linux

No Linux, o método recomendado atual é usar o Docker Compose V2 como um plugin do Docker Engine. Primeiramente, certifique-se de ter o Docker Engine e a CLI do Docker instalados. Em seguida, você pode instalar o plugin Compose diretamente dos repositórios oficiais. Por exemplo, em distribuições baseadas no Debian/Ubuntu:

sudo apt-get update
sudo apt-get install docker-compose-plugin

Esse comando instala o plugin docker compose (sem traço) que incorpora o Compose à CLI do Docker. Para distribuições RPM (como CentOS/Fedora), use:

sudo yum update
sudo yum install docker-compose-plugin

Após a instalação, verifique se o Docker Compose está disponível executando:

docker compose version

O retorno deverá exibir a versão do Compose, confirmando que a instalação foi concluída com sucesso. Caso prefira instalar manualmente (como alternativa legada), você pode baixar o binário diretamente do repositório do Docker Compose no GitHub e torná-lo executável. No entanto, essa instalação standalone não é recomendada atualmente, sendo mantida apenas por compatibilidade.

🌏 Instalando o Docker Compose no Windows e Mac

Para usuários de Windows e macOS, o modo mais fácil de obter o Docker Compose é instalar o Docker Desktop, que já inclui o Compose integrado. Basta baixar o instalador do Docker Desktop no site oficial e seguir as instruções. No Windows, é necessário usar uma versão compatível (Windows 10/11 Pro ou Enterprise) e habilitar o recurso WSL2 para obter a melhor performance. No macOS, verifique a compatibilidade com sua versão (Intel ou Apple Silicon). Após a instalação, o Docker Compose estará incluído e disponível no terminal.

🔄 Como atualizar o Docker Compose

Como o Docker Compose V2 é instalado via repositório, basta atualizar o sistema normalmente. No Ubuntu/Debian, rode:

sudo apt-get update
sudo apt-get install docker-compose-plugin

No CentOS/Fedora:

sudo yum update
sudo yum install docker-compose-plugin

Isso garantirá que você tenha a versão mais recente do Compose. Se estiver usando o Docker Desktop, verifique se não há atualizações pendentes no próprio aplicativo ou no site oficial do Docker.

🛠 Problemas comuns ao instalar Docker Compose

  • docker: command not found – Certifique-se de que o Docker Engine está instalado e funcionando. Sem o Docker instalado, o Compose não funcionará.
  • Permissão negada – Se instalou manualmente via curl, lembre-se de tornar o arquivo executável com chmod +x. Por exemplo: sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose.
  • Comando não encontrado – Para Compose v2 use docker compose (sem traço). O comando antigo docker-compose refere-se à versão legada. Verifique se não está misturando versões.
  • Problemas de permissão do Docker – Se ao usar Compose aparecer erro de conexão com o daemon, adicione seu usuário ao grupo docker ou rode os comandos com sudo.

🔘 Exemplos de uso do Docker Compose

Segue um exemplo simples de arquivo docker-compose.yml:

version: '3.9'
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"

Com esse arquivo salvo (por exemplo, em compose-demo/docker-compose.yml), você pode iniciar o serviço executando docker compose up -d. O Compose criará o contêiner do Nginx mapeando a porta 8080 do host para a porta 80 do contêiner. Veja o status com docker compose ps e acesse a aplicação via http://localhost:8080.

⚖️ Docker Compose versus outras ferramentas

O Docker Compose é comparável a outras soluções de orquestração de contêineres, mas possui características próprias:

  • Podman Compose: alternativa para usuários de Podman. É leve e integrado ao Podman, mas ainda implementa apenas parte dos recursos do Compose original.
  • Docker Swarm / Docker Stack: o Swarm é o sistema de orquestração nativo do Docker para clusters. O Docker Stack usa arquivos Compose para implantar em Swarm, mas o Compose padrão é usado principalmente para desenvolvimento local ou testes.
  • Kubernetes: o Compose é menos complexo que Kubernetes, sendo ideal para setups locais ou ambientes menores. Em ambientes de produção maiores, Kubernetes ou outras soluções podem ser mais adequadas.

Em resumo, o Docker Compose é uma ferramenta versátil e amplamente utilizada para desenvolvedores criarem ambientes multi-contêiner de forma rápida e consistente.

Para receber as últimas notícias e conteúdos exclusivos, inscreva-se na newsletter.