月份：2017年1月

当在一个worker节点执行这个命令时，这个节点将脱离集群。
可以在一个manager节点上使用–force选项来从集群删除它。不过，这不会重新配置集群来确保集群有足够的manager节点来维持一个法定仲裁人数。从一个集群删除一个manager节点的安全方法是把它降级为worker然后不使用–force来执行这个命令脱离集群。只在manager节点脱离集群后不再使用这个集群才使用–force选项，如单节点的集群。

如下示例：

要删除worker2，在worker2主机上执行如下命令：

docker swarm join用来加入一个节点到一个集群。节点加入为一个manager节点或worker节点取决于使用–token参数传递过去的token。如果传递一个manager token，这个节点以管理节点加入。如果传递一个worker token，就以worker节点加入。

以manager身份添加节点到集群

下面的示例演示使用manager token添加管理节点到集群。

一个集群应该最多只能有3-7个管理节点。不参与管理仲裁的节点应该以worker身份加入。manager节点应该是稳定的主机且有静态IP地址。

以worker身份加入集群

下面的示例演示使用worker token添加worker节点到集群。

–listen-addr value

如果节点为manager，在这个地址监听集群管理相关流量。默认是监听0.0.0.0:2377。也可以指定一个网络接口来监听这个接口的地址。例如–listen-addr eth0:2377。

端口是可选的。如果仅指定IP地址或接口名称，端口就使用默认的2377。

当加入的是一个已存在的集群时，这个参数一般不需要指定。

–advertise-addr value

指定通告给集群的节点的地址，这个地址用来给其它节点访问API和overlay网络通信。如果没有指定地址，docker将检查系统是否只有一个IP地址，如果是将使用这个地址并使用监听的端口(查看–listen-addr)。如果系统有多个IP地址，–advertise-addr就必须指定一个以便内部管理节点能够正常通信和overlay网络通信。

也可以指定一个网络接口来通告接口的地址，例如–advertise-addr eth0:2377。

端口是可选的。如果仅指定一个IP地址或接口名称，就使用端口2377。

当加入的是一个已存在的集群时，这个参数一般不需要指定。

–token string

节点加入集群所需的密钥

初始化一个集群。docker engine收到并执行这个命令所在的主机将成为新创建的单节点集群的管理节点。

docker swarm init生成两个随机的tokens，一个worker token和一个manager token。当一个节点加入到这个集群时，是worker节点还是manager节点取决于传递给swarm joing的token。

当创建集群后，可以使用swarm join-token来显示或轮换token。

–cert-expiry

设置节点证书有效期

–dispatcher-heartbeat

设置节点报告它们的健康状态间隔的时间。

–external-ca value

设置集群使用一个外部CA来签发节点证书。value的格式为protocol=X,url=Y。protocol指定的是发送签名请求到外部CA所使用的协议。目前只支持cfssl。URL指定的是签名请求应该提交到哪个endpoint。

–force-new-cluster

强制一个失去仲裁能力的集群的其中一个节点重启成为一单节点集群，而不丢失数据。

–listen-addr value

在这个地址监听集群管理相关流量。默认是监听0.0.0.0:2377。也可以指定一个网络接口来监听这个接口的地址。例如–listen-addr eth0:2377。

端口是可选的。如果仅指定IP地址或接口名称，端口就使用默认的2377。

–advertise-addr value

指定通告给集群的节点的地址，这个地址用来给其它节点访问API和overlay网络通信。如果没有指定地址，docker将检查系统是否只有一个IP地址，如果是将使用这个地址并使用监听的端口(查看–listen-addr)。如果系统有多个IP地址，–advertise-addr就必须指定一个以便内部管理节点能够正常通信和overlay网络通信。

也可以指定一个网络接口来通告接口的地址，例如–advertise-addr eth0:2377。

端口是可选的。如果仅指定一个IP地址或接口名称，就使用端口2377。

–task-history-limit

设置任务历史记录保留限制。

创建一个新的数据卷，这样容器就可以往里面存储数据了。如果–name没有指定，docker就生成一个随机的名称。创建一个数据卷之后就可以配置容器使用它了，例如：

数据卷hello挂载在容器的/world目录。docker不支持容器内的挂载点使用相对路径。

多个容器可以在相同时间段使用相同的数据卷。如果两个容器需要访问共享数据这个功能会非常有用。例如，一个容器写入数据另一个读取这个数据。

