podman-container-inspect(1) General Commands Manual podman-container-inspect(1)

podman-container-inspect - نمایش پیکربندی و اطلاعات جزئی یک کانتینر

podman container inspect [گزینه‌ها] کانتینر [کانتینر ...]

این دستور اطلاعات سطح پایین کانتینرهایی را که با نام یا شناسه مشخص شده‌اند نمایش می‌دهد. به‌طور پیش‌فرض، همه نتایج در قالب یک آرایه JSON رندر می‌شوند. در صورت مشخص شدن یک قالب، الگوی داده‌شده برای هر نتیجه اجرا می‌شود.

قالب‌بندی خروجی با استفاده از الگوی Go داده‌شده. کلیدهای JSON بازگردانده‌شده می‌توانند به عنوان مقادیر برای فلگ --format استفاده شوند (مثال‌های زیر را ببینید).

جایگزین‌های معتبر برای الگوی Go در زیر فهرست شده‌اند:

جایگزین (Placeholder) توضیحات
.AppArmorProfile پروفایل AppArmor (رشته)
.Args آرگومان‌های خط فرمان (آرایه‌ای از رشته‌ها)
.BoundingCaps مجموعه قابلیت‌های محدودکننده (آرایه‌ای از رشته‌ها)
.Config ... ساختار شامل اطلاعات پیکربندی
.ConmonPidFile مسیر فایل حاوی PID برنامه conmon (رشته)
.Created ... زمان ایجاد کانتینر (رشته، ISO3601)
.Dependencies وابستگی‌ها (آرایه‌ای از رشته‌ها)
.Driver درایور ذخیره‌سازی (رشته)
.EffectiveCaps مجموعه قابلیت‌های موثر (آرایه‌ای از رشته‌ها)
.ExecIDs شناسه‌های Exec (آرایه‌ای از رشته‌ها)
.GraphDriver ... جزئیات بیشتر درایور گراف (struct)
.HostConfig ... جزئیات پیکربندی میزبان (struct)
.HostnamePath مسیر فایل حاوی نام میزبان (رشته)
.HostsPath مسیر فایل /etc/hosts کانتینر (رشته)
.ID شناسه کانتینر (هش کامل ۶۴ کاراکتری)
.Image شناسه ایمیج کانتینر (هش ۶۴ کاراکتری)
.ImageDigest دایجست ایمیج کانتینر (هش sha256:+64-char)
.ImageName نام ایمیج کانتینر (رشته)
.IsInfra آیا این یک کانتینر زیرساختی (infra) است؟ (رشته: true/false)
.IsService آیا این یک کانتینر سرویس است؟ (رشته: true/false)
.KubeExitCodePropagation نحوه انتشار کد خروج کوبرنتیز (رشته)
.LockNumber شماره قفل Libpod کانتینر
.MountLabel برچسب SELinux نقطه اتصال (رشته)
.Mounts نقاط اتصال (آرایه‌ای از رشته‌ها)
.Name نام کانتینر (رشته)
.Namespace فضای نام کانتینر (رشته)
.NetworkSettings ... تنظیمات شبکه (struct)
.OCIConfigPath مسیر فایل پیکربندی OCI (رشته)
.OCIRuntime نام ران‌تایم OCI (رشته)
.Path مسیر دستور کانتینر (رشته)
.PidFile مسیر فایل حاوی PID کانتینر (رشته)
.Pod پاد والد (رشته)
.ProcessLabel برچسب SELinux فرآیند (رشته)
.ResolvConfPath مسیر فایل resolv.conf کانتینر (رشته)
.RestartCount تعداد دفعات راه‌اندازی مجدد کانتینر (int)
.Rootfs فایل‌سیستم ریشه کانتینر (رشته)
.SizeRootFs حجم فایل‌سیستم ریشه به بایت [1]
.SizeRw حجم لایه فوقانی (خواندنی/نوشتنی) کانتینر به بایت [1]
.State ... اطلاعات وضعیت کانتینر (struct)
.StaticDir مسیر دایرکتوری متادیتای کانتینر (رشته)
.UseImageHostname آیا از /etc/hostname موجود در ایمیج در صورت وجود استفاده شود؟ (رشته: true/false)
.UseImageHosts آیا از /etc/hosts موجود در ایمیج استفاده شود؟ (رشته: true/false)

[1] این مشخص‌کننده قالب به گزینه --size نیاز دارد

به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ایجادشده استفاده می‌کند. توجه: آخرین کانتینر شروع‌شده ممکن است متعلق به سایر کاربران Podman روی ماشین میزبان باشد. (این گزینه در کلاینت ریموت Podman، از جمله در ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست)

علاوه بر خروجی عادی، در صورتی که نوع شیء یک کانتینر باشد، حجم کل فایل را نیز نمایش می‌دهد.

بررسی کانتینر مشخص‌شده و چاپ اطلاعات آن در قالب 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": "pasta",
            "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": null,
            "OomKillDisable": false,
            "PidsLimit": 2048,
            "Ulimits": [],
            "CpuCount": 0,
            "CpuPercent": 0,
            "IOMaximumIOps": 0,
            "IOMaximumBandwidth": 0,
            "CgroupConf": null
        }
    }
]

بررسی کانتینر مشخص‌شده برای دریافت نام ایمیجی که بر پایه آن ساخته شده است.

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

بررسی کانتینر مشخص‌شده برای دریافت نام درایور گراف (GraphDriver) که با آن اجرا می‌شود.

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

بررسی آخرین کانتینر ایجادشده برای مشاهده فیلد EffectiveCaps آن. (این گزینه در کلاینت ریموت Podman، از جمله در ماشین‌های مک و ویندوز (به استثنای 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]

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

سپتامبر ۲۰۲۱، در ابتدا توسط Dan Walsh تدوین شد: dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