docker compose up
O comando docker compose up
é utilizado para iniciar, criar, ou reiniciar os serviços definidos em um arquivo docker-compose.yml
. Ele combina a criação dos containers, redes, e volumes especificados no arquivo, além de iniciar os serviços, tudo em um único comando.
Estrutura do Comando
SERVIÇOS: Você pode especificar quais serviços deseja iniciar. Se nenhum serviço for especificado, todos os serviços definidos no
docker-compose.yml
serão iniciados.
Principais Opções
-d
ou--detach
: Executa os containers em segundo plano (modo "detached"). Esse modo é útil quando você não quer que o terminal fique bloqueado pela execução dos containers.--build
: Reconstroi as imagens dos serviços antes de iniciar os containers, útil quando há mudanças noDockerfile
.--force-recreate
: Recria os containers, mesmo que eles não tenham sido alterados.--no-deps
: Inicia o serviço especificado sem iniciar seus serviços dependentes.--remove-orphans
: Remove containers de serviços que não estão mais definidos nodocker-compose.yml
.--scale SERVICE=NUM
: Define o número de instâncias que serão executadas para um serviço específico.
Exemplos
Iniciando todos os serviços em modo "detached":
Iniciando um serviço específico:
Forçando a recriação de todos os containers:
Escalando o serviço
web
para 3 instâncias:
Comportamento
Criação de Containers: Se os containers já existirem, o
docker compose up
tentará iniciá-los. Se eles não existirem, o comando os criará e os iniciará.Rede: Por padrão, uma rede é criada para conectar os containers entre si, permitindo a comunicação via nomes de serviço.
Volumes: Os volumes definidos no
docker-compose.yml
são montados nos containers, permitindo persistência de dados entre reinicializações.Logs: Se o modo "detached" não for usado, os logs dos containers são exibidos no terminal. Você pode interromper a execução pressionando
CTRL+C
.
Finalizando Serviços
Para parar os serviços que foram iniciados pelo comando docker compose up
, você pode utilizar:
Este comando também removerá as redes criadas, mas preservará os volumes e imagens.
Considerações Finais
O comando docker compose up
é ideal para ambientes de desenvolvimento, onde é conveniente iniciar rapidamente todo o ambiente necessário para a aplicação com um único comando. Para ambientes de produção, o uso do -d
é comum, garantindo que os serviços rodem em segundo plano sem bloquear o terminal.
Last updated