'\" t
.nh
.TH SKOPEO(1) Skopeo Man Pages
Jhon Honce
August 2016
.SH "نام (NAME)"
skopeo \- ابزار خط فرمان برای تعامل با ایمیج‌های کانتینر محلی و دوردست و مخازن ایمیج کانتینر

.SH "خلاصه دستور (SYNOPSIS)"
\fBskopeo\fP [\fIگزینه‌های عمومی\fP] \fIدستور\fP [\fIگزینه‌های دستور\fP]

.SH "توضیحات (DESCRIPTION)"
دستور \fBskopeo\fR یک ابزار خط فرمان است که عملیات گوناگونی را روی ایمیج‌های کانتینر و مخازن ایمیج کانتینر ارائه می‌دهد.

.PP
دستور \fBskopeo\fR می‌تواند ایمیج‌های کانتینر را بین فضاهای ذخیره‌سازی مختلف کانتینر کپی کرده و در صورت نیاز آن‌ها را تبدیل کند. برای نمونه می‌توانید از \fBskopeo\fR برای کپی کردن ایمیج‌های کانتینر از یک مخزن رجیستری کانتینر به مخزنی دیگر استفاده کنید.

.PP
دستور \fBskopeo\fR می‌تواند یک ایمیج کانتینر Docker schema 2 یا schema 1 را به یک ایمیج OCI تبدیل کند.

.PP
دستور \fBskopeo\fR می‌تواند بدون نیاز به دریافت (pull) غیرضروری ایمیج، یک مخزن را در رجیستری کانتینر بازرسی کند. دریافت ایمیج از یک مخزن، به‌ویژه یک مخزن دوردست، عملیاتی سنگین و هزینه‌بر از نظر شبکه و فضای ذخیره‌سازی است. Skopeo مانیفست مخزن را دریافت کرده و خروجی json مشابه \fBdocker inspect\fR درباره مخزن یا یک تگ نمایش می‌دهد. \fBskopeo\fR، برخلاف \fBdocker inspect\fR، به شما کمک می‌کند تا بدون نیاز به اجرای \fBdocker pull\fR اطلاعات مفیدی را درباره یک مخزن یا یک تگ جمع‌آوری کنید؛ برای نمونه: چه تگ‌هایی برای مخزن مورد نظر در دسترس هستند؟ ایمیج چه برچسب‌هایی (labels) دارد؟

.PP
دستور \fBskopeo\fR می‌تواند ایمیج‌های کانتینر را امضا و تایید اعتبار کند.

.PP
دستور \fBskopeo\fR می‌تواند ایمیج‌های کانتینر را از یک رجیستری دوردست کانتینر حذف کند.

.PP
نکته: \fBskopeo\fR برای انجام بیشتر قابلیت‌های خود نیازی به اجرای هیچ‌یک از زمان‌های اجرای کانتینر (container runtimes) ندارد. همچنین نیازی به دسترسی ریشه (root) ندارد، مگر اینکه در حال کپی کردن ایمیج‌ها به یک بک‌اند ذخیره‌سازی زمان اجرای کانتینر مانند دیمن داکر یا github.com/containers/storage باشید.

.SH "نام‌های ایمیج (IMAGE NAMES)"
بیشتر دستورات با استفاده از قالب \fItransport\fP\fB:\fR\fIdetails\fP به ایمیج‌های کانتینر ارجاع می‌دهند. قالب‌های زیر پشتیبانی می‌شوند:

.PP
\fBcontainers-storage:\fP\fIdocker-reference\fP
  یک ایمیج واقع در فضای ذخیره‌سازی محلی containers/storage. هم مکان و هم فضای ذخیره‌سازی در /etc/containers/storage.conf مشخص شده‌اند (بک‌اند Podman، CRI-O، Buildah و ابزارهای مشابه).

.PP
\fBdir:\fP\fIpath\fP
  یک مسیر دایرکتوری محلی موجود \fIpath\fP که مانیفست، فایل‌های فشرده لایه‌ها (layer tarballs) و امضاها را به صورت فایل‌های جداگانه ذخیره می‌کند. این یک فرمت غیراستاندارد است که در وهله اول برای اشکال‌زدایی یا بازرسی بدون تغییر کانتینر سودمند است.

