| podman-wait(1) | General Commands Manual | podman-wait(1) |
نام (NAME)
podman-wait - منتظر ماندن برای متوقف شدن یک یا چند کانتینر و چاپ کدهای خروج آن‌ها
خلاصه دستور (SYNOPSIS)
podman wait [گزینه‌ها] کانتینر [...]
podman container wait [گزینه‌ها] کانتینر [...]
توضیحات (DESCRIPTION)
منتظر متوقف شدن یک یا چند کانتینر می‌ماند. کانتینر می‌تواند با نام یا شناسه (ID) آن مشخص شود. در صورت وجود چندین کانتینر، پادمن به صورت متوالی برای هر یک منتظر می‌ماند. پس از برآورده شدن تمامی شرایط، کدهای بازگشتی کانتینرها با خط جدید از یکدیگر جدا شده و با همان ترتیبی که به دستور داده شده بودند چاپ می‌شوند. برای تمام شرایط به غیر از "stopped" و "exited"، کد خروج -1 برگردانده می‌شود.
هنگام انتظار برای کانتینرهایی با سیاست راه‌اندازی مجدد always یا on-failure، مانند کانتینرهایی که توسط podman kube play ایجاد شده‌اند، ممکن است کانتینرها مکرراً خارج شده و دوباره راه‌اندازی شوند که احتمالاً با کدهای خروج متفاوتی همراه خواهد بود. podman wait فقط اولین خروج پس از شروع اجرای دستور انتظار را شناسایی و نمایش می‌دهد.
هنگام اجرای یک کانتینر با دستور podman run --rm، دستور wait منتظر حذف کامل کانتینر نمی‌ماند. برای انتظار جهت حذف کانتینر از --condition=removing استفاده کنید.
گزینه‌ها (OPTIONS)
--condition=state
وضعیت یا شرط کانتینر برای منتظر ماندن. این گزینه می‌تواند چندین بار مشخص شود و در این صورت، برآورده شدن حداقل یکی از شرایط برای بازگشت دستور کافی خواهد بود. مقادیر پشتیبانی‌شده عبارتند از: "configured" ،"created" ،"exited" ،"healthy" ،"initialized" ،"paused" ،"removing" ،"running" ،"stopped" ،"stopping" و "unhealthy". شرط پیش‌فرض "stopped" است.
--exit-first-match
تنها منتظر خروج اولین کانتینری می‌ماند که با شرایط مطابقت دارد و سایر کانتینرها را نادیده می‌گیرد.
--help, -h
چاپ راهنمای استفاده از دستور
--ignore
در صورت مفقود بودن یا یافت نشدن کانتینر مشخص‌شده، از خطاها چشم‌پوشی کرده و کد بازگشتی آن را برابر با -1 ثبت می‌کند.
--interval, -i=duration
بازه زمانی انتظار پیش از بررسی مجدد وضعیت (polling). رشته مدت زمان، دنباله‌ای از اعداد ده‌دهی است که هر کدام می‌توانند دارای بخش کسری و پسوند واحد زمانی باشند؛ مانند "300ms"، "-1.5h" یا "2h45m". واحدهای زمانی معتبر عبارتند از "ns"، "us" (یا "µs")، "ms"، "s"، "m" و "h". واحد زمانی پیش‌فرض "ms" است.
--latest, -l
به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ایجادشده استفاده می‌کند. توجه: آخرین کانتینر راه‌اندازی‌شده می‌تواند متعلق به کاربران دیگر پادمن بر روی رایانه میزبان باشد. (این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به استثنای WSL2)، در دسترس نیست).
مثال‌ها (EXAMPLES)
انتظار برای خروج کانتینر مشخص‌شده:
$ podman wait mywebserver 0
انتظار برای خروج آخرین کانتینر (این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به استثنای WSL2)، در دسترس نیست):
$ podman wait --latest 0
انتظار برای خروج کانتینر با بررسی وضعیت در هر دو ثانیه:
$ podman wait --interval 2s mywebserver 0
انتظار برای کانتینر بر اساس شناسه؛ این کانتینر با وضعیت خطای ۱ خارج می‌شود:
$ podman wait 860a4b23 1
انتظار برای خروج هر دو کانتینر مشخص‌شده:
$ podman wait mywebserver myftpserver 0 125
انتظار برای خروج کانتینر نام‌برده، بدون شکست در صورت عدم وجود کانتینر:
$ podman wait --ignore does-not-exist -1
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
سپتامبر ۲۰۱۷، در ابتدا توسط Brent Baude گردآوری شد: ⟨mailto:bbaude@redhat.com⟩