podman-pod-ps(1) General Commands Manual podman-pod-ps(1)

podman-pod-ps - نمایش اطلاعات مربوط به پادها

podman pod ps [options]

دستور podman pod ps تمام پادهای موجود روی سیستم را فهرست می‌کند. به‌طور پیش‌فرض موارد زیر فهرست می‌شوند:

  • شناسهٔ پاد
  • نام پاد
  • زمان ایجاد پاد
  • تعداد کانتینرهای متصل به پاد
  • شناسهٔ کانتینر زیرساختی (infra) پاد
  • وضعیت پاد مطابق جدول زیر
    وضعیت توضیحات
    Created هیچ کانتینری در حال اجرا یا متوقف‌شده نیست
    Running حداقل یک کانتینر در حال اجرا است
    Stopped حداقل یک کانتینر متوقف شده و هیچ کانتینری در حال اجرا نیست
    Exited همهٔ کانتینرهای درون پاد متوقف شده‌اند
    Dead خطا در دریافت وضعیت

نمایش شناسه‌های کانتینر

نمایش نام‌های کانتینر

نمایش وضعیت‌های کانتینر

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

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

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

فیلتر توضیحات
ctr-ids فیلتر بر اساس شناسهٔ کانتینر درون پاد. (تطابق پیشوند CID به‌صورت پیش‌فرض؛ عبارت باقاعده را نیز می‌پذیرد)
ctr-names فیلتر بر اساس نام کانتینر درون پاد.
ctr-number فیلتر بر اساس تعداد کانتینرهای موجود در پاد.
ctr-status فیلتر بر اساس وضعیت کانتینر درون پاد.
id فیلتر بر اساس شناسهٔ پاد. (تطابق پیشوند به‌صورت پیش‌فرض؛ عبارت باقاعده را نیز می‌پذیرد)
label فیلتر بر اساس کانتینرهای دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها، در صورتی که از label!=... استفاده شود).
name فیلتر بر اساس نام پاد.
network فیلتر بر اساس نام شبکه یا شناسهٔ کامل شبکه.
status فیلتر بر اساس وضعیت پاد.
until فیلتر بر اساس پادهای ایجادشده پیش از برچسب زمانی داده‌شده.

فیلترهای ctr-ids، ctr-names، id و name قالب عبارت باقاعده (regex) را می‌پذیرند.

فیلتر ctr-status این مقادیر را می‌پذیرد: created،‏ running،‏ paused،‏ stopped،‏ exited و unknown.

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

فیلتر until می‌تواند برچسب زمان یونیکس (Unix timestamp)، برچسب زمان دارای فرمت تاریخ، یا رشته‌های بازه زمانی Go (مانند 10m یا 1h30m) باشد که نسبت به زمان ماشین محاسبه می‌شوند.

فیلتر status این مقادیر را می‌پذیرد: stopped،‏ running،‏ paused،‏ exited،‏ dead،‏ created و degraded.

چاپ زیبای کانتینرها در قالب JSON یا با استفاده از یک الگوی Go

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

جای‌نما توضیحات
.Cgroup مسیر Cgroup پاد
.ContainerIds فهرست جداشده با ویرگول شناسه‌های کانتینرهای درون پاد
.ContainerNames فهرست جداشده با ویرگول نام‌های کانتینرهای درون پاد
.ContainerStatuses فهرست جداشده با ویرگول وضعیت‌های کانتینرهای درون پاد
.Created زمان ایجاد پاد
.ID شناسهٔ کانتینر
.InfraID شناسهٔ کانتینر زیرساختی پاد
.Label string برچسب مشخص‌شدهٔ پاد
.Labels همهٔ برچسب‌های اختصاص‌یافته به پاد
.Name نام پاد
.Networks نمایش تمام شبکه‌های متصل به کانتینر زیرساختی
.NumberOfContainers نمایش تعداد کانتینرهای متصل به پاد
.Restarts نمایش تعداد کل راه‌اندازی‌های مجدد کانتینر درون یک پاد
.Status وضعیت پاد

چاپ راهنمای استفاده و خلاصهٔ دستور

نمایش آخرین پاد ایجادشده (در تمام وضعیت‌ها) (این گزینه در کلاینت ریموت Podman، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) در دسترس نیست)