.PP
\fBdocker://\fP\fIdocker-reference\fP
  یک ایمیج در رجیستری پیاده‌سازی‌کننده «Docker Registry HTTP API V2».
  اطلاعات احراز هویت معمولاً با استفاده از \fB(skopeo login)\fR مدیریت می‌شوند؛
  برای جزئیات بیشتر درباره مکانیزم جستجوی اطلاعات احراز هویت به \fBcontainers-auth.json\fP(5) مراجعه کنید.

.PP
\fBdocker-archive:\fP\fIpath\fP[\fB:\fP\fIdocker-reference\fP]
  ایمیج ذخیره‌شده در فایلی با فرمت \fBdocker save\fR. شناسه \fIdocker-reference\fP تنها هنگام ساخت چنین فایلی استفاده می‌شود و نباید شامل دایجست (digest) باشد.

.PP
\fBdocker-daemon:\fP\fIdocker-reference\fP
  یک ایمیج \fIdocker-reference\fP ذخیره‌شده در فضای ذخیره‌سازی داخلی دیمن داکر. شناسه \fIdocker-reference\fP باید شامل یک تگ یا یک دایجست باشد. متناوباً، هنگام خواندن ایمیج‌ها، فرمت می‌تواند به صورت docker-daemon:algo:digest (شناسه ایمیج) باشد.

.PP
\fBoci:\fP\fIpath\fP\fB:\fP\fItag\fP
  یک \fItag\fP ایمیج در یک دایرکتوری سازگار با «Open Container Image Layout Specification» در مسیر \fIpath\fP\&.

.PP
\fBoci-archive:\fP\fIpath\fP\fB:\fP\fItag\fP
  یک \fItag\fP ایمیج در یک آرشیو tar سازگار با «Open Container Image Layout Specification» در مسیر \fIpath\fP\&.

.PP
برای جزئیات بیشتر به containers-transports(5)
\[la]https://github.com/containers/image/blob/main/docs/containers\-transports.5.md\[ra] مراجعه کنید.

.SH "گزینه‌ها (OPTIONS)"
این گزینه‌ها باید قبل از نام زیردستور قرار گیرند.
هر یک از زیردستورها گزینه‌های مخصوص به خود را دارند.

.PP
\fB--command-timeout\fP \fIduration\fP

.PP
مدت زمان مهلت برای اجرای دستور (مانند 30s یا 10m).

.PP
\fB--debug\fP

.PP
فعال‌سازی خروجی اشکال‌زدایی.

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

.PP
نمایش راهنما.

.PP
\fB--insecure-policy\fP

.PP
اتخاذ یک سیاست ناامن و مجاز‌کننده که به همه‌چیز اجازه می‌دهد. این گزینه نیاز به فایل policy را برطرف می‌کند.

.PP
\fB--override-arch\fP \fIarch\fP

.PP
استفاده از \fIarch\fP به جای معماری ماشین برای انتخاب ایمیج‌ها.

.PP
\fB--override-os\fP \fIos\fP

.PP
استفاده از \fIos\fP به جای سیستم‌عامل جاری برای انتخاب ایمیج‌ها.

.PP
\fB--override-variant\fP \fIvariant\fP

.PP
استفاده از \fIvariant\fP به جای متغیر معماری در حال اجرا برای انتخاب ایمیج‌ها.

.PP
\fB--policy\fP \fIpath-to-policy\fP

.PP
مسیر فایل policy.json جهت استفاده برای اعتبارسنجی امضاها و تصمیم‌گیری در مورد معتمد بودن یک ایمیج، جایگزین فایل پیش‌فرض سیاست اعتماد.

.PP
\fB--registries.d\fP \fIdir\fP

.PP
استفاده از فایل‌های پیکربندی رجیستری در \fIdir\fP (برای نمونه ذخیره‌سازی امضای کانتینر)، جایگزین مسیر پیش‌فرض.

.PP
\fB--require-signed\fP

.PP
الزام به امضاشده بودن هر ایمیج دریافت شده، صرف نظر از آنچه فایل پیش‌فرض یا ارائه‌شده سیاست اعتماد مشخص کرده است.

.PP
\fB--tls-details\fP \fIpath\fP

.PP
مسیر به یک فایل containers-tls-details(5)، تأثیرگذار بر رفتار TLS در سراسر برنامه.

