显示容器、镜像、卷、网络或 Pod 的配置

概述

podman inspect [选项] 名称 [...]

描述

此命令用于显示通过名称或 ID 标识的容器和镜像的低级信息。默认情况下，此命令将所有结果以 JSON 数组的形式呈现。如果指定了 inspect 类型为 all，则检查的顺序为：容器、镜像、卷、网络和 Pod。如果容器的名称与镜像的名称相同，则返回容器的 JSON 信息，以此类推。如果指定了格式，则针对每个结果执行给定的模板。

更多检查选项，请参见：

podman-container-inspect(1)：查看容器详细信息的Podman命令。
podman-image-inspect(1)：获取镜像详细信息的Podman命令。
podman-network-inspect(1)：查看Podman网络详细配置的命令。
podman-pod-inspect(1)：检查Podman Pod状态和配置的命令。
podman-volume-inspect(1)：用于查看Podman卷详细信息的命令。

选项

--format, -f=格式

使用给定的 Go 模板格式化输出。返回的 JSON 的键可以用作 --format 标志的值（参见以下示例）。

--size, -s

除了正常输出外，如果类型是容器，则显示总文件大小。

--type, -t=类型

返回指定类型的 JSON。类型可以是 'container'、'image'、'volume'、'network'、'pod' 或 'all'（默认：all）（仅当作为 podman inspect 调用时才有意义）

示例

显示指定容器的详细信息

podman inspect <container-name-or-id>

显示指定镜像的详细信息

podman inspect <image-name-or-id>

使用 Go 模板格式化输出

podman inspect --format '{{.Id}} {{.Image}}' <container-name-or-id>

上面的命令将仅显示容器的 ID 和镜像名称。

显示所有类型（容器、镜像、卷、网络、Pod）的详细信息

podman inspect --type all

显示容器的详细信息，包括文件大小

podman inspect --size <container-name-or-id>

*示例

检查 Fedora 镜像

# podman inspect fedora
[
    {
        "Id": "f0858ad3febdf45bb2e5501cb459affffacef081f79eaa436085c3b6d9bd46ca",
        "Digest": "sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a",
        "RepoTags": [
            "docker.io/library/fedora:latest"
        ],
        "RepoDigests": [
            "docker.io/library/fedora@sha256:8fa60b88e2a7eac8460b9c0104b877f1aa0cea7fbc03c701b7e545dacccfb433",
            "docker.io/library/fedora@sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a"
        ],
        "Parent": "",
        "Comment": "",
        "Created": "2019-10-29T03:23:37.695123423Z",
        "Config": {
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "DISTTAG=f31-updates-candidatecontainer",
                "FGC=f31-updates-candidate",
                "FBR=f31-updates-candidate"
            ],
            "Cmd": [
                "/bin/bash"
            ],
            "Labels": {
                "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
            }
        },
        "Version": "18.06.1-ce",
        "Author": "",
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 201096840,
        "VirtualSize": 201096840,
        "GraphDriver": {
            "Name": "overlay",
            "Data": {
                "UpperDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/diff",
                "WorkDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/work"
            }
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9"
            ]
        },
        "Labels": {
            "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
        },
        "Annotations": {},
        "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
        "User": "",
        "History": [
            {
                "created": "2019-01-16T21:21:55.569693599Z",
                "created_by": "/bin/sh -c #(nop)  LABEL maintainer=Clement Verna \u003ccverna@fedoraproject.org\u003e",
                "empty_layer": true
            },
            {
                "created": "2019-09-27T21:21:07.784469821Z",
                "created_by": "/bin/sh -c #(nop)  ENV DISTTAG=f31-updates-candidatecontainer FGC=f31-updates-candidate FBR=f31-updates-candidate",
                "empty_layer": true
            },
            {
                "created": "2019-10-29T03:23:37.355187998Z",
                "created_by": "/bin/sh -c #(nop) ADD file:298f828afc880ccde9205fc4418435d5e696ad165e283f0530d0b1a74326d6dc in / "
            },
            {
                "created": "2019-10-29T03:23:37.695123423Z",
                "created_by": "/bin/sh -c #(nop)  CMD [\"/bin/bash\"]",
                "empty_layer": true
            }
        ],
        "NamesHistory": []
    }
]

使用 ImageName 格式说明符检查指定的镜像

查看镜像的名称:

# podman inspect a04 --format "{{.ImageName}}"
fedora

这个命令用于检查 ID 或名称为 a04 的镜像，并仅显示其名称。

查看镜像的存储驱动名称:

# podman inspect a04 --format "{{.GraphDriver.Name}}"
overlay

这个命令显示了 a04 镜像使用的存储驱动名称。

查看镜像的大小:

# podman image inspect --format "size: {{.Size}}" alpine
size: 4405240

这个命令检查了名为 alpine 的镜像，并显示其大小。

查看最新容器的有效能力（Capabilities）:

podman container inspect --latest --format {{.EffectiveCaps}}
[CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_KILL]

这个命令提取了最近创建的容器的有效能力列表。请注意，此选项确实不适用于远程 Podman 客户端（例如 Mac 和 Windows 上的客户端，除非使用的是 WSL2）。

查看指定 Pod 的名称:

# podman inspect myPod --type pod --format "{{.Name}}"
 myPod

这个命令用于检查名为 myPod 的 Pod 并显示其名称。

查看指定卷的名称:

# podman inspect myVolume --type volume --format "{{.Name}}"
myVolume

这个命令显示了名为 myVolume 的卷的名称。

查看指定网络的名称:

# podman inspect myNetwork --type network --format "{{.Name}}"
myNetwork

这个命令用于检查名为 myNetwork 的网络并显示其名称。通过运行这些命令并带上 --help 参数，你可以获取每个命令的更多详细信息和可用选项。使用 --format 选项时，你可以根据需要自定义输出，以便仅显示你关心的具体信息部分。这对于脚本编写或快速查看特定属性非常有用。这些命令和手册页与 Podman 容器管理工具相关。Podman 是一个无守护进程的容器引擎，用于管理容器、镜像、卷、网络和 Pod。上述命令分别用于检查容器、镜像、网络、Pod 和卷的详细信息。

另请参阅

podman(1): Podman 的主命令，用于管理容器和其他相关资源。
podman-container-inspect(1): 用于检查容器的详细信息。
podman-image-inspect(1): 用于检查镜像的详细信息。
podman-network-inspect(1): 用于检查网络的详细信息。
podman-pod-inspect(1): 用于检查 Pod 的详细信息。
podman-volume-inspect(1): 用于检查卷的详细信息。

历史

July 2017, 最初由 Dan Walsh 整理编写。

Podman 项目自 2017 年 7 月开始，由 Red Hat 的 Dan Walsh 等人开发并维护。随着容器技术的不断发展和 Podman 项目的完善，这个工具已经成为了管理容器化应用的重要工具之一。Podman 的手册页和文档也随着版本的更新而不断完善，为用户提供更详细的指导和帮助。

概述​

描述​

选项​

--format, -f=格式​

--size, -s​

--type, -t=类型​

示例​

显示指定容器的详细信息​

显示指定镜像的详细信息​

使用 Go 模板格式化输出​

显示所有类型（容器、镜像、卷、网络、Pod）的详细信息​

显示容器的详细信息，包括文件大小​

*示例​

使用 ImageName 格式说明符检查指定的镜像​

另请参阅​

历史​

概述

描述

选项