docker network prune

O comando docker network prune é usado para remover todas as redes não utilizadas do Docker. Redes não utilizadas são aquelas que não estão conectadas a nenhum container ativo. Esse comando é útil para liberar recursos e manter a limpeza do ambiente Docker.

Sintaxe

docker network prune [OPTIONS]

Opções Comuns

• -f, --force: Executa a remoção das redes sem solicitar confirmação do usuário.

• --filter: Permite filtrar as redes que serão removidas com base em determinadas condições, como labels.

Funcionamento

• Redes removidas: O comando remove apenas as redes que não estão sendo usadas por nenhum container ativo. Isso inclui redes criadas manualmente que não têm containers conectados, assim como redes bridge e overlay não utilizadas.

• Redes preservadas: Redes padrão como bridge, host, e none não são removidas, independentemente de estarem em uso ou não.

Exemplo de Uso

1. Remover Todas as Redes Não Utilizadas:

   docker network prune

   Ao executar este comando, o Docker solicitará confirmação antes de remover as redes não utilizadas. Isso ajuda a garantir que você não remova acidentalmente redes importantes.

2. Forçar a Remoção sem Confirmação:

   docker network prune --force

   Aqui, as redes não utilizadas serão removidas imediatamente, sem qualquer confirmação.

3. Remover Redes com Filtros Específicos:

   docker network prune --filter "label!=keep"

   Este comando remove todas as redes não utilizadas que não tenham o label keep, permitindo um controle mais granular sobre o que é removido.

Notas Importantes

• Cuidado com a remoção: Antes de usar docker network prune, certifique-se de que as redes que serão removidas realmente não são necessárias, pois a remoção é permanente.

• Recomendações de uso: Esse comando é especialmente útil em ambientes de desenvolvimento ou teste onde muitas redes temporárias podem ser criadas e esquecidas.

Exemplo de Documentação

## Limpando Redes Não Utilizadas com `docker network prune`

O comando `docker network prune` remove todas as redes Docker que não estão conectadas a nenhum container ativo, ajudando a manter o ambiente Docker limpo e eficiente.

### Exemplo Básico: Remover Redes Não Utilizadas

Para remover todas as redes que não estão em uso:

```bash
docker network prune

Este comando solicitará confirmação antes de remover as redes.

Forçando a Remoção Sem Confirmação

Se você deseja evitar a solicitação de confirmação e remover as redes imediatamente:

docker network prune --force

Uso de Filtros para Remover Redes Específicas

Para remover apenas redes não utilizadas que não tenham um label específico:

docker network prune --filter "label!=keep"

Considerações

O uso do docker network prune é recomendado para a manutenção regular do ambiente Docker, especialmente em sistemas onde muitas redes temporárias são criadas.

Essa estrutura pode ser usada para documentar o comando `docker network prune` na sua documentação Docker.