.PP
در صورت تنظیم نشدن، به یک مقدار پیش‌فرض منطقی بازمی‌گردد که ممکن است در طول زمان تغییر کند (بسته به سیاست سراسری سیستم، نسخه برنامه، نسخه زبان Go و موارد مشابه).

.PP
کاربران عموماً نباید از این گزینه استفاده کنند مگر اینکه فرآیندی برای تضمین به‌روز نگه‌داشتن پیکربندی داشته باشند.

.PP
\fB--tmpdir\fP \fIdir\fP

.PP
دایرکتوری مورد استفاده برای ذخیره فایل‌های موقت. پیش‌فرض /var/tmp است.

.PP
\fB--user-agent-prefix\fP \fIprefix\fP

.PP
پیشوند برای افزودن به رشته عامل کاربر (user agent). عامل کاربر حاصل به صورت "\fIprefix\fP skopeo/\fIversion\fP" خواهد بود.

.PP
\fB--version\fP, \fB-v\fP

.PP
چاپ شماره نسخه.

.SH "دستورات (COMMANDS)"
.TS
allbox;
l l
l l .
\fBدستور\fP	\fBتوضیحات\fP
skopeo-copy(1)	T{
کپی کردن یک ایمیج (مانیفست، لایه‌های فایل‌سیستم، امضاها) از یک مکان به مکان دیگر.
T}
skopeo-delete(1)	علامت‌گذاری \fIimage-name\fP برای حذف بعدی توسط زباله‌روب (garbage collector) رجیستری.
T{
skopeo-generate-sigstore-key(1)
T}	T{
تولید یک جفت کلید عمومی/خصوصی sigstore.
T}
skopeo-inspect(1)	T{
بازگرداندن اطلاعات سطح پایین درباره \fIimage-name\fP در یک رجیستری.
T}
skopeo-list-tags(1)	T{
فهرست کردن نام‌های ایمیج در یک مجموعه اختصاصی انتقال (transport-specific) از ایمیج‌ها.
T}
skopeo-login(1)	ورود به یک رجیستری کانتینر.
skopeo-logout(1)	T{
خروج از یک رجیستری کانتینر.
T}
skopeo-manifest-digest(1)	T{
محاسبه دایجست مانیفست برای یک فایل مانیفست و نوشتن آن در خروجی استاندارد.
T}
skopeo-standalone-sign(1)	T{
ابزار اشکال‌زدایی \- امضای محلی یک ایمیج بدون بارگذاری.
T}
skopeo-standalone-verify(1)	T{
ابزار اشکال‌زدایی \- اعتبارسنجی امضای یک ایمیج از فایل‌های محلی.
T}
skopeo-sync(1)	T{
همگام‌سازی ایمیج‌ها بین مخازن رجیستری و دایرکتوری‌های محلی.
T}
.TE

.SH "وضعیت خروج (EXIT STATUS)"
دستور \fBskopeo\fR در صورت موفقیت با وضعیت 0 و در صورت بروز خطا با مقداری غیر از صفر خارج می‌شود.

.PP
جزئیات مربوط به وضعیت‌های خروج:

.PP
\fB1\fP خطای عمومی، جزئیات در پیام خطا یافت می‌شود.

.PP
\fB2\fP ایمیج ورودی پیدا نشد. توجه داشته باشید که این تلاش بر مبنای بهترین تلاش (best effort) است و برای رجیستری‌های دوردست معمولاً وضعیت نمی‌تواند به طور قابل اعتمادی گزارش شود.

.SH "فایل‌ها (FILES)"
\fB/etc/containers/policy.json\fP
  فایل پیش‌فرض سیاست اعتماد، در صورتی که \fB--policy\fP مشخص نشده باشد.
  فرمت این سیاست در containers-policy.json(5)
\[la]https://github.com/containers/image/blob/main/docs/containers\-policy.json.5.md\[ra] مستند شده است.

.PP
\fB/etc/containers/registries.d\fP
  دایرکتوری پیش‌فرض حاوی پیکربندی رجیستری، در صورتی که \fB--registries.d\fP مشخص نشده باشد.
  محتویات این دایرکتوری در containers-registries.d(5)
\[la]https://github.com/containers/image/blob/main/docs/containers\-registries.d.5.md\[ra]\& مستند شده است.

.SH "همچنین ببینید (SEE ALSO)"
skopeo-login(1), docker-login(1), containers-auth.json(5), containers-storage.conf(5), containers-policy.json(5), containers-transports(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]