码头工人ps

描述

列出容器

用法

$ docker ps [OPTIONS]

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--all ， -a 显示所有容器（默认显示为正在运行）
--filter ， -f 根据提供的条件过滤输出
--format 使用Go模板打印漂亮的容器
--last ， -n -1 显示n个最后创建的容器（包括所有状态）
--latest ， -l 显示最新创建的容器（包括所有状态）
--no-trunc 不要截断输出
--quiet ， -q 仅显示容器ID
--size ， -s 显示文件总大小

例子

防止截断输出

正在运行，docker ps --no-trunc显示2个链接的容器。

$ docker ps

CONTAINER ID        IMAGE                        COMMAND                CREATED              STATUS              PORTS               NAMES
4c01db0b339c        ubuntu:12.04                 bash                   17 seconds ago       Up 16 seconds       3300-3310/tcp       webapp
d7886598dbe2        crosbymichael/redis:latest   /redis-server --dir    33 minutes ago       Up 33 minutes       6379/tcp            redis,webapp/db

显示正在运行和已停止的容器

docker ps默认情况下，该命令仅显示正在运行的容器。要查看所有容器，请使用-a（或--all）标志：

$ docker ps -a

docker ps如果可能，将裸露的端口分组为一个范围。例如，在列中100, 101, 102显示一个暴露TCP端口的容器。100-102/tcpPORTS

按容器显示磁盘使用情况

该docker ps -s命令为每个容器显示两种不同的磁盘大小：

$ docker ps -s

CONTAINER ID   IMAGE          COMMAND                  CREATED        STATUS       PORTS   NAMES        SIZE                                                                                      SIZE
e90b8831a4b8   nginx          "/bin/bash -c 'mkdir "   11 weeks ago   Up 4 hours           my_nginx     35.58 kB (virtual 109.2 MB)
00c6131c5e30   telegraf:1.5   "/entrypoint.sh"         11 weeks ago   Up 11 weeks          my_telegraf  0 B (virtual 209.5 MB)
  • “大小”信息显示用于每个容器可写层的数据量（在磁盘上）
  • “虚拟大小”是用于容器和可写层使用的只读图像数据的磁盘空间总量。

有关更多信息，请参阅磁盘上的容器大小部分。

筛选

过滤标志（-f或--filter）格式为一key=value对。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）

当前支持的过滤器是：

筛选 描述
id 货柜编号
name 货柜名称
label 代表键或键值对的任意字符串。表示为<key>或<key>=<value>
exited 表示容器的退出代码的整数。仅对有用--all。
status 一created，restarting，running，removing，paused，exited，或者dead
ancestor 筛选共享给定图像作为祖先的容器。表现为<image-name>[:<tag>]， <image id>或<image@digest>
before 或者 since 过滤在给定容器ID或名称之前或之后创建的容器
volume 过滤运行已安装给定卷或绑定安装的容器。
network 筛选正在运行的连接到给定网络的容器。
publish 或者 expose 筛选发布或公开给定端口的容器。表示为<port>[/<proto>]或<startport-endport>/[<proto>]
health 根据健康检查状态过滤容器。一starting，healthy，unhealthy或none。
isolation 仅Windows守护程序。其中一个default，process或hyperv。
is-task 筛选作为服务“任务”的容器。布尔选项（true或false）

标签

的label过滤器匹配基础上的存在容器label单独或label和值。

以下过滤器将容器与color标签匹配，而不管其值如何。

$ docker ps --filter "label=color"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
673394ef1d4c        busybox             "top"               47 seconds ago      Up 45 seconds                           nostalgic_shockley
d85756f57265        busybox             "top"               52 seconds ago      Up 51 seconds                           high_albattani

以下过滤器将容器与color带有blue值的标签匹配。

$ docker ps --filter "label=color=blue"

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
d85756f57265        busybox             "top"               About a minute ago   Up About a minute                       high_albattani

名称

该name过滤器上的容器的名字的全部或部分匹配。

以下过滤器将匹配包含名称包含nostalgic_stallman字符串的所有容器。

$ docker ps --filter "name=nostalgic_stallman"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9b6247364a03        busybox             "top"               2 minutes ago       Up 2 minutes                            nostalgic_stallman

您还可以过滤名称中的子字符串，如下所示：

$ docker ps --filter "name=nostalgic"

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox             "top"               3 seconds ago       Up 1 second                             i_am_nostalgic
9b6247364a03        busybox             "top"               7 minutes ago       Up 7 minutes                            nostalgic_stallman
673394ef1d4c        busybox             "top"               38 minutes ago      Up 38 minutes                           nostalgic_shockley

