Implanta e escala aplicações em containers nos seus próprios hosts Docker por uma rede WireGuard, sem Kubernetes nem Swarm.
docker/compose
Uma ferramenta CLI para definir e executar aplicações Docker com vários containers a partir de um único arquivo Compose.
- Estrelas
- 38,466
- Forks
- 5,883
- Issues abertas
- 103
- Último commit
- há 3 dias
O que é?
O Docker Compose permite descrever em um arquivo YAML, de acordo com a especificação Compose, os containers que compõem uma aplicação, como um servidor web, um banco de dados e um cache. Ao executar `docker compose up`, todos esses serviços são criados e iniciados juntos. Assim, é possível subir uma estrutura com vários serviços usando um único comando, em vez de executar várias chamadas separadas a `docker run`.
O arquivo Compose define como cada container será construído ou baixado, quais portas e volumes usará e como os serviços se conectam entre si. O projeto é escrito em Go e distribuído como um plugin da Docker CLI, então o comando `docker compose` funciona junto com a Docker CLI tradicional. Ele vem incluído no Docker Desktop para Windows e macOS, e há binários independentes disponíveis para Linux.
O README informa que a versão antiga em Python está na branch v1 e que o Docker Swarm não recebe mais atualizações de recursos do Compose, pois é mantido fora da Docker Inc.
Recursos principais
- 01Define aplicações com vários containers em um único arquivo YAML que segue a especificação Compose.
- 02Inicia, para e recria todos os serviços de uma aplicação com um único comando, como `docker compose up`.
- 03Constrói imagens a partir de um Dockerfile ou as baixa de um registry para cada serviço.
- 04Funciona em Windows, macOS e Linux, integrado ao Docker Desktop ou como binários independentes.
Casos de uso
- Executar uma aplicação web junto com seu banco de dados e cache no computador de um desenvolvedor.
- Configurar ambientes locais reproduzíveis para uma equipe usando um arquivo Compose compartilhado.
- Subir as dependências de testes de integração antes da execução de uma suíte de testes.
Início rápido
- 1
Instale o Docker Compose no Windows ou macOS pelo Docker Desktop
- 2
No Linux, baixe o binário na página de releases e coloque-o na pasta de plugins da CLI
- 3
Defina seus serviços em um arquivo compose.yaml e, em seguida, inicie o aplicativo
docker compose up
Antes de usar
- A versão v1 baseada em Python está disponível apenas em uma branch legada.
- Usuários do Docker Swarm talvez não tenham acesso a todos os recursos do Compose.
Em coleções
Tópicos
Perguntas frequentes
- O que é compose?
- Uma ferramenta CLI para definir e executar aplicações Docker com vários containers a partir de um único arquivo Compose. O Docker Compose permite descrever em um arquivo YAML, de acordo com a especificação Compose, os containers que compõem uma aplicação, como um servidor web, um banco de dados e um cache. Ao executar `docker compose up`, todos esses serviços são criados e iniciados juntos. Assim, é possível subir uma estrutura com vários serviços usando um único comando, em vez de executar várias chamadas separadas a `docker run`.
- compose é gratuito? Qual é a licença?
- compose é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- compose ainda é mantido?
- Manutenção ativa. O último commit de compose foi em 22 de out. de 2026.
- Para que posso usar compose?
- Executar uma aplicação web junto com seu banco de dados e cache no computador de um desenvolvedor. Configurar ambientes locais reproduzíveis para uma equipe usando um arquivo Compose compartilhado. Subir as dependências de testes de integração antes da execução de uma suíte de testes.
- Como instalar compose?
- Instale o Docker Compose no Windows ou macOS pelo Docker Desktop No Linux, baixe o binário na página de releases e coloque-o na pasta de plugins da CLI Defina seus serviços em um arquivo compose.yaml e, em seguida, inicie o aplicativo: docker compose up
- Onde consigo compose?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/docker/compose
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Plataforma open source de gerenciamento de contêineres para operar clusters Kubernetes em produção, em diversos ambientes.
Uma CLI e TUI que rastreia qualquer processo, porta, contêiner ou arquivo até a cadeia de sistemas que o iniciou.
Sistema open source para implantar, escalar e gerenciar aplicações em contêineres em vários hosts.
Uma interface web moderna e auto-hospedada para gerenciar contêineres, imagens e stacks do Docker Compose.
Orquestrador de workloads que agenda e executa contêineres, VMs e binários legados em infraestrutura local e na nuvem.