Repolode
docker

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. 1

    Instale o Docker Compose no Windows ou macOS pelo Docker Desktop

  2. 2

    No Linux, baixe o binário na página de releases e coloque-o na pasta de plugins da CLI

  3. 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