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)
       podman(1), podman-rm(1)


تاریخچه (HISTORY)
       سپتامبر ۲۰۱۸، در ابتدا توسط Brent Baude گردآوری شد bbaude@redhat.com
       ⟨mailto:bbaude@redhat.com⟩

                                                                podman-stop(1)