نام (NAME)

buildah-rmi - حذف یک یا چند ایمیج کانتینر از حافظه محلی

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

buildah rmi [image ...]

توضیحات (DESCRIPTION)

یک یا چند ایمیج ذخیره‌شده محلی را حذف می‌کند. ارسال آرگومان image آن را همراه با هر یک از ایمیج‌های والد معلق (بدون برچسب) حذف می‌کند.

محدودیت‌ها (LIMITATIONS)

اگر ایمیج با استفاده از انتقال‌دهنده 'dir:' به یک مسیر دایرکتوری ارسال (push) شده باشد، دستور rmi قادر به حذف آن نخواهد بود. در عوض، باید از دستورات استاندارد سیستم فایل استفاده شود.
اگر imageID یک نام باشد اما شامل نام رجیستری نباشد، buildah تلاش خواهد کرد ایمیج نام‌برده را با استفاده از نام رجیستری localhost پیدا و حذف کند؛ در صورتی که چنین ایمیجی پیدا نشود، با بسط دادن نام ارائه‌شده با استفاده از نام رجیستری‌های موجود در فایل پیکربندی رجیستری‌های سیستم (registries.conf)، به دنبال ایمیج مورد نظر خواهد گشت.
اگر imageID به یک manifest list یا image index اشاره کند، این دستور آنچه انتظار دارید را انجام نخواهد داد! این دستور ایمیج‌های مرتبط با manifest list یا index را حذف خواهد کرد (نه خودِ لیست مانیفست/ایندکس ایمیج را). برای حذف آن، به جای این کار از زیردستور buildah manifest rm استفاده کنید.

گزینه‌ها (OPTIONS)

--all, -a

تمام ایمیج‌های محلی از سیستم حذف خواهند شد، به جز مواردی که کانتینری از آن‌ها به عنوان ایمیج مرجع استفاده می‌کند. هنگام استفاده از این گزینه، نمی‌توان نام یا شناسه ایمیج را تعیین کرد. ایمیج‌های فقط‌خواندنی که با ویرایش "additionalimagestores" در فایل /etc/containers/storage.conf پیکربندی شده‌اند، قابل حذف نیستند.

--force, -f

این گزینه باعث می‌شود که Buildah پیش از حذف ایمیج از سیستم، تمام کانتینرهایی را که از آن ایمیج استفاده می‌کنند حذف کند.

--prune, -p

تمام ایمیج‌های محلی که فاقد برچسب هستند و هیچ ایمیج فرزندی به آن‌ها اشاره نمی‌کند، از سیستم حذف خواهند شد. هنگام استفاده از این گزینه، نمی‌توان نام یا شناسه ایمیج را تعیین کرد.

مثال (EXAMPLE)

buildah rmi imageID

buildah rmi --all

buildah rmi --all --force

buildah rmi --prune

buildah rmi --force imageID

buildah rmi imageID1 imageID2 imageID3

فایل‌ها (FILES)

registries.conf (/etc/containers/registries.conf)

فایل registries.conf فایل پیکربندی است که مشخص می‌کند هنگام تکمیل نام ایمیج‌هایی که فاقد بخش رجیستری یا دامنه هستند، به کدام رجیستری‌های کانتینر مراجعه شود.

storage.conf (/etc/containers/storage.conf)

فایل storage.conf فایل پیکربندی ذخیره‌سازی برای تمام ابزارهایی است که از containers/storage استفاده می‌کنند.

فایل پیکربندی ذخیره‌سازی تمام گزینه‌های ذخیره‌سازی موجود کانتینر را برای ابزارهایی که از ذخیره‌سازی مشترک کانتینر استفاده می‌کنند، مشخص می‌سازد.

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

buildah(1), containers-registries.conf(5), containers-storage.conf(5)