«

docker 命令解析之`PS`

查看 docker 容器,必然要用到 docker ps 命令。

一、基本格式

docker ps [OPTIONS]  

关键在于 OPTIONS(选项):

|**名称, 简写** | **默认** | **描述**| |---|---|---| |--all, -a | false | Show all containers (default shows just running)| |--filter, -f | | Filter output based on conditions provided| |--format | | Pretty-print containers using a Go template| |--last, -n | -1 | Show n last created containers (includes all states)| |--latest, -l | false | Show the latest created container (includes all states)| |--no-trunc | false | Don’t truncate output| |--quiet, -q | false | Only display numeric IDs| |--size, -s | false | Display total file sizes|

二、常见用法

1. 最常见的用法

$ docker ps

显示当前正在运行的容器。

PORTS 一列,如果暴露的端口是连续的,还会被合并再一起,例如一个容器暴露了3个 TCP 端口:100,101,102,则会显示未 100-102/tcp

2. 显示所有状态的容器

$ docker ps -a

容器的状态共有 7 种:created|restarting|running|removing|paused|exited|dead

3. 显示最后被创建的 n 个容器

$ docker ps -n 3

注意,这里不限状态。

4. 显示最后被创建的容器

$ docker ps -l

相当于 docker ps -n 1

5. 显示完整输出

$ docker ps --no-trunc

即不会截断输出。

该选项有点长,其中 trunc 算是 truncate 的缩写。

6. 只显示容器 ID

$ docker ps -q

清理容器时非常好用,filter 过滤显示一节有具体实例。

6. 显示容器文件大小

$ docker ps -s

该命令很实用,可以获得 2 个数值:一个是容器真实增加的大小,一个是整个容器的虚拟大小。

查看源码后可知,容器虚拟大小=容器真实增加大小+容器镜像大小

三、高级用法

1. filter 过滤显示

如果容器数量过多,或者想排除干扰容器,可以通过 --filter-f 选项,过滤需要显示的容器。

当前支持的过滤条件非常丰富,包括:

|**过滤条件** | **描述**| |---|---| |id | container's id| |label | `label=` or `label==`| |exited | int - the code of exited containers. Only useful with --all| |status | `created\restarting\running\removing\paused\exited\dead`| |ancestor | `[:], or ` - filters containers that were created from the given image or a descendant| |before | container's id or name - filters containers created before given id or name| |since | container's id or name - filters containers created since given id or name| |isolation | `default\process\hyperv` (Windows daemon only)| |volume | volume name or mount point - filters containers that mount volumes.| |network | network id or name - filters containers connected to the provided network| |health | `starting\healthy\unhealthy\none` - filters containers based on healthcheck status|

条件虽多,但万变不离其宗,只要再记住以下 3 条准则:

  1. 选项后跟的都是键值对 key=value (可不带引号),如果有多个过滤条件,就多次使用 filter 选项。例如:
docker ps --filter id=a1b2c3 --filter name=bingohuang  
  1. 相同条件之间的关系是,不同条件之间的关系是。例如:
docker ps --filter name=bingo --filter name=huang --filter status=running  

以上过滤条件会找出 name 包含 bingohuang 并且 statusrunning 的容器。

  1. idname,支持正则表达式,使用起来非常灵活。例如:
docker ps --filter name=^/bingohuang$  

精确匹配 namebingohuang 的容器。注意,容器实际名称,开头是有一个正斜线 / ,可用 docker inspect 一看便知。

docker ps --filter name=.*bingohuang.*  

匹配 name 包含 bingohuang 的容器,和 --filter name=bingohuang 一个效果。

最后, 举一个复杂点的例子,用于清理名称包含 bingohuang,且状态为 exiteddead 的容器:

docker rm $(docker ps -q --filter name=.*bingohuang.* --filter status=exited --filter status=dead 2>/dev/null)  

2. format 格式化显示

如果想自定义显示容器字段,可以用格式化选项 --format

基于 Go template 语法,可用的占位符如下:

|**占位符** | **描述**| |---|---| |.ID | Container ID| |.Image | Image ID| |.Command | Quoted command| |.CreatedAt | Time when the container was created.| |.RunningFor | Elapsed time since the container was started.| |.Ports | Exposed ports.| |.Status | Container status.| |.Size | Container disk size.| |.Names | Container names.| |.Labels | All labels assigned to the container.| |.Label | Value of a specific label for this container. For example '{{.Label "com.docker.swarm.cpu"}}'| |.Mounts | Names of the volumes mounted in this container.| |.Networks | Names of the networks attached to this container.|
  1. 当使用了 --format 选项,那么 ps 命令只会输出 template 中指定的内容:
$ 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  
  1. 如果想带上表格列头,需要再 template 中加上 table 指令:
$ 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  
分享