docker network rm

O comando docker network rm é usado para remover uma ou mais redes Docker. Esse comando permite que você exclua redes específicas que não estão mais em uso, ajudando a manter o ambiente Docker organizado e livre de recursos desnecessários.

Sintaxe

docker network rm NETWORK [NETWORK...]

• NETWORK: Nome ou ID da rede que você deseja remover. Você pode remover várias redes de uma vez, separando os nomes/IDs por espaços.

Funcionamento

• Remoção de redes conectadas a containers: Uma rede só pode ser removida se nenhum container estiver conectado a ela. Se você tentar remover uma rede que ainda está em uso, o Docker retornará um erro.

• Remoção de múltiplas redes: Se você especificar várias redes e alguma delas não puder ser removida (por estar em uso ou por ser uma rede padrão), o Docker removerá as redes válidas e retornará um erro apenas para aquelas que não puderam ser removidas.

Exemplos

1. Remover uma Rede Específica:

   docker network rm my_network

   Este comando remove a rede chamada my_network. Se ela estiver conectada a qualquer container, o comando falhará.

2. Remover Várias Redes ao Mesmo Tempo:

   docker network rm network1 network2 network3

   Este comando tenta remover network1, network2, e network3. Se alguma dessas redes estiver em uso, o Docker removerá as redes que podem ser removidas e indicará quais não puderam ser excluídas.

3. Remover Todas as Redes Criadas Manualmente:

   docker network rm $(docker network ls -q)

   Esse comando remove todas as redes personalizadas (excluindo as redes padrão como bridge, host, e none). No entanto, qualquer rede em uso não será removida.

Considerações

• Redes padrão: Redes como bridge, host, e none não podem ser removidas usando docker network rm.

• Rede em uso: Se uma rede estiver conectada a algum container, você precisará desconectar ou parar o container antes de remover a rede.

• Erro de remoção: Se uma rede estiver em uso e você tentar removê-la, o Docker emitirá um erro informando que a rede não pôde ser removida.

Exemplo de Documentação

## Removendo Redes Docker com `docker network rm`

O comando `docker network rm` permite que você remova redes Docker que não estão mais em uso, ajudando a manter o ambiente Docker organizado.

### Exemplo Básico: Remover uma Rede

Para remover uma rede chamada `my_network`:

```bash
docker network rm my_network

Se a rede estiver conectada a qualquer container, a remoção falhará.

Remover Múltiplas Redes ao Mesmo Tempo

Você pode remover várias redes especificando seus nomes ou IDs:

docker network rm network1 network2 network3

O Docker tentará remover todas as redes especificadas, ignorando aquelas que não puderem ser removidas.

Removendo Todas as Redes Personalizadas

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

docker network rm $(docker network ls -q)

Este comando remove todas as redes criadas manualmente, exceto as redes padrão (bridge, host, none).

Considerações Importantes

• Redes conectadas a containers não podem ser removidas.

• Redes padrão do Docker não podem ser removidas com este comando.

• Use docker network rm com cuidado, garantindo que as redes a serem removidas não estejam em uso por containers ativos.

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