نام (NAME)

podman-volume-prune - حذف حجم‌های بلااستفاده

خلاصه دستور (SYNOPSIS)

podman volume prune [گزینه‌ها]

توضیحات (DESCRIPTION)

حذف حجم‌های (volumes) استفاده‌نشده. به‌طور پیش‌فرض تنها حجم‌های استفاده‌نشده‌ی بی‌نام (anonymous) حذف می‌شوند. حجم‌های بی‌نام مواردی هستند که هم‌زمان با یک کانتینر ایجاد شده‌اند (مانند podman run -v /path بدون تعیین نام حجم). از گزینه --all (یا -a) برای حذف تمام حجم‌های استفاده‌نشده، شامل حجم‌های دارای نام، استفاده کنید.

می‌توان از فلگ --filter برای محدود کردن حجم‌های مدنظر استفاده کرد. پیش از حذف، از کاربر تأییدیه گرفته می‌شود مگر آنکه از گزینه --force استفاده شده باشد.

گزینه‌ها (OPTIONS)

--all, -a

حذف تمامی حجم‌های استفاده‌نشده (هم بی‌نام و هم دارای نام). بدون این گزینه، فقط حجم‌های بی‌نام استفاده‌نشده حذف می‌شوند.

گزینه --all می‌تواند با --filter ترکیب شود: --all دامنه حجم‌های کاندید را به تمام حجم‌های بلااستفاده گسترش می‌دهد و سپس فیلترها مشخص می‌کنند که کدام‌یک از آن‌ها حذف گردند. به عنوان مثال، --all --filter label!=keep هر حجم استفاده‌نشده‌ای را که برچسب keep نداشته باشد حذف می‌کند.

--dry-run

نمایش حجم‌هایی که بدون حذف واقعی، هرس و پاکسازی خواهند شد.

--filter

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

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

فیلترهایی با کلید یکسان به صورت اجتماع (یا/inclusive) عمل می‌کنند، با این استثنای انحصاری که فیلترهای label اشتراکی (و/exclusive) هستند. فیلترها با کلیدهای متفاوت همواره به صورت اشتراکی عمل می‌کنند.

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

فیلتر (Filter)	توضیحات (Description)
all	[بولی] در صورت true، حذف تمام حجم‌های استفاده‌نشده (مشابه --all). در صورت false یا تنظیم‌نشده، فقط حجم‌های بی‌نام در نظر گرفته می‌شوند.
anonymous	[بولی] تنها حجم‌هایی حذف شوند که بی‌نام (true) یا دارای نام (false) هستند.
label	[رشته] تنها حجم‌های دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها در صورت استفاده از [...]=!label) حذف شوند.
label!	[رشته] تنها حجم‌های فاقد برچسب‌های مشخص‌شده حذف شوند.
until	[تاریخ/زمان] تنها حجم‌هایی حذف شوند که پیش از برچسب زمانی داده‌شده ایجاد شده‌اند.
after/since	[حجم] فیلتر بر اساس حجم‌هایی که پس از VOLUME داده‌شده (نام یا تگ) ایجاد شده‌اند.

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

نکته: فیلترهای !label با عملگر AND با یکدیگر ترکیب می‌شوند تا رفتاری همگام و سازگار با label داشته باشند، در حالی که در داکر با عملگر OR ترکیب می‌شوند.

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

--force, -f

درخواست نکردن تأییدیه از کاربر.

--help

چاپ راهنمای استفاده

مثال‌ها (EXAMPLES)

هرس و پاکسازی تنها حجم‌های بی‌نام و استفاده‌نشده (پیش‌فرض).

$ podman volume prune

هرس تنها حجم‌های بی‌نام و استفاده‌نشده بدون درخواست تأییدیه.

$ podman volume prune --force

حذف تمام حجم‌های استفاده‌نشده (بی‌نام و دارای نام).

$ podman volume prune --all --force

حذف تمام حجم‌های استفاده‌نشده به‌جز آن‌هایی که برچسب خاصی دارند (ترکیب --all با یک فیلتر).

$ podman volume prune --all --force --filter label!=keep

حذف تمامی حجم‌های استفاده‌نشده با استفاده از فیلتر (معادل با --all).

$ podman volume prune --filter all=true --force

حذف حجم‌های استفاده‌نشده‌ای که برچسب مشخص‌شده را دارند.

$ podman volume prune --filter label=mylabel=mylabelvalue

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

$ podman volume prune --filter label!=mylabel=mylabelvalue

حذف حجم‌های استفاده‌نشده‌ای که یک کلید برچسب مشخص را دارند (صرف‌نظر از مقدار آن):

$ podman volume prune --filter label=environment

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

$ podman volume prune --filter label!=environment

پیش‌نمایش تمام حجم‌های بلااستفاده بدون حذف واقعی آن‌ها.

$ podman volume prune --all --dry-run

همچنین ببینید (SEE ALSO)

podman(1), podman-volume(1)

تاریخچه (HISTORY)

نوامبر ۲۰۱۸، نگارش اولیه توسط Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