标签：docker

返回一个或多个网络的信息。默认下，这个命令以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查看所有运行中的容器资源使用情况

查看多个容器资源使用

示例

这将删除在link /redis下引用的容器。

这将删除/webapp和/redis容器之间的底层链接，删除所有网络通信。

在link /redis下引用的容器中的主进程将收到SIGKILL，然后容器将被删除。

这个命令将删除所有已停止的容器。命令docker ps -a -q返回所有退出的容器ID并传递它们到rm命令，然后删除。任何正在运行中的容器不会被删除。

这个命令将删除redis容器及与之关联的数据卷。注意如果数据卷指定了一个名称，将不会被删除。

在这个示例中，/foo数据卷仍然保留，不过/bar数据卷将被删除。–volumes-from将继承这样的行为。

运行docker ps –no-trunc显示两2个链接容器。

docker ps命令默认只显示运行中的容器。要查看所有的容器，使用-a (或–all)标志：

docker ps将暴露的端口组合到单个范围中（如果可能）。 例如，暴露TCP端口100,101,102的容器在PORTS列中显示100-102 / tcp。

过滤

过滤标志(-f或–filter)格式是key=value。如果超过一个过滤，就传递多个标志(如–filter “foo=bar” –filter “bif=baz”)
目前支持的过滤有:

id(容器id)

label(label=或label=<key=>)

name(容器名称)

exited(整数 – 容器退出码。只在使用–all才有用)

status (created restarting running paused exited dead)

ancestor([:], or ) – 过滤从指定镜像创建的容器。

before (容器的名称或id) – 过滤在给定id或名称之前创建的容器。

since (容器的名称或id) – 过滤在给定id或名称之后创建的容器。

isolation (default process hyperv) (Windows daemon only)

volume (数据卷名称或挂载点) – 过滤挂载有指定数据卷的容器。

network (网络id或名称) – 过滤连接到指定网络的容器。

Label

label过滤器基于一个label的存在或label和值来匹配容器。
下面的过滤器指定label color不管它什么值来匹配容器。

下面过滤器指定label color及值blue来匹配容器。

Name

name过滤器全匹配或部分匹配容器名称。
下面的过滤器匹配容器名称包含nostalgic_stallman字符串的容器。

也可以匹配名称中的部分字符：

Exited

exited过滤器基于容器退出码匹配。例如，过滤那么成功退出的容器。

Killed容器

可以使用一个过滤器来过滤出那么以退出码137退出的容器，意味着此容器收到了SIGKILL(9)信号。

下面的任何一种情况都会导致以137代码退出：

手动终止容器的init进程

docker kill终止容器

docker daemon重启终止了所有运行中的容器

Status

status过滤器通过status来匹配容器。可以使用created, restarting, running, paused, exited 和 dead来过滤。例如，过滤状态码running的容器：

过滤paused容器：

Ancestor

ancestor过滤器基于容器的镜像来匹配容器。过滤器支持以下镜像表示方式：

image

image:tag

image:tag@digest

short-id

full-id

如果不指定tag，就使用latest tag。例如，过滤那么使用latest ubuntu镜像的容器：

匹配基于ubuntu-c1镜像的容器，在这里ubuntu-c1是基于ubuntu创建的。

匹配基于ubuntu，版本12.04.5镜像的容器：

下面匹配基于数据层d0e008c6cf02或在数据层堆栈中有这个数据层的镜像的容器。

Before

before过滤器显示在给定容器id或名称之前创建的容器。例如，目前有这些容器：

过滤在容器9c3527ed70ce之前创建的容器：

Since

since过滤器显示在给定容器id或名称之后创建的容器。例如，过滤出在6e63f6ff38b0之后创建的容器：

Volume

volume过滤器显示挂载有指定数据卷或有一个数据卷挂载到指定路径的容器：

Network

network过滤器显示连接到指定网络的容器。
下面过滤出匹配连接到网络为net1的容器：

network过滤器可以基于网络名称和id来匹配。下面的示例显示连接到net1网络的容器，使用的是网络id来匹配：

格式化

格式化选项(–format)使用Go模板来美化打印容器输出。
Go模板有效的占位符如下：

.ID 容器ID

.Image 镜像ID

.Command Quoted command

.CreatedAt 创建容器的时间点.

.RunningFor 从容器创建到现在过去的时间.

.Ports 暴露的端口.

.Status 容器状态.

.Size 容器占用硬盘大小.

.Names 容器名称.

.Labels 容器所有的标签.

.Label 指定label的值 例如'{{.Label “com.docker.swarm.cpu”}}’

.Mounts 挂载到这个容器的数据卷名称

示例1：

示例2:

docker port用来找出容器所有的端口映射，或指定一个端口的映射关系。
例如：

docker pause命令使用cgroups freezer挂起容器中的所有进程。传统上使用SIGSTOP信号来挂起一个进程，不过进程会察觉到挂起操作。使用cgroups freezer时，进程感知不到和无法捕获它正在挂起和随后的恢复。
更多的信息查看cgroups freezer文档

docker logs命令批量获取运行时出现的日志。

注意：这个命令只对那么使用json-file和journald日志驱动的容器有效。

docker logs –follow命令将持续从容器STDOUT和STDERR输出新的日志。
对–tail参数指定负数或非正整数是无效的，在这种情况下将设置这个值为all。
docker logs –timestamps命令将为每条日志添加一个RFC3339Nano时间戳，例如2014-09-16T06:17:46.000000000Z。
docker logs –details命令将添加额外的属性，例如环境变量和labels，这些额外的属性是在创建容器时通过–log-opt选项指定的。
–since选项显示从一个给定日期之后的容器日志。这个选项可以与–follow,–tail混合使用。