minor typos and punctuation.
Signed-off-by: Alan Thompson <cloojure@gmail.com>
(cherry picked from commit 68b8cc9735e9f966dd0e7b3b2d56835310100c2a)
Signed-off-by: Tibor Vass <tibor@docker.com>
| ... | ... |
@@ -38,8 +38,8 @@ network driver you can specify that `DRIVER` here also. If you don't specify the |
| 38 | 38 |
`--driver` option, the command automatically creates a `bridge` network for you. |
| 39 | 39 |
When you install Docker Engine it creates a `bridge` network automatically. This |
| 40 | 40 |
network corresponds to the `docker0` bridge that Engine has traditionally relied |
| 41 |
-on. When launch a new container with `docker run` it automatically connects to |
|
| 42 |
-this bridge network. You cannot remove this default bridge network but you can |
|
| 41 |
+on. When you launch a new container with `docker run` it automatically connects to |
|
| 42 |
+this bridge network. You cannot remove this default bridge network, but you can |
|
| 43 | 43 |
create new ones using the `network create` command. |
| 44 | 44 |
|
| 45 | 45 |
```bash |
| ... | ... |
@@ -48,7 +48,7 @@ $ docker network create -d bridge my-bridge-network |
| 48 | 48 |
|
| 49 | 49 |
Bridge networks are isolated networks on a single Engine installation. If you |
| 50 | 50 |
want to create a network that spans multiple Docker hosts each running an |
| 51 |
-Engine, you must create an `overlay` network. Unlike `bridge` networks overlay |
|
| 51 |
+Engine, you must create an `overlay` network. Unlike `bridge` networks, overlay |
|
| 52 | 52 |
networks require some pre-existing conditions before you can create one. These |
| 53 | 53 |
conditions are: |
| 54 | 54 |
|
| ... | ... |
@@ -65,9 +65,9 @@ The `dockerd` options that support the `overlay` network are: |
| 65 | 65 |
To read more about these options and how to configure them, see ["*Get started |
| 66 | 66 |
with multi-host network*"](../../userguide/networking/get-started-overlay.md). |
| 67 | 67 |
|
| 68 |
-It is also a good idea, though not required, that you install Docker Swarm on to |
|
| 68 |
+While not required, it is a good idea to install Docker Swarm to |
|
| 69 | 69 |
manage the cluster that makes up your network. Swarm provides sophisticated |
| 70 |
-discovery and server management that can assist your implementation. |
|
| 70 |
+discovery and server management tools that can assist your implementation. |
|
| 71 | 71 |
|
| 72 | 72 |
Once you have prepared the `overlay` network prerequisites you simply choose a |
| 73 | 73 |
Docker host in the cluster and issue the following to create the network: |
| ... | ... |
@@ -82,15 +82,15 @@ name conflicts. |
| 82 | 82 |
|
| 83 | 83 |
## Connect containers |
| 84 | 84 |
|
| 85 |
-When you start a container use the `--net` flag to connect it to a network. |
|
| 86 |
-This adds the `busybox` container to the `mynet` network. |
|
| 85 |
+When you start a container, use the `--net` flag to connect it to a network. |
|
| 86 |
+This example adds the `busybox` container to the `mynet` network: |
|
| 87 | 87 |
|
| 88 | 88 |
```bash |
| 89 | 89 |
$ docker run -itd --net=mynet busybox |
| 90 | 90 |
``` |
| 91 | 91 |
|
| 92 | 92 |
If you want to add a container to a network after the container is already |
| 93 |
-running use the `docker network connect` subcommand. |
|
| 93 |
+running, use the `docker network connect` subcommand. |
|
| 94 | 94 |
|
| 95 | 95 |
You can connect multiple containers to the same network. Once connected, the |
| 96 | 96 |
containers can communicate using only another container's IP address or name. |