.nh
.TH podman-artifact-pull 1
.SH "نام (NAME)"
podman-artifact-pull \- دریافت یک مصنوع از یک رجیستری و ذخیره آن در سطح محلی

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

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman artifact pull\fP یک مصنوع را از یک رجیستری بر روی رایانه محلی کپی می‌کند.

.SH "منبع (SOURCE)"
منبع (\fISOURCE\fR) مکانی است که ایمیج مصنوع از آن به دست می‌آید.

.EX
# دریافت از یک رجیستری
$ podman artifact pull quay.io/foobar/artifact:special
.EE

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--authfile\fP=\fIمسیر\fP
مسیر فایل احراز هویت. پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در ویندوز/مک‌او‌اس \fB$HOME/.config/containers/auth.json\fR است.
این فایل توسط \fBpodman login\fP ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، \fB$HOME/.docker/config.json\fR که با \fBdocker login\fP تنظیم می‌شود، بررسی خواهد شد.

.PP
نکته: همچنین این گزینه وجود دارد که با تنظیم متغیر محیطی \fBREGISTRY_AUTH_FILE\fR مسیر پیش‌فرض فایل احراز هویت بازنویسی شود. این کار با دستور \fBexport REGISTRY_AUTH_FILE=\fIpath\fP\fP امکان‌پذیر است.

.SS \fB--cert-dir\fP=\fIمسیر\fP
استفاده از گواهی‌های موجود در \fIمسیر\fP (*\&.crt، *\&.cert، *\&.key) برای اتصال به رجیستری (پیش‌فرض: /etc/containers/certs.d).
برای جزئیات بیشتر به \fBcontainers-certs.d(5)\fP مراجعه کنید.
(این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--creds\fP=\fI[نام‌کاربری[:گذرواژه]]\fP
مقدار [نام‌کاربری[:گذرواژه]] برای احراز هویت در رجیستری (در صورت نیاز).
اگر یک یا هر دو مقدار مشخص نشوند، اعلان خط فرمان ظاهر شده و می‌توان مقدار را وارد نمود. گذرواژه بدون بازتاب (echo) وارد می‌شود.

.PP
توجه داشته باشید که اعتبارنامه‌های مشخص‌شده فقط برای احراز هویت در رجیستری‌های هدف استفاده می‌شوند. آن‌ها برای آینه‌ها یا هنگام بازنویسی رجیستری استفاده نخواهند شد (به \fBcontainers-registries.conf(5)\fR مراجعه کنید)؛ برای احراز هویت در این موارد استفاده از فایل \fBcontainers-auth.json(5)\fR را مد نظر قرار دهید.

.SS \fB--decryption-key\fP=\fIکلید[:عبارت‌عبور]\fP
مقدار [کلید[:عبارت‌عبور]] برای رمزگشایی ایمیج‌ها. کلید می‌تواند به فایل‌های کلید یا گواهی‌ها اشاره کند. رمزگشایی با تمام کلیدها آزمایش می‌شود. اگر کلید توسط یک عبارت عبور محافظت شده باشد، ارسال آن در آرگومان الزامی است، در غیر این صورت نادیده گرفته می‌شود.

.SS \fB--help\fP, \fB-h\fP
چاپ بیانیه راهنمای استفاده.

.SS \fB--quiet\fP, \fB-q\fP
عدم نمایش پیام‌های خروجی اطلاعاتی (که نشان می‌دهند کدام دستورالعمل در حال پردازش است و وضعیت پیشرفت آن چگونه است). فقط پیام خطای نهایی یا اطلاعات تکمیل موفقیت‌آمیز، مانند شناسه ایمیج یا کانتینر چاپ می‌شود.

.SS \fB--retry\fP=\fIدفعات\fP
تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیج‌ها میان رجیستری و ذخیره‌ساز محلی در صورت بروز خطا. مقدار پیش‌فرض \fB3\fP است.

.SS \fB--retry-delay\fP=\fIمدت‌زمان\fP
مدت زمان تأخیر میان دفعات تلاش مجدد در هنگام دریافت یا ارسال ایمیج‌ها میان رجیستری و ذخیره‌ساز محلی در صورت بروز خطا. حالت پیش‌فرض شروع با دو ثانیه و سپس افزایش نمایی (exponential backoff) است. در صورت تنظیم این مقدار، تأخیر ثابت مشخص‌شده استفاده شده و عقب‌نشینی نمایی صورت نمی‌گیرد.

.SS \fB--tls-verify\fP
الزام HTTPS و تایید گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: \fBtrue\fP).
اگر به صراحت روی \fBtrue\fP تنظیم شود، اعتبارسنجی TLS اعمال می‌شود.
اگر روی \fBfalse\fP تنظیم شود، اعتبارسنجی TLS اعمال نمی‌شود.
اگر مشخص نشده باشد، اعتبارسنجی TLS استفاده می‌شود مگر اینکه رجیستری هدف در \fBcontainers-registries.conf(5)\fP به عنوان یک رجیستری ناامن ذکر شده باشد.

.SH "مثال‌ها (EXAMPLES)"
دریافت یک مصنوع از یک رجیستری:

.EX
podman artifact pull quay.io/baude/artifact:josey
Getting image source signatures
Copying blob e741c35a27bb done   |
Copying config 44136fa355 done   |
Writing manifest to image destination

.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-artifact(1)\fP, \fBpodman-login(1)\fP, \fBcontainers-certs.d(5)\fP

.SS "عیب‌یابی (Troubleshooting)"
برای راه‌حل‌های مشکلات رایج به \fBpodman-troubleshooting(7)\fP مراجعه کنید.

.SH "تاریخچه (HISTORY)"
ژانویه ۲۰۲۵، در ابتدا توسط Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]
گردآوری شد.