Update network remove --link #215

network/README.md

@@ -1,4 +1,5 @@
 # Docker 中的网络功能介绍
+
 Docker 允许通过外部访问容器或容器互联的方式来提供网络服务。
 
 Docker 在 1.13 版本引进了新的管理命令（management commands），在 Docker 1.13+ 推荐使用 `docker network` 子命令来管理 Docker 网络。

network/linking.md

@@ -1,102 +1,63 @@
 ## 容器互联
+
+如果你之前有 `Docker` 使用经验，你可能已经习惯了使用 `--link` 参数来使容器互联。
+
+随着 Docker 网络的完善，强烈建议大家将容器加入自定义的 Docker 网络来连接多个容器。
+
 容器的连接（linking）系统是除了端口映射外，另一种跟容器中应用交互的方式。
 
 该系统会在源和接收容器之间创建一个隧道，接收容器可以看到源容器指定的信息。
 
-### 自定义容器命名
+### 新建网络
-连接系统依据容器的名称来执行。因此，首先需要自定义一个好记的容器命名。
 
-虽然当创建容器的时候，系统默认会分配一个名字。自定义命名容器有2个好处：
+下面先创建一个新的 Docker 网络。
-* 自定义的命名，比较好记，比如一个web应用容器我们可以给它起名叫web
-* 当要连接其他容器时候，可以作为一个有用的参考点，比如连接web容器到db容器
 
-使用 `--name` 标记可以为容器自定义命名。
 ```bash
-$ docker run -d -P --name web training/webapp python app.py
+$ docker network create -d bridge my-net
 ```
 
-使用 `docker ps` 来验证设定的命名。
+### 连接容器
+
+创建一个容器并连接到新建的 `my-net` 网络
+
+```bash
+$ docker run -it --rm --name busybox1 --net my-net busybox sh
+```
+
+打开新的终端，再新建一个容器，加入 `my-net` 网络
+
+```bash
+$ docker run -it --rm --name busybox2 --net my-net busybox sh
+```
+
+再打开一个新的终端查看容器信息
+
 ```bash
-$ docker ps -l
 CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
-aed84ee21bde  training/webapp:latest python app.py  12 hours ago  Up 2 seconds 0.0.0.0:49154->5000/tcp  web
+b47060aca56b        busybox             "sh"                11 minutes ago      Up 11 minutes                           busybox2
+8720575823ec        busybox             "sh"                16 minutes ago      Up 16 minutes                           busybox1
 ```
-也可以使用 `docker inspect` 来查看容器的名字
+
+下面通过 `ping` 来证明 `busybox1` 容器和 `busybox2` 容器建立了互联关系。
+
+在 `busybox1` 容器输入以下命令
+
 ```bash
-$ docker inspect -f "{{ .Name }}" aed84ee21bde
+/ # ping busybox2
-/web
+PING busybox2 (172.19.0.3): 56 data bytes
+64 bytes from 172.19.0.3: seq=0 ttl=64 time=0.072 ms
+64 bytes from 172.19.0.3: seq=1 ttl=64 time=0.118 ms
 ```
-注意：容器的名称是唯一的。如果已经命名了一个叫 web 的容器，当你要再次使用 web 这个名称的时候，需要先用`docker rm` 来删除之前创建的同名容器。
 
-在执行 `docker run` 的时候如果添加 `--rm` 标记，则容器在终止后会立刻删除。注意，`--rm` 和 `-d` 参数不能同时使用。
+用 ping 来测试连接 `busybox2` 容器，它会解析成 172.19.0.3。
 
-###容器互联
+同理在 `busybox2` 容器执行 `ping busybox1`，也会成功连接到。
-使用 `--link` 参数可以让容器之间安全的进行交互。
 
-下面先创建一个新的数据库容器。
 ```bash
-$ docker run -d --name db training/postgres
+/ # ping busybox1
+PING busybox1 (172.19.0.2): 56 data bytes
+64 bytes from 172.19.0.2: seq=0 ttl=64 time=0.064 ms
+64 bytes from 172.19.0.2: seq=1 ttl=64 time=0.143 ms
 ```
-删除之前创建的 web 容器
-```bash
-$ docker rm -f web
-```
-然后创建一个新的 web 容器，并将它连接到 db 容器
-```bash
-$ docker run -d -P --name web --link db:db training/webapp python app.py
-```
-此时，db 容器和 web 容器建立互联关系。
 
