skopeo-delete(1)() skopeo-delete(1)()

skopeo-delete - علامت‌گذاری image-name برای حذف بعدی توسط زباله‌روب رجیستری

skopeo delete [options] image-name

تصویر image-name را برای حذف علامت‌گذاری می‌کند. تأثیر این کار وابسته به رجیستری است؛ بسیاری از رجیستری‌ها از این عملیات پشتیبانی نمی‌کنند، یا در برخی شرایط / پیکربندی‌ها اجازهٔ انجام آن را نمی‌دهند.

هشدار: اگر image-name حاوی یک دایجست (digest) باشد، این کار بر مانیفست ارجاع‌شده تأثیر می‌گذارد و ممکن است تمام برچسب‌های (tags) اشاره‌کننده به آن مانیفست را (در مخزن فعلی) حذف کند.

هشدار: اگر image-name حاوی یک برچسب باشد (اما نه یک دایجست)، در نسخهٔ فعلی Skopeo این برچسب به یک دایجست حل (resolve) می‌شود و سپس مانیفست بر اساس دایجست حذف می‌گردد، همان‌گونه که در بالا توضیح داده شد (احتمالاً حذف تمام برچسب‌های اشاره‌کننده به آن مانیفست، نه فقط برچسب ارائه‌شده). این رفتار ممکن است در آینده تغییر کند.

هنگام استفاده از سرور رجیستری github.com/distribution/distribution: برای آزادسازی فضای دیسک تخصیص‌یافته، باید به سرور رجیستری کانتینر وارد شده و زباله‌روب (garbage collector) رجیستری کانتینر را اجرا کنید. به عنوان مثال:

/usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml

نکته: گاهی اوقات config.yml در مسیر /etc/docker/registry/config.yml ذخیره می‌شود.

اگر رجیستری کانتینر را درون یک کانتینر اجرا می‌کنید، دستوری شبیه به این را اجرا خواهید کرد:

$ docker exec -it registry /usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml

همچنین برای گزینه‌هایی که پیش از نام زیردستور قرار می‌گیرند، skopeo(1) را ببینید.

--authfile path

مسیر فایل اصلی اطلاعات هویتی رجیستری. در لینوکس، پیش‌فرض ${XDG_RUNTIME_DIR}/containers/auth.json است. برای جزئیات بیشتر درباره سازوکار جستجوی اطلاعات هویتی و پیش‌فرض‌ها در سایر پلتفرم‌ها، containers-auth.json(5) را ببینید.

برای مدیریت اطلاعات هویتی از skopeo login استفاده کنید.

مقدار پیش‌فرض این گزینه از متغیر محیطی REGISTRY\_AUTH\_FILE خوانده می‌شود.

--creds username[:password]

اطلاعات هویتی برای دسترسی به رجیستری.

--cert-dir path

استفاده از گواهی‌های موجود در path (*.crt، *.cert، *.key) برای اتصال به رجیستری.

--daemon-host host

استفاده از هاست دیمن داکر در host (تنها برای انتقال docker-daemon:).

--help, -h

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

--no-creds

دسترسی به رجیستری به‌صورت ناشناس.

علاوه بر این، رجیستری باید با تنظیم REGISTRY_STORAGE_DELETE_ENABLED=true برای دیمن رجیستری، اجازه حذف را داده باشد.

--registry-token token

توکن حامل (Bearer token) برای دسترسی به رجیستری.

--retry-times

تعداد دفعات تلاش مجدد. به‌طور پیش‌فرض، هیچ تلاش مجددی انجام نمی‌شود.

--retry-delay

تأخیر ثابت میان تلاش‌های مجدد. اگر تنظیم نشود (یا روی 0s تنظیم گردد)، زمان انتظار بر اساس تعداد تلاش‌های ناموفق به‌صورت نمایی افزایش می‌یابد.

--shared-blob-dir directory

دایرکتوری مورد استفاده برای اشتراک‌گذاری blobها میان مخازن OCI.

--tls-verify=bool

الزام HTTPS و تأیید گواهی‌ها هنگام برقراری ارتباط با رجیستری کانتینر یا دیمن. پیش‌فرض وابسته به تنظیمات registry.conf است.

--username

نام کاربری برای دسترسی به رجیستری.

--password

گذرواژه برای دسترسی به رجیستری.

علامت‌گذاری تصویر example/pause برای حذف از رجیستری registry.example.com:

$ skopeo delete docker://registry.example.com/example/pause:latest

برای جزئیات بیشتر درباره استفاده از دستور delete به بخش‌های بالا مراجعه کنید.

skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)

Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩, Miloslav Trmac mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@redhat.com ⟨mailto:jhonce@redhat.com⟩