podman-artifact-push(1) General Commands Manual podman-artifact-push(1)

podman-artifact-push - ارسال یک مصنوع OCI از ذخیره‌ساز محلی به یک رجیستری ایمیج

podman artifact push [گزینه‌ها] ایمیج

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

# ارسال مصنوع به یک رجیستری کانتینر
$ podman artifact push quay.io/artifact/foobar1:latest

مسیر فایل احراز هویت. پیش‌فرض در لینوکس ${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 امکان‌پذیر است.

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

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

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

پس از کپی کردن ایمیج، دایجست ایمیج حاصل را در فایل می‌نویسد.

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

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

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

افزودن امضای «امضای ساده» (simple signing) در مقصد با استفاده از کلید مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

افزودن امضای sigstore بر اساس گزینه‌های مشخص‌شده بیشتر در فایل پارامتر امضای sigstore کانتینر، یعنی param-file. برای جزئیات بیشتر در مورد ساختار فایل به containers-sigstore-signing-params.yaml(5) مراجعه کنید.

افزودن امضای sigstore در مقصد با استفاده از کلید خصوصی در مسیر مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

افزودن امضای «امضای ساده» با استفاده از یک کلید Sequoia-PGP با اثر انگشت مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

در صورت امضای ایمیج (با استفاده از --sign-by، --sign-by-sq-fingerprint یا --sign-by-sigstore-private-key)، عبارت عبور مورد استفاده را از مسیر مشخص‌شده بخواند.

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

ارسال ایمیج مشخص‌شده به یک رجیستری کانتینر:

$ podman artifact push quay.io/baude/artifact:single
Getting image source signatures
Copying blob 3ddc0a3cdb61 done   |
Copying config 44136fa355 done   |
Writing manifest to image destination

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

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