podman-images(1) General Commands Manual podman-images(1)

podman-images - فهرست کردن ایمیج‌ها در فضای ذخیره‌سازی محلی

podman images [گزینه‌ها] [ایمیج]

podman image list [گزینه‌ها] [ایمیج]

podman image ls [گزینه‌ها] [ایمیج]

ایمیج‌های ذخیره‌شده در سیستم محلی، نام‌ها و شناسه‌های (ID) آن‌ها را نمایش می‌دهد.

نمایش تمام ایمیج‌ها (به‌طور پیش‌فرض لایه‌های میانی ایمیج فیلتر می‌شوند). مقدار پیش‌فرض false است.

نمایش دایجست‌های (چکیده‌های) ایمیج.

ارائه مقادیر فیلتر.

اگر بیش از یک فیلتر وجود داشته باشد، گزینه --filter باید چندین بار ارسال شود: --filter label=test --filter until=10m.

فیلترهای پشتیبانی‌شده:

فیلتر توضیحات
id فیلتر بر اساس شناسه ایمیج.
before فیلتر بر اساس ایمیج‌های ایجادشده قبل از ایمیج داده‌شده (نام یا تگ).
containers فیلتر بر اساس ایمیج‌هایی که کانتینر در حال اجرا دارند.
dangling فیلتر بر اساس ایمیج‌های معلق (بلااستفاده).
digest فیلتر بر اساس دایجست (چکیده).
intermediate فیلتر بر اساس ایمیج‌هایی که معلق بوده و هیچ فرزندی ندارند.
label فیلتر بر اساس ایمیج‌های دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها، در صورتی که از [...]!=label استفاده شود).
manifest فیلتر بر اساس ایمیج‌هایی که فهرست مانیفست هستند.
readonly فیلتر بر اساس ایمیج‌های فقط‌خواندنی یا خواندنی/نوشتنی.
reference فیلتر بر اساس نام ایمیج.
after/since فیلتر بر اساس ایمیج‌های ایجادشده پس از ایمیج داده‌شده (نام یا تگ).
until فیلتر بر اساس ایمیج‌های ایجادشده تا مدت‌زمان یا زمان داده‌شده.

فیلتر id رشته شناسه ایمیج را می‌پذیرد.

فیلتر before این قالب‌ها را می‌پذیرد: <image-name>[:<tag>]، <image id> یا <image@digest>.

فیلتر containers ایمیج‌هایی را نشان می‌دهد که کانتینری در حال اجرا بر اساس آن ایمیج دارند.

فیلتر dangling ایمیج‌هایی را نشان می‌دهد که فضای دیسک را اشغال کرده و هیچ هدفی ندارند. یک ایمیج معلق (dangling)، لایه‌ای از سیستم‌فایل است که در ساخت قبلی یک ایمیج استفاده شده و دیگر توسط هیچ ایمیجی ارجاع داده نمی‌شود. این ایمیج‌ها با تگ <none> مشخص می‌شوند، فضای دیسک را مصرف می‌کنند و کاربرد فعالی ندارند.

فیلتر digest رشته دایجست ایمیج را می‌پذیرد.

فیلتر intermediate ایمیج‌هایی را نشان می‌دهد که معلق هستند و هیچ فرزندی ندارند.

فیلتر label دو قالب را می‌پذیرد. یکی label=key یا label=key=value است که ایمیج‌های دارای برچسب‌های مشخص‌شده را نشان می‌دهد. قالب دیگر label!=key یا label!=key=value است که ایمیج‌های فاقد برچسب‌های مشخص‌شده را نمایش می‌دهد.

فیلتر readonly مقادیر true یا false را می‌پذیرد.

فیلتر reference عبارات منظم مانند image:.*-alpine را می‌پذیرد.

فیلتر after/since این قالب‌ها را می‌پذیرد: <image-name>[:<tag>]، <image id> یا <image@digest>.

فیلتر until ایمیج‌های ایجادشده پیش از تاریخ/زمان داده‌شده را نشان می‌دهد. مقدار <timestamp> می‌تواند برچسب‌های زمانی یونیکس (Unix timestamp)، برچسب‌های زمانی با فرمت تاریخ (مانند 2020-12-31، 2021-01-01T10:00:00) یا رشته‌های مدت‌زمان در زبان Go (مانند 10m، 1h30m) باشد.

