نام (NAME)

podman-artifact-pull - دریافت یک مصنوع از یک رجیستری و ذخیره آن در سطح محلی

خلاصه دستور (SYNOPSIS)

podman artifact pull [گزینه‌ها] منبع

توضیحات (DESCRIPTION)

دستور podman artifact pull یک مصنوع را از یک رجیستری بر روی رایانه محلی کپی می‌کند.

منبع (SOURCE)

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

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

گزینه‌ها (OPTIONS)

--authfile=مسیر

مسیر فایل احراز هویت. پیش‌فرض در لینوکس ${XDG_RUNTIME_DIR}/containers/auth.json و در ویندوز/مک‌او‌اس $HOME/.config/containers/auth.json است. این فایل توسط podman login ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، $HOME/.docker/config.json که با docker login تنظیم می‌شود، بررسی خواهد شد.

نکته: همچنین این گزینه وجود دارد که با تنظیم متغیر محیطی REGISTRY_AUTH_FILE مسیر پیش‌فرض فایل احراز هویت بازنویسی شود. این کار با دستور export REGISTRY_AUTH_FILE=path امکان‌پذیر است.

--cert-dir=مسیر

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

--creds=[نام‌کاربری[:گذرواژه]]

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

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

--decryption-key=کلید[:عبارت‌عبور]

مقدار [کلید[:عبارت‌عبور]] برای رمزگشایی ایمیج‌ها. کلید می‌تواند به فایل‌های کلید یا گواهی‌ها اشاره کند. رمزگشایی با تمام کلیدها آزمایش می‌شود. اگر کلید توسط یک عبارت عبور محافظت شده باشد، ارسال آن در آرگومان الزامی است، در غیر این صورت نادیده گرفته می‌شود.

--help, -h

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

--quiet, -q

عدم نمایش پیام‌های خروجی اطلاعاتی (که نشان می‌دهند کدام دستورالعمل در حال پردازش است و وضعیت پیشرفت آن چگونه است). فقط پیام خطای نهایی یا اطلاعات تکمیل موفقیت‌آمیز، مانند شناسه ایمیج یا کانتینر چاپ می‌شود.

--retry=دفعات

تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیج‌ها میان رجیستری و ذخیره‌ساز محلی در صورت بروز خطا. مقدار پیش‌فرض 3 است.

--retry-delay=مدت‌زمان

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

--tls-verify

الزام HTTPS و تایید گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: true). اگر به صراحت روی true تنظیم شود، اعتبارسنجی TLS اعمال می‌شود. اگر روی false تنظیم شود، اعتبارسنجی TLS اعمال نمی‌شود. اگر مشخص نشده باشد، اعتبارسنجی TLS استفاده می‌شود مگر اینکه رجیستری هدف در containers-registries.conf(5) به عنوان یک رجیستری ناامن ذکر شده باشد.

مثال‌ها (EXAMPLES)

دریافت یک مصنوع از یک رجیستری:

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

همچنین ببینید (SEE ALSO)

podman(1), podman-artifact(1), podman-login(1), containers-certs.d(5)

عیب‌یابی (Troubleshooting)

برای راه‌حل‌های مشکلات رایج به podman-troubleshooting(7) مراجعه کنید.

تاریخچه (HISTORY)

ژانویه ۲۰۲۵، در ابتدا توسط Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩ گردآوری شد.