NAME 名称

podman-container-inspect - Display a container’s configuration
podman-container-inspect - 显示容器的配置

SYNOPSIS 概要

podman container inspect [options] container [container …]
podman container inspect [选项] 容器 [容器 …]

DESCRIPTION 描述

This displays the low-level information on containers identified by name or ID. By default, this renders all results in a JSON array. If a format is specified, the given template is executed for each result.
这将显示通过名称或 ID 标识的容器的低级信息。默认情况下,这会将所有结果呈现为 JSON 数组。如果指定了格式,则为每个结果执行给定的模板。

OPTIONS 选项

--format, -f=format

Format the output using the given Go template. The keys of the returned JSON can be used as the values for the --format flag (see examples below).
使用给定的 Go 模板格式化输出。返回的 JSON 的键可以用作 --format 标志的值(请参见下面的示例)。

Valid placeholders for the Go template are listed below:
Go 模板的有效占位符如下所示:

Placeholder

Description

.AppArmorProfile

AppArmor profile (string)
AppArmor 配置文件(字符串)

.Args

Command-line arguments (array of strings)
命令行参数(字符串数组)

.BoundingCaps

Bounding capability set (array of strings)
边界能力集(字符串数组)

.Config … .配置 …

Structure with config info
带有配置信息的结构

.ConmonPidFile

Path to file containing conmon pid (string)
包含常见进程 ID 的文件路径 (字符串)

.Created … .创建…

Container creation time (string, ISO3601)
容器创建时间(字符串,ISO3601)

.Dependencies

Dependencies (array of strings)
依赖项(字符串数组)

.Driver

Storage driver (string) 存储驱动程序(字符串)

.EffectiveCaps

Effective capability set (array of strings)
有效能力集(字符串数组)

.ExecIDs

Exec IDs (array of strings)
执行标识(字符串数组)

.GraphDriver … .GraphDriver ...

Further details of graph driver (struct)
图形驱动程序的更多细节(结构体)

.HostConfig … .HostConfig ...

Host config details (struct)
主机配置详细信息(结构体)

.HostnamePath

Path to file containing hostname (string)
包含主机名的文件路径(字符串)

.HostsPath

Path to container /etc/hosts file (string)
容器 /etc/hosts 文件路径(字符串)

.ID

Container ID (full 64-char hash)
容器 ID(完整的 64 位哈希)

.Image

Container image ID (64-char hash)
容器镜像 ID(64 位哈希)

.ImageDigest

Container image digest (sha256:+64-char hash)
容器镜像摘要(sha256:+64 位哈希)

.ImageName

Container image name (string)
容器镜像名称(字符串)

.IsInfra

Is this an infra container? (string: true/false)
这是基础设施容器吗?(字符串:是/否)

.IsService

Is this a service container? (string: true/false)
这是服务容器吗?(字符串:是/否)

.KubeExitCodePropagation

Kube exit-code propagation (string)
Kube 退出代码传播(字符串)

.LockNumber

Number of the container’s Libpod lock
容器的 Libpod 锁编号

.MountLabel

SELinux label of mount (string)
挂载的 SELinux 标签(字符串)

.Mounts

Mounts (array of strings)
挂载点(字符串数组)

.Name

Container name (string) 容器名称(字符串)

.Namespace

Container namespace (string)
容器命名空间(字符串)

.NetworkSettings …

Network settings (struct)
网络设置 (结构)

.OCIConfigPath

Path to OCI config file (string)
OCI 配置文件路径 (字符串)

.OCIRuntime

OCI runtime name (string)
OCI 运行时名称(字符串)

.Path

Path to container command (string)
容器命令的路径(字符串)

.PidFile

Path to file containing container PID (string)
包含容器 PID 的文件路径(字符串)

.Pod

Parent pod (string) 父 Pod(字符串)

.ProcessLabel

SELinux label of process (string)
进程的 SELinux 标签(字符串)

.ResolvConfPath

Path to container’s resolv.conf file (string)
容器 resolv.conf 文件的路径(字符串)

.RestartCount

Number of times container has been restarted (int)
容器重新启动的次数(整数)

.Rootfs

Container rootfs (string)
容器的根文件系统(字符串)

.SizeRootFs

Size of rootfs, in bytes [1]
根文件系统的大小,以字节为单位 [1]

.SizeRw