退出

该exited过滤器匹配的存在状态代码容器。例如，要筛选成功退出的容器，请执行以下操作：

$ docker ps -a --filter 'exited=0'

CONTAINER ID        IMAGE             COMMAND                CREATED             STATUS                   PORTS                      NAMES
ea09c3c82f6e        registry:latest   /srv/run.sh            2 weeks ago         Exited (0) 2 weeks ago   127.0.0.1:5000->5000/tcp   desperate_leakey
106ea823fe4e        fedora:latest     /bin/sh -c 'bash -l'   2 weeks ago         Exited (0) 2 weeks ago                              determined_albattani
48ee228c9464        fedora:20         bash                   2 weeks ago         Exited (0) 2 weeks ago                              tender_torvalds

按出口信号过滤

您可以使用过滤器来定位退出的容器，其状态137 表示已SIGKILL(9)杀死它们。

$ docker ps -a --filter 'exited=137'

CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                       PORTS               NAMES
b3e1c0ed5bfe        ubuntu:latest       "sleep 1000"           12 seconds ago      Exited (137) 5 seconds ago                       grave_kowalevski
a2eb5558d669        redis:latest        "/entrypoint.sh redi   2 hours ago         Exited (137) 2 hours ago                         sharp_lalande

这些事件中的任何一个都会导致以下137状态：

  • init容器的过程被手动杀死
  • docker kill 杀死容器
  • Docker守护程序重新启动，这将杀死所有正在运行的容器

地位

该status过滤器的状态相匹配的容器。您可以使用筛选 created，restarting，running，removing，paused，exited和dead。例如，要过滤running容器：

$ docker ps --filter status=running

CONTAINER ID        IMAGE                  COMMAND             CREATED             STATUS              PORTS               NAMES
715ebfcee040        busybox                "top"               16 minutes ago      Up 16 minutes                           i_am_nostalgic
d5c976d3c462        busybox                "top"               23 minutes ago      Up 23 minutes                           top
9b6247364a03        busybox                "top"               24 minutes ago      Up 24 minutes                           nostalgic_stallman

要过滤paused容器：

$ docker ps --filter status=paused

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS                      PORTS               NAMES
673394ef1d4c        busybox             "top"               About an hour ago   Up About an hour (Paused)                       nostalgic_shockley

祖先

该ancestor过滤器匹配基于它的形象或它的后代在集装箱上。过滤器支持以下图像表示形式：

  • image
  • image:tag
  • image:tag@digest
  • short-id
  • full-id

如果您未指定tag，latest则使用标记。例如，要过滤使用最新ubuntu图像的容器，请执行以下操作：

$ docker ps --filter ancestor=ubuntu

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace
5d1e4a540723        ubuntu-c2           "top"               About a minute ago   Up About a minute                       admiring_sammet
82a598284012        ubuntu              "top"               3 minutes ago        Up 3 minutes                            sleepy_bose
bab2a34ba363        ubuntu              "top"               3 minutes ago        Up 3 minutes                            focused_yonath

根据ubuntu-c1图片来匹配容器，在这种情况下，该图片是的子级ubuntu：

$ docker ps --filter ancestor=ubuntu-c1

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
919e1179bdb8        ubuntu-c1           "top"               About a minute ago   Up About a minute                       admiring_lovelace

根据ubuntu版本12.04.5图片匹配容器：

$ docker ps --filter ancestor=ubuntu:12.04.5

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:12.04.5      "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

以下内容基于图层d0e008c6cf02或在其图层堆栈中包含该图层的图像来匹配容器。

$ docker ps --filter ancestor=d0e008c6cf02

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:12.04.5      "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

创造时间

前

该before过滤器只显示容器与给定id或名称容器之前创建的。例如，创建以下容器：

$ docker ps

CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
9c3527ed70ce        busybox     "top"         14 seconds ago       Up 15 seconds                          desperate_dubinsky
4aace5031105        busybox     "top"         48 seconds ago       Up 49 seconds                          focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat

过滤before将得到：

$ docker ps -f before=9c3527ed70ce

CONTAINER ID        IMAGE       COMMAND       CREATED              STATUS              PORTS              NAMES
4aace5031105        busybox     "top"         About a minute ago   Up About a minute                      focused_hamilton
6e63f6ff38b0        busybox     "top"         About a minute ago   Up About a minute                      distracted_fermat
自从

