| podman-stop(1) | General Commands Manual | podman-stop(1) |
نام (NAME)
podman-stop - متوقف کردن یک یا چند کانتینر در حال اجرا
خلاصه دستور (SYNOPSIS)
podman stop [options] container ...
podman container stop [options] container ...
توضیحات (DESCRIPTION)
یک یا چند کانتینر را با استفاده از شناسه (ID) یا نام کانتینر به عنوان ورودی متوقف می‌کند. گزینه --time تعداد ثانیه‌های انتظار پیش از توقف اجباری کانتینر پس از صدور دستور توقف به آن را مشخص می‌کند. مقدار پیش‌فرض ۱۰ ثانیه است. به‌طور پیش‌فرض، کانتینرها ابتدا با سیگنال SIGTERM متوقف می‌شوند و پس از پایان مهلت زمانی با SIGKILL خاتمه می‌یابند. مقدار پیش‌فرض SIGTERM می‌تواند توسط ایمیج سازنده کانتینر و همچنین از طریق خط فرمان در زمان ساخت کانتینر بازنویسی شود.
گزینه‌ها (OPTIONS)
--all, -a
متوقف کردن تمام کانتینرهای در حال اجرا. این گزینه شامل کانتینرهای متوقف‌شده موقت (paused) نمی‌شود.
--cidfile=file
خواندن شناسه کانتینر از file مشخص‌شده و متوقف کردن آن کانتینر. می‌تواند چندین بار مشخص شود.
در صورتی که file وجود نداشته باشد و کاربر گزینه --ignore را مشخص کرده باشد، دستور با خطا مواجه نمی‌شود.
--filter, -f=filter
فیلتر کردن کانتینرهایی که باید متوقف شوند. با چند بار استفاده از فلگ --filter می‌توان چندین فیلتر را تعیین کرد. فیلترهای دارای کلید یکسان به صورت فراگیر (OR) عمل می‌کنند، به استثنای label که انحصاری (AND) است. فیلترهای با کلیدهای مختلف همیشه به صورت انحصاری عمل می‌کنند.
فیلترهای معتبر در زیر فهرست شده‌اند:
| Filter | Description |
| id | [ID] شناسه کانتینر (تطبیق پیشوند CID به‌طور پیش‌فرض؛ رجکس را می‌پذیرد) |
| name | [Name] نام کانتینر (رجکس را می‌پذیرد) |
| annotation | [Key] یا [Key=Value] یادداشت اختصاص‌یافته به یک کانتینر |
| annotation! | [Key] یا [Key=Value] یادداشتی که به کانتینر اختصاص نیافته است |
| label | [Key] یا [Key=Value] برچسب اختصاص‌یافته به یک کانتینر |
| label! | [Key] یا [Key=Value] برچسبی که به کانتینر اختصاص نیافته است |
| exited | [Int] کد خروج کانتینر |
| status | [Status] وضعیت کانتینر: 'created' ،'initialized' ،'running' ،'stopped' ،'paused' ،'exited' ،'removing' ،'stopping' ،'unknown' |
| ancestor | [ImageName] ایمیج یا والدی که برای ساخت کانتینر استفاده شده (رجکس را می‌پذیرد) |
| before | [ID] یا [Name] کانتینرهایی که قبل از این کانتینر ساخته شده‌اند |
| since | [ID] یا [Name] کانتینرهایی که پس از این کانتینر ساخته شده‌اند |
| volume | [VolumeName] یا [MountpointDestination] ولوم متصل‌شده در کانتینر |
| health | [Status] سالم (healthy) یا ناسالم (unhealthy) |
| pod | [Pod] نام یا شناسه کامل یا جزئی پاد |
| network | [Network] نام یا شناسه کامل شبکه |
| restart-policy | [Policy] سیاست راه‌اندازی مجدد کانتینر (مانند 'no' ،'on-failure' ،'always' ،'unless-stopped') |
| until | [DateTime] کانتینرهای ساخته‌شده پیش از مدت‌زمان یا زمان مشخص‌شده |
| command | [Command] دستوری که کانتینر اجرا می‌کند، تنها argv[0] در نظر گرفته می‌شود |
| should-start-on-boot | [Bool] کانتینرهایی که پس از راه‌اندازی مجدد سیستم باید ری‌استارت شوند. برای کانتینرهای با سیاست 'always' یا 'unless-stopped' که صراحتاً توسط کاربر متوقف نشده‌اند برابر با True است |
--ignore, -i
نادیده گرفتن خطاها در صورتی که کانتینرهای مشخص‌شده در مخزن کانتینر وجود نداشته باشند. ممکن است کاربر تصمیم گرفته باشد کانتینری را به صورت دستی حذف کند که منجر به شکست در دستور ExecStop سرویس systemd ارجاع‌دهنده به آن کانتینر شود.
--latest, -l
به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ساخته‌شده استفاده شود. نکته: آخرین کانتینر راه‌اندازی‌شده می‌تواند متعلق به کاربران دیگر پادمن بر روی ماشین میزبان باشد. (این گزینه در کلاینت ریموت پادمن، از جمله ماشین‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست)
--time, -t=seconds
مدت‌زمان انتظار به ثانیه پیش از متوقف کردن اجباری کانتینر. از مقدار -1 برای انتظار نامحدود استفاده کنید.
مثال‌ها (EXAMPLES)
متوقف کردن کانتینر مشخص‌شده از طریق نام آن:
$ podman stop mywebserver
متوقف کردن کانتینر از طریق شناسه آن:
$ podman stop 860a4b235279
متوقف کردن چندین کانتینر:
$ podman stop mywebserver 860a4b235279
متوقف کردن کانتینر مشخص‌شده در cidfile:
$ podman stop --cidfile /home/user/cidfile-1
متوقف کردن کانتینرهای مشخص‌شده در چندین فایل cidfile:
$ podman stop --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
متوقف کردن کانتینر مشخص‌شده ظرف ۲ ثانیه:
$ podman stop --time 2 860a4b235279
متوقف کردن تمام کانتینرهای در حال اجرا:
$ podman stop -a
متوقف کردن آخرین کانتینر ساخته‌شده (این گزینه در کلاینت ریموت پادمن از جمله ماشین‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست):
$ podman stop --latest
متوقف کردن بر اساس برچسب (label):
$ podman stop --filter label=app=frontend 9351ccb3ef4272532bc0c188bd4f0ddfc2b0de217732cd108259ea126b014647
متوقف کردن بر اساس نام:
$ podman stop --filter name=db-replica 6c2680da61d54690718ac3aecdb04a8aad95ae353e42cc942736823bd05c8a1d
متوقف کردن بر اساس برچسب نقش (role):
$ podman stop --filter label=role=primary bb3ff91d969a8dc622d627e4a8d76c18bdbd417d317c5e7e66543c0b0c8ed1e8
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
سپتامبر ۲۰۱۸، در ابتدا توسط Brent Baude گردآوری شد bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