نام (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)

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

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

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

$ 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⟩