docker network connect

O comando docker network connect é utilizado para conectar um container a uma rede existente no Docker. Isso permite que um container se comunique com outros containers que estão na mesma rede. Esse comando é útil em cenários onde você deseja modificar a topologia da rede de containers sem precisar reiniciá-los.

Sintaxe

docker network connect [OPTIONS] NETWORK CONTAINER

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

• CONTAINER: O nome ou ID do container que você deseja conectar à rede.

Opções Comuns

• --alias: Define um alias para o container na rede especificada. Isso permite que o container seja acessado por esse nome dentro da rede.

• --ip: Especifica o endereço IP que o container deve usar na rede.

• --ip6: Especifica o endereço IPv6 que o container deve usar na rede.

• --link: Adiciona um link entre dois containers na rede. Um link permite que um container se comunique com outro usando um nome de host.

Exemplos

1. Conectar um Container a uma Rede:

   docker network connect my_network my_container

   Neste exemplo, o container my_container será conectado à rede my_network.

2. Conectar um Container a uma Rede com um Alias:

   docker network connect --alias db_alias my_network my_container

   Aqui, my_container será acessível pelo nome db_alias dentro da rede my_network.

3. Conectar um Container a uma Rede com um Endereço IP Específico:

   docker network connect --ip 192.168.1.100 my_network my_container

   Este comando conecta o container my_container à rede my_network e atribui a ele o endereço IP 192.168.1.100.

Notas Importantes

• Se o container já está conectado a uma rede, você pode conectá-lo a uma nova rede sem desconectá-lo da rede original.

• Use o comando docker network inspect NETWORK para verificar quais containers estão conectados a uma rede específica.

Desconectar um Container de uma Rede

Se você precisar desconectar um container de uma rede, pode usar o comando docker network disconnect:

docker network disconnect NETWORK CONTAINER

Exemplo de Documentação

## Conectando um Container a uma Rede Existente

O comando `docker network connect` permite que você conecte um container a uma rede Docker existente, facilitando a comunicação entre containers.

### Exemplo Básico

Conectar um container chamado `web` à rede `frontend`:

```bash
docker network connect frontend web

Após a execução deste comando, o container web será capaz de se comunicar com outros containers na rede frontend.

Uso Avançado

Para conectar o container db à rede backend com o alias database e endereço IP específico:

docker network connect --alias database --ip 172.18.0.22 backend db

Isso atribui o alias database ao container db dentro da rede backend e força o uso do IP 172.18.0.22.

Verificando a Conexão

Você pode verificar as redes às quais um container está conectado usando o comando:

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

Substitua CONTAINER pelo nome ou ID do container que deseja inspecionar.

Essa estrutura pode ser usada para documentar o comando `docker network connect` no seu projeto de documentação.