名称

podman-pod-ps - 打印有关 Pod 的信息

简介

podman pod ps [选项]

描述

podman pod ps 列出系统上的 Pod。默认情况下，它列出：

  • Pod ID

  • Pod 名称

  • Pod 创建时间

  • 连接到 Pod 的容器数量

  • Pod 基础设施容器的容器 ID

  • Pod 状态（定义如下表）

状态

描述

Created (已创建)

没有容器运行或停止

Running (运行中)

至少有一个容器正在运行

Stopped (已停止)

至少有一个容器已停止且没有容器正在运行

Exited (已退出)

Pod 中的所有容器均已停止

Dead (死亡)

检索状态时出错

选项

--ctr-ids

显示容器 ID

--ctr-names

显示容器名称

--ctr-status

显示容器状态

--filter, -f=过滤器

提供过滤值。

过滤器参数的格式为 key=value。如果存在多个过滤器，则传递多个选项：--filter foo=bar --filter bif=baz。

支持的过滤器

过滤器

描述

ctr-ids

按 Pod 内的容器 ID 过滤。（默认为 CID 前缀匹配；接受正则表达式）

ctr-names

按 Pod 内的容器名称过滤。

ctr-number

按 Pod 中的容器数量过滤。

ctr-status

按 Pod 内的容器状态过滤。

id

按 Pod ID 过滤。（默认为前缀匹配；接受正则表达式）

label

通过具有（或不具有，在 label!=[…] 的情况下）指定标签的容器进行过滤。

name

按 Pod 名称过滤。

network

按网络名称或网络的完整 ID 过滤。

status

按 Pod 状态过滤。

until

按给定时间戳之前创建的 Pod 过滤。

ctr-ids、 ctr-names、 id、 name 过滤器接受 regex 格式。

ctr-status 过滤器接受以下值： created、 running、 paused、 stopped、 exited、 unknown。

label 过滤器接受两种格式。一种是 label=key 或 label=key=value，用于删除具有指定标签的容器。另一种格式是 label!=key 或 label!=key=value，用于删除没有指定标签的容器。

until filter 可以是 Unix 时间戳、日期格式时间戳或相对于机器时间计算的 Go duration 字符串（例如 10m, 1h30m）。

status 过滤器接受以下值： stopped、 running、 paused、 exited、 dead、 created、 degraded。

--format=格式

将容器美观地打印为 JSON 或使用 Go 模板打印

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

占位符

描述

.Cgroup

Pod 的 Cgroup 路径

.ContainerIds

Pod 中容器 ID 的逗号分隔列表

.ContainerNames

Pod 中容器名称的逗号分隔列表

.ContainerStatuses

容器状态的逗号分隔列表

.Created

Pod 的创建时间

.ID

容器 ID

.InfraID

Pod 基础设施容器 ID

.Label string

Pod 的指定标签

.Labels …

分配给 Pod 的所有标签

.Name

Pod 名称

.Networks

显示连接到基础设施容器的所有网络

.NumberOfContainers

显示连接到 Pod 的容器数量

.Restarts

显示 Pod 中容器重启的总次数

.Status

Pod 状态

--help, -h

打印用法说明

--latest, -l

显示最新创建的 Pod（所有状态）（此选项不适用于远程 Podman 客户端，包括 Mac 和 Windows（不包括 WSL2）机器）

--namespace, --ns

显示 Pod 的命名空间信息

--no-trunc

不截断输出（默认为 false）。

--noheading, -n

从列表中省略表格标题。

--quiet, -q

仅打印 Pod 的数字 ID

--sort

按创建时间、ID、名称、状态或容器数量排序

默认值：created (创建时间)

示例

列出所有正在运行的 Pod。

$ podman pod ps
POD ID         NAME              STATUS    CREATED          INFRA ID       # OF CONTAINERS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   1
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   2

列出所有正在运行的 Pod 以及 Pod 内的容器名称。

$ podman pod ps --ctr-names
POD ID         NAME              STATUS    CREATED          INFRA ID       NAMES
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   loving_archimedes
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   thirsty_hawking,wizardly_golick

列出所有正在运行的 Pod 及其状态、名称和 ID。

$ podman pod ps --ctr-status --ctr-names --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS                         NAMES                             STATUS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4                loving_archimedes                 running
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e   thirsty_hawking,wizardly_golick   configured,configured

列出所有正在运行的 Pod 并打印 ID、容器名称和 cgroup。

$ podman pod ps --format "{{.ID}}  {{.ContainerNames}}  {{.Cgroup}}"
00dfd6fa02c0   loving_archimedes   /libpod_parent
f4df8692e116   thirsty_hawking,wizardly_golick   /libpod_parent

列出所有包含两个容器的正在运行的 Pod，并按 Pod ID 排序。

$ podman pod ps --sort id --filter ctr-number=2
POD ID         NAME             STATUS    CREATED          INFRA ID       # OF CONTAINERS
f4df8692e116   nifty_torvalds   Created   10 minutes ago   331693bff40a   2

列出所有正在运行的 Pod 及其容器 ID。

$ podman pod ps  --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e

列出所有正在运行的 Pod 及其容器 ID，不截断 ID。

$ podman pod ps --no-trunc --ctr-ids
POD ID                                                             NAME              STATUS    CREATED          INFRA ID                                                           IDS
00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050   ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050
f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b   nifty_torvalds    Created   10 minutes ago   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d

列出所有正在运行的 Pod 及其容器名称。

$ podman pod ps --ctr-names
POD ID         NAME   STATUS    CREATED        INFRA ID       NAMES
314f4da82d74   hi     Created   17 hours ago   a9f2d2165675   jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ...

列出所有正在运行的 Pod 及其容器 ID

$ podman pod ps --filter ctr-ids=aceb3b775797
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
952330c7cff0  web-app     Running     3 minutes ago  b0f247c49669  3

列出所有恰好包含 2 个容器的 Pod

$ podman pod ps --filter ctr-number=2
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     2 minutes ago  fda2a486b939  2

列出容器处于 exited 状态的 Pod

$ podman pod ps --filter ctr-status=exited
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
06c3a107763a  maintenance  Degraded    4 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    4 minutes ago  d6650a490b69  3

列出所有当前 Pod

$ podman pod ps
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest      Running     4 minutes ago  a28d133e8c63  3
deee8956522e  utility      Running     4 minutes ago  6b730e3ac334  3
06c3a107763a  maintenance  Degraded    4 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    4 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Running     4 minutes ago  b0f247c49669  3

按 ID 过滤 Pod

$ podman pod ps --filter id=95938982244d
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest     Running     4 minutes ago  a28d133e8c63  3

按标签过滤 Pod

$ podman pod ps --filter label=tier=frontend
POD ID        NAME         STATUS      CREATED       INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     1 second ago  fda2a486b939  2

按名称过滤 Pod

$ podman pod ps --filter name=db-cluster
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
1e3424d7e9c0  db-cluster  Degraded    4 minutes ago  d6650a490b69  3

按 Pod 状态过滤 Pod（例如，Degraded）

$ podman pod ps --filter status=degraded
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest      Degraded    7 minutes ago  a28d133e8c63  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

按时间阈值之前创建的 Pod 过滤（--until）

$ podman pod ps --filter until=2m
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     3 minutes ago  fda2a486b939  2
95938982244d  nettest      Degraded    8 minutes ago  a28d133e8c63  3
deee8956522e  utility      Running     8 minutes ago  6b730e3ac334  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

pod ps

打印 Pod 列表

另请参阅

podman(1), podman-pod(1)

历史

2018 年 7 月，最初由 Peter Hunt pehunt@redhat.com 编译