Size of upper (R/W) container layer, in bytes [1]
上层(读/写)容器层的大小,以字节为单位 [1]

.State … .状态 …

Container state info (struct)
容器状态信息(结构体)

.StaticDir

Path to container metadata dir (string)
容器元数据目录的路径(字符串)

[1] This format specifier requires the --size option
[1] 此格式说明符需要 --size 选项

--latest, -l

Instead of providing the container name or ID, use the last created container. Note: the last started container can be from other users of Podman on the host machine. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
不要提供容器名称或 ID,而是使用最后创建的容器。注意:最后启动的容器可能来自主机上其他 Podman 用户。(此选项在远程 Podman 客户端中不可用,包括 Mac 和 Windows(不包括 WSL2)主机)

--size, -s --size,-s ¶

In addition to normal output, display the total file size if the type is a container.
除了正常输出外,如果类型是容器,则显示总文件大小。

EXAMPLE 例子 ¶

Inspect the specified container and print its information in json format.
检查指定的容器并以 JSON 格式打印其信息。

$ podman container inspect foobar
[
    {
        "Id": "99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6",
        "Created": "2021-09-16T06:09:08.936623325-04:00",
        "Path": "echo",
        "Args": [
            "hi"
        ],
        "State": {
            "OciVersion": "1.0.2-dev",
            "Status": "exited",
            "Running": false,
            "Paused": false,
            "Restarting": false,
            "OOMKilled": false,
            "Dead": false,
            "Pid": 0,
            "ExitCode": 0,
            "Error": "",
            "StartedAt": "2021-09-16T06:09:09.033564436-04:00",
            "FinishedAt": "2021-09-16T06:09:09.036184314-04:00",
            "Healthcheck": {
                "Status": "",
                "FailingStreak": 0,
                "Log": null
            }
        },
        "Image": "14119a10abf4669e8cdbdff324a9f9605d99697215a0d21c360fe8dfa8471bab",
        "ImageName": "docker.io/library/alpine:latest",
        "Rootfs": "",
        "Pod": "",
        "ResolvConfPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/resolv.conf",
        "HostnamePath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hostname",
        "HostsPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hosts",
        "StaticDir": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata",
        "OCIConfigPath": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/config.json",
        "OCIRuntime": "crun",
        "ConmonPidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/conmon.pid",
        "PidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/pidfile",
        "Name": "foobar",
        "RestartCount": 0,
        "Driver": "overlay",
        "MountLabel": "system_u:object_r:container_file_t:s0:c25,c695",
        "ProcessLabel": "system_u:system_r:container_t:s0:c25,c695",
        "AppArmorProfile": "",
        "EffectiveCaps": [
            "CAP_CHOWN",
            "CAP_DAC_OVERRIDE",
            "CAP_FOWNER",
            "CAP_FSETID",
            "CAP_KILL",
            "CAP_NET_BIND_SERVICE",
            "CAP_SETFCAP",
            "CAP_SETGID",
            "CAP_SETPCAP",
            "CAP_SETUID",
        ],
        "BoundingCaps": [
            "CAP_CHOWN",
            "CAP_DAC_OVERRIDE",
            "CAP_FOWNER",
            "CAP_FSETID",
            "CAP_KILL",
            "CAP_NET_BIND_SERVICE",
            "CAP_SETFCAP",
            "CAP_SETGID",
            "CAP_SETPCAP",
            "CAP_SETUID",
        ],
        "ExecIDs": [],
        "GraphDriver": {
            "Name": "overlay",
            "Data": {
                "LowerDir": "/home/dwalsh/.local/share/containers/storage/overlay/e2eb06d8af8218cfec8210147357a68b7e13f7c485b991c288c2d01dc228bb68/diff",
                "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/diff",
                "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/work"
            }
        },
        "Mounts": [],
        "Dependencies": [],
        "NetworkSettings": {
            "EndpointID": "",
            "Gateway": "",
            "IPAddress": "",
            "IPPrefixLen": 0,
            "IPv6Gateway": "",
            "GlobalIPv6Address": "",
            "GlobalIPv6PrefixLen": 0,
            "MacAddress": "",
            "Bridge": "",
            "SandboxID": "",
            "HairpinMode": false,
            "LinkLocalIPv6Address": "",
            "LinkLocalIPv6PrefixLen": 0,
            "Ports": {},
            "SandboxKey": ""
        },
        "Namespace": "",
        "IsInfra": false,
        "Config": {
            "Hostname": "99f66530fe9c",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "TERM=xterm",
                "container=podman",
                "HOME=/root",
                "HOSTNAME=99f66530fe9c"
            ],
            "Cmd": [
                "echo",
                "hi"
            ],
            "Image": "docker.io/library/alpine:latest",
            "Volumes": null,
            "WorkingDir": "/",
            "Entrypoint": "",
            "OnBuild": null,
            "Labels": null,
            "Annotations": {
                "io.container.manager": "libpod",
                "io.kubernetes.cri-o.Created": "2021-09-16T06:09:08.936623325-04:00",
                "org.opencontainers.image.stopSignal": "15"
            },
            "StopSignal": 15,
            "CreateCommand": [
                "podman",
                "run",
                "--name",
                "foobar",
                "alpine",
                "echo",
                "hi"
            ],
            "Timezone": "local",
            "Umask": "0022",
            "Timeout": 0,
            "StopTimeout": 10
        },
        "HostConfig": {
            "Binds": [],
            "CgroupManager": "systemd",
            "CgroupMode": "private",
            "ContainerIDFile": "",
            "LogConfig": {
                "Type": "journald",
                "Config": null,
                "Path": "",
                "Tag": "",
                "Size": "0B"
            },
            "NetworkMode": "slirp4netns",
            "PortBindings": {},
            "RestartPolicy": {
                "Name": "",
                "MaximumRetryCount": 0
            },
            "AutoRemove": false,
            "VolumeDriver": "",
            "VolumesFrom": null,
            "CapAdd": [],
            "CapDrop": [],
            "Dns": [],
            "DnsOptions": [],
            "DnsSearch": [],
            "ExtraHosts": [],
            "GroupAdd": [],
            "IpcMode": "shareable",
            "Cgroup": "",
            "Cgroups": "default",
            "Links": null,
            "OomScoreAdj": 0,
            "PidMode": "private",
            "Privileged": false,
            "PublishAllPorts": false,
            "ReadonlyRootfs": false,
            "SecurityOpt": [],
            "Tmpfs": {},
            "UTSMode": "private",
            "UsernsMode": "",
            "ShmSize": 65536000,
            "Runtime": "oci",
            "ConsoleSize": [
                0,
                0
            ],
            "Isolation": "",
            "CpuShares": 0,
            "Memory": 0,
            "NanoCpus": 0,
            "CgroupParent": "user.slice",
            "BlkioWeight": 0,
            "BlkioWeightDevice": null,
            "BlkioDeviceReadBps": null,
            "BlkioDeviceWriteBps": null,
            "BlkioDeviceReadIOps": null,
            "BlkioDeviceWriteIOps": null,
            "CpuPeriod": 0,
            "CpuQuota": 0,
            "CpuRealtimePeriod": 0,
            "CpuRealtimeRuntime": 0,
            "CpusetCpus": "",
            "CpusetMems": "",
            "Devices": [],
            "DiskQuota": 0,
            "KernelMemory": 0,
            "MemoryReservation": 0,
            "MemorySwap": 0,
            "MemorySwappiness": 0,
            "OomKillDisable": false,
            "PidsLimit": 2048,
            "Ulimits": [],
            "CpuCount": 0,
            "CpuPercent": 0,
            "IOMaximumIOps": 0,
            "IOMaximumBandwidth": 0,
            "CgroupConf": null
        }
    }
]

Inspect the specified container for the Image Name it is based on.
检查指定的容器,查找其基于的镜像名称。

$ podman container inspect nervous_fermi --format "{{.ImageName}}"
registry.access.redhat.com/ubi8:latest

Inspect the specified container for the GraphDriver Name it is running with.
检查指定容器正在运行的 GraphDriver 名称。

$ podman container inspect foobar --format "{{.GraphDriver.Name}}"
overlay

Inspect the latest container created for its EffectiveCaps field. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
检查最新创建的容器的 EffectiveCaps 字段。(此选项不适用于远程 Podman 客户端,包括 Mac 和 Windows(不包括 WSL2)机器)

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

SEE ALSO 参见 ¶

podman(1), podman-container(1), podman-inspect(1)

HISTORY 历史 ¶

Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com
2021 年 9 月,最初由 Dan Walsh dwalsh@redhat.com 编写