docker compose down

O comando docker compose down é utilizado para parar e remover os containers, redes, volumes e imagens criados pelo comando docker compose up. Ele é essencial quando você deseja desmontar completamente o ambiente criado por um arquivo docker-compose.yml.

Estrutura do Comando

docker compose down [opções]

Principais Opções

• --rmi [all|local]: Remove as imagens usadas pelos serviços. Existem duas opções:

  • all: Remove todas as imagens, incluindo as baixadas e as criadas localmente.

  • local: Remove apenas as imagens criadas localmente.

• -v ou --volumes: Remove volumes anexados aos serviços. Isso é importante para limpar completamente os dados persistentes, mas use com cuidado, pois os dados armazenados nos volumes serão perdidos.

• --remove-orphans: Remove containers que foram criados, mas não estão mais definidos no arquivo docker-compose.yml.

• --timeout TIMEOUT: Define o tempo limite em segundos para interromper os containers. O padrão é 10 segundos.

Comportamento Padrão

Quando docker compose down é executado sem opções adicionais:

1. Containers: Todos os containers associados aos serviços definidos no arquivo docker-compose.yml são parados e removidos.

2. Redes: As redes criadas pelo comando docker compose up também são removidas, a menos que sejam usadas por outros containers que não foram criados pelo Compose.

3. Volumes: Por padrão, os volumes não são removidos. Eles permanecem para preservar os dados entre execuções. Se você quiser remover os volumes, deve usar a opção -v.

4. Imagens: As imagens utilizadas pelos containers não são removidas, a menos que a opção --rmi seja especificada.

Exemplos

1. Parando e removendo os containers e redes:

   docker compose down

2. Removendo os volumes além dos containers e redes:

   docker compose down -v

3. Removendo também as imagens criadas localmente:

   docker compose down --rmi local

4. Removendo todas as imagens e volumes:

   docker compose down --rmi all -v

5. Removendo containers órfãos:

   docker compose down --remove-orphans

Quando Utilizar

O docker compose down é ideal para desmontar completamente o ambiente de desenvolvimento ou testes, garantindo que todos os recursos (containers, redes, volumes, imagens) sejam removidos. Isso é especialmente útil quando você deseja limpar o sistema de recursos que não são mais necessários, ou quando precisa começar com um ambiente totalmente novo.

Considerações Finais

O comando docker compose down é uma ferramenta poderosa para garantir que nenhum resíduo do ambiente anterior permaneça no sistema. Entretanto, deve-se ter cuidado ao usar as opções que removem volumes ou imagens, especialmente em ambientes onde a persistência de dados é crítica.