فیلتر label دو قالب را می‌پذیرد. یکی label=key یا label=key=value است که ایمیج‌های دارای برچسب‌های مشخص‌شده را نشان می‌دهد. قالب دیگر label!=key یا label!=key=value است که ایمیج‌های فاقد برچسب‌های مشخص‌شده را نمایش می‌دهد.

فیلتر manifest ایمیج‌هایی را نشان می‌دهد که فهرست مانیفست هستند.

فیلتر readonly به‌طور پیش‌فرض هم ایمیج‌های فقط‌خواندنی و هم خواندنی/نوشتنی را نشان می‌دهد. ایمیج‌های فقط‌خواندنی را می‌توان با تغییر additionalimagestores در فایل /etc/containers/storage.conf پیکربندی کرد.

فیلتر reference الگوی ارجاع یک ایمیج را به صورت <image-name>[:<tag>] می‌پذیرد.

فیلتر after یا since این قالب‌ها را می‌پذیرد: <image-name>[:<tag>]، <image id> یا <image@digest>.

فیلتر until قالب‌های: مدت‌زمان زبان Go، زمان RFC3339 یا برچسب زمانی یونیکس را می‌پذیرد و تمام ایمیج‌هایی را که تا آن زمان ایجاد شده‌اند نشان می‌دهد.

تغییر قالب پیش‌فرض خروجی. این مقدار می‌تواند یکی از انواع پشتیبانی‌شده مانند 'json' یا یک الگوی زبان Go باشد. متغیرهای جایگزین معتبر برای الگوی Go در جدول زیر فهرست شده‌اند:

متغیر جایگزین توضیحات
.Containers تعداد کانتینرهایی که از این ایمیج استفاده می‌کنند
.Created زمان سپری‌شده از زمان ایجاد ایمیج
.CreatedAt زمان ایجاد ایمیج، YYYY-MM-DD HH:MM:SS +nnnn
.CreatedSince همانند Created.
.CreatedTime همانند CreatedAt.
.Dangling همانند IsDangling.
.Digest دایجست ایمیج
.History تاریخچه لایه ایمیج
.ID شناسه ایمیج (کوتاه‌شده)
.Id شناسه ایمیج (SHA کامل)
.IsDangling آیا ایمیج معلق است؟ (true/false)
.IsReadOnly آیا ایمیج فقط‌خواندنی است؟ (true/false)
.Labels ... آرایه نگاشت []map از برچسب‌ها
.Names نام کامل ایمیج (FQIN)
.ParentId شناسه کامل SHA ایمیج والد، یا null (رشته)
.ReadOnly همانند IsReadOnly.
.RepoDigests آرایه نگاشت []map از صفر یا چند رشته repo/name@sha256:SHA
.Repository مخزن ایمیج
.RepoTags آرایه نگاشت []map از صفر یا چند رشته FQIN برای این ایمیج
.SharedSize همیشه برابر با 0 به نظر می‌رسد
.Size اندازه لایه روی دیسک (رشته خوانا برای انسان)
.Tag تگ ایمیج
.VirtualSize اندازه لایه روی دیسک (بایت)

نمایش تاریخچه نام‌های ایمیج. اگر یک ایمیج مجدداً تگ‌گذاری شود یا تگ آن برداشته شود، تاریخچه نام ایمیج در ابتدای فهرست اضافه می‌شود (جدیدترین ایمیج در ابتدا). این گزینه به‌ویژه هنگام لغو عملیات تگ‌گذاری یا زمانی که یک ایمیج به دلیل برداشته شدن تگ فاقد نام است بسیار مفید است.

خروجی کوتاه نشود (پیش‌فرض false).

حذف سرستون‌های جدول از خروجی فهرست.

فقط شناسه‌های ایمیج فهرست می‌شوند.

مرتب‌سازی بر اساس created، id، repository، size یا tag (پیش‌فرض: created). هنگام مرتب‌سازی بر اساس repository، برای ارائه خروجی پایدار، به عنوان معیار دوم بر اساس tag نیز مرتب‌سازی انجام می‌شود.

فهرست کردن تمام ایمیج‌های غیرمعلق در فضای ذخیره‌سازی محلی:

$ podman images
REPOSITORY                         TAG         IMAGE ID      CREATED       SIZE
quay.io/podman/stable              latest      e0b7dabc3352  22 hours ago  331 MB
docker.io/library/alpine           latest      9c6f07244728  5 days ago    5.83 MB
registry.fedoraproject.org/fedora  latest      2ecb6df95994  3 weeks ago   169 MB
quay.io/libpod/testimage           20220615    f26aa69bb3f3  2 months ago  8.4 MB

