.nh
.TH skopeo-list-tags(1)
.SH "نام (NAME)"
skopeo\-list\-tags \- فهرست کردن نام ایمیج‌ها در یک مجموعه از ایمیج‌های وابسته به ترنسپورت

.SH "خلاصه دستور (SYNOPSIS)"
\fBskopeo list-tags\fP [\fIگزینه‌ها\fP] \fIsource-image\fP

.PP
بازگرداندن فهرستی از برچسب‌ها (تگ‌ها) از \fIsource-image\fP در یک رجیستری یا یک فایل محلی docker-archive.

.PP
\fIsource-image\fP نام مخزنی است که فهرست برچسب‌ها از آن واکشی می‌شود یا یک فایل محلی docker-archive.

.SH "گزینه‌ها (OPTIONS)"
همچنین به \fBskopeo\fP(1) برای گزینه‌هایی که پیش از نام زیردستور قرار می‌گیرند مراجعه کنید.

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

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

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

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

.PP
\fB--creds\fP \fIusername[:password]\fP
برای دسترسی به رجیستری.

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

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

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

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

.PP
\fB--no-creds\fP

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

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

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

.PP
\fB--retry-times\fP

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

.PP
\fB--retry-delay\fP

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

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

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

.PP
\fB--username\fP

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

.PP
\fB--password\fP

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

.SH "نام‌های مخزن (REPOSITORY NAMES)"
نام‌های مخزن مراجعی وابسته به ترنسپورت هستند، زیرا هر ترنسپورت ممکن است مفهوم خاص خود را از یک «مخزن» و «برچسب‌ها» داشته باشد.

.PP
این دستور با استفاده از قالب \fItransport\fP\fB:\fR\fIdetails\fP به مخازن ارجاع می‌دهد. قالب‌های زیر پشتیبانی می‌شوند:

.PP
\fBdocker://\fP\fIdocker-repository-reference\fP
  مخزنی در یک رجیستری که «Docker Registry HTTP API V2» را پیاده‌سازی می‌کند.
  یک \fIdocker-repository-reference\fP به فرم \fBregistryhost:port/repositoryname\fP است که شبیه به یک \fIimage-reference\fP است، اما هیچ برچسب یا دایجستی به‌عنوان مولفه پایانی در آن مجاز نیست (برای مثال بدون \fB:latest\fR یا \fB@sha256:xyz\fR).

.EX
  نمونه‌هایی از ارجاعات معتبر docker-repository-references:
    "docker.io/myuser/myrepo"
    "docker.io/nginx"
    "docker.io/library/fedora"
    "localhost:5000/myrepository"

  نمونه‌هایی از ارجاعات نامعتبر:
    "docker.io/nginx:latest"
    "docker.io/myuser/myimage:v1.0"
    "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
.EE

.PP
\fBdocker-archive:\fP\fIpath\fP[\fB:\fP\fIdocker-reference\fP]
  ایمیج‌های ذخیره‌شده در فایلی با قالب \fBdocker save\fR

.SH "مثال‌ها (EXAMPLES)"
.SS "ترنسپورت داکر (Docker Transport)"
برای دریافت فهرست برچسب‌ها در مخزن «fedora» از رجیستری docker.io (نام مخزن طبق فرم رسمی ترنسپورت داکر به «library/fedora» بسط می‌یابد):

.EX
$ skopeo list-tags docker://docker.io/fedora
{
    "Repository": "docker.io/library/fedora",
    "Tags": [
        "20",
        "21",
        "22",
        "23",
        "24",
        "25",
        "26-modular",
        "26",
        "27",
        "28",
        "29",
        "30",
        "31",
        "32",
        "branched",
        "heisenbug",
        "latest",
        "modular",
        "rawhide"
    ]
}

.EE

.PP
برای فهرست کردن برچسب‌ها در یک رجیستری محلی docker/distribution روی پورت ۵۰۰۰، در این مورد برای مخزن «fedora»:

.EX
$ skopeo list-tags docker://localhost:5000/fedora
{
    "Repository": "localhost:5000/fedora",
    "Tags": [
        "latest",
        "30",
        "31"
    ]
}

.EE

.SS "ترنسپورت بایگانی داکر (Docker-archive Transport)"
برای فهرست کردن برچسب‌ها در یک فایل محلی docker-archive:

.EX
$ skopeo list-tags docker-archive:/tmp/busybox.tar.gz
{
    "Tags": [
        "busybox:1.28.3"
    ]
}
.EE

.PP
همچنین از بیش از یک برچسب در یک بایگانی پشتیبانی می‌کند:

.EX
$ skopeo list-tags docker-archive:/tmp/docker-two-images.tar.gz
{
    "Tags": [
        "example.com/empty:latest",
        "example.com/empty/but:different"
    ]
}
.EE

.PP
برای هر ایمیج بدون برچسب یک ورودی source-index لحاظ خواهد شد:

.EX
$ skopeo list-tags docker-archive:/tmp/four-tags-with-an-untag.tar
{
    "Tags": [
        "image1:tag1",
        "image2:tag2",
        "@2",
        "image4:tag4"
    ]
}
.EE

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

.SH "نویسندگان (AUTHORS)"
Zach Hill zach@anchore.com
\[la]mailto:zach@anchore.com\[ra]