.nh
.TH skopeo-delete(1)
.SH "نام (NAME)"
skopeo-delete \- علامت‌گذاری \fIimage-name\fP برای حذف بعدی توسط زباله‌روب رجیستری

.SH "خلاصه دستور (SYNOPSIS)"
\fBskopeo delete\fP [\fIoptions\fP] \fIimage-name\fP

.SH "توضیحات (DESCRIPTION)"
تصویر \fIimage-name\fP را برای حذف علامت‌گذاری می‌کند.
تأثیر این کار وابسته به رجیستری است؛ بسیاری از رجیستری‌ها از این عملیات پشتیبانی نمی‌کنند، یا در برخی شرایط / پیکربندی‌ها اجازهٔ انجام آن را نمی‌دهند.

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

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

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

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

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

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

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

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

.PP
\fB--authfile\fP \fIpath\fP

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

.PP
برای مدیریت اطلاعات هویتی از \fBskopeo login\fR استفاده کنید.

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

.PP
\fB--creds\fP \fIusername[:password]\fP

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

.PP
\fB--cert-dir\fP \fIpath\fP

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

.PP
\fB--daemon-host\fP \fIhost\fP

.PP
استفاده از هاست دیمن داکر در \fIhost\fP (تنها برای انتقال \fBdocker-daemon:\fR).

.PP
\fB--help\fP, \fB-h\fP

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

.PP
\fB--no-creds\fP

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

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

.PP
\fB--registry-token\fP \fItoken\fP

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

.PP
\fB--retry-times\fP

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

.PP
\fB--retry-delay\fP

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

.PP
\fB--shared-blob-dir\fP \fIdirectory\fP

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

.PP
\fB--tls-verify\fP=\fIbool\fP

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

.PP
\fB--username\fP

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

.PP
\fB--password\fP

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

.SH "مثال‌ها (EXAMPLES)"
علامت‌گذاری تصویر example/pause برای حذف از رجیستری registry.example.com:

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

.PP
برای جزئیات بیشتر درباره استفاده از دستور \fBdelete\fP\& به بخش‌های بالا مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)

.SH "نویسندگان (AUTHORS)"
Antonio Murdaca runcom@redhat.com
\[la]mailto:runcom@redhat.com\[ra], Miloslav Trmac mitr@redhat.com
\[la]mailto:mitr@redhat.com\[ra], Jhon Honce jhonce@redhat.com
\[la]mailto:jhonce@redhat.com\[ra]