نمایش اطلاعات فضای نام (namespace) پاد

عدم کوتاه‌سازی خروجی (پیش‌فرض false).

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

تنها چاپ شناسه‌های عددی پادها

مرتب‌سازی بر اساس created،‏ ID،‏ name،‏ status یا number of containers

پیش‌فرض: created

فهرست کردن تمام پادها:

$ podman pod ps
POD ID         NAME              STATUS    CREATED          INFRA ID       # OF CONTAINERS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   1
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   2

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

$ podman pod ps --ctr-names
POD ID         NAME              STATUS    CREATED          INFRA ID       NAMES
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   loving_archimedes
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   thirsty_hawking,wizardly_golick

فهرست کردن تمام پادها به همراه وضعیت، نام‌ها و شناسه‌ها:

$ podman pod ps --ctr-status --ctr-names --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS                         NAMES                             STATUS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4                loving_archimedes                 running
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e   thirsty_hawking,wizardly_golick   configured,configured

فهرست کردن تمام پادها و چاپ شناسه، نام‌های کانتینر و cgroupها:

$ podman pod ps --format "{{.ID}}  {{.ContainerNames}}  {{.Cgroup}}"
00dfd6fa02c0   loving_archimedes   /libpod_parent
f4df8692e116   thirsty_hawking,wizardly_golick   /libpod_parent

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

$ podman pod ps --sort id --filter ctr-number=2
POD ID         NAME             STATUS    CREATED          INFRA ID       # OF CONTAINERS
f4df8692e116   nifty_torvalds   Created   10 minutes ago   331693bff40a   2

فهرست کردن تمام پادها به همراه شناسه‌های کانتینرهای آن‌ها:

$ podman pod ps  --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e

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

$ podman pod ps --no-trunc --ctr-ids
POD ID                                                             NAME              STATUS    CREATED          INFRA ID                                                           IDS
00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050   ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050
f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b   nifty_torvalds    Created   10 minutes ago   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d

فهرست کردن تمام پادها با نام‌های کانتینر:

$ podman pod ps --ctr-names
POD ID         NAME   STATUS    CREATED        INFRA ID       NAMES
314f4da82d74   hi     Created   17 hours ago   a9f2d2165675   jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ...

فهرست کردن پادهای حاوی شناسهٔ کانتینر مشخص‌شده:

$ podman pod ps --filter ctr-ids=aceb3b775797
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
952330c7cff0  web-app     Running     3 minutes ago  b0f247c49669  3

فهرست کردن تمام پادها با دقیقاً ۲ کانتینر:

$ podman pod ps --filter ctr-number=2
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     2 minutes ago  fda2a486b939  2

فهرست کردن پادهای دارای کانتینرهایی در وضعیت exited:

$ podman pod ps --filter ctr-status=exited
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
06c3a107763a  maintenance  Degraded    4 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    4 minutes ago  d6650a490b69  3

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

$ podman pod ps --filter id=95938982244d
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest     Running     4 minutes ago  a28d133e8c63  3

فیلتر کردن پاد بر اساس برچسب:

$ podman pod ps --filter label=tier=frontend
POD ID        NAME         STATUS      CREATED       INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     1 second ago  fda2a486b939  2

فیلتر کردن پاد بر اساس نام:

$ podman pod ps --filter name=db-cluster
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
1e3424d7e9c0  db-cluster  Degraded    4 minutes ago  d6650a490b69  3

فیلتر کردن پاد بر اساس وضعیت پاد (مانند Degraded):

$ podman pod ps --filter status=degraded
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest      Degraded    7 minutes ago  a28d133e8c63  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

فیلتر کردن پادهای ایجادشده پیش از یک آستانهٔ زمانی (--until):

$ podman pod ps --filter until=2m
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     3 minutes ago  fda2a486b939  2
95938982244d  nettest      Degraded    8 minutes ago  a28d133e8c63  3
deee8956522e  utility      Running     8 minutes ago  6b730e3ac334  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

چاپ فهرستی از پادها

podman(1), podman-pod(1)

ژوئیه ۲۰۱۸، در ابتدا توسط Peter Hunt به نشانی pehunt@redhat.com گردآوری شد ⟨mailto:pehunt@redhat.com⟩