5.1 Comando docker compose down
O comando docker compose down
é usado pra parar e remover todos os recursos criados pelo comando docker compose up
. Isso inclui parar os containers, remover redes e volumes (se especificado), e também remover imagens (opcionalmente). Nesta aula, vamos dar uma olhada detalhada em como usar o comando docker compose down
, seus principais parâmetros e boas práticas.
Principais funcionalidades do comando docker compose down
- Parar containers: todos os containers iniciados com
docker compose up
serão parados. - Remover containers: os containers parados serão removidos.
- Remover redes: as redes criadas pelo Docker Compose pra conexão entre containers serão removidas.
- Remover volumes: você pode opcionalmente remover os volumes usados pelos containers.
- Remover imagens: é opcional remover as imagens usadas pra criar os containers.
Sintaxe do comando docker compose down
docker compose down [options]
Onde:
-
[options]
: parâmetros adicionais pra configurar o comportamento do comando. Por exemplo:-
--volumes
: remove os volumes usados pelos containers. -
--rmi all
: remove todas as imagens associadas ao projeto. -
--rmi local
: remove apenas imagens locais, que não foram puxadas do registro.
-
5.2 Exemplos do comando docker compose down
Exemplos de uso do comando docker compose down
:
1. Parar e deletar todos os recursos
Para parar e deletar todos os recursos criados pelo comando docker compose up
, use o comando:
docker compose down
2. Deletar volumes
Para deletar volumes usados pelos containers, adicione a opção --volumes
:
docker compose down --volumes
3. Deletar imagens
Para deletar as imagens usadas na criação de containers, adicione a opção --rmi
com um dos seguintes valores:
all
: deletar todas as imagens usadas pelo projeto.local
: deletar apenas as imagens construídas localmente.
docker compose down --rmi all
5.3 Parâmetros do comando docker compose down
Parâmetros úteis do comando docker compose down
:
1. Parâmetros -v
, --volumes
Os parâmetros -v
e --volumes
removem todos os volumes criados e usados pelos serviços. Use com cuidado, pois isso levará à exclusão de todos os dados armazenados nesses volumes.
docker compose down --volumes
2. Parâmetro --rmi
O parâmetro --rmi
remove as imagens usadas para criar os containers. Os valores suportados são:
all
: remove todas as imagens usadas pelo projeto.local
: remove apenas as imagens construídas localmente.
docker compose down --rmi all
3. Parâmetro --remove-orphans
O parâmetro --remove-orphans
remove containers que não estão definidos no arquivo compose.yaml
atual, mas foram criados por execuções anteriores do Docker Compose.
docker compose down --remove-orphans
5.4 Recomendações práticas
1. Usando o parâmetro --volumes
com cuidado
Remover volumes com a opção --volumes
vai causar perda de todos os dados armazenados nesses volumes. Certifique-se de que realmente quer apagar esses dados antes de usar essa opção.
2. Limpando imagens desnecessárias
Usar o parâmetro --rmi all
é útil pra limpar todas as imagens e liberar espaço no disco. Mas tome cuidado pra não apagar imagens que podem ser necessárias no futuro.
3. Automatizando a limpeza
Você pode incluir o comando docker compose down
em scripts de automação ou em pipelines de CI/CD pra limpar recursos automaticamente depois que os testes ou deploys forem concluídos.
GO TO FULL VERSION