author | Jesse Butler <jesse.butler@oracle.com> |
Wed, 20 Jul 2016 17:19:20 -0700 | |
changeset 6468 | af5d82385cd7 |
permissions | -rw-r--r-- |
6468
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
1 |
.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "OCT 2015" "" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
2 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
3 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
4 |
.SH NAME |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
5 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
6 |
docker\-network\-connect \- connect a container to a network |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
7 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
8 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
9 |
.SH SYNOPSIS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
10 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
11 |
\fBdocker network connect\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
12 |
[\fB\-\-help\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
13 |
NETWORK CONTAINER |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
14 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
15 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
16 |
.SH DESCRIPTION |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
17 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
18 |
Connects a container to a network. You can connect a container by name |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
19 |
or by ID. Once connected, the container can communicate with other containers in |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
20 |
the same network. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
21 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
22 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
23 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
24 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
25 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
26 |
$ docker network connect multi\-host\-network container1 |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
27 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
28 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
29 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
30 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
31 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
32 |
You can also use the \fB\fCdocker run \-\-net=<network\-name>\fR option to start a container and immediately connect it to a network. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
33 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
34 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
35 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
36 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
37 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
38 |
$ docker run \-itd \-\-net=multi\-host\-network \-\-ip 172.20.88.22 \-\-ip6 2001:db8::8822 busybox |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
39 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
40 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
41 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
42 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
43 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
44 |
You can pause, restart, and stop containers that are connected to a network. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
45 |
Paused containers remain connected and can be revealed by a \fB\fCnetwork inspect\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
46 |
When the container is stopped, it does not appear on the network until you restart |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
47 |
it. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
48 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
49 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
50 |
If specified, the container's IP address(es) is reapplied when a stopped |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
51 |
container is restarted. If the IP address is no longer available, the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
52 |
fails to start. One way to guarantee that the IP address is available is |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
53 |
to specify an \fB\fC\-\-ip\-range\fR when creating the network, and choose the static IP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
54 |
address(es) from outside that range. This ensures that the IP address is not |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
55 |
given to another container while this container is not on the network. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
56 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
57 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
58 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
59 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
60 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
61 |
$ docker network create \-\-subnet 172.20.0.0/16 \-\-ip\-range 172.20.240.0/20 multi\-host\-network |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
62 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
63 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
64 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
65 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
66 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
67 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
68 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
69 |
.nf |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
70 |
$ docker network connect \-\-ip 172.20.128.2 multi\-host\-network container2 |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
71 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
72 |
.fi |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
73 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
74 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
75 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
76 |
To verify the container is connected, use the \fB\fCdocker network inspect\fR command. Use \fB\fCdocker network disconnect\fR to remove a container from the network. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
77 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
78 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
79 |
Once connected in network, containers can communicate using only another |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
80 |
container's IP address or name. For \fB\fCoverlay\fR networks or custom plugins that |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
81 |
support multi\-host connectivity, containers connected to the same multi\-host |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
82 |
network but launched from different Engines can also communicate in this way. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
83 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
84 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
85 |
You can connect a container to one or more networks. The networks need not be the same type. For example, you can connect a single container bridge and overlay networks. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
86 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
87 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
88 |
.SH OPTIONS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
89 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
90 |
\fBNETWORK\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
91 |
Specify network name |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
92 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
93 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
94 |
\fBCONTAINER\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
95 |
Specify container name |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
96 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
97 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
98 |
\fB\-\-help\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
99 |
Print usage statement |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
100 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
101 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
102 |
.SH HISTORY |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
103 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
104 |
OCT 2015, created by Mary Anthony |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
105 |
\[la][email protected]\[ra] |