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 upserã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