数据卷名称必须在所有驱动之间是唯一的。意味着在两个不同的驱动之间不能使用相同的数据卷名。如果尝试使用，docker将返回一个错误：

驱动特定的选项

一些数据卷驱动提供了一些选项来自定义数据卷的创建。使用-o或–opt标志传递这个驱动选项：

这些选项直接传递到数据卷驱动。内置的local Linux驱动接受的选项与linux mount命令类似。通过传递多次–opt标志来提供多个选项。完整的可用的mount选项在这里。

例如，下面创建了一个tmpfs数据卷，称为foo,大小为100M，uid为1000.

使用btrfs的另一个示例：

使用nfs从192.168.1.1挂载到/path/to/dir,模式为rw的示例：

列出Engine daemon知道的所有网络。这包括跨集群中多个主机的网络，例如：

使用–no-trunc选项显示完整的网络id:

过滤

过滤标志(-f或–filter)格式是key=value。如果超过一个过滤，那么传递多个标志(如 –filter “foo=bar” –filter “bif=baz”)。多个过滤标志作为一个OR过滤连接。例如-f type=custom -f type=builtin返回custom和builtin网络。
目前支持的过滤有：

driver

id (网络id)

label (label= 或 label==)

name (网络名称)

type (custom builtin)

Driver

driver过滤器基于它们的驱动匹配网络。
下面的示例匹配使用bridge驱动的网络：

ID

id过滤器基于完整或部分网络ID匹配网络。
下面的示例是过滤出包含ID 63d1ff1f77b0…字符串的网络。

也可以使用ID的部分字符来匹配：

Label

label过滤器基于label的存在或label和其值来匹配网络。
下面的示例过滤出有一个usage label而不管它是什么值的所有网络。

下面过滤出存在usage label且值为prod的网络。

Name

name过滤器基于网络名称的全部或部分匹配网络。
下面示例过滤出网络名称包含foobar字符中的所有网络。

也可以指定名称的部分匹配：

Type

type过滤器支持两个值;builtin显示预定义的网络(bridge,none,host)，costom显示用户定义的网络。
下面示例过滤出所有用户定义的网络：

通过这个命令可以清理网络。例如，使用这个过滤可以删除所有的用户定义的网络：

当尝试删除仍然有容器连接到的网络时将出现一个waring。

返回一个或多个网络的信息。默认下，这个命令以JSON格式输出网络信息。例如，连接两个容器到默认的bridge网络：

docker network inspect命令在其输出结果中包含容器ID。对于由多主机网络驱动程序支持的网络（如Overlay），此命令还会显示集群中其他主机上的容器endpoints。这些endpoints在输出中表示为“ep-{endpoint-id}”。 但是，对于群集范围的网络，仅显示该节点本地的endpoints。

返回关于用户定义网络的信息：

docker network create用来创建一个新的网络。其中–driver可以指定bridge或内置网络驱动overlay。如果安装了第三方的或自己编写的网络驱动，也可以指定到这里。如果不指定–driver选项，这个命令将自动为你创建一个bridge网络。当安装docker engine时它自动创建了一个bridge网络。这个网络对应于Engine传统上依赖的docker0 bridge。当使用docker run启动一个容器时会自动连接到这个bridge网络。不可以删除这个默认的bridge网络，不过可以使用docker network create命令来创建一个新的。

bridge网络是在单台Engine安装上的隔离网络。如果想创建一个跨多个运行着Engine的docker主机，必须创建一个overlay网络。不像bridge网络，在创建overlay网络之前，需要一些预存在的条件。这些条件是：

一个能够访问的键值存储。Engine支持Consul, Etcd, 和ZooKeeper (分布式的存储)键值存储.

集群中的节点能够连接到这个键值存储。

在集群中的每台主机正确地配置Engine daemon。

dockerd支持overlay网络的选项是：

–cluster-store

–cluster-store-opt

–cluster-advertise

虽然不是必须的，但推荐安装docker swarm来管理组成你的网络的集群。Swarm提供了成熟的发现和服务器管理工具，可以帮助你更好地管理集群。
一旦满足了overlay网络的配置前提条件，只需要在集群中的任何一台主机执行创建网络命令：

网络名称必须是唯一的。docker daemon虽然会尝试识别名称冲突，但无法保证都会工作。避免名称冲突这个是用户的责任。

连接容器

当运行一个容器时，使用–network标志来连接它到一个网络。下面的示例是把busybox容器添加到mynet网络：

