docker network disconnect

O comando docker network disconnect é utilizado para desconectar um container de uma rede Docker. Isso é útil quando você precisa alterar a configuração de rede de um container sem precisar parar ou remover o container.

Sintaxe

docker network disconnect [OPTIONS] NETWORK CONTAINER

• NETWORK: O nome ou ID da rede da qual você deseja desconectar o container.

• CONTAINER: O nome ou ID do container que você deseja desconectar da rede.

Opções Comuns

• --force: Força a desconexão de um container, mesmo que o container esteja em execução ou que a desconexão possa interromper as comunicações em andamento.

Exemplos

1. Desconectar um Container de uma Rede:

   docker network disconnect my_network my_container

   Neste exemplo, o container my_container será desconectado da rede my_network.

2. Forçar a Desconexão de um Container:

   docker network disconnect --force my_network my_container

   Aqui, o container my_container será forçadamente desconectado da rede my_network, mesmo que isso interrompa as comunicações em andamento.

Notas Importantes

• Se o container estiver conectado a várias redes, ele permanecerá conectado às outras redes após a execução do comando docker network disconnect.

• Desconectar um container de uma rede não o para, apenas remove sua capacidade de se comunicar com outros containers ou serviços na rede desconectada.

• Se você desconectar o container da última rede à qual ele está conectado, ele não terá mais conectividade de rede.

Verificando Conexões de Rede

Para verificar de quais redes um container está conectado, use o comando:

docker inspect --format '{{json .NetworkSettings.Networks}}' CONTAINER

Isso exibirá uma lista das redes às quais o container está atualmente conectado.

Exemplo de Documentação

## Desconectando um Container de uma Rede

O comando `docker network disconnect` permite que você desconecte um container de uma rede Docker sem parar o container.

### Exemplo Básico

Desconectar um container chamado `web` da rede `frontend`:

```bash
docker network disconnect frontend web

Após a execução deste comando, o container web será removido da rede frontend, perdendo sua capacidade de se comunicar com outros containers nessa rede.

Forçando a Desconexão

Se você precisar forçar a desconexão, mesmo que o container esteja em execução e possa interromper comunicações:

docker network disconnect --force backend db

Aqui, o container db será forçado a se desconectar da rede backend.

Verificando as Conexões

Para verificar as redes às quais um container está conectado:

docker inspect --format '{{json .NetworkSettings.Networks}}' web

Isso exibirá todas as redes conectadas ao container web.

Essa estrutura pode ser utilizada para documentar o comando `docker network disconnect` na sua documentação do Docker.