فهرست کردن تمام ایمیج‌های منطبق با نام مشخص‌شده:

$ podman images stable
REPOSITORY             TAG         IMAGE ID      CREATED       SIZE
quay.io/podman/stable  latest      e0b7dabc3352  22 hours ago  331 MB

فهرست کردن شناسه‌های تمام ایمیج‌ها در فضای ذخیره‌سازی کانتینرها:

# podman image ls --quiet
e3d42bcaf643
ebb91b73692b
4526339ae51c

فهرست کردن تمام ایمیج‌ها بدون نمایش سرستون‌ها:

# podman images --noheading
docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251 kB
<none>                                       <none>   ebb91b73692b   4 weeks ago   27.2 MB
docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126 MB

فهرست کردن تمام ایمیج‌ها بدون کوتاه کردن خروجی:

# podman image list --no-trunc
REPOSITORY                                   TAG      IMAGE ID                                                                  CREATED       SIZE
docker.io/kubernetes/pause                   latest   sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27   3 years ago   251 kB
<none>                                       <none>   sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9   4 weeks ago   27.2 MB
docker.io/library/ubuntu                     latest   sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a   6 weeks ago   126 MB

فهرست کردن محتوای تمام ایمیج‌ها با قالب‌بندی مشخص:

# podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
IMAGE ID       REPOSITORY                                   TAG
e3d42bcaf643   docker.io/kubernetes/pause                   latest
ebb91b73692b   <none>                                       <none>
4526339ae51c   docker.io/library/ubuntu                     latest

فهرست کردن ایمیج‌هایی که نام‌گذاری نشده‌اند (معلق یا dangling):

# podman images --filter dangling=true
REPOSITORY   TAG      IMAGE ID       CREATED       SIZE
<none>       <none>   ebb91b73692b   4 weeks ago   27.2 MB

فهرست کردن تمام ایمیج‌ها در قالب JSON:

# podman images --format json
[
    {
	"id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
	"names": [
	    "docker.io/kubernetes/pause:latest"
	],
	"digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
	"created": "2014-07-19T07:02:32.267701596Z",
	"size": 250665
    },
    {
	"id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
	"names": [
	    "\u003cnone\u003e"
	],
	"digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
	"created": "2017-10-26T03:07:22.796184288Z",
	"size": 27170520
    },
    {
	"id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
	"names": [
	    "docker.io/library/ubuntu:latest"
	],
	"digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
	"created": "2017-10-10T20:59:05.10196344Z",
	"size": 126085200
    }
]

فهرست کردن تمام ایمیج‌ها مرتب‌شده بر اساس ستون مشخص‌شده:

# podman images --sort repository
REPOSITORY                                   TAG      IMAGE ID       CREATED       SIZE
<none>                                      <none>   2460217d76fc   About a minute ago   4.41 MB
docker.io/library/alpine                    latest   3fd9065eaf02   5 months ago         4.41 MB
localhost/myapp                             latest   b2e0ad03474a   About a minute ago   4.41 MB
registry.access.redhat.com/rhel7            latest   7a840db7f020   2 weeks ago          211 MB
registry.fedoraproject.org/fedora           27       801894bc0e43   6 weeks ago          246 MB

نمایش تفاوت بین ایمیج‌های فهرست‌شده در حال استفاده در مقایسه با تمام ایمیج‌ها، از جمله ایمیج‌های معلق:

# podman images
REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
localhost/test             latest   18f0c080cd72   4 seconds ago   4.42 MB
docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB
# podman images -a
REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
localhost/test             latest   18f0c080cd72   6 seconds ago   4.42 MB
<none>                     <none>   270e70dc54c0   7 seconds ago   4.42 MB
<none>                     <none>   4ed6fbe43414   8 seconds ago   4.41 MB
<none>                     <none>   6b0df8e71508   8 seconds ago   4.41 MB
docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB

podman(1), containers-storage.conf(5)

برای راه‌حل‌های مربوط به مشکلات رایج به podman-troubleshooting(7) مراجعه کنید.

مارس ۲۰۱۷، در ابتدا توسط Dan Walsh تدوین شد <dwalsh@redhat.com>