skopeo-inspect(1)() skopeo-inspect(1)()

skopeo-inspect - بازگرداندن اطلاعات سطح‌پایین دربارهٔ image-name در یک رجیستری.

skopeo inspect [options] image-name

اطلاعات سطح‌پایین مربوط به image-name را در یک رجیستری بازمی‌گرداند. برای آگاهی از قالب image-name به skopeo(1) مراجعه کنید.

خروجی پیش‌فرض شامل داده‌هایی از منابع گوناگون است: ورودی کاربر (Name)، مخزن ریموت در صورت وجود (RepoTags)، مانیفست سطح بالا (Digest)، و تصویری بر اساس معماری/سیستم‌عامل منطبق با محیط زمان اجرای فعلی (بیشتر مقادیر دیگر). برای مشاهدهٔ مقادیر مربوط به یک معماری یا سیستم‌عامل متفاوت، از گزینه‌های --override-os و --override-arch که در skopeo(1) شرح داده شده‌اند استفاده کنید.

همچنین برای گزینه‌هایی که پیش از نام زیرفرمان قرار می‌گیرند، به skopeo(1) مراجعه کنید.

--authfile path

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

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

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

--cert-dir path

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

--config

خروجی دادن پیکربندی در قالب OCI؛ پیش‌فرض قالب‌بندی به صورت JSON است.

--creds username[:password]

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

--daemon-host host

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

--format, -f=format

قالب‌بندی خروجی با استفاده از الگوی Go مشخص‌شده. کلیدهای JSON بازگردانده شده می‌توانند به عنوان مقادیر پرچم --format استفاده شوند (مثال‌های زیر را ببینید). از توابع الگوسازی Go موجود در https://pkg.go.dev/github.com/containers/common/pkg/report#hdr-Template_Functions پشتیبانی می‌کند.

--help, -h

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

--no-creds

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

--raw

خروجی دادن داده‌های خام مانیفست یا پیکربندی بسته به گزینهٔ --config. گزینهٔ --format در کنار گزینهٔ --raw پشتیبانی نمی‌شود.

--registry-token Bearer token

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

--retry-times

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

--retry-delay

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

--shared-blob-dir directory

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

--tls-verify=bool

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

--username

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

--password

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

--no-tags, -n

برچسب‌های موجود از مخزن را در خروجی فهرست نمی‌کند. هنگامی که true باشد، آرایهٔ RepoTags خالی خواهد بود. پیش‌فرض false است که تمام برچسب‌های موجود را در بر می‌گیرد.

--manifest-digest=algorithm EXPERIMENTAL

الگوریتم مورد استفاده برای محاسبهٔ دایجست مانیفست (sha256، sha512)؛ به‌طور پیش‌فرض از الگوریتم استفاده‌شده در دایجست پیکربندی استفاده می‌شود.

نکته: این پرچم آزمایشی است و رفتار آن ممکن است در نسخه‌های بعدی تغییر کند.

برای بررسی اطلاعات تصویر fedora از رجیستری docker.io:

$ skopeo inspect docker://docker.io/fedora
{
    "Name": "docker.io/library/fedora",
    "Digest": "sha256:f99efcddc4dd6736d8a88cc1ab6722098ec1d77dbf7aed9a7a514fc997ca08e0",
    "RepoTags": [
        "20",
        "21",
        "..."
    ],
    "Created": "2022-11-16T07:26:42.618327645Z",
    "DockerVersion": "20.10.12",
    "Labels": {
        "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
    },
    "Architecture": "amd64",
    "Os": "linux",
    "Layers": [
        "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93"
    ],
    "LayersData": [
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93",
            "Size": 65990920,
            "Annotations": null
        }
    ],
    "Env": [
        "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
        "DISTTAG=f37container",
        "FGC=f37",
        "FBR=f37"
    ]
}

برای بازرسی تصویر python از رجیستری docker.io بدون نمایش برچسب‌های موجود:

$ skopeo inspect --no-tags docker://docker.io/library/python
{
    "Name": "docker.io/library/python",
    "Digest": "sha256:10fc14aa6ae69f69e4c953cffd9b0964843d8c163950491d2138af891377bc1d",
    "RepoTags": [],
    "Created": "2022-11-16T06:55:28.566254104Z",
    "DockerVersion": "20.10.12",
    "Labels": null,
    "Architecture": "amd64",
    "Os": "linux",
    "Layers": [
        "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
        "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
        "..."
    ],
    "LayersData": [
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
            "Size": 55038615,
            "Annotations": null
        },
        {
            "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
            "Digest": "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
            "Size": 5164893,
            "Annotations": null
        },
        "..."
    ],
    "Env": [
        "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
        "LANG=C.UTF-8",
        "...",
    ]
}
$ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
amd64
$ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
[PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]

برای دریافت دایجست با استفاده از یک الگوریتم مشخص:

$ skopeo inspect --manifest-digest=sha512 docker://docker.io/library/alpine:latest --format "Digest: {{.Digest}}"
Digest: sha512:5acb33fb56a7791bf0c69d5b19a1c70272148e4107be5261d57305d14e9509792bbca53e5277c456181ecfa1c20ad8427f9b8ba46868020584a819de1128dbd2

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⟩