如果想在容器已经在运行时把它添加到一个网络，使用docker network connect子命令。
可以连接多个容器到一个相同的网络。一旦连接成功，这些容器就可以使用另一个容器的IP地址或名称来互相通信。对于支持多主机连接的overlay网络或自定义插件，那些连接到相同的多主机网络但在不同的Engine启动的容器也能够以这种方式来互相通信。
可以使用docker network disconnect命令来从一个网络断开一个容器。

指定高级选项

当创建一个网络时，Engine默认为这个网络创建一个不重叠的子网。这个子网不是现有网络的细分。 它纯粹是为了寻址目的。可以直接使用–subnet选项来覆盖这个默认行为并指定一个子网。在一个bridge网络上创建一个单独的子网：

除此之外，可以指定–gateway –ip-range和–aux-address选项。

如果没有指定–gateway，那么Engine将从首选的ip池中为你选择一个gateway。对于overlay网络和及类似功能的网络驱动，可以创建多个子网。

要确保子网没有重叠。如果重叠了，网络创建将失败，然后Engine返回一个错误。

bridge驱动选项

当创建一个自定义的网络时，默认的网络驱动(如bridge)可以传递额外的选项。下面是这些选项且有与docker daemon选项等同的选项：

选项	等同	描述
com.docker.network.bridge.name	–	创建Linux bridge使用的bridge名称
com.docker.network.bridge.enable_ip_masquerade	–ip-masq	启用IP伪装
com.docker.network.bridge.enable_icc	–icc	启用或禁用容器间连接
com.docker.network.bridge.host_binding_ipv4	–ip	绑定容器端口时默认绑定的IP
com.docker.network.driver.mtu	–mtu	设置容器网络MTU

下面这些参数可以传递给docker network create，可以用于任何网络驱动。

参数	等同	描述
–gateway	–	主子网的IPv4或IPv6网关
–ip-range	–fixed-cidr	从一个IP范围分配IP
–internal	–	限制外网网络连接到这个网络
–ipv6	–ipv6	启用Ipv6网络
–subnet	–bip	子网

例如，使用-o或–opt选项当发布端口时绑定的IP地址：

网络内部模式

默认下，当连接一个容器到一个overlay网络时，docker同时也连接到bridge网络来提供外部连接。如果想创建一个与外部隔离的overlay网络，可以指定–internal选项。

这个命令用来连接一个容器到一个网络。可以通过名称或ID来连接容器。一旦连接成功，这个容器就能够与在同一网络的其它容器通信。

也可以使用docker run –network=命令启动一个容器并立即连接它到一个网络。

可以指定你想分配到这个容器接口的IP地址。

可以使用–link选项来指定一个首选别名来连接到另一个容器。

–alias选项用来指定一个可以在将要连接的网络使用的别名。

可以暂停，重启和停止那么已连接到一个网络的容器。当容器运行时将立即连接到它所配置的网络。
如果指定了容器IP，当重新启动已停止的容器时将重新应用这个IP。如果Ip地址不可用，容器将启动失败。保证这个IP一直可用的一个方法是在创建网络时指定一个–ip-range，然后从这个IP范围外选择一个静态IP地址。这样就确保了当容器不在这个网络时(容器停止时)这个IP地址不会分配给其它容器。

要验证这个容器是否已连接到网络，使用docker network inspect命令。使用docker network disconnect来从网络删除容器。

docker update命令可以动态地更新容器配置。可以使用这个命令限制容器在docker主机上使用太多的资源。可以在命令后台加一个或多个容器来批量更新配置。多个容器名称或ID之间使用空格分隔。
除了–kernel-memory选项，其它的选项可以应用在运行或停止的容器。–kernel-memory只可以应用在已停止的容器。当在已停止的容器运行docker update命令时，更新的配置将在下一次重启容器时生效。
另一个可以更新的命令是restart策略，当执行docker update之后，新的restart策略将立即生效。

示例

更新一个容器为cpu-shares=512

更新容器的cpu-shares和memory

更新容器restart策略

docker stats命令返回运行中的容器的实时数据流。要限制显示一个或多个指定的容器，以空格分隔指定容器名称或ID列表。可以指定一个已停止的容器，不过不会返回任何数据。
如果想要更多详细的关于容器资源使用的信息。使用/containers/(id)/stats API endpoint。

示例

运行docker stats查看所有运行中的容器资源使用情况

查看多个容器资源使用