-`--link` 参数的格式为 `--link name:alias`，其中 `name` 是要链接的容器的名称，`alias` 是这个连接的别名。
+这样，`busybox1` 容器和 `busybox2` 容器建立了互联关系。
-
-使用 `docker ps` 来查看容器的连接
-```bash
-$ docker ps
-CONTAINER ID  IMAGE                     COMMAND               CREATED             STATUS             PORTS                    NAMES
-349169744e49  training/postgres:latest  su postgres -c '/usr  About a minute ago  Up About a minute  5432/tcp                 db, web/db
-aed84ee21bde  training/webapp:latest    python app.py         16 hours ago        Up 2 minutes       0.0.0.0:49154->5000/tcp  web
-```
-可以看到自定义命名的容器，db 和 web，db 容器的 names 列有 db 也有 web/db。这表示 web 容器链接到 db 容器，web 容器将被允许访问 db 容器的信息。
-
-Docker 在两个互联的容器之间创建了一个安全隧道，而且不用映射它们的端口到宿主主机上。在启动 db 容器的时候并没有使用 `-p` 和 `-P` 标记，从而避免了暴露数据库端口到外部网络上。
-
-Docker 通过 2 种方式为容器公开连接信息：
-* 环境变量
-* 更新 `/etc/hosts` 文件
-
-使用 `env` 命令来查看 web 容器的环境变量
-```bash
-$ docker run --rm --name web2 --link db:db training/webapp env
-. . .
-DB_NAME=/web2/db
-DB_PORT=tcp://172.17.0.5:5432
-DB_PORT_5000_TCP=tcp://172.17.0.5:5432
-DB_PORT_5000_TCP_PROTO=tcp
-DB_PORT_5000_TCP_PORT=5432
-DB_PORT_5000_TCP_ADDR=172.17.0.5
-. . .
-```
-其中 DB_ 开头的环境变量是供 web 容器连接 db 容器使用，前缀采用大写的连接别名。
-
-除了环境变量，Docker 还添加 host 信息到父容器的 `/etc/hosts` 的文件。下面是父容器 web 的 hosts 文件
-```bash
-$ docker run -t -i --rm --link db:db training/webapp /bin/bash
-root@aed84ee21bde:/opt/webapp# cat /etc/hosts
-172.17.0.7  aed84ee21bde
-. . .
-172.17.0.5  db
-```
-这里有 2 个 hosts，第一个是 web 容器，web 容器用 id 作为他的主机名，第二个是 db 容器的 ip 和主机名。
-可以在 web 容器中安装 ping 命令来测试跟db容器的连通。
-```bash
-root@aed84ee21bde:/opt/webapp# apt-get install -yqq inetutils-ping
-root@aed84ee21bde:/opt/webapp# ping db
-PING db (172.17.0.5): 48 data bytes
-56 bytes from 172.17.0.5: icmp_seq=0 ttl=64 time=0.267 ms
-56 bytes from 172.17.0.5: icmp_seq=1 ttl=64 time=0.250 ms
-56 bytes from 172.17.0.5: icmp_seq=2 ttl=64 time=0.256 ms
-```
-用 ping 来测试db容器，它会解析成 `172.17.0.5`。
-*注意*：官方的 ubuntu 镜像默认没有安装 ping，需要自行安装。
-
-用户可以链接多个父容器到子容器，比如可以链接多个 web 到 db 容器上。

network/port_mapping.md

@@ -1,16 +1,21 @@
 ## 外部访问容器
+
 容器中可以运行一些网络应用，要让外部也可以访问这些应用，可以通过 `-P` 或 `-p` 参数来指定端口映射。
 
-当使用 -P 标记时，Docker 会随机映射一个 `49000~49900` 的端口到内部容器开放的网络端口。
+当使用 `-P` 标记时，Docker 会随机映射一个 `49000~49900` 的端口到内部容器开放的网络端口。
 
 使用 `docker ps` 可以看到，本地主机的 49155 被映射到了容器的 5000 端口。此时访问本机的 49155 端口即可访问容器内 web 应用提供的界面。
+
 ```bash
 $ docker run -d -P training/webapp python app.py
+
 $ docker ps -l
 CONTAINER ID  IMAGE                   COMMAND       CREATED        STATUS        PORTS                    NAMES
 bc533791f3f5  training/webapp:latest  python app.py 5 seconds ago  Up 2 seconds  0.0.0.0:49155->5000/tcp  nostalgic_morse
 ```
+
 同样的，可以通过 `docker logs` 命令来查看应用的信息。
+
 ```bash
 $ docker logs -f nostalgic_morse
 * Running on http://0.0.0.0:5000/
@@ -18,40 +23,60 @@ $ docker logs -f nostalgic_morse
 10.0.2.2 - - [23/May/2014 20:16:31] "GET /favicon.ico HTTP/1.1" 404 -
 ```
 
--p（小写的）则可以指定要映射的端口，并且，在一个指定端口上只可以绑定一个容器。支持的格式有 `ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort`。
+`-p` 则可以指定要映射的端口，并且，在一个指定端口上只可以绑定一个容器。支持的格式有 `ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort`。
 
 ### 映射所有接口地址
+
 使用 `hostPort:containerPort` 格式本地的 5000 端口映射到容器的 5000 端口，可以执行
+
 ```bash
 $ docker run -d -p 5000:5000 training/webapp python app.py
 ```
+
 此时默认会绑定本地所有接口上的所有地址。
 
 ### 映射到指定地址的指定端口
+
 可以使用 `ip:hostPort:containerPort` 格式指定映射使用一个特定地址，比如 localhost 地址 127.0.0.1
+
 ```bash
 $ docker run -d -p 127.0.0.1:5000:5000 training/webapp python app.py
 ```
+
 ### 映射到指定地址的任意端口
+
 使用 `ip::containerPort` 绑定 localhost 的任意端口到容器的 5000 端口，本地主机会自动分配一个端口。
+
 ```bash
 $ docker run -d -p 127.0.0.1::5000 training/webapp python app.py
 ```
-还可以使用 udp 标记来指定 udp 端口
+
+还可以使用 `udp` 标记来指定 `udp` 端口
+
 ```bash
 $ docker run -d -p 127.0.0.1:5000:5000/udp training/webapp python app.py
 ```
+
 ### 查看映射端口配置
+
 使用 `docker port` 来查看当前映射的端口配置，也可以查看到绑定的地址
+
 ```bash
 $ docker port nostalgic_morse 5000
 127.0.0.1:49155.
 ```
+
 注意：
 * 容器有自己的内部网络和 ip 地址（使用 `docker inspect` 可以获取所有的变量，Docker 还可以有一个可变的网络配置。）
-* -p 标记可以多次使用来绑定多个端口
+
+* `-p` 标记可以多次使用来绑定多个端口
 
 例如
+
 ```bash
-$ docker run -d -p 5000:5000  -p 3000:80 training/webapp python app.py
+$ docker run -d \
+    -p 5000:5000 \
+    -p 3000:80 \
+    training/webapp \
+    python app.py
 ```