docker network connect
描述 | 将容器连接到网络 |
---|---|
用法 | docker network connect [OPTIONS] NETWORK CONTAINER |
描述
将容器连接到网络。可以通过名称或 ID 连接容器。连接后,容器可以与同一网络中的其他容器通信。
选项
选项 | 默认值 | 描述 |
---|---|---|
--alias | 为容器添加网络范围的别名 | |
--driver-opt | 网络的驱动程序选项 | |
--gw-priority | 最高的 gw-priority 提供默认网关。接受正值和负值。 | |
--ip | IPv4 地址 (例如,172.30.100.104 ) | |
--ip6 | IPv6 地址 (例如,2001:db8::33 ) | |
--link | 添加到另一个容器的链接 | |
--link-local-ip | 为容器添加一个 link-local 地址 |
示例
将正在运行的容器连接到网络
$ docker network connect multi-host-network container1
启动容器时将其连接到网络
您也可以使用 docker run --network=<network-name>
选项来启动容器并立即将其连接到网络。
$ docker run -itd --network=multi-host-network busybox
指定容器在给定网络上使用的 IP 地址 (--ip)
您可以指定要分配给容器接口的 IP 地址。
$ docker network connect --ip 10.10.36.122 multi-host-network container2
使用旧的 --link
选项 (--link)
您可以使用 --link
选项将另一个容器与首选别名链接起来。
$ docker network connect --link container1:c1 multi-host-network container2
为容器创建网络别名 (--alias)
可以使用 --alias
选项在要连接的网络中通过另一个名称解析容器。
$ docker network connect --alias db --alias mysql multi-host-network container2
为容器接口设置 sysctls (--driver-opt)
以 net.ipv4.
和 net.ipv6.
开头的 sysctl
设置可以使用 --driver-opt
标签 com.docker.network.endpoint.sysctls
按接口设置。接口的名称必须替换为 IFNAME
。
要为一个接口设置多个 sysctl
,请将 driver-opt
字段的整个值用引号括起来,必要时请记住转义 shell 的引号。例如,如果分配给 my-net
的接口名称是 eth3
,则以下示例设置了 net.ipv4.conf.eth3.log_martians=1
和 net.ipv4.conf.eth3.forwarding=0
。
$ docker network connect --driver-opt=\"com.docker.network.endpoint.sysctls=net.ipv4.conf.IFNAME.log_martians=1,net.ipv4.conf.IFNAME.forwarding=0\" multi-host-network container2
注意
网络驱动程序可能会限制可以修改的 sysctl 设置,为了保护网络的正常运行,将来可能会增加新的限制。
停止、暂停或重启容器对网络的影响
您可以暂停、重启和停止连接到网络的容器。容器在其运行时连接到其配置的网络。
如果指定了 IP 地址,则停止的容器重新启动时会重新应用该容器的 IP 地址。如果 IP 地址不再可用,则容器将无法启动。保证 IP 地址可用的一种方法是在创建网络时指定 --ip-range
,并从该范围之外选择静态 IP 地址。这样可以确保在该容器未连接到网络时,该 IP 地址不会分配给其他容器。
$ docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 multi-host-network
$ docker network connect --ip 172.20.128.2 multi-host-network container2
要验证容器是否已连接,请使用 docker network inspect
命令。使用 docker network disconnect
将容器从网络中移除。
一旦连接到网络,容器只能使用另一个容器的 IP 地址或名称进行通信。对于 overlay
网络或支持多宿主连接的自定义插件,连接到同一多宿主网络但从不同 Engines 启动的容器也可以通过这种方式进行通信。
您可以将一个容器连接到一个或多个网络。这些网络不必是同一种类型。例如,您可以将单个容器连接到 bridge 和 overlay 网络。