| podman-container-inspect(1) | General Commands Manual | podman-container-inspect(1) |
نام (NAME)
podman-container-inspect - نمایش پیکربندی و اطلاعات جزئی یک کانتینر
خلاصه دستور (SYNOPSIS)
podman container inspect [گزینهها] کانتینر [کانتینر ...]
توضیحات (DESCRIPTION)
این دستور اطلاعات سطح پایین کانتینرهایی را که با نام یا شناسه مشخص شدهاند نمایش میدهد. بهطور پیشفرض، همه نتایج در قالب یک آرایه JSON رندر میشوند. در صورت مشخص شدن یک قالب، الگوی دادهشده برای هر نتیجه اجرا میشود.
گزینهها (OPTIONS)
--format, -f=format
قالببندی خروجی با استفاده از الگوی 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 نیاز دارد
--latest, -l
به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ایجادشده استفاده میکند. توجه: آخرین کانتینر شروعشده ممکن است متعلق به سایر کاربران Podman روی ماشین میزبان باشد. (این گزینه در کلاینت ریموت Podman، از جمله در ماشینهای مک و ویندوز (به استثنای WSL2) در دسترس نیست)
--size, -s
علاوه بر خروجی عادی، در صورتی که نوع شیء یک کانتینر باشد، حجم کل فایل را نیز نمایش میدهد.
مثالها (EXAMPLES)
بررسی کانتینر مشخصشده و چاپ اطلاعات آن در قالب 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]
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
سپتامبر ۲۰۲۱، در ابتدا توسط Dan Walsh تدوین شد: dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