名称¶

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

概要¶

podman pod ps [选项]

描述¶

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

Pod ID
Pod 名称
Pod 创建时间
附加到 Pod 的容器数量
Pod 基础设施容器的容器 ID
以下表格定义的 Pod 状态

状态	描述
已创建	没有正在运行或停止的容器
正在运行	至少有一个容器正在运行
已停止	至少有一个容器已停止，没有容器正在运行
已退出	Pod 中的所有容器都已停止
已死	检索状态错误

选项¶

--ctr-ids¶

显示容器 ID

--ctr-names¶

显示容器名称

--ctr-status¶

显示容器状态

--filter, -f=filter¶

提供过滤器值。

过滤器参数格式为 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 过滤器可以是 Unix 时间戳、日期格式的时间戳或相对于机器时间的 Go 持续时间字符串（例如 10m、1h30m）。

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

--format=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、名称、状态或容器数量排序

默认：已创建

示例¶

列出所有正在运行的 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、容器名称和 cgroups。

$ 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 ps¶

打印 Pod 列表

另请参见¶

podman(1), podman-pod(1)

历史¶

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

名称¶

概要¶

描述¶

选项¶