skopeo-list-tags(1)()                                    skopeo-list-tags(1)()

نام (NAME)
       skopeo-list-tags - فهرست کردن نام ایمیج‌ها در یک مجموعه از ایمیج‌های
       وابسته به ترنسپورت


خلاصه دستور (SYNOPSIS)
       skopeo list-tags [گزینه‌ها] source-image


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


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


گزینه‌ها (OPTIONS)
       همچنین به 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) برای اتصال به
       رجیستری.


       --help, -h


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


       --no-creds


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


       --registry-token Bearer token


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


       --retry-times


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


       --retry-delay


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


       --tls-verify=bool


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


       --username


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


       --password


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


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


       این دستور با استفاده از قالب transport:details به مخازن ارجاع می‌دهد.
       قالب‌های زیر پشتیبانی می‌شوند:


       docker://docker-repository-reference
         مخزنی در یک رجیستری که «Docker Registry HTTP API V2» را پیاده‌سازی
       می‌کند.
         یک docker-repository-reference به فرم
       registryhost:port/repositoryname است که شبیه به یک image-reference است،
       اما هیچ برچسب یا دایجستی به‌عنوان مولفه پایانی در آن مجاز نیست (برای
       مثال بدون :latest یا @sha256:xyz).

         نمونه‌هایی از ارجاعات معتبر 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"


       docker-archive:path[:docker-reference]
         ایمیج‌های ذخیره‌شده در فایلی با قالب docker save


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

       $ 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"
           ]
       }



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

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



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

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


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

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


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

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


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


نویسندگان (AUTHORS)
       Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩

                                                         skopeo-list-tags(1)()