Docker CLI docker ps 常用命令

Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的镜像中,然后发布到任何流行的 Linux或Windows操作系统的机器上,也可以实现虚拟化。Docker是内核虚拟化,不使用Hypervisor是不完全虚拟化,依赖内核的特性实现资源隔离。本文主要介绍Docker CLI 中 docker ps 常用命令。

1、docker ps 简介

docker ps 命令用于列出当前正在运行的Docker容器。

参考文档https://docs.docker.com/engine/reference/commandline/ps/

2、docker ps 语法

docker ps [OPTIONS]

3、docker ps 命令

1)不截断输出 (--no-trunc)

运行docker ps --no-trunc命令可显示2个已链接的容器。

docker ps --no-trunc

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

2)显示所有容器(包括已停止的容器)(-a, --all)

默认情况下,docker ps命令仅显示正在运行的容器。要查看所有容器,请使用--all(或-a)标志:

docker ps -a

docker ps命令将公开端口组合为单个范围(如果可能)。例如,公开TCP端口100、101、102的容器将在PORTS列中显示100-102 / tcp。

3)按容器显示磁盘使用情况(--size)

docker ps --size(或-s)命令为每个容器显示两种不同的磁盘大小:

docker ps --size

CONTAINER ID   IMAGE          COMMAND                  CREATED        STATUS       PORTS   NAMES        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)

  • “size”信息显示用于每个容器的可写层上使用的数据(在磁盘上)的量。
  • “virtual size”是用于容器和可写层使用的只读映像数据的总磁盘空间使用量。有关更多信息,请参考容器磁盘大小部分。

4)过滤输出(--filter)

--filter(或-f)标志格式为键=值对。如果有多个过滤条件,则传递多个标志(例如--filter“ foo = bar”--filter“ bif = baz”

目前支持的过滤器有:

过滤器

描述

id

容器的ID

name

容器的名称

label

一个表示键或键值对的任意字符串。表示为或=

exited

表示容器退出代码的整数。仅与--all选项有用。

status

created,restarting,running,removing,paused,exited或dead之一

ancestor

过滤共享给定映像作为祖先的容器。表示为[:]、或

image@digest

before或since

过滤在给定容器ID或名称之前或之后创建的容器

volume

过滤已挂载给定卷或绑定挂载的运行中容器

network

过滤连接到给定网络的运行中容器

publish或expose

过滤发布或公开给定端口的容器。表示为[/]或/[]

health

根据其健康检查状态过滤容器。其中之一为starting、healthy、unhealthy或none。

isolation

Windows守护程序专用。默认值、进程或hyperv之一。

is-task

过滤作为服务的“任务”的容器。布尔选项(true或false)

5)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标签的容器。

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

6)name

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

7)exited

exited filter通过存在状态代码匹配容器。例如,要筛选成功退出的容器:

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

8)通过 exit signal 筛选

可以使用过滤器查找已使用信号137退出的容器。

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守护程序重新启动,杀死所有正在运行的容器

9)status

status过滤器按状态匹配容器。可以使用created、restarting、running、removing、paused、exited和dead进行过滤。例如,要筛选正在运行的容器:

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

要筛选已暂停的容器:

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

10)ancestor

ancestor过滤器基于其映像或其后代匹配容器。该过滤器支持以下图像表示形式:

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

如果没有指定标记,则将使用最新标记。例如,要筛选使用最新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 version 22.04镜像进行匹配:

docker ps --filter ancestor=ubuntu:22.04

CONTAINER ID        IMAGE               COMMAND             CREATED              STATUS              PORTS               NAMES
82a598284012        ubuntu:22.04        "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:22.04        "top"               3 minutes ago        Up 3 minutes                            sleepy_bose

11)before

before过滤器仅显示在给定ID或名称的容器之前创建的容器。例如,有这些容器创建:

docker ps --filter ancestor=d0e008c6cf02

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

使用before进行过滤会得到:

docker ps --filter ancestor=d0e008c6cf02

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

12)since

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

13)volume

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

14)network

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。以下示例显示使用网络ID作为过滤器附加到net1网络的所有容器:

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

15)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

16)格式化输出(--Format)

格式化选项(--format)使用Go模板美化打印容器输出。

Go模板的有效占位符如下所示:

占位符

说明

.ID

容器ID

.Image

映像ID

.Command

引用的命令

.CreatedAt

创建容器的时间。

.RunningFor

自容器启动以来经过的时间。

.Ports

暴露的端口。

.State

容器状态(例如“created”、“running”、“exited”)。

.Status

带有关于持续时间和健康状态的详细信息的容器状态。

.Size

容器磁盘大小。

.Names

容器名称。

.Labels

分配给容器的所有标签。

.Label

此容器的特定标签的值。例如 '{{.Label“com.docker.swarm.cpu”}}'

.Mounts

安装在此容器中的卷的名称。

.Networks

附加到此容器的网络的名称。

当使用--format选项时,ps命令将输出数据与模板完全相同,或者当使用表格指示符时,还包括列标题。

以下示例使用没有标题的模板,并为所有正在运行的容器输出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

要以JSON格式列出所有正在运行的容器,请使用json指令:

docker ps --format json
{"Command":"\"/docker-entrypoint.…\"","CreatedAt":"2021-03-10 00:15:05 +0100 CET","ID":"a762a2b37a1d","Image":"nginx","Labels":"maintainer=NGINX Docker Maintainers \u003cdocker-maint@nginx.com\u003e","LocalVolumes":"0","Mounts":"","Names":"boring_keldysh","Networks":"bridge","Ports":"80/tcp","RunningFor":"4 seconds ago","Size":"0B","State":"running","Status":"Up 3 seconds"}

4、命令选项

选项

默认

描述

--all, -a

显示所有容器(默认只显示正在运行的)

--filter, -f

根据提供的条件筛选输出

--format

使用自定义模板格式化输出:

'table': 以带有列标题的表格格式打印输出(默认)

 'table TEMPLATE': 使用给定的Go模板以表格格式打印输出 

'json': 以JSON格式打印输出 

'TEMPLATE': 使用给定的Go模板打印输出。

有关使用模板格式化输出的更多信息,请参见

https://docs.docker.com/go/formatting/。

--last, -n

-1

显示最近创建的n个容器(包括所有状态)

--latest, -l

显示最新创建的容器(包括所有状态)

--no-trunc

不截断输出

--quiet, -q

仅显示容器ID

--size, -s

显示总文件大小


推荐阅读
cjavapy编程之路首页