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

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

.SH "توضیحات (DESCRIPTION)"
اطلاعات سطح‌پایین مربوط به \fIimage-name\fP را در یک رجیستری بازمی‌گرداند.
برای آگاهی از قالب \fIimage-name\fP به skopeo(1) مراجعه کنید\&.

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

.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--cert-dir\fP \fIpath\fP

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

.PP
\fB--config\fP

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

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

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

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

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

.PP
\fB--format\fP, \fB-f\fP=\fIformat\fP

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

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

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

.PP
\fB--no-creds\fP

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

.PP
\fB--raw\fP

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

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

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

.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
گذرواژه برای دسترسی به رجیستری.

.PP
\fB--no-tags\fP, \fB-n\fP

.PP
برچسب‌های موجود از مخزن را در خروجی فهرست نمی‌کند. هنگامی که \fBtrue\fR باشد، آرایهٔ \fBRepoTags\fR خالی خواهد بود. پیش‌فرض \fBfalse\fR است که تمام برچسب‌های موجود را در بر می‌گیرد.

.PP
\fB--manifest-digest\fP=\fIalgorithm\fP \fBEXPERIMENTAL\fP

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

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

.SH "مثال‌ها (EXAMPLES)"
برای بررسی اطلاعات تصویر fedora از رجیستری docker.io:

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

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

.EX
$ 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",
        "...",
    ]
}
.EE

.EX
$ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
amd64
.EE

.EX
$ /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]
.EE

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

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

.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]