From f838297f052972ce75a717dda52fd57eeb2192ee Mon Sep 17 00:00:00 2001 From: khs1994 Date: Mon, 13 Nov 2017 18:19:35 +0800 Subject: [PATCH 1/3] Update image install content --- image/README.md | 2 +- image/commit.md | 2 +- image/list.md | 8 +++++++- install/mirror.md | 4 ++-- 4 files changed, 11 insertions(+), 5 deletions(-) diff --git a/image/README.md b/image/README.md index 5423e7f..710c0e2 100644 --- a/image/README.md +++ b/image/README.md @@ -2,7 +2,7 @@ 在之前的介绍中，我们知道镜像是 Docker 的三大组件之一。 -Docker 运行容器前需要本地存在对应的镜像，如果镜像不存在本地，Docker 会从镜像仓库下载（默认是 Docker Hub 公共注册服务器中的仓库）。 +Docker 运行容器前需要本地存在对应的镜像，如果镜像不存在本地，Docker 会从镜像仓库下载（默认是 Docker Hub ）。 本章将介绍更多关于镜像的内容，包括： * 从仓库获取镜像； diff --git a/image/commit.md b/image/commit.md index b234918..f99a7e3 100644 --- a/image/commit.md +++ b/image/commit.md @@ -9,7 +9,7 @@ 现在让我们以定制一个 Web 服务器为例子，来讲解镜像是如何构建的。 ```bash -docker run --name webserver -d -p 80:80 nginx +$ docker run --name webserver -d -p 80:80 nginx ``` 这条命令会用 `nginx` 镜像启动一个容器，命名为 `webserver`，并且映射了 80 端口，这样我们可以用浏览器去访问这个 `nginx` 服务器。 diff --git a/image/list.md b/image/list.md index 7a69f47..18ff19c 100644 --- a/image/list.md +++ b/image/list.md @@ -24,6 +24,12 @@ ubuntu 14.04 1e0c3dd64ccd 4 weeks ago 另外一个需要注意的问题是，`docker images` 列表中的镜像体积总和并非是所有镜像实际硬盘消耗。由于 Docker 镜像是多层存储结构，并且可以继承、复用，因此不同镜像可能会因为使用相同的基础镜像，从而拥有共同的层。由于 Docker 使用 Union FS，相同的层只需要保存一份即可，因此实际镜像硬盘占用空间很可能要比这个列表镜像大小的总和要小的多。 +在 Docker 1.13+ 版本中可以你可以通过以下命令来便捷的查看镜像、容器、数据卷所占用的空间。 + +```bash +$ docker system df +``` + ### 虚悬镜像 上面的镜像列表中，还可以看到一个特殊的镜像，这个镜像既没有仓库名，也没有标签，均为 ``。： @@ -46,7 +52,7 @@ REPOSITORY TAG IMAGE ID CREATED $ docker rmi $(docker images -q -f dangling=true) ``` -注意：如果你使用的是 Docker 1.13+ 版本，你可以便捷的使用以下命令来删除虚悬镜像。 +在 Docker 1.13+ 版本中你可以便捷的使用以下命令来删除虚悬镜像。 ```bash $ docker image prune diff --git a/install/mirror.md b/install/mirror.md index dd03a8a..f720b3e 100644 --- a/install/mirror.md +++ b/install/mirror.md @@ -1,12 +1,12 @@ ## 镜像加速器 -国内访问 Docker Hub 有时会遇到困难，此时可以配置镜像加速器。Docker 官方和国内很多云服务商都提供了加速器服务，例如： +国内从 Docker Hub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。Docker 官方和国内很多云服务商都提供了国内加速器服务，例如： * [Docker 官方提供的中国registry mirror](https://docs.docker.com/registry/recipes/mirror/#use-case-the-china-registry-mirror) * [阿里云加速器](https://cr.console.aliyun.com/#/accelerator) * [DaoCloud 加速器](https://www.daocloud.io/mirror#accelerator-doc) -注册用户并且申请加速器，会获得如 `https://jxus37ad.mirror.aliyuncs.com` 这样的地址。我们需要将其配置给 Docker 引擎。 +我们以 Docker 官方加速器为例进行介绍。 ### Ubuntu 14.04、Debian 7 Wheezy From d1a640f383b93eb74b6c72b0b280a2650bcc97ac Mon Sep 17 00:00:00 2001 From: khs1994 Date: Mon, 13 Nov 2017 18:54:38 +0800 Subject: [PATCH 2/3] Fix #206 #117 --- advanced_network/bridge.md | 13 +++++++------ advanced_network/ptp.md | 14 +++++++------- compose/usage.md | 8 ++++---- container/enter.md | 12 ++++++------ container/import_export.md | 10 +++++----- container/stop.md | 4 ++-- data_management/container.md | 14 +++++++------- data_management/management.md | 16 ++++++++-------- data_management/volume.md | 30 ++++++++++++++--------------- etcd/install.md | 16 ++++++++-------- network/linking.md | 36 +++++++++++++++++------------------ network/port_mapping.md | 32 +++++++++++++++---------------- repository/dockerhub.md | 8 ++++---- swarm/filter.md | 22 ++++++++++----------- swarm/install.md | 18 +++++++++--------- underly/network.md | 14 +++++++------- 16 files changed, 134 insertions(+), 133 deletions(-) diff --git a/advanced_network/bridge.md b/advanced_network/bridge.md index 40d1f01..1d5a0b0 100644 --- a/advanced_network/bridge.md +++ b/advanced_network/bridge.md @@ -4,19 +4,20 @@ 在启动 Docker 服务的时候，使用 `-b BRIDGE`或`--bridge=BRIDGE` 来指定使用的网桥。 如果服务已经运行，那需要先停止服务，并删除旧的网桥。 -``` -$ sudo service docker stop + +```bash +$ sudo systemctl stop docker $ sudo ip link set dev docker0 down $ sudo brctl delbr docker0 ``` 然后创建一个网桥 `bridge0`。 -``` +```bash $ sudo brctl addbr bridge0 $ sudo ip addr add 192.168.5.1/24 dev bridge0 $ sudo ip link set dev bridge0 up ``` 查看确认网桥创建并启动。 -``` +```bash $ ip addr show bridge0 4: bridge0: mtu 1500 qdisc noop state UP group default link/ether 66:38:d0:0d:76:18 brd ff:ff:ff:ff:ff:ff @@ -24,9 +25,9 @@ $ ip addr show bridge0 valid_lft forever preferred_lft forever ``` 配置 Docker 服务，默认桥接到创建的网桥上。 -``` +```bash $ echo 'DOCKER_OPTS="-b=bridge0"' >> /etc/default/docker -$ sudo service docker start +$ sudo systemctl start docker ``` 启动 Docker 服务。 新建一个容器，可以看到它已经桥接到了 `bridge0` 上。 diff --git a/advanced_network/ptp.md b/advanced_network/ptp.md index cf66adc..438f6f1 100644 --- a/advanced_network/ptp.md +++ b/advanced_network/ptp.md @@ -6,18 +6,18 @@ 解决办法很简单：创建一对 `peer` 接口，分别放到两个容器中，配置成点到点链路类型即可。 首先启动 2 个容器： -``` -$ sudo docker run -i -t --rm --net=none base /bin/bash +```bash +$ docker run -i -t --rm --net=none base /bin/bash root@1f1f4c1f931a:/# -$ sudo docker run -i -t --rm --net=none base /bin/bash +$ docker run -i -t --rm --net=none base /bin/bash root@12e343489d2f:/# ``` 找到进程号，然后创建网络命名空间的跟踪文件。 -``` -$ sudo docker inspect -f '{{.State.Pid}}' 1f1f4c1f931a +```bash +$ docker inspect -f '{{.State.Pid}}' 1f1f4c1f931a 2989 -$ sudo docker inspect -f '{{.State.Pid}}' 12e343489d2f +$ docker inspect -f '{{.State.Pid}}' 12e343489d2f 3004 $ sudo mkdir -p /var/run/netns $ sudo ln -s /proc/2989/ns/net /var/run/netns/2989 @@ -25,7 +25,7 @@ $ sudo ln -s /proc/3004/ns/net /var/run/netns/3004 ``` 创建一对 `peer` 接口，然后配置路由 -``` +```bash $ sudo ip link add A type veth peer name B $ sudo ip link set A netns 2989 diff --git a/compose/usage.md b/compose/usage.md index 769261b..6e26fdf 100644 --- a/compose/usage.md +++ b/compose/usage.md @@ -20,7 +20,7 @@ #### index.py 编写一个 `index.py` 作为服务器文件，代码为 -```bash +```python #!/usr/bin/python #authors: yeasy.github.com #date: 2013-07-05 @@ -99,7 +99,7 @@ $ touch index.html #### Dockerfile 编写 `Dockerfile` 文件，内容为 -```bash +```docker FROM python:2.7 WORKDIR /code ADD . /code @@ -194,8 +194,8 @@ compose-haproxy-web └── index.py ``` 在该目录下执行 `docker-compose up` 命令，会整合输出所有容器的输出。 -``` -$sudo docker-compose up +```bash +$ docker-compose up Recreating composehaproxyweb_webb_1... Recreating composehaproxyweb_webc_1... Recreating composehaproxyweb_weba_1... diff --git a/container/enter.md b/container/enter.md index 456e02d..9ac9da6 100644 --- a/container/enter.md +++ b/container/enter.md @@ -5,12 +5,12 @@ `docker attach` 是 Docker 自带的命令。下面示例如何使用该命令。 ```bash -$ sudo docker run -idt ubuntu +$ docker run -idt ubuntu 243c32535da7d142fb0e6df616a3c3ada0b8ab417937c853a9e1c251f499f550 -$ sudo docker ps +$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 243c32535da7 ubuntu:latest "/bin/bash" 18 seconds ago Up 17 seconds nostalgic_hypatia -$sudo docker attach nostalgic_hypatia +$ docker attach nostalgic_hypatia root@243c32535da7:/# ``` @@ -20,7 +20,7 @@ root@243c32535da7:/# #### 安装 `nsenter` 工具在 util-linux 包2.23版本后包含。 如果系统中 util-linux 包没有该命令，可以按照下面的方法从源码安装。 -``` +```bash $ cd /tmp; curl https://www.kernel.org/pub/linux/utils/util-linux/v2.24/util-linux-2.24.tar.gz | tar -zxf-; cd util-linux-2.24; $ ./configure --without-ncurses $ make nsenter && sudo cp nsenter /usr/local/bin @@ -59,9 +59,9 @@ $ nsenter --target $pid --mount --uts --ipc --net --pid -- /usr/bin/env \ 下面给出一个完整的例子。 ```bash -$ sudo docker run -idt ubuntu +$ docker run -idt ubuntu 243c32535da7d142fb0e6df616a3c3ada0b8ab417937c853a9e1c251f499f550 -$ sudo docker ps +$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 243c32535da7 ubuntu:latest "/bin/bash" 18 seconds ago Up 17 seconds nostalgic_hypatia $ PID=$(docker-pid 243c32535da7) diff --git a/container/import_export.md b/container/import_export.md index e3607a8..32ca0be 100644 --- a/container/import_export.md +++ b/container/import_export.md @@ -2,24 +2,24 @@ ###导出容器 如果要导出本地某个容器，可以使用 `docker export` 命令。 -``` +```bash $ docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 7691a814370e ubuntu:14.04 "/bin/bash" 36 hours ago Exited (0) 21 hours ago test -$ sudo docker export 7691a814370e > ubuntu.tar +$ docker export 7691a814370e > ubuntu.tar ``` 这样将导出容器快照到本地文件。 ###导入容器快照 可以使用 `docker import` 从容器快照文件中再导入为镜像，例如 -``` -$ cat ubuntu.tar | sudo docker import - test/ubuntu:v1.0 +```bash +$ cat ubuntu.tar | docker import - test/ubuntu:v1.0 $ docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE test/ubuntu v1.0 9d37a6082e97 About a minute ago 171.3 MB ``` 此外，也可以通过指定 URL 或者某个目录来导入，例如 -``` +```bash $ docker import http://example.com/exampleimage.tgz example/imagerepo ``` diff --git a/container/stop.md b/container/stop.md index ea048c8..bb9c4f9 100644 --- a/container/stop.md +++ b/container/stop.md @@ -5,8 +5,8 @@ 例如对于上一章节中只启动了一个终端的容器，用户通过 `exit` 命令或 `Ctrl+d` 来退出终端时，所创建的容器立刻终止。 终止状态的容器可以用 `docker ps -a` 命令看到。例如 -``` -sudo docker ps -a +```bash +docker ps -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES ba267838cc1b ubuntu:14.04 "/bin/bash" 30 minutes ago Exited (0) About a minute ago trusting_newton 98e5efa7d997 training/webapp:latest "python app.py" About an hour ago Exited (0) 34 minutes ago backstabbing_pike diff --git a/data_management/container.md b/data_management/container.md index 9f8a13a..0b55da1 100644 --- a/data_management/container.md +++ b/data_management/container.md @@ -4,18 +4,18 @@ 数据卷容器，其实就是一个正常的容器，专门用来提供数据卷供其它容器挂载的。 首先，创建一个名为 dbdata 的数据卷容器： -``` -$ sudo docker run -d -v /dbdata --name dbdata training/postgres echo Data-only container for postgres +```bash +$ docker run -d -v /dbdata --name dbdata training/postgres echo Data-only container for postgres ``` 然后，在其他容器中使用 `--volumes-from` 来挂载 dbdata 容器中的数据卷。 -``` -$ sudo docker run -d --volumes-from dbdata --name db1 training/postgres -$ sudo docker run -d --volumes-from dbdata --name db2 training/postgres +```bash +$ docker run -d --volumes-from dbdata --name db1 training/postgres +$ docker run -d --volumes-from dbdata --name db2 training/postgres ``` 可以使用超过一个的 `--volumes-from` 参数来指定从多个容器挂载不同的数据卷。 也可以从其他已经挂载了数据卷的容器来级联挂载数据卷。 -``` -$ sudo docker run -d --name db3 --volumes-from db1 training/postgres +```bash +$ docker run -d --name db3 --volumes-from db1 training/postgres ``` *注意：使用 `--volumes-from` 参数所挂载数据卷的容器自己并不需要保持在运行状态。 diff --git a/data_management/management.md b/data_management/management.md index 636d999..daa6732 100644 --- a/data_management/management.md +++ b/data_management/management.md @@ -3,23 +3,23 @@ ### 备份 首先使用 `--volumes-from` 标记来创建一个加载 dbdata 容器卷的容器，并从主机挂载当前目录到容器的 /backup 目录。命令如下： -``` -$ sudo docker run --volumes-from dbdata -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata +```bash +$ docker run --volumes-from dbdata -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /dbdata ``` 容器启动后，使用了 `tar` 命令来将 dbdata 卷备份为容器中 /backup/backup.tar 文件，也就是主机当前目录下的名为 `backup.tar` 的文件。 ### 恢复 如果要恢复数据到一个容器，首先创建一个带有空数据卷的容器 dbdata2。 -``` -$ sudo docker run -v /dbdata --name dbdata2 ubuntu /bin/bash +```bash +$ docker run -v /dbdata --name dbdata2 ubuntu /bin/bash ``` 然后创建另一个容器，挂载 dbdata2 容器卷中的数据卷，并使用 `untar` 解压备份文件到挂载的容器卷中。 -``` -$ sudo docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf +```bash +$ docker run --volumes-from dbdata2 -v $(pwd):/backup busybox tar xvf /backup/backup.tar ``` 为了查看/验证恢复的数据，可以再启动一个容器挂载同样的容器卷来查看 +```bash +$ docker run --volumes-from dbdata2 busybox /bin/ls /dbdata ``` -$ sudo docker run --volumes-from dbdata2 busybox /bin/ls /dbdata -``` \ No newline at end of file diff --git a/data_management/volume.md b/data_management/volume.md index 6d44883..1445fd8 100644 --- a/data_management/volume.md +++ b/data_management/volume.md @@ -6,34 +6,34 @@ * 数据卷默认会一直存在，即使容器被删除 -*注意：数据卷的使用，类似于 Linux 下对目录或文件进行 mount，镜像中的被指定为挂载点的目录中的文件会隐藏掉，能显示看的是挂载的数据卷。 +*注意*：数据卷的使用，类似于 Linux 下对目录或文件进行 mount，镜像中的被指定为挂载点的目录中的文件会隐藏掉，能显示看的是挂载的数据卷。 ### 创建一个数据卷 在用 `docker run` 命令的时候，使用 `-v` 标记来创建一个数据卷并挂载到容器里。在一次 run 中多次使用可以挂载多个数据卷。 下面创建一个名为 web 的容器，并加载一个数据卷到容器的 `/webapp` 目录。 +```bash +$ docker run -d -P --name web -v /webapp training/webapp python app.py ``` -$ sudo docker run -d -P --name web -v /webapp training/webapp python app.py -``` -*注意：也可以在 Dockerfile 中使用 `VOLUME` 来添加一个或者多个新的卷到由该镜像创建的任意容器。 +*注意*：也可以在 Dockerfile 中使用 `VOLUME` 来添加一个或者多个新的卷到由该镜像创建的任意容器。 ### 删除数据卷 数据卷是被设计用来持久化数据的，它的生命周期独立于容器，Docker不会在容器被删除后自动删除数据卷，并且也不存在垃圾回收这样的机制来处理没有任何容器引用的数据卷。如果需要在删除容器的同时移除数据卷。可以在删除容器的时候使用 `docker rm -v` 这个命令。无主的数据卷可能会占据很多空间，要清理会很麻烦。Docker官方正在试图解决这个问题，相关工作的进度可以查看这个[PR](https://github.com/docker/docker/pull/8484)。 ### 挂载一个主机目录作为数据卷 使用 `-v` 标记也可以指定挂载一个本地主机的目录到容器中去。 -``` -$ sudo docker run -d -P --name web -v /src/webapp:/opt/webapp training/webapp python app.py +```bash +$ docker run -d -P --name web -v /src/webapp:/opt/webapp training/webapp python app.py ``` 上面的命令加载主机的 `/src/webapp` 目录到容器的 `/opt/webapp` 目录。这个功能在进行测试的时候十分方便，比如用户可以放置一些程序到本地目录中，来查看容器是否正常工作。本地目录的路径必须是绝对路径，如果目录不存在 Docker 会自动为你创建它。 -*注意：Dockerfile 中不支持这种用法，这是因为 Dockerfile 是为了移植和分享用的。然而，不同操作系统的路径格式不一样，所以目前还不能支持。 +*注意*：Dockerfile 中不支持这种用法，这是因为 Dockerfile 是为了移植和分享用的。然而，不同操作系统的路径格式不一样，所以目前还不能支持。 Docker 挂载数据卷的默认权限是读写，用户也可以通过 `:ro` 指定为只读。 -``` -$ sudo docker run -d -P --name web -v /src/webapp:/opt/webapp:ro +```bash +$ docker run -d -P --name web -v /src/webapp:/opt/webapp:ro training/webapp python app.py ``` 加了 `:ro` 之后，就挂载为只读了。 @@ -41,13 +41,13 @@ training/webapp python app.py ### 查看数据卷的具体信息 在主机里使用以下命令可以查看指定容器的信息 -``` +```bash $ docker inspect web ... ``` 在输出的内容中找到其中和数据卷相关的部分，可以看到所有的数据卷都是创建在主机的`/var/lib/docker/volumes/`下面的 -``` +```json "Volumes": { "/webapp": "/var/lib/docker/volumes/fac362...80535" }, @@ -57,7 +57,7 @@ $ docker inspect web ... ``` 注：从Docker 1.8.0起，数据卷配置在"Mounts"Key下面，可以看到所有的数据卷都是创建在主机的`/mnt/sda1/var/lib/docker/volumes/....`下面了。 -``` +```json "Mounts": [ { "Name": "b53ebd40054dae599faf7c9666acfe205c3e922fc3e8bc3f2fd178ed788f1c29", @@ -74,10 +74,10 @@ $ docker inspect web ### 挂载一个本地主机文件作为数据卷 `-v` 标记也可以从主机挂载单个文件到容器中 -``` -$ sudo docker run --rm -it -v ~/.bash_history:/.bash_history ubuntu /bin/bash +```bash +$ docker run --rm -it -v ~/.bash_history:/.bash_history ubuntu /bin/bash ``` 这样就可以记录在容器输入过的命令了。 -*注意：如果直接挂载一个文件，很多文件编辑工具，包括 `vi` 或者 `sed --in-place`，可能会造成文件 inode 的改变，从 Docker 1.1 +*注意*：如果直接挂载一个文件，很多文件编辑工具，包括 `vi` 或者 `sed --in-place`，可能会造成文件 inode 的改变，从 Docker 1.1 .0起，这会导致报错误信息。所以最简单的办法就直接挂载文件的父目录。 diff --git a/etcd/install.md b/etcd/install.md index 17c4b10..dd51f2a 100644 --- a/etcd/install.md +++ b/etcd/install.md @@ -8,14 +8,14 @@ etcd 基于 Go 语言实现，因此，用户可以从 [项目主页](https://gi 例如，下面的命令使用 curl 工具下载压缩包，并解压。 -``` +```bash curl -L https://github.com/coreos/etcd/releases/download/v2.0.0-rc.1/etcd-v2.0.0-rc.1-linux-amd64.tar.gz -o etcd-v2.0.0-rc.1-linux-amd64.tar.gz tar xzvf etcd-v2.0.0-rc.1-linux-amd64.tar.gz cd etcd-v2.0.0-rc.1-linux-amd64 ``` 解压后，可以看到文件包括 -``` +```bash $ ls etcd etcdctl etcd-migrate README-etcdctl.md README.md ``` @@ -24,12 +24,12 @@ etcd etcdctl etcd-migrate README-etcdctl.md README.md 推荐通过下面的命令将三个文件都放到系统可执行目录 `/usr/local/bin/` 或 `/usr/bin/`。 -``` +```bash $ sudo cp etcd* /usr/local/bin/ ``` 运行 etcd，将默认组建一个两个节点的集群。数据库服务端默认监听在 2379 和 4001 端口，etcd 实例监听在 2380 和 7001 端口。显示类似如下的信息： -``` +```bash $ ./etcd 2014/12/31 14:52:09 no data-dir provided, using default data-dir ./default.etcd 2014/12/31 14:52:09 etcd: listening for peers on http://localhost:2380 @@ -56,7 +56,7 @@ $ ./etcd ``` 此时，可以使用 etcdctl 命令进行测试，设置和获取键值 `testkey: "hello world"`，检查 etcd 服务是否启动成功： -``` +```bash $ ./etcdctl set testkey "hello world" hello world $ ./etcdctl get testkey @@ -65,7 +65,7 @@ hello world 说明 etcd 服务已经成功启动了。 当然，也可以通过 HTTP 访问本地 2379 或 4001 端口的方式来进行操作，例如查看 `testkey` 的值： -``` +```bash $ curl -L http://localhost:4001/v2/keys/testkey {"action":"get","node":{"key":"/testkey","value":"hello world","modifiedIndex":3,"createdIndex":3}} ``` @@ -73,6 +73,6 @@ $ curl -L http://localhost:4001/v2/keys/testkey ### Docker 镜像方式下载 镜像名称为 quay.io/coreos/etcd:v2.0.0_rc.1，可以通过下面的命令启动 etcd 服务监听到 4001 端口。 -``` -$ sudo docker run -p 4001:4001 -v /etc/ssl/certs/:/etc/ssl/certs/ quay.io/coreos/etcd:v2.0.0_rc.1 +```bash +$ docker run -p 4001:4001 -v /etc/ssl/certs/:/etc/ssl/certs/ quay.io/coreos/etcd:v2.0.0_rc.1 ``` diff --git a/network/linking.md b/network/linking.md index 9b237a1..79efbe7 100644 --- a/network/linking.md +++ b/network/linking.md @@ -11,19 +11,19 @@ * 当要连接其他容器时候，可以作为一个有用的参考点，比如连接web容器到db容器 使用 `--name` 标记可以为容器自定义命名。 -``` -$ sudo docker run -d -P --name web training/webapp python app.py +```bash +$ docker run -d -P --name web training/webapp python app.py ``` 使用 `docker ps` 来验证设定的命名。 -``` -$ sudo docker ps -l +```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 ``` 也可以使用 `docker inspect` 来查看容器的名字 -``` -$ sudo docker inspect -f "{{ .Name }}" aed84ee21bde +```bash +$ docker inspect -f "{{ .Name }}" aed84ee21bde /web ``` 注意：容器的名称是唯一的。如果已经命名了一个叫 web 的容器，当你要再次使用 web 这个名称的时候，需要先用`docker rm` 来删除之前创建的同名容器。 @@ -34,23 +34,23 @@ $ sudo docker inspect -f "{{ .Name }}" aed84ee21bde 使用 `--link` 参数可以让容器之间安全的进行交互。 下面先创建一个新的数据库容器。 -``` -$ sudo docker run -d --name db training/postgres +```bash +$ docker run -d --name db training/postgres ``` 删除之前创建的 web 容器 -``` +```bash $ docker rm -f web ``` 然后创建一个新的 web 容器，并将它连接到 db 容器 -``` -$ sudo docker run -d -P --name web --link db:db training/webapp python app.py +```bash +$ docker run -d -P --name web --link db:db training/webapp python app.py ``` 此时，db 容器和 web 容器建立互联关系。 `--link` 参数的格式为 `--link name:alias`，其中 `name` 是要链接的容器的名称，`alias` 是这个连接的别名。 使用 `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 @@ -65,8 +65,8 @@ Docker 通过 2 种方式为容器公开连接信息： * 更新 `/etc/hosts` 文件 使用 `env` 命令来查看 web 容器的环境变量 -``` -$ sudo docker run --rm --name web2 --link db:db training/webapp env +```bash +$ docker run --rm --name web2 --link db:db training/webapp env . . . DB_NAME=/web2/db DB_PORT=tcp://172.17.0.5:5432 @@ -79,8 +79,8 @@ DB_PORT_5000_TCP_ADDR=172.17.0.5 其中 DB_ 开头的环境变量是供 web 容器连接 db 容器使用，前缀采用大写的连接别名。 除了环境变量，Docker 还添加 host 信息到父容器的 `/etc/hosts` 的文件。下面是父容器 web 的 hosts 文件 -``` -$ sudo docker run -t -i --rm --link db:db training/webapp /bin/bash +```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 . . . @@ -88,7 +88,7 @@ root@aed84ee21bde:/opt/webapp# cat /etc/hosts ``` 这里有 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 @@ -97,6 +97,6 @@ PING db (172.17.0.5): 48 data bytes 56 bytes from 172.17.0.5: icmp_seq=2 ttl=64 time=0.256 ms ``` 用 ping 来测试db容器，它会解析成 `172.17.0.5`。 -*注意：官方的 ubuntu 镜像默认没有安装 ping，需要自行安装。 +*注意*：官方的 ubuntu 镜像默认没有安装 ping，需要自行安装。 用户可以链接多个父容器到子容器，比如可以链接多个 web 到 db 容器上。 diff --git a/network/port_mapping.md b/network/port_mapping.md index 2547ea2..fa7a57b 100644 --- a/network/port_mapping.md +++ b/network/port_mapping.md @@ -4,15 +4,15 @@ 当使用 -P 标记时，Docker 会随机映射一个 `49000~49900` 的端口到内部容器开放的网络端口。 使用 `docker ps` 可以看到，本地主机的 49155 被映射到了容器的 5000 端口。此时访问本机的 49155 端口即可访问容器内 web 应用提供的界面。 -``` -$ sudo docker run -d -P training/webapp python app.py -$ sudo docker ps -l +```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` 命令来查看应用的信息。 -``` -$ sudo docker logs -f nostalgic_morse +```bash +$ docker logs -f nostalgic_morse * Running on http://0.0.0.0:5000/ 10.0.2.2 - - [23/May/2014 20:16:31] "GET / HTTP/1.1" 200 - 10.0.2.2 - - [23/May/2014 20:16:31] "GET /favicon.ico HTTP/1.1" 404 - @@ -22,28 +22,28 @@ $ sudo docker logs -f nostalgic_morse ### 映射所有接口地址 使用 `hostPort:containerPort` 格式本地的 5000 端口映射到容器的 5000 端口，可以执行 -``` -$ sudo docker run -d -p 5000:5000 training/webapp python app.py +```bash +$ docker run -d -p 5000:5000 training/webapp python app.py ``` 此时默认会绑定本地所有接口上的所有地址。 ### 映射到指定地址的指定端口 可以使用 `ip:hostPort:containerPort` 格式指定映射使用一个特定地址，比如 localhost 地址 127.0.0.1 -``` -$ sudo docker run -d -p 127.0.0.1:5000:5000 training/webapp python app.py +```bash +$ docker run -d -p 127.0.0.1:5000:5000 training/webapp python app.py ``` ### 映射到指定地址的任意端口 使用 `ip::containerPort` 绑定 localhost 的任意端口到容器的 5000 端口，本地主机会自动分配一个端口。 -``` -$ sudo docker run -d -p 127.0.0.1::5000 training/webapp python app.py +```bash +$ docker run -d -p 127.0.0.1::5000 training/webapp python app.py ``` 还可以使用 udp 标记来指定 udp 端口 -``` -$ sudo docker run -d -p 127.0.0.1:5000:5000/udp training/webapp python app.py +```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. ``` @@ -52,6 +52,6 @@ $ docker port nostalgic_morse 5000 * -p 标记可以多次使用来绑定多个端口 例如 -``` -$ sudo docker run -d -p 5000:5000 -p 3000:80 training/webapp python app.py +```bash +$ docker run -d -p 5000:5000 -p 3000:80 training/webapp python app.py ``` diff --git a/repository/dockerhub.md b/repository/dockerhub.md index 7622eb3..ef8c3b3 100644 --- a/repository/dockerhub.md +++ b/repository/dockerhub.md @@ -10,8 +10,8 @@ 你可以通过 `docker search` 命令来查找官方仓库中的镜像，并利用 `docker pull` 命令来将它下载到本地。 例如以 centos 为关键词进行搜索： -``` -$ sudo docker search centos +```bash +$ docker search centos NAME DESCRIPTION STARS OFFICIAL AUTOMATED centos The official build of CentOS. 465 [OK] tianon/centos CentOS 5 and 6, created using rinse instea... 28 @@ -30,8 +30,8 @@ tutum/centos-6.4 DEPRECATED. Use tutum/centos:6.4 另外，在查找的时候通过 `-s N` 参数可以指定仅显示评价为 `N` 星以上的镜像（新版本Docker推荐使用`--filter=stars=N`参数）。 下载官方 centos 镜像到本地。 -``` -$ sudo docker pull centos +```bash +$ docker pull centos Pulling repository centos 0b443ba03958: Download complete 539c0211cd76: Download complete diff --git a/swarm/filter.md b/swarm/filter.md index ce84bcf..ebb5f34 100644 --- a/swarm/filter.md +++ b/swarm/filter.md @@ -9,13 +9,13 @@ Constraint 过滤器是绑定到节点的键值对，相当于给节点添加标 可在启动 Docker 服务的时候指定，例如指定某个节点颜色为 `red`。 -```sh -$ sudo docker daemon --label color=red -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock +```bash +$ docker daemon --label color=red -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock ``` 同样的，可以写在 Docker 服务的配置文件里面（以 Ubuntu 14.04 为例，是 `/etc/default/docker`）。 -```sh +```bash DOCKER_OPTS="--label color=red -H 0.0.0.0:2375 -H unix:///var/run/docker.sock" ``` @@ -25,7 +25,7 @@ DOCKER_OPTS="--label color=red -H 0.0.0.0:2375 -H unix:///var/run/docker.sock" 然后，分别启动两个容器，指定使用过滤器分别为红色和绿色。 -```sh +```bash $ docker -H 192.168.0.2:12375 run -d -e constraint:color==red ubuntu:14.04 ping 127.0.0.1 252ffb48e64e9858c72241f5eedf6a3e4571b1ad926faf091db3e26672370f64 $ docker -H 192.168.0.2:12375 run -d -e constraint:color==green ubuntu:14.04 ping 127.0.0.1 @@ -36,7 +36,7 @@ $ docker -H 192.168.0.2:12375 run -d -e constraint:color==green ubuntu:14.04 pin 查看它们将被分配到指定节点上。 -```sh +```bash $ docker -H 192.168.0.2:12375 ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 252ffb48e64e ubuntu:14.04 "ping 127.0.0.1" 1 minutes ago Up 1 minutes Host-2/sick_galileo @@ -47,7 +47,7 @@ CONTAINER ID IMAGE COMMAND CREATED 例如，目前集群中各个节点的信息为： -```sh +```bash $ docker -H 192.168.0.2:12375 info Containers: 5 Images: 39 @@ -72,26 +72,26 @@ Name: 946d65606f7c ### Affinity 过滤器 Affinity 过滤器允许用户在启动一个容器的时候，让它分配到某个已有容器的节点上。 - + 例如，下面我们将启动一个 nginx 容器，让它分配到已经运行某个 ubuntu 容器的节点上。 - + 在 Constraint 过滤器的示例中，我们分别启动了两个 ubuntu 容器 `sick_galileo` 和 `compassionate_ritchie`，分别在 Host-2 和 Host-3 上。 现在启动一个 nginx 容器，让它跟容器 `sick_galileo` 放在一起，都放到 Host-2 节点上。可以通过 `-e affinity:container==` 参数来实现。 -```sh +```bash $ docker -H 192.168.0.2:12375 run -d -e affinity:container==sick_galileo nginx ``` 然后启动一个 redis 容器，让它跟容器 `compassionate_ritchie` 放在一起，都放到 Host-3 节点上。 -```sh +```bash $ docker -H 192.168.0.2:12375 run -d -e affinity:container==compassionate_ritchie redis ``` 查看所有容器运行情况。 -```sh +```bash $ docker -H 192.168.0.2:12375 ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 0a32f15aa8ee redis "/entrypoint.sh redis" 2 seconds ago Up 1 seconds 6379/tcp Host-3/awesome_darwin diff --git a/swarm/install.md b/swarm/install.md index 8836ab0..fefb120 100644 --- a/swarm/install.md +++ b/swarm/install.md @@ -6,13 +6,13 @@ Swarm 安装有几种方式，可以基于 Docker Machine 来进行安装，也 ### 下载镜像 Docker 官方已经提供了 Swarm 镜像使用，需要在所有被 Swarm 管理的 Docker 主机上下载该镜像。 -```sh +```bash $ docker pull swarm ``` 可以使用下面的命令来查看 Swarm 版本，验证是否成功下载 Swarm 镜像。 -```sh +```bash $ docker run --rm swarm -v swarm version 1.2.2 (34e3da3) ``` @@ -22,8 +22,8 @@ Docker 主机在加入 Swarm 集群前，需要进行一些简单配置，添加 例如，在启动 Docker daemon 的时候通过 `-H` 参数： -```sh -$ sudo docker daemon -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock +```bash +$ docker daemon -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock ``` *注：Docker 1.8.0 版本之前不支持 daemon 命令，可以用 -d 代替。* @@ -34,7 +34,7 @@ $ sudo docker daemon -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock 在文件的最后添加： -```sh +```bash DOCKER_OPTS="$DOCKER_OPTS -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock" ``` @@ -48,7 +48,7 @@ Docker 集群管理需要使用服务发现（Service Discover）功能，Swarm #### 启动 Consul 服务后端 启动 consul 服务容器，映射到主机的 8500 端口。 -```sh +```bash $ docker run -d -p 8500:8500 --name=consul progrium/consul -server -bootstrap ``` @@ -57,13 +57,13 @@ $ docker run -d -p 8500:8500 --name=consul progrium/consul -server -bootstrap #### 启动管理节点 首先，启动一个主管理节点，映射到主机的 4000 端口，并获取所在主机地址为 ``。其中 4000 端口是 Swarm 管理器的默认监听端口，用户也可以指定映射为其它端口。 -```sh +```bash $ docker run -d -p 4000:4000 swarm manage -H :4000 --replication --advertise :4000 consul://:8500 ``` 为了提高高可用性，用户也可以启动从管理节点。假定获取所在主机地址为 ``。 -```sh +```bash $ docker run -d swarm manage -H :4000 --replication --advertise :4000 consul://:8500 ``` @@ -72,7 +72,7 @@ $ docker run -d swarm manage -H :4000 --replication --advertise :40 获取节点的主机地址为 ``，并指定前面获取到的 consul 服务地址。 -```sh +```bash $ docker run -d swarm join --advertise=:2375 consul://:8500 ``` diff --git a/underly/network.md b/underly/network.md index 26a6302..4a0c200 100644 --- a/underly/network.md +++ b/underly/network.md @@ -29,33 +29,33 @@ Docker 创建一个容器的时候，会执行如下操作： 用户使用 `--net=none` 后，可以自行配置网络，让容器达到跟平常一样具有访问网络的权限。通过这个过程，可以了解 Docker 配置网络的细节。 首先，启动一个 `/bin/bash` 容器，指定 `--net=none` 参数。 -``` -$ sudo docker run -i -t --rm --net=none base /bin/bash +```bash +$ docker run -i -t --rm --net=none base /bin/bash root@63f36fc01b5f:/# ``` 在本地主机查找容器的进程 id，并为它创建网络命名空间。 -``` -$ sudo docker inspect -f '{{.State.Pid}}' 63f36fc01b5f +```bash +$ docker inspect -f '{{.State.Pid}}' 63f36fc01b5f 2778 $ pid=2778 $ sudo mkdir -p /var/run/netns $ sudo ln -s /proc/$pid/ns/net /var/run/netns/$pid ``` 检查桥接网卡的 IP 和子网掩码信息。 -``` +```bash $ ip addr show docker0 21: docker0: ... inet 172.17.42.1/16 scope global docker0 ... ``` 创建一对 “veth pair” 接口 A 和 B，绑定 A 到网桥 `docker0`，并启用它 -``` +```bash $ sudo ip link add A type veth peer name B $ sudo brctl addif docker0 A $ sudo ip link set A up ``` 将B放到容器的网络命名空间，命名为 eth0，启动它并配置一个可用 IP（桥接网段）和默认网关。 -``` +```bash $ sudo ip link set B netns $pid $ sudo ip netns exec $pid ip link set dev B name eth0 $ sudo ip netns exec $pid ip link set eth0 up From cb21e9b1677777cfe8ce5832f75342bf73046529 Mon Sep 17 00:00:00 2001 From: khs1994 Date: Mon, 13 Nov 2017 19:35:41 +0800 Subject: [PATCH 3/3] Follow GitHub recommended community standards --- contribute.md => .github/CONTRIBUTING.md | 6 +-- .github/ISSUE_TEMPLATE.md | 47 ++++++++++++++++++++++++ .github/PULL_REQUEST_TEMPLATE.md | 11 ++++++ README.md | 2 +- SUMMARY.md | 2 +- 5 files changed, 63 insertions(+), 5 deletions(-) rename contribute.md => .github/CONTRIBUTING.md (96%) create mode 100644 .github/ISSUE_TEMPLATE.md create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/contribute.md b/.github/CONTRIBUTING.md similarity index 96% rename from contribute.md rename to .github/CONTRIBUTING.md index 80f2f78..c36f6c1 100644 --- a/contribute.md +++ b/.github/CONTRIBUTING.md @@ -2,7 +2,7 @@ * 在 GitHub 上 `fork` 到自己的仓库，如 `docker_user/docker_practice`，然后 `clone` 到本地，并设置用户信息。 - ```sh + ```bash $ git clone git@github.com:docker_user/docker_practice.git $ cd docker_practice $ git config user.name "yourname" @@ -11,7 +11,7 @@ * 修改代码后提交，并推送到自己的仓库。 - ```sh + ```bash $ #do some change on the content $ git commit -am "Fix issue #1: change helo to hello" $ git push @@ -20,7 +20,7 @@ * 在 GitHub 网站上提交 pull request。 * 定期使用项目仓库内容更新自己仓库内容。 - ```sh + ```bash $ git remote add upstream https://github.com/yeasy/docker_practice $ git fetch upstream $ git checkout master diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md new file mode 100644 index 0000000..c564724 --- /dev/null +++ b/.github/ISSUE_TEMPLATE.md @@ -0,0 +1,47 @@ +### your OS + + + + +* [x] Linux + + * [x] CentOS 7 + + * [ ] Ubuntu 14.04 + + * [ ] Ubuntu 16.04 + + * [ ] Ubuntu 17.04 + + * [ ] Ubuntu 17.10 + + * [ ] CoreOS + + * [ ] Debian 7.7 + + * [ ] Debian 8 + + * [ ] Debian 9 + + +* [ ] macOS + +* [ ] Windows 10 + +### Docker CE Version + + + + +* [x] 17.10 edge + +* [ ] 17.09 stable + +* [ ] 1.13.0 + +* [ ] 1.8.0 + +### Problem description + + + diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..72fa318 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,11 @@ + + +### Proposed changes (optional) + + + +### Fix issues (optional) + + diff --git a/README.md b/README.md index b637904..3b7f856 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ * pdf 版本 [下载](https://www.gitbook.com/download/pdf/book/yeasy/docker_practice) * epub 版本 [下载](https://www.gitbook.com/download/epub/book/yeasy/docker_practice) -Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初学者使用 Linux 上最新版的 Docker (v17.10.0) 进行学习实践。欢迎参与维护项目：[如何贡献](contribute.md)。 +Docker 自身仍在快速发展中，生态环境也在蓬勃成长。建议初学者使用 Linux 上最新版的 Docker (v17.10.0) 进行学习实践。欢迎参与维护项目：[如何贡献](.github/CONTRIBUTING.md)。 * [修订记录](revision.md) * [贡献者名单](https://github.com/yeasy/docker_practice/graphs/contributors) diff --git a/SUMMARY.md b/SUMMARY.md index 88529c8..d861043 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -2,7 +2,7 @@ * [前言](README.md) * [修订记录](revision.md) -* [如何贡献](contribute.md) +* [如何贡献](.github/CONTRIBUTING.md) * [Docker 简介](introduction/README.md) * [什么是 Docker](introduction/what.md) * [为什么要用 Docker](introduction/why.md)