该since过滤器只显示容器，因为与给定id或名称的容器中创建。例如，使用与before过滤器相同的容器：

$ docker ps -f since=6e63f6ff38b0

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9c3527ed70ce        busybox     "top"         10 minutes ago      Up 10 minutes                           desperate_dubinsky
4aace5031105        busybox     "top"         10 minutes ago      Up 10 minutes                           focused_hamilton

体积

该volume过滤器只示出了该支架的特定体积或具有安装在一个特定的路径的容积的容器：

$ docker ps --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"

CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

$ docker ps --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"

CONTAINER ID        MOUNTS
9c3527ed70ce        remote-volume

网络

所述network唯一滤波器显示了连接到网络的具有给定名称或ID的容器。

以下过滤器匹配名称为的所有连接到网络的容器net1。

$ docker run -d --net=net1 --name=test1 ubuntu top
$ docker run -d --net=net2 --name=test2 ubuntu top

$ docker ps --filter network=net1

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

网络过滤器会同时匹配网络的名称和ID。下面的示例net1使用网络ID作为过滤器，显示连接到网络的所有容器。

$ docker network inspect --format "{{.ID}}" net1

8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5

$ docker ps --filter network=8c0b4110ae930dbe26b258de9bc34a03f98056ed6f27f991d32919bfe401d7c5

CONTAINER ID        IMAGE       COMMAND       CREATED             STATUS              PORTS               NAMES
9d4893ed80fe        ubuntu      "top"         10 minutes ago      Up 10 minutes                           test1

发布并公开

的publish和expose过滤器仅显示已发布或暴露端口与给定的端口号，端口范围，和/或协议的容器。tcp未指定默认协议。

以下过滤器匹配已发布端口80的所有容器：

$ docker run -d --publish=80 busybox top
$ docker run -d --expose=8080 busybox top

$ docker ps -a

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                   NAMES
9833437217a5        busybox             "top"               5 seconds ago       Up 4 seconds        8080/tcp                dreamy_mccarthy
fc7e477723b7        busybox             "top"               50 seconds ago      Up 50 seconds       0.0.0.0:32768->80/tcp   admiring_roentgen

$ docker ps --filter publish=80

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS                   NAMES
fc7e477723b7        busybox             "top"               About a minute ago   Up About a minute   0.0.0.0:32768->80/tcp   admiring_roentgen

以下过滤器匹配所有暴露了TCP端口的容器，其范围为8000-8080：

$ docker ps --filter expose=8000-8080/tcp

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
9833437217a5        busybox             "top"               21 seconds ago      Up 19 seconds       8080/tcp            dreamy_mccarthy

以下过滤器匹配具有公开UDP端口的所有容器80：

$ docker ps --filter publish=80/udp

CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES

格式设定

格式化选项（--format）使用Go模板漂亮地打印了容器的输出。

下面列出了Go模板的有效占位符：

占位符 描述
.ID 货柜编号
.Image 图片编号
.Command 引用命令
.CreatedAt 容器创建的时间。
.RunningFor 自容器启动以来经过的时间。
.Ports 裸露的端口。
.State 容器状态（例如；“已创建”，“正在运行”，“已退出”）。
.Status 容器状态以及有关持续时间和健康状态的详细信息。
.Size 容器磁盘大小。
.Names 容器名称。
.Labels 分配给容器的所有标签。
.Label 此容器的特定标签的值。例如'{{.Label "com.docker.swarm.cpu"}}'
.Mounts 安装在此容器中的卷的名称。
.Networks 附加到此容器的网络的名称。

当使用该--format选项时，该ps命令将完全按照模板声明的方式输出数据，或者在使用table指令时也包括列标题。

以下示例使用不带标题的模板，ID并为所有正在运行的容器输出Command用冒号（:）分隔的和 条目：

$ docker ps --format "{{.ID}}: {{.Command}}"

a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA
c1d3b0166030: /bin/sh -c yum -y up
41d50ecd2f57: /bin/sh -c #(nop) MA

要以表格格式列出所有正在运行的容器及其标签，可以使用：

$ docker ps --format "table {{.ID}}\t{{.Labels}}"

CONTAINER ID        LABELS
a87ecb4f327c        com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd
01946d9d34d8
c1d3b0166030        com.docker.swarm.node=debian,com.docker.swarm.cpu=6
41d50ecd2f57        com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd

上级命令

命令 描述
码头工人 Docker CLI的基本命令。