跳到主要内容

podman pod inspect - 显示描述Pod的信息

概要​

podman pod 检查 [选项] pod ...

描述​

显示给定Pod的配置和状态信息。它还会显示属于Pod的容器的信息。

选项​

以下是podman pod inspect命令可用的选项：

  • --format, -f 格式

    使用Go模板格式字符串来格式化输出。例如，可以使用{{.Id}}来仅显示Pod的ID。

  • --type, -t

    显示指定类型的信息。可以是"pod"或"container"。

  • --quiet, -q

    仅显示Pod或容器的ID。

  • --help

    显示帮助信息并退出。

请注意，具体的选项可能会根据Podman的版本而有所不同。要获取最新和最准确的信息，请查阅Podman的官方文档或运行podman pod inspect --help命令。

--format, -f=format​

改变默认的输出格式。这可以是支持的类型，如 'json'，或者是一个 Go 模板。 Go 模板中有效的占位符如下：

占位符说明
.BlkioDeviceReadBps块 I/O 设备读取速率，以字节/秒为单位
.BlkioDeviceWriteBps块 I/O 设备写入速率，以字节/秒为单位
.BlkioWeight块 I/O 权重
.BlkioWeightDevice块 I/O 设备权重
.CgroupParentPod cgroup 的父级
.CgroupPathPod cgroup 的路径
.ContainersPod 内的容器列表
.CPUPeriodCPU 周期
.CPUQuotaCPU 配额
.CPUSetCPUsCPU 设置的 CPU 列表
.CPUSetMemsCPU 设置的内存节点列表
.CPUSharesCPU 共享权重
.CreateCgroup是否创建了 cgroup
.CreateCommand创建命令
.Created ...Pod 创建的时间
.CreateInfra是否创建了基础设施容器
.Devices设备列表
.ExitPolicy退出策略
.HostnamePod 的主机名
.IDPod 的 ID
.InfraConfig ...基础设施配置（包含更多字段）
.InfraContainerIDPod 基础设施容器的 ID
.InspectPodData ...嵌套结构，仅供专家使用
.Labels ...Pod 的标签列表
.LockNumberPod 的 Libpod 锁编号
.MemoryLimitPod 的内存限制，单位为字节
.MemorySwapPod 的内存交换限制，单位为字节
.MountsPod 的挂载点列表
.NamePod 的名称
.NamespacePod 所在的命名空间
.NumContainersPod 中的容器数量
.RestartPolicyPod 的重启策略
.SecurityOptsPod 的安全选项
.SharedNamespacesPod 共享的命名空间列表
.StatePod 的状态（例如：running, exited, paused 等）
.VolumesFromPod 从中挂载的卷列表（通常用于共享卷）

这些占位符在输出模板时会被相应的值替换，使得用户可以根据需要定制输出格式。例如，如果你想以 json 格式输出 Pod 的 ID 和主机名，你可以使用 --format '{{json .ID}} {{json .Hostname}}'。如果你想以纯文本格式输出这些信息，可以使用 --format "{{.ID}} {{.Hostname}}"。这样，你就可以根据实际需求灵活地定制 Podman 的输出内容。 这些占位符允许用户通过 Go 模板定制 Podman 的输出内容，以满足特定的需求。例如，如果你想获取 Pod 的名称、状态以及其中的容器数量，你可以使用 --format "{{.Name}} {{.State}} {{.NumContainers}}"。这样，输出将只包含这三个字段的信息，使得输出更加简洁和清晰。

示例​

显示名为"foobar"的Pod的详细信息：

podman pod inspect foobar

以特定格式显示Pod的ID和名称：

podman pod inspect --format "{{.Id}} {{.Name}}" foobar

只显示Pod的ID：

podman pod inspect --quiet foobar

检查指定的Pod：

# podman pod inspect foobar
[
     {
         "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
         "Name": "foobar",
         "Labels": {},
         "CgroupParent": "/libpod_parent",
         "CreateCgroup": true,
         "Created": "2018-08-08T11:15:18.823115347-05:00",
         "State": "created",
         "Hostname": "",
         "SharedNamespaces": [
              "uts",
              "ipc",
              "net"
         ],
         "CreateInfra": false,
         "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699",
         "CgroupPath": "",
         "Containers": [
              {
                   "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
                   "state": "configured"
              }
         ]
     }
]

另请参阅​

历史​

Podman是一个开源项目，用于管理容器和Pod。随着时间的推移，其功能和选项可能会发生变化。为了获取最新和最准确的信息，建议查阅Podman的官方文档或源代码。

历史​

2018年8月，最初由Brent Baude整理编译。

翻译说明：

以上内容是对原始英文示例、另请参阅和历史部分的中文翻译。翻译力求准确传达原文含义，但可能因语境和文化差异而略有不同。在实际应用中，建议参考官方文档或手册页以获取最准确的信息。